if no local destination is provided for the transfer then provide

[rsync/rsync.git] / rsync.yo

diff --git a/rsync.yo b/rsync.yo
index cedf578..411a8ce 100644 (file)
--- a/rsync.yo
+++ b/rsync.yo
@@ -140,6 +140,9 @@ itemize(
 
        it() if you specify no path name on the remote server then the
        list of accessible paths on the server will be shown.
 
        it() if you specify no path name on the remote server then the
        list of accessible paths on the server will be shown.

+       
+       it() if you specify no local destination then a listing of the
+       specified files on the remote server is provided

 )
 
 Some paths on the remote server may require authentication. If so then
 )
 
 Some paths on the remote server may require authentication. If so then


@@ -345,10 +348,14 @@ permissions to be the same as the local permissions.
 
 dit(bf(-o, --owner)) This option causes rsync to update the  remote  owner
 of the  file to be the same as the local owner. This is only available
 
 dit(bf(-o, --owner)) This option causes rsync to update the  remote  owner
 of the  file to be the same as the local owner. This is only available

-to the super-user.
+to the super-user.  Note that if the source system is a daemon using chroot,
+the --numeric-ids option is implied because the source system cannot get
+access to the user names.

 
 dit(bf(-g, --group)) This option causes rsync to update the  remote  group
 
 dit(bf(-g, --group)) This option causes rsync to update the  remote  group

-of the file to be the same as the local group.
+of the file to be the same as the local group.  Note that if the source
+system is a daemon using chroot, the --numeric-ids option is implied because
+the source system cannot get access to the group names.

 
 dit(bf(-D, --devices)) This option causes rsync to transfer character and
 block device information to the remote system to recreate these
 
 dit(bf(-D, --devices)) This option causes rsync to transfer character and
 block device information to the remote system to recreate these


@@ -512,8 +519,9 @@ what ownership to give files. The special uid 0 and the special group
 0 and never mapped via user/group names even if the --numeric-ids
 option is not specified.
 
 0 and never mapped via user/group names even if the --numeric-ids
 option is not specified.
 

-If a user or group name does not exist on the destination system then
-the numeric id from the source system is used instead.
+If the source system is a daemon using chroot, or if a user or group name
+does not exist on the destination system, then the numeric id from the
+source system is used instead.

 
 dit(bf(--timeout=TIMEOUT)) This option allows you to set a maximum IO
 timeout in seconds. If no data is transferred for the specified time
 
 dit(bf(--timeout=TIMEOUT)) This option allows you to set a maximum IO
 timeout in seconds. If no data is transferred for the specified time