Mercurial > libervia-backend

comparison doc/jp/file_share_affiliations.rst @ 3325:7ebda4b54170

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
jp (file/share): added commands to manage affiliations and configuration + documentation
author Goffi <goffi@goffi.org>
date Sat, 01 Aug 2020 16:25:50 +0200
parents
children
comparison
equal deleted inserted replaced
3324:b57b5e42e894 3325:7ebda4b54170
1 .. _jp-file_share_affiliations:
2
3 =============================================================
4 file/share/affiliations: file sharing affiliations management
5 =============================================================
6
7 ``affiliations`` let you manage access permission to your shared files repository, in a
8 way similar as for pubsub.
9
10 Affiliations with file sharing are not standard and will only work with the SàT file
11 sharing component.
12
13 Affiliations are similar to pubsub ones:
14
15 ``owner``
16 Has full permissions on the node, including changing affiliations. Owner can't be
17 changed at the moment.
18
19 ``publisher``
20 Can read, upload and delete files
21
22 ``member``
23 Can access file but can't modify them or add new ones
24
25 ``none``
26 Is not a member of this node, use it to remove an existing affiliation.
27
28
29 get
30 ===
31
32 Retrieve entities affiliated to this file sharing node, and their role
33
34 example
35 -------
36
37 Get affiliations of a file sharing node::
38
39 $ jp file share affiliations get -P "/some/path" louise@files.example.org
40
41 set
42 ===
43
44 Set affiliations of an entity to a file sharing node.
45
46 examples
47 --------
48
49 Allow read access to a photo album to Louise::
50
51 $ jp file share affiliations set -c files.example.net -P "/albums/holidays" -a louise@tazar2.int member
52
53 Remove access to a directory from an old address of Pierre, and give it to the new one::
54
55 $ jp file share affiliations set -c files.example.net -N "some_namespace" -P
56 "/interesting/directory" -a pierre@example.com none -a pierre@example.org member