rsync (command)

Reference

Syntax

Local

rsync [OPTION...] SRC... [DEST]

Access via remote shell

# Pull:

rsync [OPTION...] [USER@]HOST:SRC... [DEST]

# Push:

rsync [OPTION...] SRC... [USER@]HOST:DEST

Access via rsync daemon

Pull:

  • rsync [OPTION...] [USER@]HOST::SRC... [DEST]

  • rsync [OPTION...] rsync://[USER@]HOST[:PORT]/SRC... [DEST]

Push:

  • rsync [OPTION...] SRC... [USER@]HOST::DEST

  • rsync [OPTION...] SRC... rsync://[USER@]HOST[:PORT]/DEST

Rsync Command Options

Option

Long Option

Description

-a

--archive

archive mode; equals -rlptgoD (no -H,-A,-X)

-v

--verbose

increase verbosity

-r

--recursive

recurse into directories

-x

--xattrs

preserve extended attributes

-A

--acls

preserve ACLs (implies -p)

--stats

give some file-transfer stats

-h

--human-readable

output numbers in a human-readable format

--progress

show progress during transfer

--info=progress2

-P

same as --partial --progress

--partial

-z

--compress

compress file data during the transfer

-b

--backup

With this option, preexisting destination files are renamed as each file is transferred or deleted. You can control where the backup file goes and what (if any) suffix gets appended using the --backup-dir and --suffix options.

--remove-source-files

This tells rsync to remove from the sending side the files (meaning non-directories) that are a part of the transfer and have been successfully duplicated on the receiving side.

Last updated