СВОДКА ПАРАМЕТРОВ

Далее краткий обзор параметров, понимаемых rsync. Пожалуйста, обращайтесь к более детальному описанию чуть ниже.

-v, --verbose

увеличить уровень подробностей

-q, --quiet

уменьшить уровень подробностей

-c, --checksum

проверять контрольные суммы

-a, --archive

архивный режим, эквивалент для -rlptgoD

-r, --recursive

рекурсивно входить в подкаталоги

--no-recursive

отключить действие --recursive

--no-implied-dirs

не передавать затрагиваемые параметром -R каталоги

-R, --relative

использовать относительные пути

-b, --backup

создавать резервную копию (см. --suffix и --backup-dir)

--backup-dir

создавать резервную копию в этом каталоге

--suffix=SUFFIX

суффикс для резервной копии (по умолчанию ~ в отсутствие --backup-dir)

-u, --update

только обновление (не переписывает более новые файлы)

-l, --links

копировать символьные ссылки как символьные ссылки

-L, --copy-links

копировать то, на что ссылаются символьные ссылки

--copy-unsafe-links

копировать ccылки за пределы исходного дерева каталогов

--safe-links

не копировать любые символьные ссылки, которые ссылаются за пределы дерева каталогов назначения

-H, --hard-links

сохранять жесткие ссылки

-p, --perms

сохранять разрешения

-o, --owner

сохранять владельца (только root)

-g, --group

сохранять группу

-D, --devices

сохранять файлы устройств (только root)

-t, --times

сохранять время

-S, --sparse

эффективно обработать фрагментированные файлы

-n, --dry-run

показать, что скопируется

-W, --whole-file

копировать весь файл без rsync-алгоритма

--no-whole-file

отключить --whole-file

-x, --one-file-system

не выходить за пределы файловой системы

-B, --block-size=SIZE

размер блока контрольных сумм (по умолчанию 700)

-e, --rsh=COMMAND

указывает замену программу удаленной оболочки

--rsync-path=PATH

указывает путь к rsync на удаленной машине

--existing

только обновить те файлы, которые уже существуют

--ignore-existing

пропускать те файлы, которые уже существуют на приемной стороне

--delete

удалять файлы, которых нет на передающей стороне

--delete-excluded

также удалять те файлы, которые исключены из списка копирования

--delete-after

удалять после копирования, а не до него

--ignore-errors

удалить даже при наличии ошибок ввода/вывода

--max-delete=NUM

не удалять больше, чем NUM файлов

--partial

сохранять частично переданные файлы

--force

принудительно удалять даже не пустые каталоги

--numeric-ids

не преобразовывать значения uid/gid по именам пользователя/группы

--timeout=TIME

установить время ожидания ввода/вывода в секундах

-I, --ignore-times

отключить "быструю проверку" файлов по времени модификации и размеру

--size-only

отключить проверку времени модификации при "быстрой проверке" файлов (проверять только размер)

--modify-window=NUM

сравнивать времена модификации файлов с пониженной точностью

-T, --temp-dir=DIR

каталог для временных файлов

--compare-dest=DIR

также сравнивать принятые файлы относительно каталога DIR

--link-dest=DIR

создавать жесткие ссылки в каталоге DIR на не изменявшиеся файлы

-P

эквивалент для --partial --progress

-z, --compress

сжимать поток передачи данных

-C, --cvs-exclude

автоматический пропуск файлов тем же способом, что и в cvs

--exclude=PATTERN

исключить файлы, соответствующие шаблону PATTERN

--exclude-from=FILE

шаблоны исключения брать из файла FILE

--include=PATTERN

не исключать файлы по шаблону PATTERN

--include-from=FILE

не исключать файлы по шаблонам в файле FILE

--files-from=FILE

читать имена файлов для копирования из файла FILE

-0, --from0

нуль - разделитель всех списков файлов

--version

вывести номер версии

--daemon

запустить как rsync-демон

--no-detach

не отключаться от родительского процесса

--address=ADDRESS

слушать на указанном адресе

--config=FILE

указать другой rsyncd.conf файл

--port=PORT

слушать другой порт

