Rechercher une page de manuel
u1sync
Langue: en
Version: 330223 (ubuntu - 24/10/10)
Section: 1 (Commandes utilisateur)
NAME
u1sync - locally mirror an Ubuntu One share or storage volumeSYNOPSYS
u1sync [OPTION]... [DIRECTORY]u1sync --authorize [OPTION]...
u1sync --list-shares [OPTION]...
u1sync --init [--share=SHARE_UUID] [--subtree=PATH] [OPTION]... DIRECTORY
u1sync --diff [--share=SHARE_UUID] [--subtree=PATH] [OPTION]... DIRECTORY
DESCRIPTION
u1sync synchronizes a local directory with the Ubuntu One storage service. It can also be used to authorize a new machine for use with Ubuntu One or compare the contents of a local directory with contents stored in the storage service.To initialize a directory for use as a mirror of your Ubuntu One Storage volume, use the --init option and supply the name of the directory to initialize as a mirror. The directory will be created if it doesn't already exist. u1sync operates separately from the Ubuntu One synchronization daemon and shouldn't normally be used with directories under "$HOME/Ubuntu One" (although --diff is always safe).
Once the directory has been initialized, running u1sync within it (or by supplying the directory as an argument) will bring the mirror up to date. Subsequent changes will not be propagated until u1sync is run again. By default, synchronization is bidirectional, applying local changes to the server and server-side changes to the local mirror, although different behavior can be selected using --action.
In addition to "My Files", u1sync can also manage local mirrors of shares which have been offered to you by other users. You can use the --list-shares option to see the shares currently available to you, and the --share option can be used with --init to initialize a directory as a mirror of a particular share rather than your personal storage.
If your machine is not authorized with Ubuntu One, you can authorize it by calling u1sync with the --authorize option. It will open a browser window to conduct the authorization process using your Launchpad credentials and store the resulting token in the gnome keyring.
OPTIONS
- --action=ACTION
- selects the synchronization action to use; ACTION may be one of:
-
- upload
- apply local changes to the server (preserving non-conflicting server-side changes)
- download
- apply server-side changes to the local mirror (preserving non-conflicting local changes)
- sync
- perform a bi-directional sync
- clobber-local
- make the local mirror match what is on the server
- clobber-server
- make the server match what is in the local mirror
- auto
- the default; download from read-only shares, otherwise sync
-
- --authorize
- authorizes your machine for use with Ubuntu One
- --diff
- shows the differences between the contents of a directory and your Ubuntu One storage (the directory doesn't need to be an initialized mirror)
- --dry-run
- go through the motions but don't actually modify anything
- --init
- initializes the provided directory for use as a mirror
- -h, --help
- displays a brief help message summarizing usage and options
- --host=HOST
- connects to the specified hostname rather than the default API service
- --list-shares
- lists available shares
- --oauth=KEY:SECRET
- explicitly specify an OAuth token to use rather than querying the keyring
- --port=PORT
- specify a non-default port to connect to
- --quiet
- produce less output
- --share=SHARE_UUID
- specify a share to mirror (instead of "My Files"); share UUIDs can be obtained from --list-shares
- --subtree=PATH
- used with --init to set up a mirror of subtree rather than the entirety of your personal storage (or the specified share); can also be used with --diff to compare the local directory against a subtree
TIPS AND TRICKS
You can use u1sync's --diff mode to see which files in your personal storage the Ubuntu One synchronization daemon has yet to synchronize:u1sync --diff ~/Ubuntu\ One/My\ Files
You can also check the status of files in shares in a similar fashion if you know the share's UUID (which you can obtain via --list-shares):
u1sync --diff --share=a4f57216-6086-45b6-be26-694e76ffa2f0 ~/Ubuntu\ One/Shared\ With\ Me/awesome
u1sync --authorize can be used to re-authorize a machine whose authorization token has expired; it will replace the expired token in your keyring with a new one.
AUTHOR
This manual page was written by Tim Cole <tim.cole@canonical.com>.Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre