3
u1sync - locally mirror an Ubuntu One share or storage volume
6
[\fIOPTION\fR]... [\fIDIRECTORY\fR]
9
\-\-authorize [\fIOPTION\fR]...
12
\-\-list\-shares [\fIOPTION\fR]...
15
\-\-init [\fI\-\-share=SHARE_UUID\fR] [\fI\-\-subtree=PATH\fR]
16
[\fIOPTION\fR]... \fIDIRECTORY\fR
19
\-\-diff [\fI\-\-share=SHARE_UUID\fR] [\fI\-\-subtree=PATH\fR]
20
[\fIOPTION\fR]... \fIDIRECTORY\fR
23
u1sync synchronizes a local directory with the Ubuntu One storage
24
service. It can also be used to authorize a new machine for use with
25
Ubuntu One or compare the contents of a local directory with contents
26
stored in the storage service.
28
To initialize a directory for use as a mirror of your Ubuntu One
29
Storage volume, use the \-\-init option and supply the name of the
30
directory to initialize as a mirror. The directory will be created if it
31
doesn't already exist. u1sync operates separately from the Ubuntu One
32
synchronization daemon and shouldn't normally be used with directories
33
under "$HOME/Ubuntu One" (although \-\-diff is always safe).
35
Once the directory has been initialized, running u1sync within it (or
36
by supplying the directory as an argument) will bring the mirror
37
up to date. Subsequent changes will not be propagated until u1sync is
38
run again. By default, synchronization is bidirectional, applying local
39
changes to the server and server-side changes to the local mirror,
40
although different behavior can be selected using \-\-action.
42
In addition to "My Files", u1sync can also manage local mirrors of shares
43
which have been offered to you by other users. You can use the
44
\-\-list\-shares option to see the shares currently available to you, and
45
the \-\-share option can be used with \-\-init to initialize a directory as
46
a mirror of a particular share rather than your personal storage.
48
If your machine is not authorized with Ubuntu One, you can authorize it
49
by calling u1sync with the \-\-authorize option. It will open a browser
50
window to conduct the authorization process using your Launchpad credentials
51
and store the resulting token in the gnome keyring.
54
\fB\-\-action\fR=\fIACTION\fR
55
selects the synchronization action to use; ACTION may be one of:
59
apply local changes to the server (preserving non-conflicting server-side changes)
62
apply server-side changes to the local mirror (preserving non-conflicting local changes)
65
perform a bi-directional sync
68
make the local mirror match what is on the server
71
make the server match what is in the local mirror
74
the default; \fIdownload\fR from read-only shares, otherwise \fIsync\fR
78
authorizes your machine for use with Ubuntu One
81
shows the differences between the contents of a directory and
82
your Ubuntu One storage (the directory doesn't need to be an
86
go through the motions but don't actually modify anything
89
initializes the provided directory for use as a mirror
91
\fB\-h\fR, \fB\-\-help\fR
92
displays a brief help message summarizing usage and options
94
\fB\-\-host\fR=\fIHOST\fR
95
connects to the specified hostname rather than the default API service
97
\fB\-\-list\-shares\fR
98
lists available shares
100
\fB\-\-oauth\fR=\fIKEY\fR:\fISECRET\fR
101
explicitly specify an OAuth token to use rather than querying the keyring
103
\fB\-\-port\fR=\fIPORT\fR
104
specify a non-default port to connect to
109
\fB\-\-share\fR=\fISHARE_UUID\fR
110
specify a share to mirror (instead of "My Files"); share UUIDs can be
111
obtained from \-\-list\-shares
113
\fB\-\-subtree\fR=\fIPATH\fR
114
used with \-\-init to set up a mirror of subtree rather than the
115
entirety of your personal storage (or the specified share); can also
116
be used with \-\-diff to compare the local directory against a subtree
118
You can use u1sync's \-\-diff mode to see which files in your personal
119
storage the Ubuntu One synchronization daemon has yet to synchronize:
121
u1sync \-\-diff ~/Ubuntu\\ One/My\\ Files
123
You can also check the status of files in shares in a similar fashion if
124
you know the share's UUID (which you can obtain via \-\-list\-shares):
126
u1sync \-\-diff \-\-share=a4f57216\-6086\-45b6\-be26\-694e76ffa2f0 ~/Ubuntu\\ One/Shared\\ With\\ Me/awesome
128
u1sync \-\-authorize can be used to re-authorize a machine whose
129
authorization token has expired; it will replace the expired token in
130
your keyring with a new one.
132
This manual page was written by Tim Cole <tim.cole@canonical.com>.