--blocking-io

использовать блочный ввод/вывод для удаленной оболочки

--no-blocking-io

отключить --blocking-io

--stats

выдавать статистику по передаче файлов

--progress

показать % выполнения во время передачи

--log-format=FORMAT

формат лог-файла передач

--password-file=FILE

читать пароль из файла FILE

--bwlimit=KBPS

ограничить скорость ввода/вывода, Кбайт/с

--read-batch=PREFIX

для пакетного режима читать набор файлов с префиксом PREFIX

--write-batch=PREFIX

для пакетного режима записать набор файлов с префиксом PREFIX

-h, --help

показать помощь

 

ПАРАМЕТРЫ

rsync использует соглашение о длинных именах параметров GNU. Многие из параметров командной строки имеют два варианта: один - короткий, а другой - длинный. Ниже это отражено в разделении запятой двух вариантов. Некоторые параметры имеют только длинный вариант. Знак '=' для параметров с дополнительным значением необязателен и может быть заменен на пробел.

-h, --help

Печатает короткую подсказку, описывающую доступные параметры rsync

--version

Печатает номер версии rsync и завершается

-v, --verbose

Этот параметр увеличивает сумму подробностей, которые выводятся в течение передачи. По умолчанию, rsync работает молча. Один -v будет иметь следствием выдачу списка переданных файлов и короткий итог в конце. Два -v раскрывают детали о пропущенных файлах и выдают несколько больше информации в завершение. Большее число может понадобится только при отладке rsync.

-q, --quiet

Уменьшает сумму подробностей о передаче, преимущественно, сообщения от удаленного сервера. Этот параметр полезен при вызове из cron.

-I, --ignore-times

Обычно rsync пропускает файлы, чей размер и время модификации идентичны. Этот параметр отключает такое поведение "быстрой проверки".

--size-only

Обычно rsync пропускает файлы, чей размер и время модификации идентичны. С --size-only файлы будут пропускаться, если их размер одинаков, независимо от времени модификации. Это полезно при использовании rsync сразу после работы другой зеркалирующей системы, которая не сохранила точно времена.

--modify-window

При сравнение двух меток времени rsync рассматривает эти метки равными, если они расходятся в пределах значения modify_window. Обычно это значение ноль, но Вы можете найти полезным установку его в большую величину в некоторых случаях. На практике, при передаче на файловую систему Windows FAT, которая не может представлять время с точностью до секунды, --modify_window=1 весьма полезна.

-c, --checksum

Принуждает на передающей стороне подсчитывать контрольные суммы всех файлов, используя 128-битный алгоритм MD4 перед передачей. Контрольная сумма затем проверяется на приемной стороне для того, чтобы пропускать передачи уже существующих файлов с одинаковыми размером и контрольной суммой. Этот параметр может приводить к некоторому замедлению.

-a, --archive

Эквивалентно набору -rlptgoD. Это быстрый способ указать, что Вам нужна рекурсия и Вы хотите сохранить почти все.

Однако заметьте, что -a не сохраняет жесткие ссылки, потому что поиск многосвязных файлов дорог. Вам придется отдельно указывать -H.

-r, --recursive

Указывает rsync копировать каталоги рекурсивно. Без указания этого rsync совсем не будет копировать каталоги.

-R, --relative

Использовать относительные пути. Это значит, что посылаются полные пути, указанные в командной строке, а не последние части имен файлов. На практике это полезно, когда Вам нужно послать несколько различных каталогов за раз. Например, если указать команду:

rsync foo/bar/foo.c remote:/tmp/ 

то она создаст файл foo.c в /tmp на удаленной машине. Если вместо этого указать

rsync -R foo/bar/foo.c remote:/tmp/ 

то файл создастся в /tmp/foo/bar/foo.c на удаленной машине - полный путь сохранится.

--no-relative

Выключает параметр --relative. Это нужно только если Вы хотите использовать параметр --files-from без подразумеваемого им поведения с включенным параметром --relative.

--no-implied-dirs

