file/share: advanced files sharing¶
share
groups commands for listing file available on a device/service, sharing a file
or directory, and inviting people to retrieve files.
list¶
List files available on a device or sharing service. You mainly have to specify the jid of the device/service where the files are stored (if jid is omitted, your own jid will be used, so you can check what you are sharing).
Note
you have to use the full jid of the device if you want to list files available on a device.
You may specify a path using -d PATH, --path PATH
.
File and directories are printed with a different colour if you use default output.
examples¶
List files shared from a device (note that we use a full jid here):
$ li file share list louise@example.org/some_resource
List files available on a sharing service at the path /photos
:
$ li file share list -d photos files.example.org
Louise wants to list the file shared by Pierre:
$ li file share list pierre@files.example.org
path¶
Share a local file or directory with a list of entities, or publicly. The files can then be listed or requested using libervia-cli_file_share_list or request.
You specify the file or directory the positional path
argument. By default the name of
the file/directory is used, but you can give a different one using -n NAME, --name
NAME
.
You can specify entities allowed to see your files using -j JID, --jid JID
as many
time as necessary. If you don’t specify any entity, the file will only be accessible by
your own devices. If you want to make your file accessible to everybody, use --public
(note that this means that your file is accessible to the world, i.e. also to people you
don’t know, so use this option carefully).
examples¶
Share the file interesting_doc.odt
with Pierre and Louise:
$ li file share path -j pierre@example.net -j louise@example.org interesting_doc.odt
Imagine that you have built a weather station and want to make its data public. You can
share the directory ~/weather_station_data
with the world, using the name public
weather data
:
$ li file share path --public --name "public weather data" ~/weather_station_data
invite¶
This command send an invitation for a file sharing repository to an XMPP entity.
The invitation is a non standard (yet?) way to notify somebody of the existence of a files repository.
Beside the positional arguments service
and jid
, which are respectively the
service where is the files repository and the jid of the entity to invite, you mainly have
to indicate the path and namespace of your repository, using -P PATH, --path PATH
and
N NAMESPACE, --namespace NAMESPACE
.
Use the -t {files,photos}, --type {files,photos}
to specify if you repository is a
generic files repository or a photo album.
Optionally, you can associate a thumbnail to the repository with -T THUMBNAIL,
--thumbnail THUMBNAIL
. This is recommended to have more user friendly representation of
the album in e.g. Libervia.
example¶
Pierre wants to invite Louise to view his summer holidays
photo album:
$ li file share invite -P "photos/summer holidays" -t photos pierre@files.example.net
louise@example.org
affiliations¶
subcommands for file sharing affiliations management. please check file/share/affiliations: file sharing affiliations management.
configuration¶
subcommands for retrieving/modifying file sharing node configuration. please check file/share/configuration: file sharing node configuration.