В комбинации с --relative все затрагиваемые каталоги в каждом пути явно не копируются как часть процесса передачи. Это делает передачу более оптимальной и также позволяет иметь непарные (см. пример ниже) символьные ссылки в подразумеваемых передачей путях. Например, если передается файл "/path/foo/file" с параметром -R, то по умолчанию rsync следит, чтобы "/path" и "/path/foo" в точности соответствовали каталогам/ссылкам на приемной стороне. Параметр --no-implied-dirs позволяет игнорировать несоответствие, когда "/path" - реальный каталог на одной стороне и символьная ссылка на другой. rsync не пытается с этим параметром что-либо менять в этом случае.

-b, --backup

С этим параметром существовавшие до передачи файлы на приемной стороне переименовываются, как только соответствующий файл передан или удален. Вы можете контролировать, куда перемещаются файлы и какой суффикс (если нужно) добавляется к имени, используя параметры --backup-dir и --suffix.

--backup-dir=DIR

В комбинации с --backup указывает каталог, куда сохранять резервные копии. Это весьма полезно для инкрементального резервирования. Вы можете дополнительно указать суффикс с помощью --suffix (иначе резервные копии файлов будут сохранять свои исходные имена).

--suffix=SUFFIX

Этот параметр позволяет указать суффикс, отличный от суффикса по умолчанию, для резервных копий файлов при установленном --backup (-b). По умолчанию этот суффикс установлен в ~ без установки --backup-dir, установка которого сбрасывает этот суффикс в пустую строку.

-u, --update

Указывает пропускать любые файлы, уже существующие на приемной стороне с более поздней датой, чем у исходных файлов.

-l, --links

Если обнаружена символьная ссылка, то она же создается и на приемной стороне.

-L, --copy-links

Если обнаружена символьная ссылка, то на приемную сторону копируется файл, на который она указывает, а не такая же символьная ссылка.

--copy-unsafe-links

Копирует все объекты за пределами исходного дерева каталогов, на которые ссылаются символьные ссылки. Абсолютные символьные ссылки, а также, при выставленном --relative, любые символьные ссылки в пределах исходного дерева каталогов, рассматриваются как обычные файлы.

--safe-links

Указывает игнорировать любую символьную ссылку, которая относится к объекту за пределами конечного дерева каталогов. Все абсолютные ссылки также пропускаются. Использование этого параметра в комбинации с --relative может дать неожиданные результаты.

-H, --hard-links

Указывает пересоздать жесткие ссылки на конечной стороне в соответствии с тем, что имеется на исходной. Без этого параметра жесткие ссылки обрабатываются как обычные файлы.

Обратите внимание, что rsync может обнаруживать жесткие ссылки, только если обе части ссылки попадают в список предназначенных к передаче файлов.

С этим параметром передача может быть довольно-таки медленной, так что пользуйтесь им только при необходимости.

-W, --whole-file

Этот параметр отключает дифференциальный алгоритм rsync'а и с ним весь файл передается как есть, целиком. Передача может происходить быстрее с этим параметром, если полоса пропускания между исходной и конечной машинами шире, чем полоса пропускания доступа к диску (особенно, если "диск" в действительности сетевая файловая система). Этот параметр включен по умолчанию, если и исходная, и конечная цели находятся локально.

--no-whole-file

Выключает действие параметра --whole-file, если последний включен по умолчанию.

-p, --perms

Копирует все права на приемную сторону точь в точь с оригиналом.

Без указания этого параметра каждый новый файл получает те права доступа, что имеет исходный с учетом umask, действующей на приемной стороне, в то время как все другие (включая обновляемые) сохраняют свои уже существующие разрешения (это то же поведение, что имеют другие утилиты копирования файлов, такие как cp).

-o, --owner

Копирует атрибуты владельца на приемную сторону в точности с оригиналом. На большинстве систем только супер-пользователь имеет право устанавливать владельца файла. Нужно заметить, что если удаленный демон действует в chroot-окружении, то подразумевается наличие параметра --numeric-ids, потому что на удаленной стороне в этом случае нет доступа к именам пользователей в /etc/passwd.

-g, --group

Копирует атрибуты группы на приемную сторону в точности с оригиналом. Если удаленная сторона не действует из-под супер-пользователя, то сохранятся только те значения групп, членом которых является пользователь приемной стороны (имеет значение имя группы, а не ее id).

-D, --devices

Указывает передавать информацию о символьных и блочных устройствах для пересоздания их на приемной стороне. Доступно только супер-пользователю.

-t, --times

Указывает передавать время модификации файлов и обновлять им соответствующий атрибут на приемной стороне. Обратите внимание, что если этот параметр не установлен, то становится неэффективной оптимизация передачи по исключению не изменявшихся по времени файлов; другими словами, пропуск -t или -a будет означать, что следующая передача будет осуществляться с параметром -I, для всех файлов будут сравниваться контрольные суммы, а в журнале появятся соответствующие сообщения о них, даже если они не изменялись.

-n, --dry-run

Указывает не осуществлять никаких передач, а только сообщать о тех действиях, которые могли бы произойти.

-S, --sparse

Пытаться эффективнее обработать фрагментацию файлов, чтобы сэкономить пространство на приемной стороне.

ЗАМЕЧАНИЕ: Не используйте этот параметр, если в точке назначения имеется файловая система "tmpfs" Solaris. Не представляется возможным правильно управлять поиском среди "дырок" (null regions), что заканчивается повреждением файлов.

-x, --one-file-system

Требует не переходить границ файловой системы при рекурсивном копировании. Это полезно при необходимости копирования только одной файловой системы.

--existing

Указывает не создавать никаких новых файлов - только обновить те, которые уже существуют на приемной стороне.

--ignore-existing

Указывает не обновлять файлы, которые уже существуют на приемной стороне.

--max-delete=NUM

Не удалять больше, чем NUM файлов и каталогов. Это полезно при зеркалировании очень массивных деревьев каталогов для предохранения от неприятностей.

--delete

Удалять любые файлы на приемной стороне, которых нет на передающей. Файлы, исключенные из передачи, исключаются также и из процесса удаления, если не указана --delete-excluded.

Этот параметр не оказывает никакого влияния, если не включено рекурсивное копирование каталогов.

Этот параметр может быть опасным при неправильном использовании! Очень хорошим правилом может стать использование сначала холостого выполнения rsync (-n) для просмотра того, что за файлы могут удалиться и нет ли среди них важных.

При возникновении каких-либо ошибок ввода-вывода на передающей стороне удаление любых файлов на приемной автоматически отключается. Это предотвращает от массивного удаления файлов на приемной стороне из-за временных ошибок файловой системы (например, NFS) на передающей. Это поведение можно отключить параметром --ignore-errors.

--delete-excluded

В дополнение к файлам, удаляемым на приемной стороне из-за отсутствия их на передающей, указывает удалять также любые исключенные параметром --exclude файлы на приемной стороне. Подразумевается наличие параметра --delete.

--delete-after

По умолчанию, rsync сначала выполняет удаление файлов перед копированием для пущей уверенности, что хватит свободного места на приемной стороне. Если же Вы хотите, чтобы удаление производилось после, то используйте --delete-after. Подразумевается наличие параметра --delete.

--ignore-errors

При удалении (--delete) форсирует процесс и игнорирует любые ошибки, даже ошибки ввода-вывода.

--force

Удалять каталоги при замене их не-каталогами, даже если они не пусты. Уместен только без --delete, потому что удаление происходит только каталогов одного уровня. Требует --recursive (который подразумевается, если -a) для значимого эффекта.

-B, --block-size=BLOCKSIZE

Регулирует размер блока, используемый rsync-алгоритмом. См. техническое описание на предмет деталей.

-e, --rsh=COMMAND

Позволяет выбрать альтернативную программу удаленной оболочки для осуществления соединения между удаленной и локальной копиями rsync. Обычно rsync сконфигурирован для использования ssh по умолчанию, но Вы можете предпочесть использовать rsh в локальной сети.

Если этот параметр используется с указанием пути вида [user@]host::module/path, то программа удаленной оболочки COMMAND будет использована для запуска rsync-сервера на удаленной стороне, а все данные будут передаваться через соединение удаленной оболочки, а не напрямую через соединение с rsync-сервером на "том" конце. См. раздел "ПОДКЛЮЧЕНИЕ К RSYNC-СЕРВЕРУ ЧЕРЕЗ УДАЛЕННУЮ ОБОЛОЧКУ".

Аргументы командной строки для COMMAND разрешено указывать в форме, при которой COMMAND представляется для rsync в виде одного аргумента. Например:

-e "ssh -p 2234"

(Заметьте, что ssh-пользователи могут альтернативно настраивать специфичные для своего окружения параметры подключения в своих .ssh/config файлах.)

Вы также можете выбирать программу удаленной оболочки через переменную окружения RSYNC_RSH, которая принимает тот же диапазон значений, что и -e.

См. также --blocking-io, на которую влияет установка параметра -e.

--rsync-path=PATH

Указывает путь к копии rsync на удаленной стороне. Полезен, если rsync'а нет в Ваших путях поиска. Заметьте, что здесь указывается полный путь к программе, а не каталог, где она лежит.

-C, --cvs-exclude

Этим параметром Вы исключаете широкий диапазон файлов, которые Вы не хотите передавать между системами. При этом используется тот же алгоритм, что использует CVS для определения игнорируемых файлов.

Список исключений изначально включает в себя:

RCS/ SCCS/ CVS/ .svn/ CVS.adm RCSLOG cvslog.* tags TAGS .make.state .nse_depinfo *~ #* .#* ,* *.old *.bak *.BAK *.orig *.rej .del-* *.a *.o *.obj *.so *.Z *.elc *.ln core

затем файлы, перечисленные в $HOME/.cvsignore , добавляются к первоначальному списку, а также любые, перечисленные в переменной окружения CVSIGNORE (разделенные пробелами).

В заключение, любой файл пропускается, если в том же каталоге есть файл .cvsignore, в котором есть соответствующий файлу шаблон. См. руководство по cvs(1) для дальнейшей информации.

--exclude=PATTERN

Позволяет выборочно исключать определенные файлы из процесса передачи. Это наиболее полезно при рекурсивной передаче.

Вы можете использовать так много --exclude, как Вам заблагорассудится для построения произвольного списка исключаемых файлов.

См. секцию "ШАБЛОНЫ ИСКЛЮЧЕНИЯ" за информацией о синтаксисе для этого параметра.

--exclude-file=FILE

Подобен параметру --exclude, но в отличие от него использует шаблоны исключаемых фалов, перечисленные в файле FILE. Пустые строки вместе со строками, начинающимися с ';' или '#', игнорируются. Если FILE указан как -, то список шаблонов читается со стандартного ввода.

--include=PATTERN

Указывает шаблоны для имен тех файлов, которые нельзя исключать из процесса. Полезен тем, что позволяет Вам строить довольно сложные правила включения/исключения.

См. секцию "ШАБЛОНЫ ИСКЛЮЧЕНИЯ" за информацией о синтаксисе для этого параметра.

--include-from=FILE

Указывает брать список обязательно включаемых в передачу файлов из файла FILE. Если FILE указан как -, то список шаблонов читается со стандартного ввода.

--files-from=FILE

Позволяет задать точный список файлов для передачи (который будет прочитан из указанного FILE или из стандартного ввода, если указан -). Это также меняет поведение rsync по умолчанию в целях облегчения процесса передачи заданных файлов и каталогов. Например, по умолчанию включается использование опции --relative (для отключения этого используйте --no-relative), на принимающей стороне создаются все указанные в списке каталоги (а не пропускаются безгласно, как если бы не использовалась опция -r), а поведение -a (--archive) не подразумевает наличие -r (--recursive) - его, при необходимости, нужно указывать явно.

Все имена файлов, прочитанные из FILE, считаются относительными к исходному каталогу -- первые слэши убираются и не допускаются ссылки "..", указывающие выше по дереву исходного каталога. Для примера рассмотрим:

rsync -a --files-from=/tmp/foo /usr remote:/backup

Если /tmp/foo содержит строку bin (или даже "/bin"), каталог /usr/bin будет создан как /backup/bin на удаленной машине (но содержимое /usr/bin не должно передаваться, кроме тех случаев, когда объекты явно указаны в /tmp/foo, или в случае указания параметра -r). Также учитывайте, что эффект от --relative (включенный по умолчанию) касается копирования путей, прочитанных из файла, -- он не принуждает копировать полностью указанный исходный путь (/usr в примере).

В дополнение, --files-from файл может быть прочитан с удаленной машины, а не локально, если указать перед именем файла "host:" (это должно соответствовать одному из концов передачи). Для краткости, можно указывать только префикс ":" для обозначения удаленного участника копирования. Например:

rsync -a --files-from=:/path/file-list src:/ /tmp/copy

эта команда должна скопировать все файлы указанные в файле /path/file-list, который расположен на удаленной машине "src".

-0, --from0

Говорит rsync, что имена файлов, читаемые извне, заканчиваются символом '\0', не NL, CR или CR+LF. Это касается параметров --exclude-from, --include-from, and --files-from.

-T, --temp-dir=DIR

Инструктирует использовать DIR как каталог временных копий передаваемых файлов на принимающей стороне. По умолчанию временные файлы создаются в каталоге назначения.

--compare-dest=DIR

Инструктирует использовать DIR на машине назначения как каталог, относительно содержимого которого осуществляется сравнение во время процесса передачи при условии отсутствия файлов в каталоге назначения. Это полезно для осуществления передачи в новое место, оставляя существующие файлы неприкосновенными, а затем перенося и очищая, когда все файлы были переданы (например, при перемещении каталогов в новое место и удалении старого, хотя при этом пропускаются не изменявшиеся файлы; см. также --link-dest).

Прим. переводчика: Существование этого параметра обусловлено необходимостью обновлять, например, дерево с взаимозависимыми файлами. В этом случае нежелательно осуществлять копирование на пофайловой основе. Параметр --compare-dest позволяет указывать временный каталог назначения, куда и копируются передаваемые файлы. По окончании процесса передачи rsync переименовывает оригинальное дерево назначения, затем переименовывает временный каталог DIR в оригинальный и, наконец, удаляет переименованный на первом шаге оригинальный каталог со "старыми" файлами.

Этот параметр повышает полезность --partial, потому что частично переданные файлы будут оставаться в новом временном каталоге до тех пор, пока не окажутся целиком на месте. Если DIR задан как относительный путь, то он соотносится к каталогу назначения.

--link-dest=DIR

Ведет себя также, как и --compare-dest, но также создает жесткие ссылки в DIR на не изменявшиеся файлы в каталоге назначения. Файлы с измененными правами и владением не подвергаются этому. Как и в случае --compare-dest, если DIR задается относительным именем, то и действия осуществляются относительно каталога назначения.

-z, --compress

С этим параметром rsync сжимает все передаваемые данные файлов. Это полезно на медленных линиях. Метод сжатия, используемый при этом, тот же, что реализует gzip.

Заметьте, что при этом обычно достигается лучший коэффициент сжатия, чем может быть достигнут, используя сжатие программ удаленной оболочки или сжатие транспортного уровня, т.к. в процесс сжатия вовлекается вся информация, посылаемая в соответствующих блоках данных.

--numeric-ids

Вместо имен групп и пользователей посылаются их числовые id и ставятся в соответствие друг другу на обоих концах.

По умолчанию rsync использует имена групп и пользователей для определения владельца файлов. Специальные uid 0 и gid 0 никогда не отображаются через имена пользователей/групп, даже если не указана --numeric-ids.

Если исходная система работает в ограниченном chroot-окружении или если пользователь или группа не существуют на приемной стороне, то используются исходные числовые id.

--timeout=TIMEOUT

Позволяет устанавливать максимальное время ожидания ввода-вывода в секундах. Если за указанный период ничего не передано, то работа rsync завершается. По умолчанию 0, что означает без ожидания.

--daemon

Запускает rsync как демон. Демон доступен для клиентов через синтаксис host::module или rsync://host/module .

Если стандартным вводом является сокет, то rsync полагает условием запуск от inetd, иначе он отключается от текущего терминала и становится фоновым процессом-демоном. Демон читает конфигурационный файл (rsyncd.conf) на каждое соединение от клиентов и соответственно отвечает на их запросы.

--no-detach

При запуске демоном этот параметр инструктирует rsync не отключаться от терминала и стать фоновым процессом. Он требуется при запуске службой под Cygwin, и также может быть полезен, если rsync находится под наблюдением таких программ как daemontools или AIX's System Resource Controller. --no-detach также рекомендуется к применению при запуске rsync под отладчиком. Этот параметр не имеет никакого эффекта при запуске от inetd или sshd.

--address

По умолчанию rsync использует групповой адрес 0.0.0.0, когда запускается как демон с --daemon или при подключениях к rsync-серверу. --address позволяет Вам указать точный IP-адрес (или хост-имя) для этого. Это делает возможным виртуальный хостинг в сочетании с --config.

--config=FILE

Указывает альтернативный файл конфигурации. Это имеет значение только если указан --daemon. По умолчанию /etc/rsyncd.conf за исключением случая, когда демон запускается поверх удаленной оболочки и удаленный пользователь не root. В последнем случае rsyncd.conf по умолчанию располагается в текущем каталоге (обычно $HOME).

--port=PORT

Указывает альтернативный номер TCP порта для работы, а не 873 по умолчанию.

--blocking-io

Указывает использовать блокирующий ввод-вывод при запуске поверх программы-транспорта удаленной оболочки. Если этой программой являются либо rsh, либо remsh, то rsync использует блокирующий ввод-вывод по умолчанию, иначе по умолчанию используется неблокирующий ввод-вывод. (Заметьте, что ssh предпочитает неблокирующий.)

--no-blocking-io

Отключает действие --blocking-io, когда оно активировано по умолчанию.

--log-format=FORMAT

Позволяет Вам точно указывать, что rsync сообщает (журналирует) на стандартный вывод на по-файловой основе. Формат сообщений определяется тем же соглашением, что и для параметра журналирования в файле rsyncd.conf.

--stats

Указывает выводить подробную статистику по передаче файлов, позволяя Вам оценить, насколько эффективен алгоритм rsync относительно Ваших данных.

--partial

По умолчанию rsync будет удалять все частично-переданные файлы в случае прерывания передачи. В некоторых случаях более желательно сохранять такие файлы. Используя параметр --partial, можно указать rsync сохранять частично-переданный файл, что может ускорить передачу всего файла при последовательном повторении таких передач.

--progress

Указывает выводить rsync информацию о ходе передачи. Скучающему пользователю будет на что посмотреть. Подразумевает наличие --verbose без увеличения подробностей.

-P

Эквивалент для --partial --progress . Автор нашел для себя частым использование этой комбинации, поэтому для облегчения ввел отдельный параметр.

--password-file

Позволяет Вам предоставить пароль для доступа к rsync-серверу, сохранив его в файле. Заметьте, что этот параметр полезен только при использовании для доступа к rsync-серверу встроенного rsync-транспорта, при использовании программы удаленной оболочки он бесполезен. Файл не должен быть всем доступен на чтение. Он должен содержать только пароль, в одну строчку.

--bwlimit=KBPS

Позволяет указать максимальную скорость передачи, килобайт в секунду. Этот параметр наиболее эффективен при использовании rsync для передачи больших файлов (несколько мегабайт и выше). В соответствии с природой rsync-передач передается обычный блок данных, затем если rsync определяет, что скорость выше установленного, то он вводит задержку перед посылкой следующего блока. В результате средняя скорость передачи равна указанному пределу. Нулевое значение означает отсутствие этого ограничения.

--write-batch=PREFIX

Генерирует набор файлов, которые могут быть переданы в пакетном обновлении. Каждое имя файла в наборе начинается с PREFIX. См. раздел "ПАКЕТНЫЙ РЕЖИМ" за деталями.

--read-batch=PREFIX

Применяет ранее сгенерированный пакет изменений, используя тот набор файлов, чьи имена начинаются с PREFIX. См. раздел "ПАКЕТНЫЙ РЕЖИМ" за деталями.