rsync - Online di Cloud

PROGRAM:

NAMA

rsync - alat penyalinan file yang cepat, serbaguna, jarak jauh (dan lokal)

RINGKASAN

Lokal: rsync [OPTION...] SRC... [DEST]

Akses melalui shell jarak jauh:
Tarik: rsync [OPTION...] [USER@]HOST:SRC... [DEST]
Tekan: rsync [OPTION...] SRC... [USER@]HOST:DEST

Akses melalui daemon rsync:
Tarik: rsync [OPTION...] [USER@]HOST::SRC... [DEST]
rsync [OPSI...] rsync://[USER@]HOST[:PORT]/SRC... [DEST]
Tekan: rsync [OPTION...] SRC... [USER@]HOST::DEST
rsync [PILIHAN...] SRC... rsync://[USER@]HOST[:PORT]/DEST

Penggunaan hanya dengan satu argumen SRC dan tanpa argumen DEST akan mencantumkan file sumber alih-alih
penyalinan.

DESKRIPSI

Rsync adalah alat penyalinan file yang cepat dan luar biasa serbaguna. Itu dapat menyalin secara lokal,
ke/dari Host lain melalui shell jarak jauh apa pun, atau ke/dari daemon rsync jarak jauh. Ini menawarkan
sejumlah besar opsi yang mengontrol setiap aspek perilakunya dan memungkinkan sangat fleksibel
spesifikasi kumpulan file yang akan disalin. Ini terkenal dengan transfer delta-nya
algoritma, yang mengurangi jumlah data yang dikirim melalui jaringan dengan hanya mengirimkan
perbedaan antara file sumber dan file yang ada di tujuan. Rsync adalah
banyak digunakan untuk pencadangan dan pencerminan dan sebagai perintah penyalinan yang ditingkatkan untuk penggunaan sehari-hari.

Rsync menemukan file yang perlu ditransfer menggunakan algoritme "pemeriksaan cepat" (secara default)
yang mencari file yang telah diubah ukurannya atau dalam waktu terakhir diubah. Setiap perubahan dalam
atribut yang diawetkan lainnya (seperti yang diminta oleh opsi) dibuat pada file tujuan
langsung ketika pemeriksaan cepat menunjukkan bahwa data file tidak perlu diperbarui.

Beberapa fitur tambahan rsync adalah:

o dukungan untuk menyalin tautan, perangkat, pemilik, grup, dan izin

o mengecualikan dan mengecualikan-dari opsi yang mirip dengan tar GNU

oa mode pengecualian CVS untuk mengabaikan file yang sama yang akan diabaikan CVS

o dapat menggunakan shell jarak jauh transparan, termasuk ssh atau rsh

o tidak memerlukan hak pengguna super

o pemipaan transfer file untuk meminimalkan biaya latensi

o dukungan untuk daemon rsync anonim atau terotentikasi (ideal untuk mirroring)

UMUM

Rsync menyalin file ke atau dari host jarak jauh, atau secara lokal di host saat ini (itu
tidak mendukung penyalinan file antara dua host jarak jauh).

Ada dua cara berbeda bagi rsync untuk menghubungi sistem jarak jauh: menggunakan shell jarak jauh
program sebagai transport (seperti ssh atau rsh) atau menghubungi daemon rsync secara langsung melalui
TCP. Transpor remote-shell digunakan setiap kali jalur sumber atau tujuan berisi:
pemisah titik dua (:) setelah spesifikasi host. Menghubungi daemon rsync
langsung terjadi ketika jalur sumber atau tujuan berisi titik dua ganda (::)
pemisah setelah spesifikasi host, ATAU ketika URL rsync:// ditentukan (lihat juga:
Bagian "MENGUNAKAN FITUR RSYNC-DAEMON VIA A REMOTE-SHELL CONNECTION" untuk pengecualian
aturan terakhir ini).

Sebagai kasus khusus, jika argumen sumber tunggal ditentukan tanpa tujuan, file
terdaftar dalam format output yang mirip dengan "ls -l".

Seperti yang diharapkan, jika jalur sumber atau tujuan tidak menentukan host jarak jauh, salinannya
terjadi secara lokal (lihat juga --daftar-saja pilihan).

Rsync mengacu pada sisi lokal sebagai "klien" dan sisi jarak jauh sebagai "server". jangan
membingungkan "server" dengan daemon rsync -- daemon selalu merupakan server, tetapi server dapat
baik daemon atau proses spawned shell jarak jauh.

SETUP

Lihat file README untuk petunjuk instalasi.

Setelah terinstal, Anda dapat menggunakan rsync ke mesin apa pun yang dapat Anda akses melalui shell jarak jauh
(serta beberapa yang dapat Anda akses menggunakan protokol mode daemon rsync). Untuk jarak jauh
transfer, rsync modern menggunakan ssh untuk komunikasinya, tetapi mungkin telah dikonfigurasi
untuk menggunakan shell jarak jauh yang berbeda secara default, seperti rsh atau remsh.

Anda juga dapat menentukan shell jarak jauh yang Anda suka, baik dengan menggunakan -e command line
pilihan, atau dengan mengatur variabel lingkungan RSYNC_RSH.

Perhatikan bahwa rsync harus diinstal pada mesin sumber dan tujuan.

PENGGUNAAN

Anda menggunakan rsync dengan cara yang sama seperti Anda menggunakan rcp. Anda harus menentukan sumber dan tujuan,
salah satunya mungkin jauh.

Mungkin cara terbaik untuk menjelaskan sintaks adalah dengan beberapa contoh:

rsync -t *.c foo:src/

Ini akan mentransfer semua file yang cocok dengan pola *.c dari direktori saat ini ke
direktori src pada mesin foo. Jika salah satu file sudah ada di sistem jarak jauh
kemudian protokol pembaruan jarak jauh rsync digunakan untuk memperbarui file dengan hanya mengirim
perbedaan datanya. Perhatikan bahwa perluasan wildcard pada baris perintah (*.c)
ke dalam daftar file ditangani oleh shell sebelum menjalankan rsync dan bukan oleh rsync itu sendiri
(persis sama dengan semua program gaya posix lainnya).

rsync -avz foo:src/bar /data/tmp

Ini akan secara rekursif mentransfer semua file dari direktori src/bar di mesin foo
ke direktori /data/tmp/bar pada mesin lokal. File ditransfer dalam
mode "arsip", yang memastikan bahwa tautan simbolik, perangkat, atribut, izin,
kepemilikan, dll. dipertahankan dalam transfer. Selain itu, kompresi akan digunakan untuk
mengurangi ukuran bagian data transfer.

rsync -avz foo:src/bar/ /data/tmp

Garis miring pada sumber mengubah perilaku ini untuk menghindari membuat tambahan
tingkat direktori di tujuan. Anda dapat menganggap trailing / pada sumber sebagai makna
"salin isi direktori ini" sebagai lawan dari "salin direktori dengan nama", tetapi dalam
kedua kasus atribut dari direktori yang berisi ditransfer ke yang berisi
direktori pada tujuan. Dengan kata lain, masing-masing perintah berikut menyalin
file dengan cara yang sama, termasuk pengaturan atribut /dest/foo:

rsync -av /src/foo /tujuan
rsync -av /src/foo/ /tujuan/foo

Perhatikan juga bahwa referensi host dan modul tidak memerlukan garis miring untuk menyalin
isi direktori default. Misalnya, keduanya menyalin direktori jarak jauh
isi ke "/ tujuan":

rsync -av host: /tujuan
rsync -av Host::module /tujuan

Anda juga dapat menggunakan rsync dalam mode lokal saja, di mana sumber dan tujuan tidak
memiliki ':' di namanya. Dalam hal ini berperilaku seperti perintah salin yang ditingkatkan.

Terakhir, Anda dapat membuat daftar semua modul (dapat didaftarkan) yang tersedia dari daemon rsync tertentu
dengan meninggalkan nama modul:

rsync somehost.domainku.com::

Lihat bagian berikut untuk lebih jelasnya.

ADVANCED PENGGUNAAN

Sintaks untuk meminta banyak file dari host jarak jauh dilakukan dengan menentukan
argumen host jarak jauh tambahan dengan gaya yang sama seperti yang pertama, atau dengan nama host dihilangkan.
Misalnya, semua ini berfungsi:

rsync -av Host:file1 :file2 Host:file{3,4} /tujuan/
rsync -av Host::modname/file{1,2} host::modname/file3 /dest/
rsync -av Host::modname/file1 ::modname/file{3,4}

Versi rsync yang lebih lama diperlukan menggunakan spasi yang dikutip di SRC, seperti contoh berikut:

rsync -av Host:'dir1/file1 dir2/file2' /tujuan
rsync host::'modname/dir1/file1 modname/dir2/file2' / tujuan

Pemisahan kata ini masih berfungsi (secara default) di rsync terbaru, tetapi tidak semudah
gunakan sebagai cara pertama.

Jika Anda perlu mentransfer nama file yang berisi spasi, Anda dapat menentukan
--melindungi-args (-s), atau Anda harus keluar dari spasi putih sedemikian rupa sehingga
shell jarak jauh akan mengerti. Contohnya:

rsync -av Host: 'file\ nama\ dengan\ spasi' / tujuan

HUBUNGAN UNTUK AN RSYNC DAEMON

Dimungkinkan juga untuk menggunakan rsync tanpa shell jarak jauh sebagai transport. Pada kasus ini
Anda akan langsung terhubung ke daemon rsync jarak jauh, biasanya menggunakan port TCP 873. (Ini
jelas membutuhkan daemon untuk dijalankan pada sistem jarak jauh, jadi lihat MULAI
AN RSYNC DAEMON UNTUK MENERIMA KONEKSI di bawah ini untuk informasi tentang itu.)

Menggunakan rsync dengan cara ini sama dengan menggunakannya dengan shell jarak jauh kecuali bahwa:

o Anda juga menggunakan titik dua ganda :: alih-alih titik dua tunggal untuk memisahkan nama host
dari jalur, atau Anda menggunakan URL rsync://.

o kata pertama dari "path" sebenarnya adalah nama modul.

o daemon jarak jauh dapat mencetak pesan hari ketika Anda terhubung.

o jika Anda tidak menentukan nama jalur pada daemon jarak jauh, maka daftar jalur yang dapat diakses
pada daemon akan ditampilkan.

o jika Anda tidak menentukan tujuan lokal maka daftar file yang ditentukan di
daemon jarak jauh disediakan.

o Anda tidak boleh menentukan --rsh (-e) pilihan.

Contoh yang menyalin semua file dalam modul jarak jauh bernama "src":

rsync -av host::src /tujuan

Beberapa modul pada daemon jarak jauh mungkin memerlukan autentikasi. Jika demikian, Anda akan menerima
permintaan kata sandi saat Anda terhubung. Anda dapat menghindari permintaan kata sandi dengan mengatur
variabel lingkungan RSYNC_PASSWORD ke kata sandi yang ingin Anda gunakan atau gunakan
--file kata sandi pilihan. Ini mungkin berguna saat membuat skrip rsync.

PERINGATAN: Pada beberapa variabel lingkungan sistem terlihat oleh semua pengguna. Pada sistem itu
menggunakan --file kata sandi direkomendasikan.

Anda dapat membuat koneksi melalui proxy web dengan mengatur variabel lingkungan
RSYNC_PROXY ke nama host: pasangan port yang menunjuk ke proxy web Anda. Perhatikan bahwa web Anda
konfigurasi proxy harus mendukung koneksi proxy ke port 873.

Anda juga dapat membuat koneksi daemon menggunakan program sebagai proxy dengan mengatur
variabel lingkungan RSYNC_CONNECT_PROG ke perintah yang ingin Anda jalankan sebagai pengganti pembuatan
koneksi soket langsung. String mungkin berisi escape "%H" untuk mewakili
nama host yang ditentukan dalam perintah rsync (jadi gunakan "%%" jika Anda memerlukan satu "%" di
rangkaian). Sebagai contoh:

ekspor RSYNC_CONNECT_PROG='ssh proxyhost nc %H 873'
rsync -av targethost1::modul/src/ /tujuan/
rsync -av rsync:://targethost2/modul/src/ /tujuan/

Perintah yang ditentukan di atas menggunakan ssh untuk menjalankan nc (netcat) pada proxyhost, yang meneruskan semua
data ke port 873 (daemon rsync) di host target (%H).

MENGGUNAKAN RSYNC-DAEMON FITUR VIA A RUANG JARAK JAUH KONEKSI

Terkadang berguna untuk menggunakan berbagai fitur daemon rsync (seperti modul bernama)
tanpa benar-benar mengizinkan koneksi soket baru apa pun ke dalam sistem (selain apa yang
sudah diperlukan untuk mengizinkan akses shell jarak jauh). Rsync mendukung koneksi ke host menggunakan
shell jarak jauh dan kemudian memunculkan server "daemon" sekali pakai yang mengharapkan untuk membacanya
config di direktori home dari pengguna jarak jauh. Ini bisa berguna jika Anda ingin mengenkripsi
data transfer gaya daemon, tetapi karena daemon dimulai baru dengan remote
pengguna, Anda mungkin tidak dapat menggunakan fitur seperti chroot atau mengubah uid yang digunakan oleh
daemon. (Untuk cara lain mengenkripsi transfer daemon, pertimbangkan untuk menggunakan ssh untuk melakukan tunnel a
port lokal ke mesin jarak jauh dan konfigurasikan daemon rsync normal pada host jarak jauh itu untuk
hanya izinkan koneksi dari "localhost".)

Dari sudut pandang pengguna, transfer daemon melalui koneksi remote-shell menggunakan hampir
sintaks baris perintah yang sama dengan transfer rsync-daemon normal, dengan satu-satunya pengecualian
karena Anda harus secara eksplisit mengatur program shell jarak jauh pada baris perintah dengan
--rsh=PERINTAH pilihan. (Mengatur RSYNC_RSH di lingkungan tidak akan mengaktifkan ini
fungsionalitas.) Misalnya:

rsync -av --rsh=ssh Host::module /dest

Jika Anda perlu menentukan pengguna shell jarak jauh yang berbeda, ingatlah bahwa awalan user@
di depan Host menentukan nilai rsync-user (untuk modul yang memerlukan
otentikasi berbasis pengguna). Ini berarti Anda harus memberikan opsi '-l user' ke ssh
saat menentukan shell jarak jauh, seperti dalam contoh ini yang menggunakan versi pendek dari
--rsh opsi:

rsync -av -e "ssh -l ssh-user" rsync-user@host::module /dest

"ssh-user" akan digunakan pada level ssh; "rsync-user" akan digunakan untuk masuk ke
"modul".

MULAI AN RSYNC DAEMON UNTUK MENERIMA SAMBUNGAN

Untuk terhubung ke daemon rsync, sistem jarak jauh harus sudah memiliki daemon
berjalan (atau perlu mengonfigurasi sesuatu seperti inetd untuk menelurkan daemon rsync untuk
koneksi masuk pada port tertentu). Untuk informasi lengkap tentang cara memulai daemon
yang akan menangani koneksi soket yang masuk, lihat rsyncd.conf(5) halaman manual -- yaitu
file konfigurasi untuk daemon, dan berisi detail lengkap tentang cara menjalankan daemon
(termasuk konfigurasi yang berdiri sendiri dan inetd).

Jika Anda menggunakan salah satu transport remote-shell untuk transfer, tidak perlu
memulai daemon rsync secara manual.

diurutkan TRANSFER PESANAN

Rsync selalu mengurutkan nama file yang ditentukan ke dalam daftar transfer internalnya. Ini menangani
Penggabungan isi direktori dengan nama yang sama, memudahkan untuk
menghapus nama file duplikat, dan dapat membingungkan seseorang saat file tersebut ditransfer dalam a
urutan yang berbeda dari apa yang diberikan pada baris perintah.

Jika Anda memerlukan file tertentu untuk ditransfer sebelum yang lain, pisahkan file
file ke panggilan rsync yang berbeda, atau pertimbangkan untuk menggunakan --delay-pembaruan (yang tidak mempengaruhi
urutan transfer yang diurutkan, tetapi membuat fase pembaruan file terakhir terjadi lebih banyak
dengan cepat).

CONTOH

Berikut adalah beberapa contoh bagaimana saya menggunakan rsync.

Untuk mencadangkan direktori home istri saya, yang terdiri dari file dan email MS Word yang besar
folder, saya menggunakan pekerjaan cron yang berjalan

rsync -Cavz . arvidsjaur:cadangan

setiap malam melalui koneksi PPP ke direktori duplikat di komputer saya "arvidsjaur".

Untuk menyinkronkan pohon sumber samba saya, saya menggunakan target Makefile berikut:

Dapatkan:
rsync -avuzb --exclude '*~' samba:samba/ .
taruh:
rsync -Cavuzb . samba: samba/
sinkronisasi: dapatkan put

ini memungkinkan saya untuk menyinkronkan dengan direktori CVS di ujung lain koneksi. saya kemudian melakukan
Operasi CVS pada mesin jarak jauh, yang menghemat banyak waktu sebagai protokol CVS jarak jauh
sangat tidak efisien.

Saya mencerminkan direktori antara situs ftp "lama" dan "baru" saya dengan perintah:

rsync -az -e ssh --delete ~ftp/pub/samba nimbus:"~ftp/pub/tridge"

Ini diluncurkan dari cron setiap beberapa jam.

PILIHAN RINGKASAN

Berikut adalah ringkasan singkat dari opsi yang tersedia di rsync. Silakan lihat detailnya
deskripsi di bawah ini untuk deskripsi lengkap.

-v, --verbose meningkatkan verbositas
--info=FLAGS verbositas informasi berbutir halus
--debug=FLAGS verbositas debug berbutir halus
--msgs2stderr penanganan keluaran khusus untuk debugging
-q, --quiet menekan pesan non-kesalahan
--no-motd menekan daemon-mode MOTD (lihat peringatan)
-c, --checksum lewati berdasarkan checksum, bukan waktu & ukuran mod
-a, --mode arsip arsip; sama dengan -rlptgoD (tidak ada -H,-A,-X)
--no-OPTION mematikan OPTION tersirat (misalnya --no-D)
-r, --recursive recurse ke dalam direktori
-R, --relative gunakan nama jalur relatif
--no-implied-dirs jangan mengirim direktori tersirat dengan --relative
-b, --backup membuat cadangan (lihat --suffix & --backup-dir)
--backup-dir=DIR membuat cadangan menjadi hierarki berdasarkan DIR
--suffix=SUFFIX cadangan sufiks (default ~ tanpa --backup-dir)
-u, --update lewati file yang lebih baru di receiver
--di tempat perbarui file tujuan di tempat
--tambahkan tambahkan data ke file yang lebih pendek
--append-verify --append dengan data lama di file checksum
-d, --dirs mentransfer direktori tanpa berulang
-l, --links salin symlink sebagai symlink
-L, --copy-links mengubah symlink menjadi file/dir referensi
--copy-unsafe-links hanya symlink "tidak aman" yang diubah
--safe-links mengabaikan symlink yang mengarah ke luar pohon
--munge-link symlink munge untuk membuatnya lebih aman
-k, --copy-dirlinks mengubah symlink menjadi dir menjadi dir referensi
-K, --keep-dirlinks memperlakukan dir symlink pada receiver sebagai dir
-H, --hard-links mempertahankan hard link
-p, --perms mempertahankan izin
-E, --executability menjaga executability
--chmod=CHMOD memengaruhi izin file dan/atau direktori
-A, --acls mempertahankan ACL (menyiratkan -p)
-X, --xattrs mempertahankan atribut yang diperluas
-o, --owner mempertahankan pemilik (khusus pengguna super)
-g, --grup melestarikan grup
--devices menyimpan file perangkat (khusus pengguna super)
--spesial menyimpan file khusus
-D sama dengan --devices --specials
-t, --times mempertahankan waktu modifikasi
-O, --omit-dir-times menghilangkan direktori dari --times
-J, --omit-link-times menghilangkan symlink dari --times
--penerima super mencoba aktivitas pengguna super
--fake-super store/pulihkan atribut istimewa menggunakan xattrs
-S, --sparse menangani file yang jarang secara efisien
--preallocate mengalokasikan file tujuan sebelum menulis
-n, --dry-run melakukan uji coba tanpa perubahan yang dilakukan
-W, --whole-file salin seluruh file (tanpa algoritme delta-xfer)
-x, --one-file-system tidak melewati batas filesystem
-B, --block-size=SIZE memaksa ukuran blok checksum tetap
-e, --rsh=COMMAND tentukan shell jarak jauh yang akan digunakan
--rsync-path=PROGRAM tentukan rsync untuk dijalankan di mesin jarak jauh
--ada melewatkan membuat file baru di penerima
--abaikan-abaikan yang ada lewati pembaruan file yang ada di penerima
--remove-source-files sender menghapus file yang disinkronkan (non-dir)
--del alias untuk --delete-selama
--delete menghapus file asing dari direktori tujuan
--delete-before penerima menghapus sebelum xfer, bukan selama
--delete-selama penerima menghapus selama transfer
--delete-delay temukan penghapusan selama, hapus setelah
--delete-after penerima menghapus setelah transfer, bukan selama
--delete-excluded juga menghapus file yang dikecualikan dari direktori tujuan
--ignore-missing-args mengabaikan argumen sumber yang hilang tanpa kesalahan
--delete-missing-args menghapus argumen sumber yang hilang dari tujuan
--ignore-errors hapus bahkan jika ada kesalahan I/O
--paksa penghapusan direktori meskipun tidak kosong
--max-delete=NUM jangan hapus lebih dari NUM file
--max-size=SIZE jangan transfer file yang lebih besar dari SIZE
--min-size=SIZE jangan transfer file yang lebih kecil dari SIZE
--sebagian menyimpan sebagian file yang ditransfer
--partial-dir=DIR masukkan sebagian file yang ditransfer ke DIR
--delay-updates menempatkan semua file yang diperbarui ke tempatnya di akhir
-m, --prune-empty-dirs Pangkas rantai direktori kosong dari daftar file
--numeric-id tidak memetakan nilai uid/gid berdasarkan nama pengguna/grup
--usermap=STRING pemetaan nama pengguna khusus
--groupmap=STRING pemetaan nama grup khusus
--chown=USER:GROUP nama pengguna sederhana/pemetaan nama grup
--timeout=SECONDS mengatur batas waktu I/O dalam hitungan detik
--contimeout=SECONDS mengatur batas waktu koneksi daemon dalam hitungan detik
-Saya, --ignore-times tidak melewatkan file yang sesuai dengan ukuran dan waktu
--size-only lewati file yang ukurannya cocok
--modify-window=NUM bandingkan waktu mod dengan akurasi yang berkurang
-T, --temp-dir=DIR buat file sementara di direktori DIR
-y, --fuzzy temukan file serupa untuk basis jika tidak ada file tujuan
--compare-dest=DIR juga membandingkan file yang diterima relatif terhadap DIR
--copy-dest=DIR ... dan sertakan salinan file yang tidak diubah
--link-dest=DIR hardlink ke file dalam DIR saat tidak diubah
-z, --kompres data file kompres selama transfer
--compress-level=NUM secara eksplisit mengatur level kompresi
--skip-compress=LIST lewati kompresi file dengan akhiran di LIST
-C, --cvs-exclude file abaikan otomatis dengan cara yang sama seperti CVS
-f, --filter=RULE tambahkan ATURAN pemfilteran file
-F sama dengan --filter='dir-merge /.rsync-filter'
diulang: --filter='- .rsync-filter'
--exclude=PATTERN mengecualikan file yang cocok dengan POLA
--exclude-from=FILE baca pola pengecualian dari FILE
--include=PATTERN jangan mengecualikan file yang cocok dengan POLA
--include-from=FILE baca sertakan pola dari FILE
--files-from=FILE membaca daftar nama file sumber dari FILE
-0, --from0 semua file *from/filter dipisahkan oleh 0s
-s, --protect-args tidak ada pemisahan ruang; karakter wildcard saja
--address=ADDRESS mengikat alamat soket keluar ke daemon
--port=PORT tentukan nomor port alternatif titik dua ganda
--sockopts=OPTIONS tentukan opsi TCP khusus
--blocking-io gunakan pemblokiran I/O untuk shell jarak jauh
--outbuf=N|L|B mengatur buffering ke None, Line, atau Block
--stats memberikan beberapa statistik transfer file
-8, -8-bit-output membiarkan karakter bit tinggi tidak lolos dalam output
-h, --nomor keluaran yang dapat dibaca manusia dalam format yang dapat dibaca manusia
--progres menunjukkan kemajuan selama transfer
-P sama dengan --partial --progress
-i, --itemize-changes menampilkan ringkasan perubahan untuk semua pembaruan
-M, --remote-option=OPTION kirim OPTION ke sisi jarak jauh saja
--out-format=FORMAT pembaruan keluaran menggunakan FORMAT yang ditentukan
--log-file=FILE mencatat apa yang kita lakukan pada FILE yang ditentukan
--log-file-format=Pembaruan log FMT menggunakan FMT yang ditentukan
--password-file=FILE membaca sandi akses daemon dari FILE
--list-only daftar file alih-alih menyalinnya
--bwlimit=RATE batas soket I/O bandwidth
--write-batch=FILE tulis pembaruan batch ke FILE
--only-write-batch=FILE seperti --write-batch tetapi tanpa memperbarui tujuan
--read-batch=FILE membaca pembaruan batch dari FILE
--protocol=NUM memaksa versi protokol yang lebih lama untuk digunakan
--iconv=CONVERT_SPEC meminta konversi charset dari nama file
--checksum-seed=NUM set blok/file checksum seed (lanjutan)
-4, --ipv4 lebih memilih IPv4
-6, --ipv6 lebih memilih IPv6
--versi nomor versi cetak
(-h) --help tunjukkan bantuan ini (lihat di bawah untuk -h komentar)

Rsync juga dapat dijalankan sebagai daemon, dalam hal ini opsi berikut diterima:

--daemon dijalankan sebagai daemon rsync
--address=ADDRESS mengikat ke alamat yang ditentukan
--bwlimit=RATE batas soket I/O bandwidth
--config=FILE tentukan file rsyncd.conf alternatif
-M, --dparam=OVERRIDE menimpa parameter konfigurasi daemon global
--no-detach jangan lepas dari induknya
--port=PORT dengarkan pada nomor port alternatif
--log-file=FILE menimpa pengaturan "file log"
--log-file-format=FMT menimpa pengaturan "format log"
--sockopts=OPTIONS tentukan opsi TCP khusus
-v, --verbose meningkatkan verbositas
-4, --ipv4 lebih memilih IPv4
-6, --ipv6 lebih memilih IPv6
-h, --help tampilkan bantuan ini (jika digunakan setelah --daemon)

PILIHAN

Rsync menerima opsi panjang (tanda hubung ganda + kata) dan pendek (tanda hubung tunggal + huruf).
Daftar lengkap opsi yang tersedia dijelaskan di bawah ini. Jika opsi dapat ditentukan
di lebih dari satu cara, pilihan dipisahkan dengan koma. Beberapa opsi hanya memiliki waktu yang lama
varian, tidak pendek. Jika opsi mengambil parameter, parameter hanya dicantumkan setelah
varian panjang, meskipun juga harus ditentukan untuk yang pendek. Saat menentukan
parameter, Anda dapat menggunakan formulir --option=param atau mengganti '=' dengan spasi.
Parameter mungkin perlu dikutip dalam beberapa cara agar dapat bertahan dari shell
penguraian baris perintah. Perlu diingat bahwa tilde utama (~) dalam nama file diganti
oleh Shell Anda, jadi --option=~/foo tidak akan mengubah tilde ke direktori home Anda
(hapus '=' untuk itu).

--membantu Cetak halaman bantuan singkat yang menjelaskan opsi yang tersedia di rsync dan keluar. Untuk
kompatibilitas mundur dengan versi rsync yang lebih lama, bantuan juga akan dikeluarkan
jika Anda menggunakan -h pilihan tanpa argumen lain.

--Versi: kapan
cetak nomor versi rsync dan keluar.

-di, --bertele-tele
Opsi ini meningkatkan jumlah informasi yang Anda berikan selama transfer.
Secara default, rsync bekerja tanpa suara. Tunggal -v akan memberi Anda informasi tentang apa
file sedang ditransfer dan ringkasan singkat di akhir. Dua -v pilihan akan
memberi Anda informasi tentang file apa yang dilewati dan sedikit lebih banyak informasi
pada akhirnya. Lebih dari dua -v opsi hanya boleh digunakan jika Anda sedang men-debug
rsync.

Dalam rsync modern, -v opsi ini setara dengan pengaturan grup --info
dan --debug pilihan. Anda dapat memilih untuk menggunakan opsi yang lebih baru ini selain, atau
di tempat menggunakan --bertele-tele, karena pengaturan terperinci apa pun mengesampingkan yang tersirat
pengaturan dari -v. Kedua --info dan --debug punya cara untuk meminta bantuan yang memberi tahu Anda
persis apa bendera yang ditetapkan untuk setiap peningkatan verbositas.

Namun, perlu diingat bahwa pengaturan "max verbositas" daemon akan membatasi caranya
tingkat tinggi berbagai bendera individu dapat diatur di sisi daemon. Untuk
misalnya, jika maks adalah 2, maka info dan/atau flag debug apa pun yang disetel ke yang lebih tinggi
nilai dari apa yang akan ditetapkan oleh -vv akan diturunkan ke -vv level dalam
pencatatan daemon.

--info=BENDERA
Opsi ini memungkinkan Anda memiliki kontrol halus atas keluaran informasi yang Anda inginkan
untuk melihat. Nama bendera individu dapat diikuti dengan nomor level, dengan arti 0
untuk membungkam output itu, 1 menjadi level output default, dan angka yang lebih tinggi
meningkatkan output dari flag itu (bagi mereka yang mendukung level yang lebih tinggi). Menggunakan
--info=bantuan untuk melihat semua nama bendera yang tersedia, apa yang mereka hasilkan, dan bendera apa
nama ditambahkan untuk setiap peningkatan level verbose. Beberapa contoh:

rsync -a --info=progress2 src/ tujuan/
rsync -avv --info=stats2,misc1,flist0 src/ tujuan/

Perhatikan bahwa --info=namakeluarannya dipengaruhi oleh --keluar-format dan
--itemize-perubahan (-i) pilihan. Lihat opsi tersebut untuk informasi lebih lanjut tentang apa itu
keluaran dan kapan.

Opsi ini ditambahkan ke 3.1.0, jadi rsync lama di sisi server mungkin menolak
upaya Anda pada kontrol halus (jika satu atau lebih bendera perlu dikirim ke
server dan server terlalu tua untuk memahaminya). Lihat juga "maks
verbositas" peringatan di atas ketika berhadapan dengan daemon.

--debug=BENDERA
Opsi ini memungkinkan Anda memiliki kontrol halus atas output debug yang Anda inginkan
Lihat. Nama bendera individu dapat diikuti dengan nomor level, dengan 0 artinya
senyapkan output itu, 1 sebagai level output default, dan angka yang lebih tinggi
meningkatkan output dari flag itu (bagi mereka yang mendukung level yang lebih tinggi). Menggunakan
--debug=bantuan untuk melihat semua nama bendera yang tersedia, apa yang mereka hasilkan, dan bendera apa
nama ditambahkan untuk setiap peningkatan level verbose. Beberapa contoh:

rsync -avvv --debug=none src/ tujuan/
rsync -avA --del --debug=del2,acl src/ tujuan/

Perhatikan bahwa beberapa pesan debug hanya akan ditampilkan ketika --pesan2stderr ditentukan,
terutama yang berkaitan dengan I/O dan buffer debugging.

Opsi ini ditambahkan ke 3.1.0, jadi rsync lama di sisi server mungkin menolak
upaya Anda pada kontrol halus (jika satu atau lebih bendera perlu dikirim ke
server dan server terlalu tua untuk memahaminya). Lihat juga "maks
verbositas" peringatan di atas ketika berhadapan dengan daemon.

--pesan2stderr
Opsi ini mengubah rsync untuk mengirim semua outputnya langsung ke stderr daripada ke
mengirim pesan ke sisi klien melalui protokol (yang biasanya mengeluarkan info
pesan melalui stdout). Ini terutama ditujukan untuk debugging untuk menghindari
mengubah data yang dikirim melalui protokol, karena data protokol tambahan dapat berubah
apa yang sedang diuji. Ingatlah bahwa koneksi daemon tidak memiliki stderr
saluran untuk mengirim pesan kembali ke sisi klien, jadi jika Anda melakukan apa pun
debugging daemon-transfer menggunakan opsi ini, Anda harus memulai daemon menggunakan
--tidak-melepaskan sehingga Anda dapat melihat output stderr di sisi daemon.

Opsi ini memiliki efek samping membuat keluaran stderr mendapatkan buffer baris sehingga
penggabungan output dari 3 program terjadi dengan cara yang lebih mudah dibaca.

-Q, --diam
Opsi ini mengurangi jumlah informasi yang Anda berikan selama transfer,
terutama menekan pesan informasi dari server jauh. Pilihan ini adalah
berguna saat menjalankan rsync dari cron.

--tidak-motd
Opsi ini mempengaruhi informasi yang dikeluarkan oleh klien pada awal a
pemindahan daemon. Ini menekan teks pesan hari ini (MOTD), tetapi juga
memengaruhi daftar modul yang dikirim daemon sebagai respons terhadap "rsync Host::"
permintaan (karena batasan dalam protokol rsync), jadi hilangkan opsi ini jika Anda
ingin meminta daftar modul dari daemon.

-SAYA, --abaikan-kali
Biasanya rsync akan melewatkan file apa pun yang sudah berukuran sama dan memiliki ukuran yang sama
stempel waktu modifikasi. Opsi ini mematikan perilaku "pemeriksaan cepat" ini, menyebabkan
semua file yang akan diperbarui.

--hanya ukuran
Ini memodifikasi algoritme "pemeriksaan cepat" rsync untuk menemukan file yang perlu
ditransfer, mengubahnya dari default mentransfer file dengan baik a
mengubah ukuran atau mengubah waktu terakhir diubah menjadi hanya mencari file yang memiliki
berubah ukurannya. Ini berguna ketika mulai menggunakan rsync setelah menggunakan yang lain
sistem pencerminan yang mungkin tidak mempertahankan stempel waktu dengan tepat.

--modifikasi-jendela
Saat membandingkan dua stempel waktu, rsync memperlakukan stempel waktu sebagai sama jika:
berbeda tidak lebih dari nilai jendela modifikasi. Ini biasanya 0 (tepatnya
cocok), tetapi Anda mungkin merasa berguna untuk mengatur ini ke nilai yang lebih besar di beberapa
situasi. Khususnya, saat mentransfer ke atau dari MS Windows FAT
sistem file (yang mewakili waktu dengan resolusi 2 detik), --modifikasi-jendela=1
berguna (memungkinkan waktu berbeda hingga 1 detik).

-C, --checksum
Ini mengubah cara rsync memeriksa apakah file telah diubah dan membutuhkan
transfer. Tanpa opsi ini, rsync menggunakan "pemeriksaan cepat" yang (secara default)
memeriksa apakah ukuran setiap file dan waktu modifikasi terakhir cocok antara pengirim
dan penerima. Opsi ini mengubah ini untuk membandingkan checksum 128-bit untuk setiap file
yang memiliki ukuran yang serasi. Menghasilkan checksum berarti bahwa kedua belah pihak akan
menghabiskan banyak disk I/O membaca semua data dalam file dalam transfer (dan
ini sebelum pembacaan apa pun yang akan dilakukan untuk mentransfer file yang diubah), jadi ini
dapat memperlambat segalanya secara signifikan.

Sisi pengirim menghasilkan checksumnya saat melakukan pemindaian sistem file
yang membangun daftar file yang tersedia. Penerima menghasilkan checksumnya
ketika memindai file yang diubah, dan akan memeriksa semua file yang memiliki file yang sama
size sebagai file pengirim yang sesuai: file dengan ukuran yang diubah atau a
checksum yang diubah dipilih untuk ditransfer.

Perhatikan bahwa rsync selalu memverifikasi bahwa setiap ditransfer file dengan benar
direkonstruksi di sisi penerima dengan memeriksa checksum seluruh file yaitu
dihasilkan saat file ditransfer, tetapi setelah transfer otomatis itu
verifikasi tidak ada hubungannya dengan opsi ini sebelum transfer "Apakah ini?
file perlu diperbarui?" periksa.

Untuk protokol 30 dan seterusnya (pertama didukung di 3.0.0), checksum yang digunakan adalah MD5.
Untuk protokol yang lebih lama, checksum yang digunakan adalah MD4.

-Sebuah, --Arsip
Ini setara dengan -rlptgoD. Ini adalah cara cepat untuk mengatakan Anda ingin rekursi dan
ingin melestarikan hampir semuanya (dengan -H menjadi kelalaian penting). Satu-satunya
Pengecualian untuk persamaan di atas adalah ketika --file-dari ditentukan, dalam hal ini
-r tidak tersirat.

Perhatikan bahwa -a tidak tidak memelihara tautan keras, karena menemukan file yang ditautkan banyak adalah
mahal. Anda harus menentukan secara terpisah -H.

--tidak ada pilihan
Anda dapat mematikan satu atau lebih opsi tersirat dengan mengawali nama opsi dengan
"tidak-". Tidak semua opsi dapat diawali dengan "tidak-": hanya opsi yang tersirat
oleh opsi lain (mis --anggukan, --tanpa izin) atau memiliki default yang berbeda di berbagai
keadaan (misalnya --tanpa-seluruh-file, --tidak-memblokir-io, --tidak-dir). Anda dapat menentukan
baik nama opsi pendek atau panjang setelah awalan "tidak-" (mis --juga bukan adalah
sama seperti --tidak ada kerabat).

Misalnya: jika Anda ingin menggunakan -a (--Arsip) tapi tidak mau -o (--pemilik), sebagai gantinya
mengubah -a ke -rlptgD, Anda dapat menentukan -a --tidak-tidak (Atau -a --tidak ada pemilik).

Urutan opsi itu penting: jika Anda menentukan --juga bukan -a, yang -r Option
akan berakhir dihidupkan, kebalikan dari -a --juga bukan. Perhatikan juga bahwa
efek samping dari --file-dari opsi BUKAN posisi, karena memengaruhi
keadaan default dari beberapa opsi dan sedikit mengubah arti dari -a (Lihat
--file-dari pilihan untuk lebih jelasnya).

-R, --rekursif
Ini memberitahu rsync untuk menyalin direktori secara rekursif. Lihat juga --dir (-d).

Dimulai dengan rsync 3.0.0, algoritma rekursif yang digunakan sekarang adalah pemindaian tambahan
yang menggunakan memori jauh lebih sedikit daripada sebelumnya dan memulai transfer setelah pemindaian
dari beberapa direktori pertama telah selesai. Pemindaian tambahan ini saja
mempengaruhi algoritma rekursi kami, dan tidak mengubah transfer non-rekursif. Dia
juga hanya mungkin jika kedua ujung transfer setidaknya versi 3.0.0.

Beberapa opsi memerlukan rsync untuk mengetahui daftar file lengkap, jadi opsi ini menonaktifkan
mode rekursi tambahan. Ini termasuk: --hapus-sebelumnya, --hapus-setelah,
--prune-kosong-dirs, dan --delay-pembaruan. Karena itu, mode hapus default
ketika Anda menentukan --menghapus sekarang --hapus-selama ketika kedua ujung koneksi
setidaknya 3.0.0 (gunakan -del or --hapus-selama untuk meminta penghapusan yang ditingkatkan ini
modus secara eksplisit). Lihat juga --hapus-tunda pilihan itu adalah pilihan yang lebih baik daripada
menggunakan --hapus-setelah.

Rekursi tambahan dapat dinonaktifkan menggunakan --no-inc-rekursif pilihan atau nya
singkat --no-ir alias.

-R, --relatif
Gunakan jalur relatif. Ini berarti bahwa nama path lengkap ditentukan pada perintah
baris dikirim ke server bukan hanya bagian terakhir dari nama file. Ini
sangat berguna ketika Anda ingin mengirim beberapa direktori berbeda di
waktu yang sama. Misalnya, jika Anda menggunakan perintah ini:

rsync -av /foo/bar/baz.c jarak jauh:/ tmp /

... ini akan membuat file bernama baz.c di / tmp / pada mesin jarak jauh. Jika sebaliknya
Anda dulu

rsync -avR /foo/bar/baz.c jarak jauh:/ tmp /

kemudian file bernama /tmp/foo/bar/baz.c akan dibuat pada mesin jarak jauh,
melestarikan jalur penuhnya. Elemen jalur ekstra ini disebut "tersirat
direktori" (yaitu direktori "foo" dan "foo/bar" dalam contoh di atas).

Dimulai dengan rsync 3.0.0, rsync selalu mengirimkan direktori tersirat ini sebagai nyata
direktori dalam daftar file, bahkan jika elemen path benar-benar sebuah symlink pada
sisi pengirim. Ini mencegah beberapa perilaku yang benar-benar tidak terduga saat menyalin yang lengkap
jalur file yang tidak Anda sadari memiliki symlink di jalurnya. Jika Anda menghendaki
duplikat symlink sisi server, sertakan symlink melalui jalurnya, dan
direktori referensi melalui jalur aslinya. Jika Anda berurusan dengan rsync lama di
sisi pengirim, Anda mungkin perlu menggunakan --no-direktori-tersirat .

Dimungkinkan juga untuk membatasi jumlah informasi jalur yang dikirim secara tersirat
direktori untuk setiap jalur yang Anda tentukan. Dengan rsync modern di sisi pengiriman
(dimulai dengan 2.6.7), Anda dapat memasukkan titik dan garis miring ke jalur sumber, seperti
ini:

rsync -avR /foo/./bar/baz.c jarak jauh:/ tmp /

Itu akan membuat /tmp/bar/baz.c pada mesin jarak jauh. (Perhatikan bahwa titiknya harus
diikuti dengan garis miring, jadi "/ foo/." tidak akan disingkat.) Untuk rsync yang lebih lama
versi, Anda perlu menggunakan chdir untuk membatasi jalur sumber. Sebagai contoh,
saat mendorong file:

(cd /foo; rsync -avR bar/baz.c jarak jauh:/ tmp /)

(Perhatikan bahwa parens menempatkan dua perintah ke dalam sub-kulit, sehingga "cd"
perintah tidak tetap berlaku untuk perintah di masa mendatang.) Jika Anda menarik file
dari rsync yang lebih lama, gunakan idiom ini (tetapi hanya untuk transfer non-daemon):

rsync -avR --rsync-path="cd /foo; rsync" \
jarak jauh: bar/baz.c / tmp /

--no-direktori-tersirat
Opsi ini memengaruhi perilaku default dari --relatif pilihan. kapan?
ditentukan, atribut direktori tersirat dari nama sumber tidak
termasuk dalam pemindahan. Ini berarti bahwa elemen jalur yang sesuai pada
sistem tujuan dibiarkan tidak berubah jika ada, dan semua yang hilang tersirat
direktori dibuat dengan atribut default. Ini bahkan memungkinkan ini tersirat
elemen jalur memiliki perbedaan besar, seperti menjadi symlink ke direktori di
pihak penerima.

Misalnya, jika argumen baris perintah atau entri file-dari menyuruh rsync untuk mentransfer
file "path/foo/file", direktori "path" dan "path/foo" tersirat ketika
--relatif digunakan. Jika "path/foo" adalah symlink ke "bar" pada sistem tujuan,
rsync penerima biasanya akan menghapus "path/foo", membuatnya kembali sebagai direktori,
dan menerima file ke direktori baru. Dengan --no-direktori-tersirat, penerima
rsync memperbarui "path/foo/file" menggunakan elemen jalur yang ada, yang berarti
file akhirnya dibuat di "path/bar". Cara lain untuk mencapai tautan ini
pelestarian adalah dengan menggunakan --simpan-dirlink opsi (yang juga akan memengaruhi symlink
ke direktori di sisa transfer).

Saat menarik file dari rsync yang lebih lama dari 3.0.0, Anda mungkin perlu menggunakan opsi ini
jika sisi pengirim memiliki symlink di jalur yang Anda minta dan Anda menginginkan yang tersirat
direktori yang akan ditransfer sebagai direktori normal.

-B, --cadangan
Dengan opsi ini, file tujuan yang sudah ada akan diganti namanya karena setiap file adalah
ditransfer atau dihapus. Anda dapat mengontrol ke mana perginya file cadangan dan apa (jika
any) sufiks ditambahkan menggunakan --cadangan-dir dan --akhiran Pilihan.

Perhatikan bahwa jika Anda tidak menentukan --cadangan-dir, (1) file --menghilangkan-dir-kali pilihan akan
tersirat, dan (2) jika --menghapus juga berlaku (tanpa --hapus-dikecualikan),
rsync akan menambahkan aturan filter "lindungi" untuk sufiks cadangan di akhir semua . Anda
pengecualian yang ada (mis -f "P *~"). Ini akan mencegah file yang sebelumnya dicadangkan
dari dihapus. Perhatikan bahwa jika Anda menyediakan aturan filter Anda sendiri, Anda dapat
perlu memasukkan aturan pengecualian/perlindungan Anda sendiri secara manual di suatu tempat yang lebih tinggi di
daftar sehingga memiliki prioritas yang cukup tinggi untuk menjadi efektif (misalnya, jika aturan Anda
tentukan inklusi/pengecualian tambahan dari '*', aturan yang ditambahkan secara otomatis tidak akan pernah
tercapai).

--cadangan-dir=DIR
Dalam kombinasi dengan --cadangan opsi, ini memberitahu rsync untuk menyimpan semua cadangan di
direktori yang ditentukan di sisi penerima. Ini dapat digunakan untuk incremental
cadangan. Anda juga dapat menentukan sufiks cadangan menggunakan --akhiran Option
(jika tidak, file yang dicadangkan di direktori yang ditentukan akan tetap asli
nama file).

Perhatikan bahwa jika Anda menentukan jalur relatif, direktori cadangan akan relatif terhadap
direktori tujuan, jadi Anda mungkin ingin menentukan jalur absolut
atau jalur yang dimulai dengan "../". Jika daemon rsync adalah penerima, cadangannya
dir tidak dapat keluar dari hierarki jalur modul, jadi berhati-hatilah untuk tidak menghapus
atau menyalin ke dalamnya.

--akhiran=akhiran
Opsi ini memungkinkan Anda untuk mengganti sufiks cadangan default yang digunakan dengan --cadangan
(-b) pilihan. Sufiks default adalah ~ jika tidak ada --cadangan-dir ditentukan, jika tidak
itu adalah string kosong.

-kamu, --memperbarui
Ini memaksa rsync untuk melewatkan file apa pun yang ada di tujuan dan memiliki
waktu modifikasi yang lebih baru dari file sumber. (Jika file tujuan yang ada
memiliki waktu modifikasi yang sama dengan file sumber, itu akan diperbarui jika ukurannya
berbeda.)

Perhatikan bahwa ini tidak mempengaruhi penyalinan dir, symlink, atau spesial lainnya
file. Juga, perbedaan format file antara pengirim dan penerima selalu
dianggap cukup penting untuk pembaruan, tidak peduli tanggal berapa di
objek. Dengan kata lain, jika sumber memiliki direktori di mana tujuan memiliki
file, transfer akan terjadi terlepas dari cap waktu.

Opsi ini adalah aturan transfer, bukan pengecualian, sehingga tidak memengaruhi data yang
masuk ke daftar file, dan karenanya tidak memengaruhi penghapusan. Itu hanya membatasi
file yang diminta penerima untuk ditransfer.

--di tempat
Opsi ini mengubah cara rsync mentransfer file saat datanya perlu diperbarui:
alih-alih metode default untuk membuat salinan file baru dan memindahkannya ke
tempat ketika selesai, rsync malah menulis data yang diperbarui langsung ke
berkas tujuan.

Ini memiliki beberapa efek:

o Tautan keras tidak rusak. Ini berarti data baru akan terlihat melalui
tautan keras lainnya ke file tujuan. Selain itu, upaya untuk menyalin
file sumber yang berbeda ke file tujuan multi-linked akan menghasilkan
dalam "tarik tarik tambang" dengan data tujuan yang bolak-balik.

o Binari yang sedang digunakan tidak dapat diperbarui (baik OS akan mencegahnya dari
terjadi, atau binari yang mencoba menukar data mereka akan berperilaku tidak semestinya atau
jatuh).

o Data file akan berada dalam keadaan tidak konsisten selama transfer dan
akan dibiarkan seperti itu jika transfer terputus atau jika pembaruan gagal.

o File yang tidak dapat ditulis oleh rsync tidak dapat diperbarui. Sementara pengguna super bisa
perbarui file apa pun, pengguna biasa perlu diberikan izin menulis untuk
buka file agar penulisan berhasil.

o Efisiensi algoritme transfer delta rsync dapat dikurangi jika beberapa:
data dalam file tujuan ditimpa sebelum dapat disalin ke a
posisi nanti di file. Ini tidak berlaku jika Anda menggunakan --cadangan, sejak
rsync cukup pintar untuk menggunakan file cadangan sebagai file dasar untuk
transfer.

PERINGATAN: Anda tidak boleh menggunakan opsi ini untuk memperbarui file yang sedang diakses oleh
orang lain, jadi berhati-hatilah saat memilih untuk menggunakan ini untuk salinan.

Opsi ini berguna untuk mentransfer file besar dengan perubahan berbasis blok atau
data yang ditambahkan, dan juga pada sistem yang terikat disk, bukan terikat jaringan. Bisa
juga membantu menjaga snapshot sistem file copy-on-write agar tidak menyimpang secara keseluruhan
isi file yang hanya memiliki sedikit perubahan.

Pilihan menyiratkan --sebagian (karena transfer yang terputus tidak menghapus
file), tetapi bertentangan dengan --partial-dir dan --delay-pembaruan. Sebelum rsync 2.6.4
--di tempat juga tidak sesuai dengan --bandingkan-tujuan dan --link-tujuan.

--menambahkan
Ini menyebabkan rsync memperbarui file dengan menambahkan data ke akhir file,
yang menganggap bahwa data yang sudah ada di sisi penerima identik
dengan awal file di sisi pengirim. Jika file perlu ditransfer
dan ukurannya di penerima sama atau lebih panjang dari ukuran di pengirim,
file dilewati. Ini tidak mengganggu pembaruan non-konten file
atribut (misalnya izin, kepemilikan, dll.) ketika file tidak perlu
ditransfer, juga tidak mempengaruhi pembaruan file non-reguler. menyiratkan
--di tempat, tetapi tidak bertentangan dengan --jarang (karena selalu memanjang a
panjang file).

--tambahkan-verifikasi
Ini bekerja seperti --menambahkan pilihan, tetapi data yang ada pada penerima
sisi disertakan dalam langkah verifikasi checksum file lengkap, yang akan menyebabkan a
file yang akan dikirim ulang jika langkah verifikasi terakhir gagal (rsync menggunakan normal,
tidak menambahkan --di tempat transfer untuk mengirim ulang).

Catatan: sebelum rsync 3.0.0, --menambahkan opsi berfungsi seperti --tambahkan-verifikasi, jadi jika
Anda berinteraksi dengan rsync yang lebih lama (atau transfer menggunakan protokol sebelumnya
hingga 30), menentukan salah satu opsi penambahan akan memulai dan --tambahkan-verifikasi transfer.

-D, --dir
Beri tahu pihak pengirim untuk memasukkan direktori apa pun yang ditemui. Tidak seperti
--rekursif, isi direktori tidak akan disalin kecuali nama direktori
ditentukan adalah "." atau diakhiri dengan garis miring (misalnya ".", "dir/.", "dir/", dll.).
Tanpa opsi ini atau --rekursif opsi, rsync akan melewati semua direktori itu
pertemuan (dan output pesan ke efek itu untuk masing-masing). Jika Anda menentukan keduanya
--dir dan --rekursif, --rekursif diutamakan.

--dir pilihan tersirat oleh --file-dari pilihan atau --daftar-saja Option
(termasuk tersirat --daftar-saja penggunaan) jika --rekursif tidak ditentukan (sehingga
direktori terlihat dalam daftar). Menentukan --tidak-dir (Atau --anggukan) jika Anda menghendaki
matikan ini.

Ada juga opsi pembantu kompatibilitas mundur, --dir-lama (Atau --lama-d) itu
memberitahu rsync untuk menggunakan hack "-r --exclude='/*/*'" untuk mendapatkan rsync yang lebih lama ke daftar a
direktori tunggal tanpa berulang.

-aku, --link
Saat symlink ditemukan, buat ulang symlink di tujuan.

-L, --salin-tautan
Ketika symlink ditemukan, item yang mereka tunjuk (referensi) adalah
disalin, bukan symlink. Di versi rsync yang lebih lama, opsi ini juga memiliki
efek samping dari memberi tahu pihak penerima untuk mengikuti symlink, seperti symlink
ke direktori. Dalam rsync modern seperti ini, Anda harus menentukan
--simpan-dirlink (-K) untuk mendapatkan perilaku ekstra ini. Satu-satunya pengecualian adalah ketika
mengirim file ke rsync yang terlalu tua untuk dipahami -K -- dalam hal ini, -L
opsi masih akan memiliki efek samping dari -K pada rsync penerima yang lebih lama itu.

--salin-tautan-tidak aman
Ini memberitahu rsync untuk menyalin referensi tautan simbolik yang mengarah ke luar
pohon yang disalin. Symlink absolut juga diperlakukan seperti file biasa, dan begitu juga
symlink apa pun di jalur sumber itu sendiri ketika --relatif digunakan. Opsi ini tidak memiliki
efek tambahan jika --salin-tautan juga ditentukan.

--tautan-aman
Ini memberitahu rsync untuk mengabaikan tautan simbolis apa pun yang mengarah ke luar pohon yang disalin.
Semua symlink absolut juga diabaikan. Menggunakan opsi ini bersama dengan
--relatif dapat memberikan hasil yang tidak terduga.

--munge-link
Opsi ini memberitahu rsync untuk (1) memodifikasi semua symlink di sisi penerima dengan cara
yang membuatnya tidak dapat digunakan tetapi dapat dipulihkan (lihat di bawah), atau (2) untuk menghapus symlink di
sisi pengirim yang telah disimpan dalam keadaan mati. Ini berguna jika Anda
jangan terlalu percaya pada sumber data untuk tidak mencoba menyelipkan symlink ke a
tempat yang tidak terduga.

Cara rsync menonaktifkan penggunaan symlink adalah dengan mengawali masing-masing dengan string
"/rsyncd-munged/". Ini mencegah tautan digunakan selama itu
direktori tidak ada. Ketika opsi ini diaktifkan, rsync akan menolak untuk dijalankan jika
jalur itu adalah direktori atau symlink ke direktori.

Opsi ini hanya memengaruhi sisi klien dari transfer, jadi jika Anda membutuhkannya
mempengaruhi server, tentukan melalui --pilihan jarak jauh. (Perhatikan bahwa dalam transfer lokal,
sisi klien adalah pengirim.)

Opsi ini tidak berpengaruh pada daemon, karena daemon mengonfigurasi apakah ia mau
munged symlink melalui parameter "munge symlinks". Lihat juga "munge-symlink"
skrip perl di direktori dukungan kode sumber.

-k, --salin-dirlink
Opsi ini menyebabkan pihak pengirim memperlakukan symlink ke direktori seolah-olah
adalah direktori nyata. Ini berguna jika Anda tidak ingin symlink
non-direktori yang akan terpengaruh, karena mereka akan menggunakan --salin-tautan.

Tanpa opsi ini, jika sisi pengirim telah mengganti direktori dengan symlink ke
direktori, pihak penerima akan menghapus apa pun yang menghalangi yang baru
symlink, termasuk hierarki direktori (selama --memaksa or --menghapus dalam
efek).

Lihat juga --simpan-dirlink untuk opsi analog untuk sisi penerima.

--salin-dirlink berlaku untuk semua symlink ke direktori di sumber. jika kamu mau
untuk mengikuti hanya beberapa symlink yang ditentukan, trik yang dapat Anda gunakan adalah meneruskannya sebagai
argumen sumber tambahan dengan garis miring, menggunakan --relatif untuk membuat jalan
cocok benar. Sebagai contoh:

rsync -r --src relatif/./ src/./ikuti-saya/ tujuan/

Ini berfungsi karena panggilan rsync status(2) pada argumen sumber seperti yang diberikan, dan
trailing slash membuat status(2) ikuti symlink, memunculkan direktori di
file-list yang menggantikan symlink yang ditemukan selama pemindaian "src/./".

-K, --simpan-dirlink
Opsi ini menyebabkan pihak penerima memperlakukan symlink ke direktori seolah-olah
itu adalah direktori nyata, tetapi hanya jika itu cocok dengan direktori nyata dari pengirim.
Tanpa opsi ini, symlink penerima akan dihapus dan diganti dengan a
direktori nyata.

Misalnya, Anda mentransfer direktori "foo" yang berisi file "file",
tapi "foo" adalah symlink ke direktori "bar" di receiver. Tanpa
--simpan-dirlink, penerima menghapus symlink "foo", membuatnya kembali sebagai direktori,
dan menerima file ke direktori baru. Dengan --simpan-dirlink, penerima
menjaga symlink dan "file" berakhir di "bar".

Satu catatan peringatan: jika Anda menggunakan --simpan-dirlink, Anda harus mempercayai semua symlink
dalam salinan! Jika mungkin bagi pengguna yang tidak dipercaya untuk membuat symlink mereka sendiri
ke direktori mana pun, pengguna kemudian dapat (pada salinan berikutnya) mengganti symlink
dengan direktori nyata dan memengaruhi konten direktori apa pun symlink
referensi. Untuk salinan cadangan, Anda lebih baik menggunakan sesuatu seperti bind
mount alih-alih symlink untuk mengubah hierarki penerimaan Anda.

Lihat juga --salin-dirlink untuk opsi analog untuk sisi pengirim.

-H, --hard-link
Ini memberi tahu rsync untuk mencari file yang ditautkan keras di sumber dan menautkannya
file yang sesuai di tujuan. Tanpa opsi ini, file hard-linked di
sumber diperlakukan seolah-olah mereka adalah file yang terpisah.

Opsi ini TIDAK serta merta memastikan bahwa pola tautan keras pada
tujuan sama persis dengan yang ada di sumbernya. Kasus di mana tujuan mungkin
berakhir dengan tautan ekstra keras termasuk yang berikut:

o Jika tujuan berisi tautan keras yang tidak relevan (lebih banyak tautan daripada yang ada
ada dalam daftar file sumber), algoritme penyalinan tidak akan merusaknya
secara eksplisit. Namun, jika satu atau lebih jalur memiliki perbedaan konten,
proses pembaruan file normal akan memutus tautan tambahan tersebut (kecuali jika Anda
menggunakan --di tempat pilihan).

o Jika Anda menentukan --link-tujuan direktori yang berisi tautan keras, tautannya
dari file tujuan terhadap --link-tujuan file dapat menyebabkan beberapa jalur
di tempat tujuan menjadi terhubung bersama karena --link-tujuan
asosiasi.

Perhatikan bahwa rsync hanya dapat mendeteksi tautan keras antara file yang ada di dalam
transfer set. Jika rsync memperbarui file yang memiliki koneksi hard-link ekstra ke
file di luar transfer, tautan itu akan terputus. Jika Anda tergoda untuk menggunakan
itu --di tempat pilihan untuk menghindari kerusakan ini, berhati-hatilah agar Anda tahu bagaimana Anda
file sedang diperbarui sehingga Anda yakin bahwa tidak ada perubahan yang tidak diinginkan terjadi
karena tautan keras yang tersisa (dan lihat --di tempat opsi untuk lebih banyak peringatan).

Jika rekursi tambahan aktif (lihat --rekursif), rsync dapat mentransfer yang hilang
file tertaut keras sebelum menemukan bahwa tautan lain untuk konten itu ada
di tempat lain dalam hierarki. Ini tidak mempengaruhi keakuratan transfer
(yaitu file mana yang ditautkan bersama), hanya efisiensinya (yaitu menyalin
data untuk salinan awal baru dari file hard-linked yang bisa ditemukan nanti
dalam transfer di anggota lain dari kumpulan file yang ditautkan). Salah satu cara untuk
menghindari inefisiensi ini adalah dengan menonaktifkan rekursi tambahan menggunakan
--no-inc-rekursif .

-P, --perm
Opsi ini menyebabkan rsync penerima mengatur izin tujuan menjadi
sama dengan izin sumber. (Lihat juga --chmod opsi untuk cara memodifikasi
apa yang rsync anggap sebagai izin sumber.)

Ketika opsi ini adalah lepas, izin ditetapkan sebagai berikut:

o File yang ada (termasuk file yang diperbarui) mempertahankan izin yang ada,
meskipun --eksekusibilitas opsi mungkin hanya mengubah izin eksekusi
untuk file tersebut.

o File baru mendapatkan bit izin "normal" yang disetel ke file sumber
izin ditutupi dengan izin default direktori penerima
(baik umask proses penerimaan, atau izin yang ditentukan melalui
ACL default direktori tujuan), dan bit izin khusus mereka
dinonaktifkan kecuali dalam kasus di mana direktori baru mewarisi bit setgid dari
direktori induknya.

Jadi, ketika --perm dan --eksekusibilitas keduanya dinonaktifkan, perilaku rsync adalah
sama seperti utilitas penyalinan file lainnya, seperti cp(1) dan ter(1).

Singkatnya: untuk memberikan file tujuan (lama dan baru) izin sumber,
menggunakan --perm. Untuk memberikan file baru izin tujuan-default (sambil meninggalkan
file yang ada tidak berubah), pastikan bahwa --perm opsi mati dan gunakan
--chmod=ugo=rwX (yang memastikan bahwa semua bit non-masker diaktifkan). Jika kamu mau
peduli untuk membuat perilaku yang terakhir ini lebih mudah untuk diketik, Anda dapat menentukan alias popt untuk
itu, seperti meletakkan baris ini di file ~/.popt (berikut ini mendefinisikan -Z
opsi, dan menyertakan --no-g untuk menggunakan grup default direktori tujuan):

rsync alias -Z --no-p --no-g --chmod=ugo=rwX

Anda kemudian dapat menggunakan opsi baru ini dalam perintah seperti ini:

rsync -avZ src/ tujuan/

(Peringatan: pastikan bahwa -a tidak mengikuti -Z, atau itu akan mengaktifkan kembali keduanya
Opsi "--no-*" yang disebutkan di atas.)

Pelestarian bit setgid tujuan pada direktori yang baru dibuat ketika
--perm tidak aktif ditambahkan di rsync 2.6.7. Versi rsync yang lebih lama secara keliru
mempertahankan tiga bit izin khusus untuk file yang baru dibuat ketika --perm
dimatikan, saat mengganti pengaturan bit setgid tujuan pada yang baru dibuat
direktori. Ketaatan ACL default telah ditambahkan ke patch ACL untuk rsync 2.6.7, jadi
rsync yang lebih lama (atau non-ACL-enabled) menggunakan umask bahkan jika ACL default ada.
(Perlu diingat bahwa versi penerima rsync yang memengaruhi ini
perilaku.)

-E, --eksekusibilitas
Opsi ini menyebabkan rsync mempertahankan executability (atau non-executability) dari
file biasa ketika --perm tidak diaktifkan. File biasa dianggap sebagai
dapat dieksekusi jika setidaknya satu 'x' diaktifkan dalam izinnya. Ketika yang ada
executability file tujuan berbeda dari sumber yang sesuai
file, rsync memodifikasi izin file tujuan sebagai berikut:

o Untuk membuat file tidak dapat dieksekusi, rsync menonaktifkan semua izin 'x'.

o Untuk membuat file dapat dieksekusi, rsync mengaktifkan setiap izin 'x' yang memiliki
izin 'r' yang sesuai diaktifkan.

If --perm diaktifkan, opsi ini diabaikan.

-SEBUAH, --acls
Opsi ini menyebabkan rsync memperbarui ACL tujuan menjadi sama dengan
sumber ACL. Opsi ini juga menyiratkan --perm.

Sistem sumber dan tujuan harus memiliki entri ACL yang kompatibel untuk opsi ini
untuk bekerja dengan benar. Lihat --palsu-super opsi untuk cara mencadangkan dan memulihkan ACL
yang tidak kompatibel.

-X, --xattrs
Opsi ini menyebabkan rsync memperbarui atribut tujuan yang diperluas menjadi
sama dengan sumbernya.

Untuk sistem yang mendukung ruang nama atribut yang diperluas, penyalinan dilakukan oleh a
super-user menyalin semua ruang nama kecuali system.*. Pengguna biasa hanya menyalin
pengguna.* ruang nama. Untuk dapat mencadangkan dan memulihkan ruang nama non-pengguna seperti biasa
pengguna, lihat --palsu-super .

Perhatikan bahwa opsi ini tidak menyalin nilai xattr khusus rsyncs (mis. yang digunakan oleh
--palsu-super) kecuali jika Anda mengulangi opsi tersebut (misalnya -XX). Mode "salin semua xattrs" ini
tidak dapat digunakan dengan --palsu-super.

--chmod
Opsi ini memberitahu rsync untuk menerapkan satu atau lebih mode "chmod" yang dipisahkan koma ke
izin dari file dalam transfer. Nilai yang dihasilkan diperlakukan seolah-olah
itu adalah izin yang diberikan pihak pengirim untuk file tersebut, yang berarti
bahwa opsi ini tampaknya tidak berpengaruh pada file yang ada jika --perm tidak
diaktifkan.

Selain aturan penguraian normal yang ditentukan dalam chmod(1) halaman manual, Anda bisa
tentukan item yang seharusnya hanya berlaku untuk direktori dengan mengawalinya dengan 'D',
atau tentukan item yang seharusnya hanya berlaku untuk file dengan mengawalinya dengan 'F'.
Misalnya, berikut ini akan memastikan bahwa semua direktori ditandai set-gid,
bahwa tidak ada file yang dapat ditulis oleh orang lain, bahwa keduanya dapat ditulis oleh pengguna dan dapat ditulis oleh grup,
dan keduanya memiliki executability yang konsisten di semua bit:

--chmod=Dg+s,ug+w,Fo-w,+X

Menggunakan nomor mode oktal juga diperbolehkan:

--chmod=D2775,F664

Ini juga legal untuk menentukan kelipatan --chmod opsi, karena setiap opsi tambahan adalah
baru saja ditambahkan ke daftar perubahan yang harus dilakukan.

Lihat --perm dan --eksekusibilitas opsi untuk bagaimana nilai izin yang dihasilkan
dapat diterapkan ke file dalam transfer.

-Hai, --pemilik
Opsi ini menyebabkan rsync mengatur pemilik file tujuan menjadi sama dengan
file sumber, tetapi hanya jika rsync penerima dijalankan sebagai pengguna super
(lihat juga --super dan --palsu-super pilihan). Tanpa opsi ini, pemilik
file baru dan/atau yang ditransfer diatur ke pengguna yang memanggil di sisi penerima.

Pelestarian kepemilikan akan mengaitkan nama yang cocok secara default, tetapi mungkin
kembali menggunakan nomor ID dalam beberapa keadaan (lihat juga --numeric-id
pilihan untuk diskusi penuh).

-G, --kelompok
Opsi ini menyebabkan rsync mengatur grup file tujuan menjadi sama dengan
file sumber. Jika program penerima tidak berjalan sebagai pengguna super (atau jika
--tidak-super ditentukan), hanya grup yang memanggil pengguna di sisi penerima
adalah anggota akan dipertahankan. Tanpa opsi ini, grup diatur ke
grup default dari pengguna yang memanggil di sisi penerima.

Pelestarian informasi grup akan mengaitkan nama yang cocok secara default, tetapi
mungkin kembali menggunakan nomor ID dalam beberapa keadaan (lihat juga:
--numeric-id pilihan untuk diskusi penuh).

--perangkat
Opsi ini menyebabkan rsync mentransfer karakter dan memblokir file perangkat ke remote
sistem untuk membuat ulang perangkat ini. Opsi ini tidak berpengaruh jika penerima rsync
tidak dijalankan sebagai pengguna super (lihat juga --super dan --palsu-super pilihan).

--khusus
Opsi ini menyebabkan rsync mentransfer file khusus seperti soket bernama dan fifos.

-D -D pilihan setara dengan --perangkat --khusus.

-T, --waktu
Ini memberitahu rsync untuk mentransfer waktu modifikasi bersama dengan file dan memperbarui
mereka pada sistem jarak jauh. Perhatikan bahwa jika opsi ini tidak digunakan, pengoptimalan
yang mengecualikan file yang belum dimodifikasi tidak dapat efektif; di lain
kata-kata, rindu -t or -a akan menyebabkan transfer berikutnya berperilaku seolah-olah digunakan -I,
menyebabkan semua file diperbarui (meskipun algoritme transfer delta rsync akan membuat
pembaruan cukup efisien jika file belum benar-benar berubah, Anda banyak
lebih baik menggunakan -t).

-HAI, --menghilangkan-dir-kali
Ini memberitahu rsync untuk menghilangkan direktori ketika mempertahankan waktu modifikasi (lihat
--waktu). Jika NFS membagikan direktori di sisi penerima, itu bagus
ide untuk digunakan -O. Opsi ini disimpulkan jika Anda menggunakan --cadangan tanpa --cadangan-dir.

Opsi ini juga memiliki efek samping untuk menghindari pembuatan direktori awal di
salinan rekursi tambahan. Standarnya --inc-rekursif menyalin biasanya tidak
buat pass awal dari semua sub-direktori di direktori induk untuk itu
untuk dapat segera mengatur waktu modifikasi direktori induk (tanpa
harus menunda itu sampai sekelompok penyalinan rekursif selesai). Ini
idiom pembuatan awal tidak diperlukan jika waktu modifikasi direktori tidak dilakukan
dipertahankan, sehingga dilewati. Karena direktori pembuatan awal tidak memiliki akurasi
mode, mtime, atau kepemilikan, penggunaan opsi ini dapat membantu ketika seseorang ingin
hindari direktori yang sudah selesai sebagian ini.

-J, --hilangkan-tautan-kali
Ini memberitahu rsync untuk menghilangkan symlink saat mempertahankan waktu modifikasi (lihat
--waktu).

--super
Ini memberitahu pihak penerima untuk mencoba aktivitas pengguna super bahkan jika
menerima rsync tidak dijalankan oleh pengguna super. Kegiatan tersebut antara lain: melestarikan
pengguna melalui --pemilik opsi, mempertahankan semua grup (bukan hanya milik pengguna saat ini
kelompok) melalui --kelompok opsi, dan menyalin perangkat melalui --perangkat .
Ini berguna untuk sistem yang memungkinkan aktivitas seperti itu tanpa menjadi pengguna super,
dan juga untuk memastikan bahwa Anda akan mendapatkan kesalahan jika pihak penerima tidak sedang
dijalankan sebagai pengguna super. Untuk mematikan aktivitas pengguna super, pengguna super dapat menggunakan
--tidak-super.

--palsu-super
Saat opsi ini diaktifkan, rsync mensimulasikan aktivitas pengguna super dengan
menyimpan/memulihkan atribut istimewa melalui atribut tambahan khusus yang
dilampirkan ke setiap file (sesuai kebutuhan). Ini termasuk pemilik dan grup file (jika
bukan default), info perangkat file (perangkat & file khusus dibuat sebagai
file teks kosong), dan bit izin apa pun yang tidak akan kami izinkan untuk disetel pada
file asli (mis. file asli mendapatkan kami, gs, atau untuk keamanan) atau itu akan membatasi
akses pemilik (karena pengguna super sebenarnya selalu dapat mengakses/mengubah file,
file yang kami buat selalu dapat diakses/diubah oleh pengguna yang membuat). Pilihan ini
juga menangani ACL (jika --acls telah ditentukan) dan atribut tambahan non-pengguna (jika
--xattrs telah ditentukan).

Ini adalah cara yang baik untuk mencadangkan data tanpa menggunakan pengguna super, dan untuk menyimpan ACL
dari sistem yang tidak kompatibel.

--palsu-super opsi hanya mempengaruhi sisi di mana opsi digunakan. Mempengaruhi
sisi jarak jauh dari koneksi cangkang jarak jauh, gunakan --pilihan jarak jauh (-M) pilihan:

rsync -av -M--fake-super /src/ host:/tujuan/

Untuk salinan lokal, opsi ini memengaruhi sumber dan tujuan. Jika kamu
ingin salinan lokal untuk mengaktifkan opsi ini hanya untuk file tujuan, tentukan
-M--palsu-super. Jika Anda menginginkan salinan lokal untuk mengaktifkan opsi ini hanya untuk sumbernya
file, gabungkan --palsu-super dengan -M--super.

Opsi ini ditimpa oleh keduanya --super dan --tidak-super.

Lihat juga pengaturan "fake super" di file rsyncd.conf daemon.

-S, --jarang
Cobalah untuk menangani file yang jarang secara efisien sehingga tidak memakan banyak ruang di
tujuan. Konflik dengan --di tempat karena tidak mungkin untuk menimpa data
dengan cara yang jarang.

--pra-alokasikan
Ini memberitahu penerima untuk mengalokasikan setiap file tujuan ke ukuran akhirnya
sebelum menulis data ke file. Rsync hanya akan menggunakan tingkat sistem file yang sebenarnya
dukungan pra-alokasi disediakan oleh Linux salah(2) panggilan sistem atau Cygwin
posix_fallocation(3), bukan implementasi glibc lambat yang menulis byte nol ke dalam
setiap blok.

Tanpa opsi ini, file yang lebih besar mungkin tidak sepenuhnya bersebelahan pada sistem file,
tetapi dengan opsi ini rsync mungkin akan menyalin lebih lambat. Jika tujuannya adalah
bukan sistem file yang mendukung perluasan (seperti ext4, xfs, NTFS, dll.), opsi ini
mungkin tidak memiliki efek positif sama sekali.

-N, --lari-kering
Ini membuat rsync melakukan uji coba yang tidak membuat perubahan apa pun (dan menghasilkan
sebagian besar output yang sama sebagai run nyata). Ini paling sering digunakan dalam kombinasi
pada pengatur terkenal. Pengatur ini menawarkan bantuan hukum kepada traderapabila trader berselisih dengan broker yang terdaftar dengan mereka. -di, --bertele-tele dan / atau -Saya, --itemize-perubahan opsi untuk melihat apa itu rsync
perintah yang akan dilakukan sebelum seseorang benar-benar menjalankannya.

Output dari --itemize-perubahan seharusnya persis sama pada lari kering dan
lari nyata berikutnya (kecuali tipuan yang disengaja dan kegagalan panggilan sistem); jika
bukan, itu bug. Output lainnya sebagian besar tidak berubah, tetapi mungkin berbeda dalam
beberapa daerah. Khususnya, proses kering tidak mengirim data aktual untuk transfer file,
so --kemajuan tidak berpengaruh, "byte terkirim", "byte diterima", "data literal",
dan statistik "data yang cocok" terlalu kecil, dan nilai "percepatan" setara
untuk menjalankan di mana tidak ada transfer file yang diperlukan.

-W, --seluruh file
Dengan opsi ini, algoritme transfer delta rsync tidak digunakan dan seluruh file
dikirim apa adanya. Transfer mungkin lebih cepat jika opsi ini digunakan saat
bandwidth antara mesin sumber dan tujuan lebih tinggi dari bandwidth
ke disk (terutama ketika "disk" sebenarnya adalah sistem file jaringan). Ini adalah
default ketika sumber dan tujuan ditentukan sebagai jalur lokal, tetapi
hanya jika tidak ada opsi penulisan batch yang berlaku.

-X, --satu-file-sistem
Ini memberitahu rsync untuk menghindari melintasi batas sistem file saat berulang. Ini tidak
tidak membatasi kemampuan pengguna untuk menentukan item yang akan disalin dari beberapa sistem file,
hanya rekursi rsync melalui hierarki setiap direktori yang pengguna
ditentukan, dan juga rekursi analog di sisi penerima selama penghapusan.
Juga perlu diingat bahwa rsync memperlakukan mount "bind" ke perangkat yang sama seperti aktif
sistem file yang sama.

Jika opsi ini diulang, rsync menghilangkan semua direktori mount-point dari salinan.
Jika tidak, itu termasuk direktori kosong di setiap titik mount yang ditemuinya (menggunakan
atribut direktori mount karena atribut mount-point yang mendasarinya
direktori tidak dapat diakses).

Jika rsync telah diberitahu untuk menutup symlink (melalui --salin-tautan or
--salin-tautan-tidak aman), symlink ke direktori di perangkat lain diperlakukan seperti a
titik-mount. Symlink ke non-direktori tidak terpengaruh oleh opsi ini.

--ada, --abaikan-tidak ada
Ini memberitahu rsync untuk melewati pembuatan file (termasuk direktori) yang tidak ada
masih di tempat tujuan. Jika opsi ini digabungkan dengan --abaikan-ada
opsi, tidak ada file yang akan diperbarui (yang dapat berguna jika yang ingin Anda lakukan hanyalah
menghapus file asing).

Opsi ini adalah aturan transfer, bukan pengecualian, sehingga tidak memengaruhi data yang
masuk ke daftar file, dan karenanya tidak memengaruhi penghapusan. Itu hanya membatasi
file yang diminta penerima untuk ditransfer.

--abaikan-ada
Ini memberitahu rsync untuk melewati pembaruan file yang sudah ada di tujuan (ini
tidak tidak abaikan direktori yang ada, atau tidak ada yang akan selesai). Lihat juga
--ada.

Opsi ini adalah aturan transfer, bukan pengecualian, sehingga tidak memengaruhi data yang
masuk ke daftar file, dan karenanya tidak memengaruhi penghapusan. Itu hanya membatasi
file yang diminta penerima untuk ditransfer.

Opsi ini dapat berguna bagi mereka yang melakukan pencadangan menggunakan --link-tujuan pilihan kapan
mereka perlu melanjutkan proses pencadangan yang terputus. Sejak --link-tujuan menjalankan
disalin ke hierarki direktori baru (bila digunakan dengan benar), menggunakan --mengabaikan
ada akan memastikan bahwa file yang sudah ditangani tidak di-tweak (yang menghindari
perubahan izin pada file hard-linked). Ini berarti bahwa opsi ini
hanya melihat file yang ada di hierarki tujuan itu sendiri.

--hapus-sumber-file
Ini memberitahu rsync untuk menghapus dari sisi pengirim file (artinya
non-direktori) yang merupakan bagian dari transfer dan telah berhasil
digandakan di sisi penerima.

Perhatikan bahwa Anda hanya boleh menggunakan opsi ini pada file sumber yang tidak aktif. Jika
Anda menggunakan ini untuk memindahkan file yang muncul di direktori tertentu ke
host lain, pastikan file yang sudah selesai diganti namanya menjadi sumbernya
direktori, tidak langsung ditulis ke dalamnya, sehingga rsync tidak mungkin mentransfer a
file yang belum sepenuhnya ditulis. Jika Anda tidak dapat menulis file terlebih dahulu menjadi a
direktori yang berbeda, Anda harus menggunakan idiom penamaan yang memungkinkan rsync menghindari
mentransfer file yang belum selesai (mis. beri nama file "foo.new" saat itu
ditulis, ganti namanya menjadi "foo" setelah selesai, lalu gunakan opsi
--exclude='*.new' untuk transfer rsync).

Dimulai dengan 3.1.0, rsync akan melewatkan penghapusan sisi pengirim (dan menghasilkan kesalahan)
jika ukuran file atau waktu modifikasi tidak berubah.

--menghapus
Ini memberitahu rsync untuk menghapus file asing dari sisi penerima (yang
tidak di sisi pengirim), tetapi hanya untuk direktori yang sedang
disinkronkan. Anda harus meminta rsync untuk mengirim seluruh direktori (mis. "dir" atau
"dir/") tanpa menggunakan wildcard untuk isi direktori (misalnya "dir/*") karena
wildcard diperluas oleh shell dan rsync sehingga mendapat permintaan untuk mentransfer
file individual, bukan direktori induk file. File yang dikecualikan dari
transfer juga dikecualikan untuk dihapus kecuali Anda menggunakan
--hapus-dikecualikan opsi atau tandai aturan sebagai hanya cocok di sisi pengirim
(lihat pengubah include/exclude di bagian FILTER ATURAN).

Sebelum rsync 2.6.7, opsi ini tidak akan berpengaruh kecuali --rekursif adalah
diaktifkan. Dimulai dengan 2.6.7, penghapusan juga akan terjadi ketika --dir (-d) aku s
diaktifkan, tetapi hanya untuk direktori yang isinya sedang disalin.

Opsi ini bisa berbahaya jika digunakan secara tidak benar! Ini adalah ide yang sangat baik untuk pertama
coba lari menggunakan --lari-kering pilihan (-n) untuk melihat file apa yang akan dibuat
dihapus.

Jika pihak pengirim mendeteksi kesalahan I/O, maka penghapusan file apa pun di
tujuan akan dinonaktifkan secara otomatis. Ini untuk mencegah sistem file sementara
kegagalan (seperti kesalahan NFS) di sisi pengiriman karena menyebabkan penghapusan besar-besaran
file di tempat tujuan. Anda dapat menimpa ini dengan --abaikan-kesalahan
.

--menghapus opsi dapat digabungkan dengan salah satu opsi --delete-WHEN tanpa
konflik, serta --hapus-dikecualikan. Namun, jika tidak ada --delete-WHEN
opsi ditentukan, rsync akan memilih --hapus-selama algoritma saat berbicara
ke rsync 3.0.0 atau lebih baru, dan --hapus-sebelumnya algoritma ketika berbicara dengan yang lebih tua
rsync. Lihat juga --hapus-tunda dan --hapus-setelah.

--hapus-sebelumnya
Minta agar penghapusan file di pihak penerima dilakukan sebelum transfer
dimulai. Lihat --menghapus (yang tersirat) untuk detail lebih lanjut tentang penghapusan file.

Menghapus sebelum transfer berguna jika sistem file sempit untuk ruang dan
menghapus file asing akan membantu memungkinkan transfer. Namun, itu
memang menyebabkan penundaan sebelum dimulainya transfer, dan penundaan ini dapat menyebabkan
transfer ke batas waktu (jika --waktu habis telah ditentukan). Itu juga memaksa rsync untuk menggunakan
algoritma rekursi non-incremental lama yang membutuhkan rsync untuk memindai semua
file di transfer ke memori sekaligus (lihat --rekursif).

--hapus-selama, -del
Minta agar penghapusan file di sisi penerima dilakukan secara bertahap sebagai
transfer terjadi. Pemindaian penghapusan per direktori dilakukan tepat sebelum masing-masing
direktori diperiksa untuk pembaruan, sehingga berperilaku seperti lebih efisien
--hapus-sebelumnya, termasuk melakukan penghapusan sebelum filter per direktori
file yang sedang diperbarui. Opsi ini pertama kali ditambahkan di rsync versi 2.6.4. Lihat
--menghapus (yang tersirat) untuk detail lebih lanjut tentang penghapusan file.

--hapus-tunda
Meminta agar penghapusan file di sisi penerima dihitung selama
perpindahan (seperti --hapus-selama), lalu dihapus setelah transfer selesai.
Ini berguna bila dikombinasikan dengan --delay-pembaruan dan / atau --kusut, dan lebih banyak lagi
efisien daripada menggunakan --hapus-setelah (tetapi dapat berperilaku berbeda, karena
--hapus-setelah menghitung penghapusan dalam lintasan terpisah setelah semua pembaruan dilakukan
selesai). Jika jumlah file yang dihapus melebihi buffer internal, sementara
file akan dibuat di sisi penerima untuk menyimpan nama (dihapus saat
terbuka, jadi Anda tidak akan melihatnya selama transfer). Jika penciptaan
file sementara gagal, rsync akan mencoba kembali menggunakan --hapus-setelah (yang itu
tidak bisa jika --rekursif sedang melakukan pemindaian tambahan). Lihat --menghapus (yang mana
tersirat) untuk detail lebih lanjut tentang penghapusan file.

--hapus-setelah
Minta agar penghapusan file di pihak penerima dilakukan setelah transfer
telah selesai. Ini berguna jika Anda mengirim file gabungan per direktori baru sebagai
bagian dari transfer dan Anda ingin pengecualian mereka berlaku untuk penghapusan
fase transfer arus. Itu juga memaksa rsync untuk menggunakan yang lama,
algoritma rekursi non-incremental yang membutuhkan rsync untuk memindai semua file di
transfer ke dalam memori sekaligus (lihat --rekursif). Lihat --menghapus (yang mana
tersirat) untuk detail lebih lanjut tentang penghapusan file.

--hapus-dikecualikan
Selain menghapus file di sisi penerima yang tidak ada di pengiriman
sisi, ini memberitahu rsync untuk juga menghapus file apa pun di sisi penerima yang
dikecualikan (lihat --mengecualikan). Lihat bagian FILTER ATURAN untuk cara membuat
pengecualian individu berperilaku seperti ini pada penerima, dan sebagai cara untuk melindungi
file dari --hapus-dikecualikan. Lihat --menghapus (yang tersirat) untuk detail lebih lanjut tentang
penghapusan file.

--abaikan-hilang-argumen
Saat rsync pertama kali memproses file sumber yang diminta secara eksplisit (mis
argumen baris perintah atau --file-dari entri), biasanya merupakan kesalahan jika
berkas tidak dapat ditemukan. Opsi ini menekan kesalahan itu, dan tidak mencoba untuk
mentransfer file. Ini tidak mempengaruhi kesalahan file hilang berikutnya jika file
awalnya ditemukan ada dan kemudian tidak ada lagi.

--hapus-argumen yang hilang
Opsi ini mengambil perilaku (yang tersirat) --abaikan-hilang-argumen pilihan satu langkah
lebih jauh: setiap argumen yang hilang akan menjadi permintaan penghapusan yang sesuai
file tujuan di sisi penerima (jika ada). Jika file tujuan
adalah direktori yang tidak kosong, hanya akan berhasil dihapus jika --force atau
--delete sedang berlaku. Selain itu, opsi ini tidak tergantung pada yang lain
jenis pemrosesan penghapusan.

File sumber yang hilang diwakili oleh entri daftar file khusus yang menampilkan
sebagai entri "*hilang" di --daftar-saja output.

--abaikan-kesalahan
Memberitahu --menghapus untuk melanjutkan dan menghapus file bahkan ketika ada kesalahan I/O.

--memaksa
Opsi ini memberitahu rsync untuk menghapus direktori yang tidak kosong ketika akan diganti
oleh non-direktori. Ini hanya relevan jika penghapusan tidak aktif (lihat
--menghapus untuk lebih jelasnya).

Catatan untuk versi rsync yang lebih lama: --memaksa dulu masih dibutuhkan saat menggunakan
--hapus-setelah, dan dulunya tidak berfungsi kecuali jika --rekursif pilihan adalah
juga diaktifkan.

--max-delete=JUMLAH
Ini memberitahu rsync untuk tidak menghapus lebih dari NUM file atau direktori. Jika batas itu
terlampaui, semua penghapusan lebih lanjut akan dilewati hingga akhir transfer. Pada
akhirnya, rsync mengeluarkan peringatan (termasuk jumlah penghapusan yang dilewati) dan
keluar dengan kode kesalahan 25 (kecuali beberapa kondisi kesalahan yang lebih penting juga
muncul).

Dimulai dengan versi 3.0.0, Anda dapat menentukan --max-hapus=0 untuk diperingatkan tentang apapun
file asing di tujuan tanpa menghapus salah satu dari mereka. Klien yang lebih tua
menafsirkan ini sebagai "tidak terbatas", jadi jika Anda tidak tahu versi kliennya,
Anda dapat menggunakan yang kurang jelas --max-hapus=-1 sebagai cara yang kompatibel ke belakang untuk
tentukan bahwa tidak ada penghapusan yang diizinkan (meskipun versi yang sangat lama tidak memperingatkan kapan
batasnya terlampaui).

--max-size=UKURAN
Ini memberitahu rsync untuk menghindari mentransfer file apa pun yang lebih besar dari yang ditentukan
UKURAN. Nilai SIZE dapat diakhiri dengan string untuk menunjukkan pengali ukuran,
dan dapat berupa nilai pecahan (misalnya "--max-ukuran = 1.5 m").

Opsi ini adalah aturan transfer, bukan pengecualian, sehingga tidak memengaruhi data yang
masuk ke daftar file, dan karenanya tidak memengaruhi penghapusan. Itu hanya membatasi
file yang diminta penerima untuk ditransfer.

Sufiksnya adalah sebagai berikut: "K" (atau "KiB") adalah kibibyte (1024), "M" (atau "MiB") adalah
satu mebibyte (1024*1024), dan "G" (atau "GiB") adalah gibibyte (1024*1024*1024). Jika kamu
ingin pengali menjadi 1000 bukannya 1024, gunakan "KB", "MB", atau "GB". (Catatan:
huruf kecil juga diterima untuk semua nilai.) Akhirnya, jika sufiks berakhir dengan baik
"+1" atau "-1", nilainya akan diimbangi oleh satu byte ke arah yang ditunjukkan.

Contoh: --max-size=1.5mb-1 adalah 1499999 byte, dan --max-size=2g+1 adalah 2147483649
byte.

Perhatikan bahwa versi rsync sebelum 3.1.0 tidak mengizinkan --ukuran-maks=0.

--min-ukuran=UKURAN
Ini memberitahu rsync untuk menghindari mentransfer file apa pun yang lebih kecil dari yang ditentukan
SIZE, yang dapat membantu untuk tidak mentransfer file sampah kecil. Lihat --maks-ukuran
pilihan untuk deskripsi UKURAN dan informasi lainnya.

Perhatikan bahwa versi rsync sebelum 3.1.0 tidak mengizinkan --min-ukuran=0.

-B, --block-size=BLOKSIZE
Ini memaksa ukuran blok yang digunakan dalam algoritme transfer delta rsync ke tetap
nilai. Biasanya dipilih berdasarkan ukuran setiap file yang diperbarui. Lihat
laporan teknis untuk rincian.

-e, --rsh=PERINTAH
Opsi ini memungkinkan Anda untuk memilih program shell jarak jauh alternatif yang akan digunakan untuk
komunikasi antara salinan rsync lokal dan jarak jauh. Biasanya, rsync adalah
dikonfigurasi untuk menggunakan ssh secara default, tetapi Anda mungkin lebih suka menggunakan rsh di jaringan lokal.

Jika opsi ini digunakan dengan [pengguna@]host::modul/jalur, lalu cangkang jarak jauh COMMAND
akan digunakan untuk menjalankan daemon rsync pada host jarak jauh, dan semua data akan
ditransmisikan melalui koneksi shell jarak jauh itu, bukan melalui koneksi langsung
koneksi socket ke daemon rsync yang sedang berjalan pada host jarak jauh. Lihat bagian
"GUNAKAN FITUR RSYNC-DAEMON MELALUI KONEKSI REMOTE-SHELL" di atas.

Argumen baris perintah diizinkan di COMMAND asalkan COMMAND disajikan
untuk rsync sebagai argumen tunggal. Anda harus menggunakan spasi (bukan tab atau spasi putih lainnya)
untuk memisahkan perintah dan argumen satu sama lain, dan Anda dapat menggunakan single- dan/atau
tanda kutip ganda untuk mempertahankan spasi dalam argumen (tetapi bukan garis miring terbalik). Perhatikan bahwa
menggandakan tanda kutip tunggal di dalam string tanda kutip tunggal memberi Anda tanda kutip tunggal;
demikian juga untuk tanda kutip ganda (walaupun Anda perlu memperhatikan tanda kutip mana yang Anda kutip
shell parsing dan kutipan mana yang rsync parsing). Beberapa contoh:

-e 'ssh -p 2234'
-e 'ssh -o "ProxyCommand nohup ssh firewall nc -w1 %h %p"'

(Perhatikan bahwa pengguna ssh dapat secara bergantian menyesuaikan opsi koneksi khusus situs di
file .ssh/config mereka.)

Anda juga dapat memilih program shell jarak jauh menggunakan lingkungan RSYNC_RSH
variabel, yang menerima rentang nilai yang sama dengan -e.

Lihat juga --memblokir-io opsi yang dipengaruhi oleh opsi ini.

--rsync-jalur=PROGRAM
Gunakan ini untuk menentukan program apa yang akan dijalankan pada mesin jarak jauh untuk memulai
rsync. Sering digunakan ketika rsync tidak berada di jalur shell jarak jauh default (mis
--rsync-path=/usr/local/bin/rsync). Perhatikan bahwa PROGRAM dijalankan dengan bantuan a
shell, jadi itu bisa berupa program, skrip, atau urutan perintah apa pun yang ingin Anda jalankan, jadi
selama itu tidak merusak standar masuk & keluar standar yang digunakan rsync untuk
menyampaikan.

Salah satu contoh rumit adalah mengatur direktori default yang berbeda pada mesin jarak jauh
untuk digunakan dengan --relatif pilihan. Contohnya:

rsync -avR --rsync-path="cd /a/b && rsync" host:c/d /e/

-M, --remote-option=OPSI
Opsi ini digunakan untuk situasi yang lebih maju di mana Anda ingin efek tertentu
terbatas pada satu sisi transfer saja. Misalnya, jika Anda ingin lulus
--file-log=FILE dan --palsu-super ke sistem jarak jauh, tentukan seperti ini:

rsync -av -M --log-file=foo -M--fake-super src/ tujuan/

Jika Anda ingin memiliki opsi yang hanya memengaruhi sisi lokal transfer saat itu
biasanya mempengaruhi kedua belah pihak, mengirim negasinya ke sisi yang jauh. Seperti ini:

rsync -av -x -M--no-x src/ tujuan/

Berhati-hatilah menggunakan ini, karena memungkinkan untuk mengaktifkan opsi yang akan menyebabkan rsync
untuk memiliki gagasan yang berbeda tentang data apa yang diharapkan selanjutnya melalui soket, dan itu
akan membuatnya gagal secara samar.

Perhatikan bahwa yang terbaik adalah menggunakan yang terpisah --pilihan jarak jauh untuk setiap opsi yang Anda inginkan
lulus. Ini membuat penggunaan Anda kompatibel dengan --melindungi-args pilihan. Jika itu
opsi tidak aktif, spasi apa pun di opsi jarak jauh Anda akan dibagi oleh shell jarak jauh
kecuali Anda mengambil langkah untuk melindungi mereka.

Saat melakukan transfer lokal, sisi "lokal" adalah pengirim dan sisi "jauh"
sisi adalah penerima.

Perhatikan beberapa versi perpustakaan penguraian opsi popt memiliki bug di dalamnya yang
mencegah Anda menggunakan argumen yang berdekatan dengan yang sama di dalamnya di sebelah opsi pendek
letter (mis. -M--log-file=/tmp/foo. Jika bug ini memengaruhi versi popt Anda, Anda
dapat menggunakan versi popt yang disertakan dengan rsync.

-C, --cvs-tidak termasuk
Ini adalah singkatan yang berguna untuk mengecualikan berbagai file yang sering Anda
tidak ingin mentransfer antar sistem. Ini menggunakan algoritma yang mirip dengan CVS untuk
menentukan apakah suatu file harus diabaikan.

Daftar pengecualian diinisialisasi untuk mengecualikan item berikut (item awal ini
ditandai sebagai mudah rusak -- lihat bagian ATURAN FILTER):

RCS SCCS CVS CVS.adm RCSLOG cvslog.* tag TAGS .make.state .nse_depinfo *~
#* .#* ,* _$* *$ *.old *.bak *.BAK *.orig *.rej .del-* *.a *.olb *.o *.obj
*.jadi *.exe *.Z *.elc *.ln inti .svn/ .git/ .hg/ .bzr/

kemudian, file yang terdaftar di $HOME/.cvsignore ditambahkan ke daftar dan file apa pun yang terdaftar
dalam variabel lingkungan CVSIGNORE (semua nama cvsignore dibatasi oleh
spasi).

Terakhir, file apa pun akan diabaikan jika berada di direktori yang sama dengan file .cvsignore
dan cocok dengan salah satu pola yang tercantum di dalamnya. Tidak seperti filter/kecualikan rsync
file, pola ini dibagi pada spasi. Lihat cvs(1) manual untuk lebih banyak
informasi.

Jika Anda menggabungkan -C dengan milikmu sendiri --Saring aturan, Anda harus mencatat bahwa CVS ini
pengecualian ditambahkan di akhir aturan Anda sendiri, di mana pun -C adalah
ditempatkan pada baris perintah. Ini menjadikannya prioritas yang lebih rendah daripada aturan apa pun yang Anda
ditentukan secara eksplisit. Jika Anda ingin mengontrol di mana pengecualian CVS ini dimasukkan
ke dalam aturan filter Anda, Anda harus menghilangkan -C sebagai opsi baris perintah dan gunakan a
kombinasi dari --filter=:C dan --filter=-C (baik di baris perintah Anda atau dengan
menempatkan aturan ":C" dan "-C" ke dalam file filter dengan aturan Anda yang lain). NS
opsi pertama mengaktifkan pemindaian per direktori untuk file .cvsignore. NS
opsi kedua melakukan impor satu kali dari pengecualian CVS yang disebutkan di atas.

-F, --filter=ATURAN
Opsi ini memungkinkan Anda untuk menambahkan aturan untuk mengecualikan file tertentu secara selektif dari
daftar file yang akan ditransfer. Ini paling berguna dalam kombinasi dengan a
transfer rekursif.

Anda dapat menggunakan sebanyak mungkin --Saring opsi pada baris perintah yang Anda ingin bangun
daftar file yang akan dikecualikan. Jika filter berisi spasi, pastikan untuk mengutip
sehingga Shell memberikan aturan ke rsync sebagai argumen tunggal. Teks di bawah ini
juga menyebutkan bahwa Anda dapat menggunakan garis bawah untuk mengganti spasi yang memisahkan a
aturan dari arg-nya.

Lihat bagian FILTER ATURAN untuk informasi rinci tentang opsi ini.

-F -F opsi adalah singkatan untuk menambahkan dua --Saring aturan untuk perintah Anda. NS
pertama kali digunakan adalah singkatan untuk aturan ini:

--filter='dir-merge /.rsync-filter'

Ini memberitahu rsync untuk mencari file .rsync-filter per-direktori yang telah
disebarkan melalui hierarki dan menggunakan aturan mereka untuk memfilter file di
transfer. Jika -F diulang, ini adalah singkatan untuk aturan ini:

--filter='kecualikan .rsync-filter'

Ini menyaring file .rsync-filter sendiri dari transfer.

Lihat bagian FILTER ATURAN untuk informasi mendetail tentang cara kerja opsi ini.

--kecualikan=POLA
Opsi ini adalah bentuk sederhana dari --Saring opsi yang default ke pengecualian
aturan dan tidak mengizinkan sintaks parsing aturan penuh dari aturan filter normal.

Lihat bagian FILTER ATURAN untuk informasi rinci tentang opsi ini.

--kecualikan-dari=FILE
Opsi ini terkait dengan --mengecualikan opsi, tetapi menentukan FILE yang
berisi pola pengecualian (satu per baris). Baris kosong dalam file dan baris
dimulai dengan ';' atau '#' diabaikan. Jika FILE is -, daftar akan dibaca dari
masukan standar.

--termasuk=POLA
Opsi ini adalah bentuk sederhana dari --Saring opsi yang default ke include
aturan dan tidak mengizinkan sintaks parsing aturan penuh dari aturan filter normal.

Lihat bagian FILTER ATURAN untuk informasi rinci tentang opsi ini.

--termasuk-dari=FILE
Opsi ini terkait dengan --termasuk opsi, tetapi menentukan FILE yang
berisi pola termasuk (satu per baris). Baris kosong dalam file dan baris
dimulai dengan ';' atau '#' diabaikan. Jika FILE is -, daftar akan dibaca dari
masukan standar.

--file-dari=FILE
Menggunakan opsi ini memungkinkan Anda untuk menentukan daftar file yang akan ditransfer (sebagai
baca dari FILE yang ditentukan atau - untuk masukan standar). Itu juga mengubah default
perilaku rsync untuk mentransfer hanya file dan direktori yang ditentukan
lebih mudah:

o Itu --relatif (-R) opsi tersirat, yang mempertahankan informasi jalur
yang ditentukan untuk setiap item dalam file (gunakan --tidak ada kerabat or --juga bukan if
Anda ingin mematikannya).

o Itu --dir (-d) opsi tersirat, yang akan membuat direktori yang ditentukan
dalam daftar tujuan daripada melewatkannya dengan berisik (gunakan
--tidak-dir or --anggukan jika Anda ingin mematikannya).

o Itu --Arsip (-a) perilaku opsi tidak menyiratkan --rekursif (-r), jadi
tentukan secara eksplisit, jika Anda menginginkannya.

o Efek samping ini mengubah status default rsync, jadi posisi
--file-dari opsi pada baris perintah tidak ada hubungannya dengan bagaimana opsi lain
diurai (mis -a bekerja sama sebelum atau sesudah --file-dari, seperti halnya
--juga bukan dan semua opsi lainnya).

Nama file yang dibaca dari FILE semuanya relatif terhadap direktori sumber -- any
garis miring di depan dihilangkan dan tidak ada referensi ".." yang boleh lebih tinggi dari
sumber dir. Misalnya, ambil perintah ini:

rsync -a --file-dari=/tmp/foo / usr jarak jauh:/cadangan

Jika /tmp/foo berisi string "bin" (atau bahkan "/tempat sampah"), NS / usr / bin direktori akan
dibuat sebagai /backup/bin pada remote host. Jika berisi "bin/" (perhatikan
trailing slash), konten langsung dari direktori juga akan dikirim
(tanpa perlu disebutkan secara eksplisit dalam file -- ini dimulai di versi
2.6.4). Dalam kedua kasus, jika -r opsi diaktifkan, seluruh hierarki direktori itu
juga akan ditransfer (perlu diingat bahwa -r perlu ditentukan secara eksplisit
dengan --file-dari, karena tidak tersirat oleh -a). Perhatikan juga bahwa efek dari
yang (diaktifkan secara default) --relatif pilihannya adalah menduplikasi hanya info jalur yang
dibaca dari file -- itu tidak memaksa duplikasi jalur spesifikasi sumber
(/ usr pada kasus ini).

Selain itu, --file-dari file dapat dibaca dari host jarak jauh alih-alih
host lokal jika Anda menentukan "host:" di depan file (host harus cocok dengan satu
akhir pemindahan). Sebagai jalan pintas, Anda dapat menentukan hanya awalan ":" yang berarti
"gunakan ujung jarak jauh dari transfer". Sebagai contoh:

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

Ini akan menyalin semua file yang ditentukan dalam file /path/file-list yang sebelumnya
terletak di host "src" jarak jauh.

Jika --ikonv dan --melindungi-args pilihan ditentukan dan --file-dari
nama file sedang dikirim dari satu host ke host lain, nama file akan diterjemahkan
dari charset host pengirim ke charset host penerima.

CATATAN: menyortir daftar file di input --files-from membantu rsync menjadi lebih
efisien, karena akan menghindari mengunjungi kembali elemen jalur yang dibagi antara
entri yang berdekatan. Jika input tidak diurutkan, beberapa elemen jalur (tersirat
direktori) mungkin akan dipindai beberapa kali, dan rsync pada akhirnya akan
batalkan duplikatnya setelah diubah menjadi elemen daftar file.

-0, --dari0
Ini memberitahu rsync bahwa aturan/nama file yang dibacanya dari file diakhiri oleh a
karakter null ('\0'), bukan NL, CR, atau CR+LF. Ini mempengaruhi --kecuali-dari,
--termasuk-dari, --file-dari, dan file gabungan apa pun yang ditentukan dalam a --Saring aturan.
Itu tidak mempengaruhi --cvs-tidak termasuk (karena semua nama yang dibaca dari file .cvsignore adalah
pisahkan pada spasi putih).

-S, --melindungi-args
Opsi ini mengirim semua nama file dan sebagian besar opsi ke rsync jarak jauh tanpa
memungkinkan shell jarak jauh untuk menafsirkannya. Ini berarti bahwa spasi tidak terbelah
dalam nama, dan karakter khusus non-wildcard tidak diterjemahkan (seperti ~, $,
;, &, dll.). Wildcard diperluas pada host jarak jauh oleh rsync (bukan
cangkang melakukannya).

Jika Anda menggunakan opsi ini dengan --ikonv, argumen yang terkait dengan sisi jarak jauh juga akan
diterjemahkan dari set karakter lokal ke set karakter jarak jauh. Terjemahan terjadi
sebelum wildcard diperluas. Lihat juga --file-dari .

Anda juga dapat mengontrol opsi ini melalui variabel lingkungan RSYNC_PROTECT_ARGS.
Jika variabel ini memiliki nilai bukan nol, opsi ini akan diaktifkan secara default,
jika tidak maka akan dinonaktifkan secara default. Salah satu status ditimpa secara manual
versi positif atau negatif yang ditentukan dari opsi ini (perhatikan bahwa --tidak-s dan
--tidak-melindungi-argumen adalah versi negatif). Karena opsi ini adalah yang pertama
diperkenalkan di 3.0.0, Anda harus memastikannya dinonaktifkan jika Anda perlu
berinteraksi dengan rsync jarak jauh yang lebih lama dari itu.

Rsync juga dapat dikonfigurasi (pada waktu pembuatan) agar opsi ini diaktifkan secara default
(with diganti oleh lingkungan dan baris perintah). Pilihan ini
pada akhirnya akan menjadi pengaturan default baru di beberapa titik yang belum ditentukan di
masa depan.

-T, --temp-dir=DIR
Opsi ini menginstruksikan rsync untuk menggunakan DIR sebagai direktori awal saat membuat
salinan sementara dari file yang ditransfer di sisi penerima. Standarnya
perilaku adalah membuat setiap file sementara di direktori yang sama dengan yang terkait
berkas tujuan. Dimulai dengan rsync 3.1.1, nama file temp di dalam
DIR yang ditentukan tidak akan diawali dengan titik tambahan (meskipun mereka masih memiliki
sufiks acak ditambahkan).

Opsi ini paling sering digunakan ketika partisi disk penerima tidak memiliki
cukup ruang kosong untuk menyimpan salinan file terbesar dalam transfer. Pada kasus ini
(yaitu ketika direktori awal berada di partisi disk yang berbeda), rsync tidak akan
dapat mengganti nama setiap file sementara yang diterima di atas yang terkait
file tujuan, tetapi sebaliknya harus menyalinnya ke tempatnya. Rsync melakukan ini dengan menyalin
file di atas file tujuan, yang berarti bahwa tujuan
file akan berisi data yang terpotong selama penyalinan ini. Jika ini tidak dilakukan dengan cara ini
(bahkan jika file tujuan pertama kali dihapus, data disalin secara lokal ke a
file sementara di direktori tujuan, dan kemudian diganti namanya menjadi tempatnya) itu akan
mungkin untuk file lama untuk terus mengambil ruang disk (jika seseorang memilikinya
terbuka), dan dengan demikian mungkin tidak ada cukup ruang untuk memuat versi baru pada disk
pada saat yang sama.

Jika Anda menggunakan opsi ini untuk alasan selain kekurangan ruang disk, Anda
mungkin ingin menggabungkannya dengan --delay-pembaruan pilihan, yang akan memastikan bahwa semua
file yang disalin dimasukkan ke dalam subdirektori dalam hierarki tujuan, menunggu
akhir pemindahan. Jika Anda tidak memiliki cukup ruang untuk menduplikasi semua yang tiba
file di partisi tujuan, cara lain untuk memberi tahu rsync bahwa Anda tidak
terlalu khawatir tentang ruang disk adalah dengan menggunakan --partial-dir pilihan dengan
Jalur relatif; karena ini memberi tahu rsync bahwa boleh saja menyimpan salinan a
file tunggal dalam subdir dalam hierarki tujuan, rsync akan menggunakan
parsial-dir sebagai area pementasan untuk membawa file yang disalin, dan kemudian mengganti namanya
ke tempatnya dari sana. (Menentukan --partial-dir dengan jalur absolut tidak
memiliki efek samping ini.)

-y, --kusut
Opsi ini memberi tahu rsync bahwa ia harus mencari file basis untuk tujuan apa pun
berkas yang hilang. Algoritma saat ini terlihat di direktori yang sama dengan
file tujuan untuk file yang memiliki ukuran dan waktu modifikasi yang sama, atau
file dengan nama yang sama. Jika ditemukan, rsync menggunakan file basis fuzzy untuk mencoba mempercepat
naik transfer.

Jika opsi diulang, pemindaian fuzzy juga akan dilakukan dalam pencocokan apa pun
direktori tujuan alternatif yang ditentukan melalui --bandingkan-tujuan,
--salin-tujuan, atau --link-tujuan.

Perhatikan bahwa penggunaan --menghapus opsi mungkin menghilangkan kemungkinan pencocokan fuzzy
file, jadi gunakan --hapus-setelah atau tentukan beberapa pengecualian nama file jika Anda membutuhkan
untuk mencegahnya.

--bandingkan-tujuan=DIR
Opsi ini menginstruksikan rsync untuk menggunakan DIR pada mesin tujuan sebagai tambahan
hierarki untuk membandingkan file tujuan dengan melakukan transfer (jika file tersebut
hilang di direktori tujuan). Jika file ditemukan di DIR itu identik
ke file pengirim, file TIDAK akan ditransfer ke tujuan
direktori. Ini berguna untuk membuat cadangan yang jarang dari hanya file yang memiliki
diubah dari cadangan sebelumnya. Opsi ini biasanya digunakan untuk menyalin ke
direktori kosong (atau baru dibuat).

Mulai versi 2.6.4, banyak --bandingkan-tujuan direktori dapat disediakan,
yang akan menyebabkan rsync mencari daftar dalam urutan yang ditentukan dengan tepat
cocok. Jika kecocokan ditemukan yang hanya berbeda dalam atribut, salinan lokal dibuat
dan atribut diperbarui. Jika kecocokan tidak ditemukan, file basis dari salah satu dari
DIRs akan dipilih untuk mencoba mempercepat transfer.

If DIR adalah jalur relatif, itu relatif terhadap direktori tujuan. Lihat juga
--salin-tujuan dan --link-tujuan.

CATATAN: dimulai dengan versi 3.1.0, rsync akan menghapus file dari yang tidak kosong
hierarki tujuan jika kecocokan persis ditemukan di salah satu tujuan perbandingan
hierarki (membuat hasil akhir lebih cocok dengan salinan baru).

--copy-tujuan=DIR
Opsi ini berperilaku seperti --bandingkan-tujuan, tetapi rsync juga akan menyalin file yang tidak diubah
ditemukan di DIR ke direktori tujuan menggunakan salinan lokal. Ini berguna untuk
melakukan transfer ke tujuan baru sambil membiarkan file yang ada tetap utuh, dan kemudian
melakukan flash-cutover ketika semua file telah berhasil ditransfer.

kelipatan --salin-tujuan direktori mungkin disediakan, yang akan menyebabkan rsync mencari
daftar dalam urutan yang ditentukan untuk file yang tidak berubah. Jika kecocokan tidak ditemukan, a
file dasar dari salah satu DIRs akan dipilih untuk mencoba mempercepat transfer.

If DIR adalah jalur relatif, itu relatif terhadap direktori tujuan. Lihat juga
--bandingkan-tujuan dan --link-tujuan.

--link-tujuan=DIR
Opsi ini berperilaku seperti --salin-tujuan, tetapi file yang tidak diubah ditautkan dengan keras dari DIR
ke direktori tujuan. File harus identik dalam semua yang diawetkan
atribut (misalnya izin, mungkin kepemilikan) agar file menjadi
dihubungkan bersama. Sebuah contoh:

rsync -av --link-dest=$PWD/prior_dir Host:src_dir/ new_dir/

Jika file tidak terhubung, periksa kembali atributnya. Periksa juga apakah beberapa
atribut dipaksa di luar kendali rsync, opsi pemasangan seperti itu
squishes root ke satu pengguna, atau pasang drive yang dapat dilepas dengan kepemilikan umum
(seperti opsi "Abaikan kepemilikan pada volume ini" OS X).

Mulai versi 2.6.4, banyak --link-tujuan direktori dapat disediakan, yang
akan menyebabkan rsync mencari daftar dalam urutan yang ditentukan untuk kecocokan yang tepat. Jika
kecocokan ditemukan yang hanya berbeda dalam atribut, salinan lokal dibuat dan
atribut diperbarui. Jika kecocokan tidak ditemukan, file basis dari salah satu dari DIRs
akan dipilih untuk mencoba mempercepat transfer.

Opsi ini berfungsi paling baik saat menyalin ke hierarki tujuan kosong, karena
file yang ada mungkin mendapatkan atributnya di-tweak, dan itu dapat memengaruhi alternatif
file tujuan melalui hard-link. Juga, perincian perubahan bisa sedikit
karut. Perhatikan bahwa sebelum versi 3.1.0, kecocokan persis direktori alternatif
tidak akan pernah ditemukan (atau ditautkan ke tujuan) ketika file tujuan
sudah ada.

Perhatikan bahwa jika Anda menggabungkan opsi ini dengan --abaikan-kali, rsync tidak akan menautkan apa pun
file bersama karena hanya menautkan file yang identik sebagai pengganti
mentransfer file, tidak pernah sebagai pemeriksaan tambahan setelah file diperbarui.

If DIR adalah jalur relatif, itu relatif terhadap direktori tujuan. Lihat juga
--bandingkan-tujuan dan --salin-tujuan.

Perhatikan bahwa versi rsync sebelum 2.6.1 memiliki bug yang dapat mencegah --link-tujuan
dari bekerja dengan benar untuk non-pengguna super ketika -o telah ditentukan (atau tersirat oleh
-a). Anda dapat mengatasi bug ini dengan menghindari -o opsi saat mengirim ke yang lama
rsync.

-z, --kompres
Dengan opsi ini, rsync mengompresi data file saat dikirim ke tujuan
mesin, yang mengurangi jumlah data yang ditransmisikan -- sesuatu yang
berguna melalui koneksi yang lambat.

Perhatikan bahwa opsi ini biasanya mencapai rasio kompresi yang lebih baik daripada yang bisa
dicapai dengan menggunakan shell jarak jauh yang mengompresi atau transportasi kompresi karena itu
mengambil keuntungan dari informasi implisit dalam blok data yang cocok yang
tidak secara eksplisit dikirim melalui koneksi. Kompresi pencocokan-data ini datang pada a
biaya CPU, dan dapat dinonaktifkan dengan mengulangi -z pilihan, tetapi hanya jika
kedua belah pihak setidaknya versi 3.1.1.

Perhatikan bahwa jika versi rsync Anda dikompilasi dengan zlib eksternal (bukan
zlib yang dikemas dengan rsync) maka itu tidak akan mendukung gaya lama
kompresi, hanya kompresi gaya baru (opsi berulang). Di masa depan ini
kompresi gaya baru kemungkinan akan menjadi default.

Klien rsync meminta kompresi gaya baru di server melalui
--kompres baru opsi, jadi jika Anda melihat opsi itu ditolak, itu berarti server
tidak cukup baru untuk mendukung -zz. Rsync juga menerima --kompres lama pilihan untuk
waktu mendatang ketika kompresi gaya baru menjadi default.

Lihat --lewati-kompres opsi untuk daftar default sufiks file yang tidak akan
dimampatkan.

--kompres-tingkat=NUM
Secara eksplisit mengatur tingkat kompresi untuk digunakan (lihat --kompres) daripada membiarkannya
bawaan. Jika NUM bukan nol, --kompres pilihan tersirat.

--skip-compress=DAFTAR
Ganti daftar sufiks file yang tidak akan dikompresi. NS DAFTAR seharusnya
satu atau lebih akhiran file (tanpa titik) dipisahkan oleh garis miring (/).

Anda dapat menentukan string kosong untuk menunjukkan bahwa tidak ada file yang harus dilewati.

Pencocokan kelas karakter sederhana didukung: masing-masing harus terdiri dari daftar
huruf di dalam tanda kurung siku (misalnya tidak ada kelas khusus, seperti "[:alpha:]",
didukung, dan '-' tidak memiliki arti khusus).

Karakter tanda bintang (*) dan tanda tanya (?) tidak memiliki arti khusus.

Berikut adalah contoh yang menentukan 6 sufiks untuk dilewati (karena 1 dari 5 aturan cocok
2 sufiks):

--skip-compress=gz/jpg/mp[34]/7z/bz2

Daftar sufiks default yang tidak akan dikompres adalah ini (dalam versi ini
dari rsync):

7z kartu as rar bz2 deb gpg gz iso jpeg jpg lz lzma lzo ungu muda mp3 mp4 ogg png langka rpm rzip
tbz tgz tolong terima kasih xz z zip

Daftar ini akan digantikan oleh Anda --lewati-kompres daftar di semua kecuali satu situasi: a
salin dari daemon rsync akan menambahkan sufiks yang Anda lewati ke daftarnya
file non-kompresi (dan daftarnya dapat dikonfigurasi ke default yang berbeda).

--numeric-id
Dengan opsi ini rsync akan mentransfer grup numerik dan ID pengguna daripada menggunakan
nama pengguna dan grup dan memetakannya di kedua ujungnya.

Secara default rsync akan menggunakan nama pengguna dan nama grup untuk menentukan kepemilikan apa
memberikan file. Uid khusus 0 dan grup khusus 0 tidak pernah dipetakan melalui
nama pengguna/grup meskipun --numeric-id pilihan tidak ditentukan.

Jika pengguna atau grup tidak memiliki nama di sistem sumber atau tidak memiliki kecocokan di
sistem tujuan, maka ID numerik dari sistem sumber digunakan sebagai gantinya.
Lihat juga komentar pada pengaturan "gunakan chroot" di halaman manual rsyncd.conf untuk
informasi tentang bagaimana pengaturan chroot mempengaruhi kemampuan rsync untuk mencari nama
pengguna dan grup dan apa yang dapat Anda lakukan.

--peta pengguna=STRING, --peta grup=STRING
Opsi ini memungkinkan Anda untuk menentukan pengguna dan grup yang harus dipetakan ke lainnya
nilai oleh pihak penerima. NS STRING adalah satu atau lebih DARI:UNTUK pasangan nilai
dipisahkan dengan koma. Setiap pencocokan DARI nilai dari pengirim diganti dengan a UNTUK
nilai dari penerima. Anda dapat menentukan nama pengguna atau ID pengguna untuk DARI dan UNTUK
nilai, dan DARI nilai juga dapat berupa string wild-card, yang akan dicocokkan
terhadap nama pengirim (wild-card TIDAK cocok dengan nomor ID, meskipun lihat
di bawah ini mengapa '*' cocok dengan semuanya). Anda dapat menentukan rentang ID
nomor melalui rentang inklusif: RENDAH-TINGGI. Sebagai contoh:

--usermap=0-99:tidak seorang pun,wayne:admin,*:normal --groupmap=usr:1,1:usr

Pertandingan pertama dalam daftar adalah yang digunakan. Anda harus menentukan semua
pemetaan pengguna menggunakan satu --peta pengguna opsi, dan/atau semua pemetaan grup Anda menggunakan
satu --peta grup .

Perhatikan bahwa nama pengirim untuk 0 pengguna dan grup tidak dikirimkan ke
penerima, jadi Anda harus mencocokkan nilai ini menggunakan 0, atau menggunakan nama di
efek pada sisi penerima (biasanya "root"). Semua lainnya DARI nama cocok dengan itu
digunakan di sisi pengirim. Semua UNTUK nama cocok dengan yang digunakan di sisi penerima.

Setiap ID yang tidak memiliki nama di sisi pengirim dianggap kosong
nama untuk tujuan pencocokan. Ini memungkinkan mereka untuk dicocokkan melalui "*" atau
menggunakan nama kosong. Contohnya:

--usermap=:tidak ada --groupmap=*:tidak ada

Ketika --numeric-id opsi digunakan, pengirim tidak mengirim nama apa pun, jadi semua
ID diperlakukan sebagai memiliki nama kosong. Ini berarti Anda perlu
tentukan numerik DARI nilai jika Anda ingin memetakan ID tanpa nama ini ke yang berbeda
nilai-nilai.

Untuk --peta pengguna opsi untuk memiliki efek apa pun, the -o (--pemilik) opsi harus digunakan
(atau tersirat), dan penerima harus dijalankan sebagai pengguna super (lihat juga
itu --palsu-super pilihan). Untuk --peta grup opsi untuk memiliki efek apa pun, the -g
(--kelompok) opsi harus digunakan (atau tersirat), dan penerima harus memiliki
izin untuk mengatur grup itu.

--chown=PENGGUNA:GROUP
Opsi ini memaksa semua file dimiliki oleh USER dengan grup GROUP. Ini adalah sebuah
antarmuka yang lebih sederhana daripada menggunakan --peta pengguna dan --peta grup langsung, tapi itu
diimplementasikan menggunakan opsi-opsi itu secara internal, jadi Anda tidak dapat mencampurnya. Jika salah satu
USER atau GROUP kosong, tidak akan ada pemetaan untuk pengguna/grup yang dihilangkan. Jika KELOMPOK
kosong, titik dua tambahan dapat dihilangkan, tetapi jika USER kosong, titik dua di depan
harus disediakan.

Jika Anda menentukan "--chown=foo:bar, ini persis sama dengan menentukan
"--usermap=*:foo --groupmap=*:bar", hanya lebih mudah.

--waktu habis=TIMEOUT
Opsi ini memungkinkan Anda untuk mengatur batas waktu I/O maksimum dalam hitungan detik. Jika tidak ada data
ditransfer untuk waktu yang ditentukan maka rsync akan keluar. Standarnya adalah 0, yang
berarti tidak ada batas waktu.

--waktu habis
Opsi ini memungkinkan Anda untuk mengatur berapa lama rsync akan menunggunya
koneksi ke daemon rsync untuk berhasil. Jika batas waktu tercapai, rsync keluar
dengan kesalahan.

--alamat
Secara default rsync akan mengikat ke alamat wildcard saat menghubungkan ke rsync
daemon. NS --alamat opsi memungkinkan Anda untuk menentukan alamat IP tertentu (atau
nama host) untuk mengikat. Lihat juga opsi ini di --daemon bagian modus.

--port=PELABUHAN
Ini menentukan nomor port TCP alternatif untuk digunakan daripada default 873.
Ini hanya diperlukan jika Anda menggunakan sintaks titik dua (::) untuk terhubung dengan
daemon rsync (karena sintaks URL memiliki cara untuk menentukan port sebagai bagian dari
URL-nya). Lihat juga opsi ini di --daemon bagian modus.

--sockopt
Opsi ini dapat memberikan kesenangan tanpa akhir bagi orang-orang yang suka menyetel sistem mereka ke
derajat yang paling tinggi. Anda dapat mengatur segala macam opsi soket yang dapat melakukan transfer
lebih cepat (atau lebih lambat!). Baca halaman manual untuk panggilan sistem setsockopt() untuk detailnya
pada beberapa opsi yang mungkin dapat Anda atur. Secara default tidak ada opsi soket khusus
diatur. Ini hanya memengaruhi koneksi soket langsung ke daemon rsync jarak jauh.
Opsi ini juga ada di --daemon bagian modus.

--memblokir-io
Ini memberitahu rsync untuk menggunakan pemblokiran I/O saat meluncurkan transport shell jarak jauh. Jika
shell jarak jauh adalah rsh atau remsh, default rsync menggunakan pemblokiran I/O,
jika tidak, defaultnya adalah menggunakan I/O non-pemblokiran. (Perhatikan bahwa ssh lebih suka
I/O tanpa pemblokiran.)

--outbuf=MODE
Ini mengatur mode buffering output. Modusnya bisa None (alias Unbuffered), Line,
atau Blok (alias Penuh). Anda dapat menentukan hanya satu huruf untuk mode,
dan gunakan huruf besar atau kecil.

Penggunaan utama dari opsi ini adalah untuk mengubah buffering Penuh ke buffering Line ketika
keluaran rsync akan menjadi file atau pipa.

-Saya, --itemize-perubahan
Meminta daftar terperinci sederhana dari perubahan yang dibuat untuk setiap file,
termasuk perubahan atribut. Ini persis sama dengan menentukan
--out-format='%i %n%L'. Jika Anda mengulangi opsi tersebut, file yang tidak diubah juga akan menjadi
output, tetapi hanya jika rsync penerima setidaknya versi 2.6.7 (Anda dapat menggunakan -vv
dengan versi rsync yang lebih lama, tetapi itu juga mengaktifkan output verbose lainnya
pesan).

Pelarian "%i" memiliki keluaran samar yang panjangnya 11 huruf. Format umum
itu seperti tali YXcstpoguax, Di mana Y digantikan oleh jenis pembaruan yang
selesai, X diganti dengan tipe file, dan huruf lainnya mewakili atribut
yang mungkin dihasilkan jika sedang dimodifikasi.

Jenis pembaruan yang menggantikan Y adalah sebagai berikut:

Hai A < berarti file sedang ditransfer ke host jarak jauh (dikirim).

Hai A > berarti bahwa file sedang ditransfer ke host lokal (diterima).

Hai A c berarti bahwa perubahan/penciptaan lokal sedang terjadi untuk item tersebut (seperti
pembuatan direktori atau perubahan symlink, dll.).

Hai A h berarti item tersebut adalah tautan keras ke item lain (memerlukan
--hard-link).

Hai A . berarti item tersebut tidak diperbarui (meskipun mungkin ada
atribut yang sedang dimodifikasi).

Hai A * berarti bahwa sisa area keluaran yang diperinci berisi pesan (mis
"menghapus").

Jenis file yang menggantikan X adalah: f untuk sebuah file, a d untuk sebuah direktori, dan L untuk
symlink, a D untuk perangkat, dan a S untuk file khusus (misalnya soket bernama dan
fifo).

Huruf-huruf lain dalam string di atas adalah huruf sebenarnya yang akan dikeluarkan jika
atribut terkait untuk item sedang diperbarui atau "." untuk tidak ada perubahan.
Tiga pengecualian untuk ini adalah: (1) item yang baru dibuat menggantikan setiap huruf dengan a
"+", (2) item identik menggantikan titik dengan spasi, dan (3) tidak diketahui
atribut menggantikan setiap huruf dengan "?" (ini bisa terjadi ketika berbicara dengan yang lebih tua
sinkronisasi).

Atribut yang terkait dengan setiap huruf adalah sebagai berikut:

Hai A c berarti bahwa file biasa memiliki checksum yang berbeda (memerlukan
--checksum) atau bahwa symlink, perangkat, atau file khusus memiliki nilai yang diubah.
Perhatikan bahwa jika Anda mengirim file ke rsync sebelum 3.0.1, perubahan ini
flag akan hadir hanya untuk file biasa yang berbeda checksum.

Hai A s berarti ukuran file biasa berbeda dan akan diperbarui oleh
transfer file

Hai A t berarti waktu modifikasi berbeda dan sedang diperbarui ke
nilai pengirim (memerlukan --waktu). Nilai alternatif dari T berarti bahwa
waktu modifikasi akan diatur ke waktu transfer, yang terjadi ketika a
file/symlink/perangkat diperbarui tanpa --waktu dan ketika symlink diubah
dan penerima tidak dapat mengatur waktunya. (Catatan: saat menggunakan rsync 3.0.0
klien, Anda mungkin melihat s bendera dikombinasikan dengan t bukannya yang tepat T
tandai kegagalan pengaturan waktu ini.)

Hai A p berarti izinnya berbeda dan sedang diperbarui ke
nilai pengirim (memerlukan --perm).

o Sebuah o berarti pemiliknya berbeda dan sedang diperbarui ke nilai pengirim
(membutuhkan --pemilik dan hak pengguna super).

Hai A g berarti grupnya berbeda dan sedang diperbarui ke nilai pengirim
(membutuhkan --kelompok dan wewenang untuk mengatur kelompok).

o Itu u slot dicadangkan untuk penggunaan di masa mendatang.

o Itu a berarti informasi ACL berubah.

o Itu x berarti bahwa informasi atribut yang diperluas berubah.

Satu output lain dimungkinkan: saat menghapus file, "%i" akan menampilkan string
"*menghapus" untuk setiap item yang sedang dihapus (dengan asumsi Anda berbicara dengan a
rsync yang cukup baru sehingga mencatat penghapusan alih-alih mengeluarkannya sebagai verbose
pesan).

--keluar-format=FORMAT
Ini memungkinkan Anda untuk menentukan dengan tepat apa yang dikeluarkan oleh klien rsync kepada pengguna pada a
basis per-update. Formatnya adalah string teks yang berisi karakter tunggal yang disematkan
urutan escape diawali dengan karakter persen (%). Format default dari
"%n%L" diasumsikan jika keduanya --info=nama or -v ditentukan (ini memberitahu Anda hanya
nama file dan, jika item adalah tautan, di mana ia menunjuk). Untuk daftar lengkap
kemungkinan karakter pelarian, lihat pengaturan "format log" di rsyncd.conf
halaman manual.

Menentukan --keluar-format pilihan menyiratkan --info=nama pilihan, yang akan
sebutkan setiap file, dir, dll. yang diperbarui secara signifikan (ditransfer
file, symlink/perangkat yang dibuat ulang, atau direktori yang disentuh). Selain itu, jika
itemize-changes escape (%i) disertakan dalam string (mis. jika
--itemize-perubahan opsi digunakan), pencatatan nama meningkat untuk menyebutkan apa saja
item yang diubah dengan cara apapun (selama sisi penerima setidaknya 2.6.4).
Lihat --itemize-perubahan pilihan untuk deskripsi output dari "%i".

Rsync akan menampilkan string out-format sebelum transfer file kecuali salah satu dari
pelarian transfer-statistik diminta, dalam hal ini logging dilakukan di
akhir transfer file. Kapan pencatatan terlambat ini berlaku dan --kemajuan
juga ditentukan, rsync juga akan menampilkan nama file yang sedang ditransfer
sebelum informasi kemajuannya (diikuti, tentu saja, oleh output format luar).

--file-log=FILE
Opsi ini menyebabkan rsync mencatat apa yang dilakukannya ke file. Ini mirip dengan
logging yang dilakukan daemon, tetapi dapat diminta untuk sisi klien dan/atau
sisi server dari transfer non-daemon. Jika ditentukan sebagai opsi klien, transfer
logging akan diaktifkan dengan format default "%i %n%L". Lihat
--format-file-log pilihan jika Anda ingin menimpa ini.

Berikut adalah contoh perintah yang meminta sisi jarak jauh untuk mencatat apa yang terjadi:

rsync -av --remote-option=--log-file=/tmp/rlog src/ tujuan/

Ini sangat berguna jika Anda perlu men-debug mengapa koneksi ditutup secara tidak terduga.

--format-file-log=FORMAT
Ini memungkinkan Anda untuk menentukan dengan tepat log per-pembaruan apa yang dimasukkan ke dalam file
ditentukan oleh --file-log opsi (yang juga harus ditentukan untuk opsi ini untuk
memiliki efek apapun). Jika Anda menentukan string kosong, file yang diperbarui tidak akan
disebutkan dalam file log. Untuk daftar karakter pelarian yang mungkin, lihat
pengaturan "format log" di halaman manual rsyncd.conf.

FORMAT default digunakan jika --file-log ditentukan dan opsi ini tidak adalah '%i
%n%L'.

--statistik
Ini memberitahu rsync untuk mencetak serangkaian statistik verbose pada transfer file,
memungkinkan Anda untuk mengetahui seberapa efektif algoritme transfer delta rsync untuk Anda
data. Opsi ini setara dengan --info=statistik2 jika digabungkan dengan 0 atau 1 -v
pilihan, atau --info=statistik3 jika digabungkan dengan 2 atau lebih -v Pilihan.

Statistik saat ini adalah sebagai berikut:

o Jumlah of arsip adalah jumlah semua "file" (dalam arti umum), yang
termasuk direktori, symlink, dll. Jumlah total akan diikuti oleh a
daftar jumlah berdasarkan jenis file (jika totalnya bukan nol). Misalnya: "(reg:
5, dir: 3, link: 2, dev: 1, special: 1)" daftar total untuk file biasa,
direktori, symlink, perangkat, dan file khusus. Jika ada yang bernilai 0, maka
benar-benar dihilangkan dari daftar.

o Jumlah of dibuat arsip adalah hitungan berapa banyak "file" (arti umum)
telah dibuat (sebagai lawan diperbarui). Jumlah total akan diikuti oleh
daftar jumlah berdasarkan jenis file (jika totalnya bukan nol).

o Jumlah of dihapus arsip adalah hitungan berapa banyak "file" (arti umum)
telah dibuat (sebagai lawan diperbarui). Jumlah total akan diikuti oleh
daftar jumlah berdasarkan jenis file (jika totalnya bukan nol). Perhatikan bahwa baris ini
hanya output jika penghapusan berlaku, dan hanya jika protokol 31 sedang
digunakan (default untuk rsync 3.1.x).

o Jumlah of reguler arsip ditransfer adalah jumlah file normal yang
diperbarui melalui algoritme transfer delta rsync, yang tidak menyertakan dir,
symlink, dll. Perhatikan bahwa rsync 3.1.0 menambahkan kata "reguler" ke dalam ini
heading.

o Total fillet ukuran adalah jumlah total semua ukuran file dalam transfer. Ini
tidak menghitung ukuran apa pun untuk direktori atau file khusus, tetapi termasuk
ukuran symlink.

o Total ditransfer fillet ukuran adalah jumlah total semua ukuran file hanya untuk
file yang ditransfer.

o Secara harfiah data adalah berapa banyak data pembaruan file yang tak tertandingi yang harus kami kirim ke
receiver untuk membuat ulang file yang diperbarui.

o Cocok data adalah berapa banyak data yang diterima penerima secara lokal saat membuat ulang
file yang diperbarui.

o File daftar ukuran adalah seberapa besar data daftar file saat pengirim mengirimkannya
penerima. Ini lebih kecil dari ukuran dalam memori untuk daftar file yang jatuh tempo
untuk mengompresi data duplikat saat rsync mengirim daftar.

o File daftar generasi waktu adalah jumlah detik yang dihabiskan pengirim
membuat daftar file. Ini membutuhkan rsync modern di sisi pengiriman
untuk ini hadir.

o File daftar transfer waktu adalah jumlah detik yang dihabiskan pengirim
mengirimkan daftar file ke penerima.

o Total byte mengirim adalah jumlah semua byte yang dikirim rsync dari
sisi klien ke sisi server.

o Total byte diterima adalah jumlah semua byte non-pesan yang rsync
diterima oleh sisi klien dari sisi server. Byte "Non-pesan" berarti
bahwa kami tidak menghitung byte untuk pesan verbose yang dikirim oleh server
kami, yang membuat statistik lebih konsisten.

-8, -8-bit-keluaran
Ini memberitahu rsync untuk membiarkan semua karakter bit tinggi tidak lolos dalam output sebagai gantinya
mencoba mengujinya untuk melihat apakah itu valid di lokal saat ini dan melarikan diri
yang tidak valid. Semua karakter kontrol (tetapi tidak pernah tab) selalu lolos,
terlepas dari pengaturan opsi ini.

Ungkapan escape yang dimulai pada 2.6.7 adalah untuk menampilkan garis miring terbalik literal (\) dan a
hash (#), diikuti dengan tepat 3 digit oktal. Misalnya, baris baru akan menampilkan
sebagai "\#012". Garis miring terbalik literal yang ada dalam nama file tidak diloloskan kecuali jika
diikuti oleh hash dan 3 digit (0-9).

-H, --dapat dibaca manusia
Keluarkan angka dalam format yang lebih mudah dibaca manusia. Ada 3 kemungkinan level: (1)
angka keluaran dengan pemisah antara setiap set 3 digit (baik koma atau a
titik, tergantung pada apakah titik desimal diwakili oleh titik atau koma);
(2) angka keluaran dalam satuan 1000 (dengan akhiran karakter untuk satuan yang lebih besar --
Lihat di bawah); (3) nomor keluaran dalam satuan 1024.

Standarnya adalah level 1 yang dapat dibaca manusia -h opsi meningkatkan level satu per satu.
Anda dapat menurunkan level ke 0 (untuk menampilkan angka sebagai angka murni) dengan menentukan
itu --tidak dapat dibaca manusia (--tidak-h) pilihan.

Huruf satuan yang ditambahkan pada level 2 dan 3 adalah: K (kilo), M (mega), G
(giga), atau T (tera). Misalnya, file 1234567-byte akan ditampilkan sebagai 1.23M in
level-2 (dengan asumsi bahwa titik adalah titik desimal lokal Anda).

Catatan kompatibilitas mundur: versi rsync sebelum 3.1.0 tidak mendukung
level 1 yang dapat dibaca manusia, dan mereka default ke level 0. Jadi, tentukan satu atau dua
-h opsi akan berperilaku dengan cara yang sebanding dalam versi lama dan baru selama
Anda tidak menentukan --tidak-h pilihan sebelum satu atau lebih -h pilihan. Lihat
--daftar-saja pilihan untuk satu perbedaan.

--sebagian
Secara default, rsync akan menghapus file yang ditransfer sebagian jika transfernya
terganggu. Dalam beberapa keadaan lebih diinginkan untuk tetap sebagian
file yang ditransfer. Menggunakan --sebagian opsi memberitahu rsync untuk menyimpan sebagian file
yang seharusnya membuat transfer selanjutnya dari sisa file lebih cepat.

--partial-dir=DIR
Cara yang lebih baik untuk menyimpan sebagian file daripada --sebagian pilihannya adalah untuk menentukan DIR
yang akan digunakan untuk menyimpan sebagian data (alih-alih menuliskannya ke
berkas tujuan). Pada transfer berikutnya, rsync akan menggunakan file yang ditemukan di direktori ini
sebagai data untuk mempercepat dimulainya kembali transfer dan kemudian menghapusnya setelah itu
melayani tujuannya.

Perhatikan bahwa jika --seluruh file ditentukan (atau tersirat), file direktori parsial apa pun yang
ditemukan untuk file yang sedang diperbarui hanya akan dihapus (karena rsync adalah
mengirim file tanpa menggunakan algoritme transfer delta rsync).

Rsync akan membuat DIR jika tidak ada (hanya direktori terakhir -- bukan keseluruhan
jalur). Ini membuatnya mudah untuk menggunakan jalur relatif (seperti
"--partial-dir=.rsync-partial") agar rsync membuat direktori parsial di
direktori file tujuan saat diperlukan, lalu hapus lagi saat sebagian
file dihapus.

Jika nilai parsial-dir bukan jalur absolut, rsync akan menambahkan aturan pengecualian di
akhir dari semua pengecualian Anda yang ada. Ini akan mencegah pengiriman apa pun
file parsial-dir yang mungkin ada di sisi pengirim, dan juga akan mencegah
penghapusan item parsial-dir sebelum waktunya di sisi penerima. Contoh: the
atas --partial-dir opsi akan menambahkan yang setara dengan "-f '-P .rsync-partial/'"Di
akhir aturan filter lainnya.

Jika Anda menyediakan aturan pengecualian Anda sendiri, Anda mungkin perlu menambahkan aturan Anda sendiri
kecualikan/sembunyikan/lindungi aturan untuk direktori parsial karena (1) aturan yang ditambahkan secara otomatis dapat
menjadi tidak efektif di akhir aturan Anda yang lain, atau (2) Anda mungkin ingin menggantinya
pilihan pengecualian rsync. Misalnya, jika Anda ingin melakukan pembersihan rsync
sebagian-dirs sisa yang mungkin tergeletak di sekitar, Anda harus menentukan --hapus-setelah
dan tambahkan aturan filter "risiko", mis -f 'R .rsync-partial/'. (Hindari pemakaian
--hapus-sebelumnya or --hapus-selama kecuali Anda tidak perlu rsync untuk menggunakan salah satu dari
data parsial-dir yang tersisa selama proses saat ini.)

PENTING: --partial-dir tidak boleh ditulis oleh pengguna lain atau itu adalah a
risiko keamanan. Misalnya HINDARI "/ Tmp".

Anda juga dapat mengatur nilai parsial-dir variabel lingkungan RSYNC_PARTIAL_DIR.
Mengatur ini di lingkungan tidak memaksa --sebagian untuk diaktifkan, melainkan
itu memengaruhi ke mana sebagian file pergi ketika --sebagian ditentukan. Contohnya,
bukannya menggunakan --partial-dir=.rsync-tmp bersama dengan --kemajuan, Anda dapat mengatur
RSYNC_PARTIAL_DIR=.rsync-tmp di lingkungan Anda dan kemudian gunakan saja -P pilihan untuk
aktifkan penggunaan direktori .rsync-tmp untuk transfer parsial. Satu-satunya saat itu
itu --sebagian opsi tidak mencari nilai lingkungan ini adalah (1) ketika
--di tempat telah ditentukan (sejak --di tempat konflik dengan --partial-dir), dan (2)
ketika --delay-pembaruan ditentukan (lihat di bawah).

Untuk keperluan pengaturan "opsi penolakan" daemon-config, --partial-dir
tidak tidak berarti --sebagian. Hal ini dimaksudkan agar penolakan --sebagian pilihan bisa
digunakan untuk melarang penimpaan file tujuan dengan transfer sebagian,
sambil tetap membiarkan idiom yang lebih aman disediakan oleh --partial-dir.

--delay-pembaruan
Opsi ini menempatkan file sementara dari setiap file yang diperbarui ke dalam direktori penyimpanan
sampai akhir transfer, pada saat semua file diganti namanya menjadi tempatnya
dalam suksesi yang cepat. Ini mencoba membuat pembaruan file sedikit lebih banyak
atom. Secara default, file ditempatkan ke dalam direktori bernama ".~tmp~" di masing-masing
direktori tujuan file, tetapi jika Anda telah menentukan --partial-dir pilihan,
direktori itu akan digunakan sebagai gantinya. Lihat komentar di --partial-dir bagian
untuk diskusi tentang bagaimana direktori ".~tmp~" ini akan dikeluarkan dari transfer, dan
apa yang dapat Anda lakukan jika Anda ingin rsync membersihkan direktori lama ".~tmp~" yang mungkin berbohong
sekitar. Konflik dengan --di tempat dan --menambahkan.

Opsi ini menggunakan lebih banyak memori di sisi penerima (satu bit per file yang ditransfer)
dan juga membutuhkan ruang disk kosong yang cukup di sisi penerima untuk menampung
salinan tambahan dari semua file yang diperbarui. Perhatikan juga bahwa Anda tidak boleh menggunakan
jalan mutlak menuju --partial-dir kecuali (1) tidak ada kemungkinan salah satu file di
transfer memiliki nama yang sama (karena semua file yang diperbarui akan dimasukkan ke dalam a
direktori tunggal jika jalurnya absolut) dan (2) tidak ada titik pemasangan di
hierarki (karena pembaruan yang tertunda akan gagal jika tidak dapat diubah namanya menjadi
tempat).

Lihat juga skrip perl "atomic-rsync" di subdir "dukungan" untuk pembaruan
algoritma yang bahkan lebih atom (menggunakan --link-tujuan dan hierarki paralel dari
file).

-M, --prune-kosong-dirs
Opsi ini memberitahu penerima rsync untuk membuang direktori kosong dari
file-list, termasuk direktori bersarang yang tidak memiliki turunan non-direktori. Ini
berguna untuk menghindari pembuatan sekumpulan direktori yang tidak berguna saat
mengirim rsync secara rekursif memindai hierarki file menggunakan
sertakan/kecualikan/filter aturan.

Perhatikan bahwa penggunaan aturan transfer, seperti --min-ukuran pilihan, tidak mempengaruhi
apa yang masuk ke daftar file, dan dengan demikian tidak membiarkan direktori kosong, bahkan jika
tidak ada file dalam direktori yang cocok dengan aturan transfer.

Karena daftar file sebenarnya sedang dipangkas, opsi ini juga memengaruhi apa yang
direktori dihapus saat penghapusan aktif. Namun, perlu diingat bahwa
file dan direktori yang dikecualikan dapat mencegah item yang ada dihapus karena
sebuah mengecualikan baik menyembunyikan file sumber dan melindungi file tujuan. Lihat
opsi aturan filter yang mudah rusak untuk cara menghindarinya.

Anda dapat mencegah pemangkasan direktori kosong tertentu dari daftar file dengan:
menggunakan filter "proteksi" global. Misalnya, opsi ini akan memastikan bahwa
direktori "emptydir" disimpan dalam daftar file:

--filter 'melindungi emptydir/'

Berikut adalah contoh yang menyalin semua file .pdf dalam hierarki, hanya membuat
direktori tujuan yang diperlukan untuk menyimpan file .pdf, dan memastikan bahwa setiap
file dan direktori yang berlebihan di tujuan dihapus (perhatikan sembunyikan
filter non-direktori yang digunakan alih-alih pengecualian):

rsync -avm --del --include='*.pdf' -f 'sembunyikan,! */' src/ tujuan

Jika Anda tidak ingin menghapus file tujuan yang berlebihan, semakin terhormat waktunya
pilihan dari "--termasuk='*/' --tidak termasuk='*'" akan bekerja dengan baik di tempat
hide-filter (jika itu lebih alami bagi Anda).

--kemajuan
Opsi ini memberitahu rsync untuk mencetak informasi yang menunjukkan kemajuan transfer.
Ini memberi pengguna yang bosan sesuatu untuk ditonton. Dengan rsync modern, ini sama
sebagai menentukan --info=flist2,nama,progres, tetapi pengaturan apa pun yang disediakan pengguna untuk itu
flag info diutamakan (misalnya "--info=flist0 --progress").

Saat rsync mentransfer file biasa, itu memperbarui garis kemajuan yang terlihat
seperti ini:

782448 63% 110.64 kB/dtk 0:00:04

Dalam contoh ini, penerima telah merekonstruksi 782448 byte atau 63% dari pengirim
file, yang sedang direkonstruksi pada kecepatan 110.64 kilobyte per detik, dan
transfer akan selesai dalam 4 detik jika kecepatan saat ini dipertahankan hingga
akhir.

Statistik ini dapat menyesatkan jika algoritma transfer delta rsync sedang digunakan.
Misalnya, jika file pengirim terdiri dari file dasar diikuti oleh tambahan
data, tingkat yang dilaporkan mungkin akan turun drastis ketika penerima mencapai
data literal, dan transfer mungkin akan memakan waktu lebih lama untuk diselesaikan daripada
penerima memperkirakan saat sedang menyelesaikan bagian file yang cocok.

Ketika transfer file selesai, rsync menggantikan baris kemajuan dengan ringkasan
garis yang terlihat seperti ini:

1,238,099 100% 146.38kB/s 0:00:08 (xfr#5, to-chk=169/396)

Dalam contoh ini, panjang file adalah 1,238,099 byte, kecepatan rata-rata
transfer untuk seluruh file adalah 146.38 kilobyte per detik selama 8 detik itu
dibutuhkan untuk menyelesaikannya, itu adalah transfer ke-5 dari file biasa selama ini
rsync, dan ada 169 file lagi untuk diperiksa penerima (untuk melihat apakah
mereka up-to-date atau tidak) tersisa dari 396 total file dalam daftar file.

Dalam pemindaian rekursi tambahan, rsync tidak akan mengetahui jumlah total file dalam
daftar file hingga mencapai akhir pemindaian, tetapi sejak mulai mentransfer
file selama pemindaian, itu akan menampilkan baris dengan teks "ir-chk" (untuk
pemeriksaan rekursi tambahan) alih-alih "to-chk" sampai titik yang diketahuinya
ukuran penuh dari daftar, di mana ia akan beralih menggunakan "to-chk". Dengan demikian,
melihat "ir-chk" memberi tahu Anda bahwa jumlah total file dalam daftar file adalah
masih akan meningkat (dan setiap kali itu terjadi, jumlah file yang tersisa untuk diperiksa
akan bertambah dengan jumlah file yang ditambahkan ke daftar).

-P -P pilihan setara dengan --sebagian --kemajuan. Tujuannya adalah untuk membuatnya
jauh lebih mudah untuk menentukan dua opsi ini untuk transfer panjang yang mungkin
terputus.

Ada juga --info=kemajuan2 opsi yang menampilkan statistik berdasarkan keseluruhan
transfer, bukan file individual. Gunakan bendera ini tanpa mengeluarkan a
nama file (misalnya hindari -v atau sebutkan --info=nama0 jika Anda ingin melihat bagaimana transfernya
lakukan tanpa menggulir layar dengan banyak nama. (Anda tidak perlu
tentukan --kemajuan pilihan untuk digunakan --info=kemajuan2.)

--file-kata sandi=FILE
Opsi ini memungkinkan Anda memberikan kata sandi untuk mengakses daemon rsync melalui a
file atau melalui input standar jika FILE is -. File harus berisi hanya kata sandi
pada baris pertama (semua baris lainnya diabaikan). Rsync akan keluar dengan kesalahan jika
FILE dapat dibaca dunia atau jika perintah rsync yang dijalankan root menemukan file yang bukan milik root.

Opsi ini tidak menyediakan kata sandi untuk transport shell jarak jauh seperti ssh; ke
pelajari cara melakukannya, lihat dokumentasi shell jarak jauh. Saat mengakses sebuah
rsync daemon menggunakan shell jarak jauh sebagai transportasi, opsi ini hanya muncul
efek setelah shell jarak jauh menyelesaikan otentikasinya (yaitu jika Anda juga
menentukan kata sandi dalam file konfigurasi daemon).

--daftar-saja
Opsi ini akan menyebabkan file sumber dicantumkan alih-alih ditransfer. Ini
opsi disimpulkan jika ada argumen sumber tunggal dan tidak ada tujuan yang ditentukan, jadi
kegunaan utamanya adalah: (1) untuk mengubah perintah salin yang menyertakan argumen tujuan menjadi
perintah daftar file, atau (2) untuk dapat menentukan lebih dari satu argumen sumber
(catatan: pastikan untuk menyertakan tujuan). Perhatian: perlu diingat bahwa sumber
arg dengan wild-card diperluas oleh shell menjadi beberapa arg, jadi tidak pernah
aman untuk mencoba membuat daftar argumen seperti itu tanpa menggunakan opsi ini. Sebagai contoh:

rsync -av --daftar-hanya foo* dest/

Dimulai dengan rsync 3.1.0, ukuran yang dihasilkan oleh --daftar-saja dipengaruhi oleh
--dapat dibaca manusia pilihan. Secara default mereka akan berisi pemisah digit, tetapi lebih tinggi
tingkat keterbacaan akan menampilkan ukuran dengan sufiks unit. Perhatikan juga bahwa
lebar kolom untuk output ukuran telah meningkat dari 11 menjadi 14 karakter untuk semua
tingkat yang dapat dibaca manusia. Menggunakan --tidak-h jika Anda hanya ingin angka dalam ukuran, dan
lebar kolom lama 11 karakter.

Catatan kompatibilitas: saat meminta daftar file jarak jauh dari rsync yang
adalah versi 2.6.3 atau lebih lama, Anda mungkin mengalami kesalahan jika meminta a
daftar non-rekursif. Ini karena daftar file menyiratkan: --dir Option
dg --rekursif, dan rsync yang lebih lama tidak memiliki opsi itu. Untuk menghindari masalah ini,
atau tentukan --tidak-dir opsi (jika Anda tidak perlu memperluas direktori
konten), atau aktifkan rekursi dan kecualikan konten subdirektori: -r
--tidak termasuk='/*/*'.

--bwlimit=NILAI
Opsi ini memungkinkan Anda untuk menentukan kecepatan transfer maksimum untuk data yang dikirim
soket, ditentukan dalam satuan per detik. Nilai RATE dapat diakhiri dengan a
string untuk menunjukkan pengali ukuran, dan mungkin berupa nilai pecahan (mis
"--bwlimit=1.5m"). Jika tidak ada sufiks yang ditentukan, nilainya akan dianggap dalam
unit 1024 byte (seolah-olah "K" atau "KiB" telah ditambahkan). Lihat --maks-ukuran
pilihan untuk deskripsi semua sufiks yang tersedia. Nilai nol menentukan
tidak terbatas.

Untuk alasan kompatibilitas mundur, batas tarif akan dibulatkan ke yang terdekat
Satuan KiB, jadi tidak ada kecepatan yang lebih kecil dari 1024 byte per detik yang dimungkinkan.

Rsync menulis data melalui soket dalam blok, dan opsi ini membatasi ukuran
dari blok yang ditulis rsync, dan mencoba untuk menjaga kecepatan transfer rata-rata pada
batas yang diminta. Beberapa "burstiness" mungkin terlihat di mana rsync menulis blok dari
data dan kemudian tidur untuk membawa tingkat rata-rata sesuai.

Karena buffering data internal, --kemajuan pilihan mungkin tidak akurat
refleksi tentang seberapa cepat data dikirim. Ini karena beberapa file dapat ditampilkan
sebagai dikirim dengan cepat ketika data disangga dengan cepat, sementara yang lain dapat muncul
sebagai sangat lambat ketika pembilasan buffer output terjadi. Ini dapat diperbaiki dalam
versi masa depan.

--tulis-batch=FILE
Rekam file yang nantinya dapat diterapkan ke tujuan lain yang identik dengan
--baca-batch. Lihat bagian "BATCH MODE" untuk detailnya, dan juga
--hanya-tulis-batch .

--hanya-tulis-batch=FILE
Bekerja seperti --tulis-batch, kecuali bahwa tidak ada pembaruan yang dilakukan pada sistem tujuan
saat membuat batch. Ini memungkinkan Anda mengangkut perubahan ke tujuan
sistem melalui beberapa cara lain dan kemudian menerapkan perubahan melalui --baca-batch.

Perhatikan bahwa Anda dapat merasa bebas untuk menulis kumpulan secara langsung ke beberapa media portabel: jika
media ini terisi penuh sebelum akhir transfer, Anda dapat mengajukan permohonan
transfer sebagian ke tujuan dan ulangi seluruh proses untuk mendapatkan
sisa perubahan (selama Anda tidak keberatan dengan tujuan yang diperbarui sebagian
sistem saat siklus multi-pembaruan sedang terjadi).

Perhatikan juga bahwa Anda hanya menghemat bandwidth saat mendorong perubahan ke sistem jarak jauh
karena ini memungkinkan data batch dialihkan dari pengirim ke batch
file tanpa harus mengalir melalui kabel ke penerima (saat menarik, pengirim
jarak jauh, dan karenanya tidak dapat menulis kumpulan).

--baca-batch=FILE
Terapkan semua perubahan yang disimpan dalam FILE, file yang sebelumnya dibuat oleh
--tulis-batch. Jika FILE is -, data batch akan dibaca dari input standar. Lihat
bagian "BATCH MODE" untuk detailnya.

--protokol=NUM
Paksa versi protokol yang lebih lama untuk digunakan. Ini berguna untuk membuat batch
file yang kompatibel dengan versi rsync yang lebih lama. Misalnya, jika rsync
2.6.4 sedang digunakan dengan --tulis-batch opsi, tetapi rsync 2.6.3 adalah yang akan terjadi
digunakan untuk menjalankan --baca-batch opsi, Anda harus menggunakan "--protocol=28" saat membuat
file batch untuk memaksa versi protokol yang lebih lama untuk digunakan dalam file batch
(dengan asumsi Anda tidak dapat memutakhirkan rsync pada sistem membaca).

--ikonv=CONVERT_SPEC
Rsync dapat mengonversi nama file antar set karakter menggunakan opsi ini. Menggunakan sebuah
CONVERT_SPEC dari "." memberitahu rsync untuk mencari set karakter default melalui lokal
pengaturan. Sebagai alternatif, Anda dapat sepenuhnya menentukan konversi apa yang harus dilakukan dengan memberikan a
charset lokal dan jarak jauh dipisahkan dengan koma dalam urutan --iconv=LOKAL,JAUH JAUH,
misalnya --ikonv=utf8,iso88591. Pesanan ini memastikan bahwa opsi akan tetap sama
apakah Anda mendorong atau menarik file. Akhirnya, Anda dapat menentukan keduanya
--tidak ada ikonv atau CONVERT_SPEC dari "-" untuk menonaktifkan konversi apa pun. Standarnya
pengaturan opsi ini adalah khusus situs, dan juga dapat dipengaruhi melalui
Variabel lingkungan RSYNC_ICONV.

Untuk daftar nama charset apa yang didukung perpustakaan iconv lokal Anda, Anda dapat menjalankan
"iconv --daftar".

Jika Anda menentukan --melindungi-args pilihan (-s), rsync akan menerjemahkan nama file
Anda tentukan pada baris perintah yang sedang dikirim ke host jarak jauh. Lihat juga
itu --file-dari .

Perhatikan bahwa rsync tidak melakukan konversi nama apa pun dalam file filter (termasuk
menyertakan/mengecualikan file). Terserah Anda untuk memastikan bahwa Anda menentukan pencocokan
aturan yang bisa cocok di kedua sisi transfer. Misalnya, Anda dapat menentukan
aturan tambahan sertakan/kecualikan jika ada perbedaan nama file di kedua sisi yang
perlu dipertanggungjawabkan.

Ketika Anda melewati sebuah --ikonv opsi untuk daemon rsync yang mengizinkannya, daemon menggunakan
charset yang ditentukan dalam parameter konfigurasi "charset" terlepas dari
charset jarak jauh yang benar-benar Anda lewati. Dengan demikian, Anda mungkin merasa bebas untuk menentukan hanya
charset lokal untuk transfer daemon (mis --ikonv=utf8).

-4, --ipv4 or -6, --ipv6
Memberitahu rsync untuk memilih IPv4/IPv6 saat membuat soket. Ini hanya mempengaruhi soket
bahwa rsync memiliki kontrol langsung, seperti soket keluar saat langsung
menghubungi daemon rsync. Lihat juga opsi ini di --daemon bagian modus.

Jika rsync dipenuhi tanpa dukungan untuk IPv6, --ipv6 pilihan tidak akan memiliki
efek. Itu --Versi: kapan output akan memberi tahu Anda jika ini masalahnya.

--checksum-seed=NUM
Setel benih checksum ke bilangan bulat NUM. Benih checksum 4 byte ini termasuk dalam
setiap blok dan perhitungan checksum file MD4 (checksum file MD5 yang lebih modern
tidak menggunakan biji). Secara default, benih checksum dihasilkan oleh server dan
default ke waktu saat ini() . Opsi ini digunakan untuk mengatur checksum tertentu
seed, yang berguna untuk aplikasi yang menginginkan checksum blok berulang, atau di
kasus di mana pengguna menginginkan benih checksum yang lebih acak. Menyetel NUM ke 0 penyebab
rsync untuk menggunakan default time() untuk seed checksum.

DAEMON PILIHAN

Opsi yang diizinkan saat memulai daemon rsync adalah sebagai berikut:

--daemon
Ini memberitahu rsync bahwa itu akan dijalankan sebagai daemon. Daemon yang Anda mulai jalankan mungkin
diakses menggunakan klien rsync menggunakan tuan rumah::modul or rsync://host/modul/
sintaks.

Jika input standar adalah soket, maka rsync akan menganggapnya dijalankan melalui
inetd, jika tidak maka akan terlepas dari terminal saat ini dan menjadi latar belakang
daemon. Daemon akan membaca file konfigurasi (rsyncd.conf) pada setiap koneksi yang dibuat oleh
klien dan menanggapi permintaan yang sesuai. Lihat rsyncd.conf(5) halaman manual untuk
keterangan lebih lanjut.

--alamat
Secara default rsync akan mengikat ke alamat wildcard saat dijalankan sebagai daemon dengan
--daemon pilihan. Itu --alamat opsi memungkinkan Anda untuk menentukan alamat IP tertentu
(atau nama host) untuk diikat. Ini memungkinkan hosting virtual bersama dengan
itu --konfigurasi pilihan. Lihat juga opsi global "alamat" di rsyncd.conf
halaman manual.

--bwlimit=NILAI
Opsi ini memungkinkan Anda untuk menentukan kecepatan transfer maksimum untuk data daemon
mengirimkan melalui soket. Klien masih dapat menentukan yang lebih kecil --batas bw nilai, tapi
tidak ada nilai yang lebih besar akan diizinkan. Lihat versi klien dari opsi ini (di atas) untuk
beberapa detail tambahan.

--config=FILE
Ini menentukan file konfigurasi alternatif dari default. Ini hanya relevan
ketika --daemon ditentukan. Standarnya adalah /etc/rsyncd.conf kecuali daemonnya adalah
menjalankan program shell jarak jauh dan pengguna jarak jauh bukanlah pengguna super; di dalam
dalam hal ini defaultnya adalah rsyncd.conf di direktori saat ini (biasanya $HOME).

-M, --dparam=GANTI
Opsi ini dapat digunakan untuk menyetel parameter daemon-config saat memulai rsync di
modus daemon. Ini setara dengan menambahkan parameter di akhir global
pengaturan sebelum definisi modul pertama. Nama parameter dapat berupa
ditentukan tanpa spasi, jika Anda menginginkannya. Contohnya:

rsync --daemon -M pidfile=/path/rsync.pid

--tidak-melepaskan
Saat dijalankan sebagai daemon, opsi ini menginstruksikan rsync untuk tidak melepaskan dirinya sendiri dan
menjadi proses latar belakang. Opsi ini diperlukan saat menjalankan sebagai layanan di
Cygwin, dan mungkin juga berguna ketika rsync diawasi oleh program seperti:
alat daemon atau AIX System Sumber pengawas. --tidak-melepaskan juga direkomendasikan
ketika rsync dijalankan di bawah debugger. Opsi ini tidak berpengaruh jika rsync dijalankan dari
inetd atau sshd.

--port=PELABUHAN
Ini menentukan nomor port TCP alternatif untuk daemon untuk mendengarkan daripada
default 873. Lihat juga opsi global "port" di halaman manual rsyncd.conf.

--file-log=FILE
Opsi ini memberi tahu daemon rsync untuk menggunakan nama file log yang diberikan alih-alih menggunakan
pengaturan "file log" di file konfigurasi.

--format-file-log=FORMAT
Opsi ini memberi tahu daemon rsync untuk menggunakan string FORMAT yang diberikan alih-alih menggunakan
pengaturan "format log" di file konfigurasi. Ini juga memungkinkan "transfer logging"
kecuali string kosong, dalam hal ini transfer logging dimatikan.

--sockopt
Ini mengesampingkan stopkontak Pilihan pengaturan di file rsyncd.conf dan memiliki hal yang sama
sintaks.

-di, --bertele-tele
Opsi ini meningkatkan jumlah informasi yang dicatat daemon selama pengaktifannya
fase. Setelah klien terhubung, tingkat verbositas daemon akan dikontrol
oleh opsi yang digunakan klien dan pengaturan "maks verbositas" di modul
bagian konfigurasi.

-4, --ipv4 or -6, --ipv6
Memberitahu rsync untuk memilih IPv4/IPv6 saat membuat soket masuk yang rsync
daemon akan digunakan untuk mendengarkan koneksi. Salah satu opsi ini mungkin diperlukan dalam
versi lama Linux untuk mengatasi bug IPv6 di kernel (jika Anda melihat
kesalahan "alamat sudah digunakan" ketika tidak ada yang menggunakan port, coba tentukan
--ipv6 or --ipv4 saat memulai daemon).

Jika rsync dipenuhi tanpa dukungan untuk IPv6, --ipv6 pilihan tidak akan memiliki
efek. Itu --Versi: kapan output akan memberi tahu Anda jika ini masalahnya.

-H, --membantu
Ketika ditentukan setelah --daemon, cetak halaman bantuan singkat yang menjelaskan opsi
tersedia untuk memulai daemon rsync.

FILTER ATURAN

Aturan filter memungkinkan pemilihan file yang fleksibel untuk ditransfer (disertakan) dan
file mana yang harus dilewati (dikecualikan). Aturan baik secara langsung menentukan pola include/exclude
atau mereka menentukan cara untuk memperoleh lebih banyak pola penyertaan/pengecualian (misalnya untuk membacanya dari a
file).

Saat daftar file/direktori yang akan ditransfer dibuat, rsync memeriksa setiap nama untuk menjadi
ditransfer terhadap daftar pola sertakan/kecualikan secara bergantian, dan pencocokan pertama
pola ditindaklanjuti: jika itu adalah pola pengecualian, maka file itu dilewati; jika itu adalah
sertakan pola maka nama file itu tidak dilewati; jika tidak ada pola yang cocok ditemukan, maka
nama file tidak dilewati.

Rsync membuat daftar aturan filter yang diurutkan seperti yang ditentukan pada baris perintah. Saring
aturan memiliki sintaks berikut:

ATURAN [PATTERN_OR_FILENAME]
ATURAN,MODIFIER [PATTERN_OR_FILENAME]

Anda memiliki pilihan untuk menggunakan nama RULE pendek atau panjang, seperti yang dijelaskan di bawah ini. Jika kamu
gunakan aturan singkat, ',' memisahkan ATURAN dari MODIFIERS adalah opsional. NS
POLA atau NAMA FILE yang mengikuti (bila ada) harus muncul setelah spasi tunggal atau
garis bawah (_). Berikut adalah awalan aturan yang tersedia:

mengecualikan, - menentukan pola pengecualian.
termasuk, + menentukan pola include.
menggabungkan, . menentukan file gabungan untuk membaca aturan lainnya.
penggabungan kotoran, : menentukan file gabungan per direktori.
menyembunyikan, H menentukan pola untuk menyembunyikan file dari transfer.
menunjukkan, S file yang cocok dengan pola tidak disembunyikan.
melindungi, P menentukan pola untuk melindungi file dari penghapusan.
risiko, R file yang cocok dengan pola tidak dilindungi.
bersih, ! menghapus daftar sertakan/kecualikan saat ini (tidak memerlukan argumen)

Saat aturan sedang dibaca dari file, baris kosong diabaikan, begitu juga baris komentar yang
mulai dengan "#".

Perhatikan bahwa --termasuk/--mengecualikan opsi baris perintah tidak memungkinkan berbagai aturan
parsing seperti dijelaskan di atas -- mereka hanya mengizinkan spesifikasi include/exclude
pola ditambah "!" token untuk menghapus daftar (dan penguraian komentar normal ketika aturannya
membaca dari file). Jika suatu pola tidak dimulai dengan "- " (tanda hubung, spasi) atau "+" (plus,
spasi), maka aturan tersebut akan ditafsirkan sebagai jika "+" (untuk opsi penyertaan) atau "- " (untuk
opsi pengecualian) diawali dengan string. A --Saring pilihan, di sisi lain,
harus selalu berisi nama aturan pendek atau panjang di awal aturan.

Perhatikan juga bahwa --Saring, --termasuk, dan --mengecualikan opsi masing-masing mengambil satu aturan/pola.
Untuk menambahkan beberapa, Anda dapat mengulangi opsi pada baris perintah, gunakan file gabungan
sintaks dari --Saring opsi, atau opsi --termasuk-dari/--kecuali-dari Pilihan.

TERMASUK TIDAK TERMASUK POLA ATURAN

Anda dapat menyertakan dan mengecualikan file dengan menentukan pola menggunakan filter "+", "-", dll.
aturan (seperti yang diperkenalkan di bagian ATURAN FILTER di atas). Aturan sertakan/kecualikan masing-masing
tentukan pola yang cocok dengan nama file yang akan dibuat
ditransfer. Pola-pola ini dapat mengambil beberapa bentuk:

o jika polanya dimulai dengan a / maka pola tersebut ditambatkan ke tempat tertentu di
hierarki file, jika tidak maka akan dicocokkan dengan akhir nama path. Ini
mirip dengan ^ utama dalam ekspresi reguler. Jadi "/ foo" akan cocok dengan nama
dari "foo" baik di "akar transfer" (untuk aturan global) atau di
direktori merge-file (untuk aturan per-direktori). Seorang "foo" yang tidak memenuhi syarat akan
cocokkan nama "foo" di mana saja di pohon karena algoritme diterapkan
secara rekursif dari atas ke bawah; itu berperilaku seolah-olah setiap komponen jalur mendapat belokan di
menjadi akhir dari nama file. Bahkan "sub/foo" yang tidak terikat akan cocok dengan apa pun
titik dalam hierarki di mana "foo" ditemukan dalam direktori bernama "sub". Lihat
bagian tentang ANCHORING INCLUDE/EXCLUDE POLA untuk diskusi lengkap tentang bagaimana
tentukan pola yang cocok dengan akar transfer.

o jika pola diakhiri dengan / maka itu hanya akan cocok dengan direktori, bukan reguler
file, symlink, atau perangkat.

o rsync memilih antara melakukan pencocokan string sederhana dan pencocokan karakter pengganti dengan mencentang
jika polanya berisi salah satu dari tiga karakter wildcard ini: '*', '?', dan '[' .

oa '*' cocok dengan komponen jalur apa pun, tetapi berhenti di garis miring.

o gunakan '**' untuk mencocokkan apa pun, termasuk garis miring.

oh '?' cocok dengan karakter apa pun kecuali garis miring (/).

oa '[' memperkenalkan kelas karakter, seperti [az] atau [[:alpha:]].

o dalam pola wildcard, garis miring terbalik dapat digunakan untuk menghindari karakter wildcard, tetapi
itu dicocokkan secara harfiah ketika tidak ada wildcard yang ada. Artinya ada
tingkat ekstra penghapusan garis miring terbalik ketika suatu pola berisi karakter wildcard
dibandingkan dengan pola yang tidak memilikinya. misalnya jika Anda menambahkan wildcard ke "foo\bar"
(yang cocok dengan garis miring terbalik) Anda harus menggunakan "foo\\bar*" untuk menghindari "\b"
menjadi hanya "b".

o jika polanya berisi / (tidak termasuk tanda /) atau "**", maka itu adalah
dicocokkan dengan nama path lengkap, termasuk direktori utama mana pun. jika
pola tidak mengandung / atau "**", maka hanya cocok dengan final
komponen nama file. (Ingat bahwa algoritme diterapkan secara rekursif sehingga
"nama file lengkap" sebenarnya dapat berupa bagian jalur mana pun dari direktori awal
ke bawah.)

oa trailing "dir_name/***" akan cocok dengan kedua direktori (seolah-olah "dir_name/" telah
ditentukan) dan semua yang ada di direktori (seolah-olah "dir_name/**" telah
ditentukan). Perilaku ini telah ditambahkan di versi 2.6.7.

Perhatikan bahwa, saat menggunakan --rekursif (-r) opsi (yang tersirat oleh -a), setiap
subkomponen dari setiap jalur dikunjungi dari atas ke bawah, jadi sertakan/kecualikan pola get
diterapkan secara rekursif ke setiap nama lengkap subkomponen (misalnya untuk menyertakan "/foo/bar/baz"
subkomponen "/foo" dan "/foo/bar" tidak boleh dikecualikan). Pola pengecualian sebenarnya
hubungan arus pendek tahap traversal direktori saat rsync menemukan file yang akan dikirim. Jika sebuah
pola mengecualikan direktori induk tertentu, itu dapat membuat pola penyertaan yang lebih dalam
tidak efektif karena rsync tidak turun melalui bagian hierarki yang dikecualikan itu.
Ini sangat penting saat menggunakan aturan '*' di akhir. Misalnya, ini tidak akan
kerja:

+ /some/path/file-ini-tidak-akan-ditemukan
+ /file-disertakan
🇧🇷

Ini gagal karena direktori induk "beberapa" dikecualikan oleh aturan '*', jadi rsync tidak pernah
mengunjungi salah satu file di direktori "some" atau "some/path". Salah satu solusinya adalah bertanya
untuk semua direktori dalam hierarki untuk dimasukkan dengan menggunakan satu aturan: "+ */" ​​(letakkan
di suatu tempat sebelum aturan "- *"), dan mungkin menggunakan --prune-kosong-dirs pilihan. Lain
solusinya adalah menambahkan aturan penyertaan khusus untuk semua direktori induk yang perlu dikunjungi.
Misalnya, seperangkat aturan ini berfungsi dengan baik:

+ /beberapa/
+ /beberapa/jalan/
+ /some/path/file-ini-ditemukan
+ /file-juga-termasuk
🇧🇷

Berikut adalah beberapa contoh pencocokan pengecualian/penyertaan:

o "- *.o" akan mengecualikan semua nama yang cocok dengan *.o

o "- /foo" akan mengecualikan file (atau direktori) bernama foo di transfer-root
direktori

o "- foo/" akan mengecualikan direktori apa pun yang bernama foo

o "- /foo/*/bar" akan mengecualikan file apa pun bernama bar yang berada pada dua tingkat di bawah a
direktori bernama foo di direktori transfer-root

o "- /foo/**/bar" akan mengecualikan file apa pun yang bernama bar dua tingkat atau lebih di bawah a
direktori bernama foo di direktori transfer-root

o Kombinasi "+ */", "+ *.c", dan "- *" akan mencakup semua direktori dan C
file sumber tetapi tidak ada yang lain (lihat juga --prune-kosong-dirs opsional)

o Kombinasi "+ foo/", "+ foo/bar.c", dan "- *" hanya akan menyertakan foo
direktori dan foo/bar.c (direktori foo harus disertakan secara eksplisit atau akan
dikecualikan oleh "*")

Pengubah berikut diterima setelah "+" atau "-":

Hai A / menentukan bahwa aturan include/exclude harus dicocokkan dengan absolute
nama jalur item saat ini. Sebagai contoh, "-/ / etc / passwd" akan mengecualikan
file passwd setiap kali transfer mengirim file dari "/ Etc" direktori, dan
"-/ subdir/foo" akan selalu mengecualikan "foo" ketika berada di dir bernama "subdir", bahkan
jika "foo" adalah akar dari transfer saat ini.

Hai A ! menentukan bahwa penyertaan/pengecualian akan berlaku jika pola gagal
cocok. Misalnya, "-! */" akan mengecualikan semua non-direktori.

Hai A C digunakan untuk menunjukkan bahwa semua aturan pengecualian CVS global harus dimasukkan sebagai
tidak termasuk sebagai pengganti "-C". Tidak ada arg yang harus diikuti.

o Sebuah s digunakan untuk menunjukkan bahwa aturan berlaku untuk sisi pengirim. Ketika aturan
mempengaruhi sisi pengiriman, mencegah file dari yang ditransfer. Standarnya adalah
aturan untuk mempengaruhi kedua belah pihak kecuali --hapus-dikecualikan ditentukan, di mana
aturan default kasus menjadi sisi pengirim saja. Lihat juga sembunyikan (H) dan tampilkan (S)
aturan, yang merupakan cara alternatif untuk menentukan penyertaan/pengecualian sisi pengiriman.

o Sebuah r digunakan untuk menunjukkan bahwa aturan berlaku untuk sisi penerima. Ketika aturan
mempengaruhi sisi penerima, mencegah file dari yang dihapus. Lihat s
pengubah untuk info lebih lanjut. Lihat juga aturan proteksi (P) dan risiko (R), yang merupakan
cara alternatif untuk menentukan penyertaan/pengecualian sisi penerima.

Hai A p menunjukkan bahwa aturan itu mudah rusak, artinya aturan itu diabaikan dalam direktori
yang sedang dihapus. Misalnya, -C aturan default opsi yang mengecualikan
hal-hal seperti "CVS" dan "*.o" ditandai sebagai mudah rusak, dan tidak akan mencegah a
direktori yang dihapus pada sumber dari dihapus pada tujuan.

GABUNG-FILE FILTER ATURAN

Anda dapat menggabungkan seluruh file ke dalam aturan filter dengan menentukan gabungan (.) atau a
aturan filter dir-merge (:) (seperti yang diperkenalkan di bagian ATURAN FILTER di atas).

Ada dua jenis file gabungan -- instance tunggal ('.') dan per-direktori (':'). A
file gabungan instance tunggal dibaca satu kali, dan aturannya dimasukkan ke dalam
daftar filter di tempat "." aturan. Untuk file gabungan per direktori, rsync akan memindai
setiap direktori yang dilintasi untuk file bernama, menggabungkan isinya saat file
ada ke dalam daftar aturan yang diwariskan saat ini. File aturan per direktori ini harus
dibuat di sisi pengirim karena sisi pengirim yang dipindai untuk
file yang tersedia untuk ditransfer. File aturan ini mungkin juga perlu ditransfer ke
pihak penerima jika Anda ingin mereka memengaruhi file apa yang tidak terhapus (lihat PER-DIRECTORY
ATURAN DAN HAPUS di bawah).

Beberapa contoh:

gabungkan /etc/rsync/default.rules
. /etc/rsync/default.rules
dir-merge .per-dir-filter
dir-merge,n- .non-diwarisi-per-dir-tidak termasuk
:n- .non-warisan-per-dir-tidak termasuk

Pengubah berikut diterima setelah aturan penggabungan atau penggabungan dir:

Hai A - menentukan bahwa file harus terdiri dari hanya mengecualikan pola, tanpa yang lain
penguraian aturan kecuali untuk komentar dalam file.

Hai A + menentukan bahwa file harus hanya terdiri dari pola yang disertakan, tanpa yang lain
penguraian aturan kecuali untuk komentar dalam file.

Hai A C adalah cara untuk menentukan bahwa file harus dibaca dengan cara yang kompatibel dengan CVS.
Ini mengaktifkan 'n', 'w', dan '-', tetapi juga memungkinkan token penghapus daftar (!)
ditentukan. Jika tidak ada nama file yang diberikan, ".cvsignore" diasumsikan.

Hai A e akan mengecualikan nama file gabungan dari transfer; misalnya "dir-merge,e .rules"
seperti "dir-merge .rules" dan "- .rules".

o Sebuah n menentukan bahwa aturan tidak diwarisi oleh subdirektori.

Hai A w menentukan bahwa aturannya adalah pemisahan kata pada spasi, bukan normal
pemisahan garis. Ini juga menonaktifkan komentar. Catatan: ruang yang memisahkan
awalan dari aturan diperlakukan secara khusus, jadi "- foo + bar" diuraikan sebagai dua aturan
(dengan asumsi bahwa penguraian awalan tidak juga dinonaktifkan).

o Anda juga dapat menentukan salah satu pengubah untuk aturan "+" atau "-" (di atas) secara berurutan
untuk memiliki aturan yang dibaca dari file default untuk memiliki pengubah itu
ditetapkan (kecuali untuk ! pengubah, yang tidak akan berguna). Contohnya,
"merge,-/ .excl" akan memperlakukan konten .excl sebagai jalur absolut yang dikecualikan, sedangkan
"dir-merge,s .filt" dan ":sC" masing-masing akan membuat semua aturan per direktori mereka berlaku
hanya di sisi pengirim. Jika aturan penggabungan menentukan sisi yang akan terpengaruh (melalui s
or r pengubah atau keduanya), maka aturan dalam file tidak boleh menentukan sisi (melalui a
pengubah atau awalan aturan seperti menyembunyikan).

Aturan per-direktori diwarisi di semua subdirektori dari direktori tempat
merge-file ditemukan kecuali pengubah 'n' digunakan. Aturan setiap subdirektori adalah
diawali dengan aturan per-direktori yang diwarisi dari induknya, yang memberikan yang terbaru
aturan prioritas yang lebih tinggi daripada aturan yang diwariskan. Seluruh rangkaian aturan dir-merge adalah
dikelompokkan bersama di tempat file gabungan ditentukan, jadi dimungkinkan untuk
timpa aturan dir-merge melalui aturan yang telah ditentukan sebelumnya dalam daftar global
aturan. Ketika aturan penghapusan daftar ("!") dibaca dari file per-direktori, itu hanya
menghapus aturan yang diwarisi untuk file gabungan saat ini.

Cara lain untuk mencegah satu aturan dari file dir-merge diwarisi adalah dengan
jangkar dengan garis miring. Aturan berlabuh dalam file gabungan per direktori bersifat relatif
ke direktori file gabungan, jadi pola "/ foo" hanya akan cocok dengan file "foo" di
direktori tempat file filter dir-merge ditemukan.

Berikut adalah contoh file filter yang akan Anda tentukan melalui --filter=". mengajukan":

gabungkan /home/user/.global-filter
- *.gz
dir-merge .rules
+ *.[ch]
- *.o

Ini akan menggabungkan konten file /home/user/.global-filter di awal
list dan juga mengubah nama file ".rules" menjadi file filter per direktori. Semua aturan
baca sebelum memulai pemindaian direktori, ikuti aturan penahan global (mis
kecocokan garis miring di akar transfer).

Jika file gabungan per direktori ditentukan dengan jalur yang merupakan direktori induk dari
direktori transfer pertama, rsync akan memindai semua direktori induk dari titik awal itu ke
direktori transfer untuk file per direktori yang ditunjukkan. Misalnya, di sini adalah
filter umum (lihat -F):

--filter=': /.rsync-filter'

Aturan itu memberitahu rsync untuk memindai file .rsync-filter di semua direktori dari root
turun melalui direktori induk transfer sebelum dimulainya normal
pemindaian direktori file di direktori yang dikirim sebagai bagian dari transfer.
(Catatan: untuk daemon rsync, root selalu sama dengan "jalur" modul)

Beberapa contoh pra-pemindaian ini untuk file per direktori:

rsync -avF /src/path/ /tujuan/dir
rsync -av --filter=': ../../.rsync-filter' /src/path/ /dest/dir
rsync -av --filter=': .rsync-filter' /src/path/ /dest/dir

Dua perintah pertama di atas akan mencari ".rsync-filter" di "/" dan "/src" sebelum
pemindaian normal mulai mencari file di "/src/path" dan subdirektorinya. Yang terakhir
perintah menghindari pemindaian induk-dir dan hanya mencari file ".rsync-filter" di masing-masing
direktori yang merupakan bagian dari transfer.

Jika Anda ingin memasukkan konten ".cvsignore" dalam pola Anda, Anda harus menggunakan
aturan ":C", yang membuat dir-merge dari file .cvsignore, tetapi diuraikan dalam
cara yang kompatibel dengan CVS. Anda dapat menggunakan ini untuk mempengaruhi di mana --cvs-tidak termasuk (-C) pilihan
penyertaan file .cvsignore per-direktori ditempatkan ke dalam aturan Anda dengan meletakkan
":C" di mana pun Anda suka dalam aturan filter Anda. Tanpa ini, rsync akan menambahkan dir-merge
aturan untuk file .cvsignore di akhir semua aturan Anda yang lain (memberikannya lebih rendah
prioritas daripada aturan baris perintah Anda). Sebagai contoh:

kucing <
+ foo.o
:C
- *.tua
EOT
rsync -avC --include=foo.o -f :C --exclude='*.old' a/ b

Kedua perintah rsync di atas identik. Masing-masing akan menggabungkan semua per-direktori
aturan .cvsignore di tengah daftar, bukan di akhir. Ini memungkinkan mereka
aturan khusus dir untuk menggantikan aturan yang mengikuti :C alih-alih tunduk
untuk semua aturan Anda. Untuk mempengaruhi aturan pengecualian CVS lainnya (yaitu daftar default dari
pengecualian, konten $HOME/.cvsignore, dan nilai $CVSIGNORE) yang harus Anda hilangkan
itu -C opsi baris perintah dan sebagai gantinya masukkan aturan "-C" ke dalam aturan filter Anda; misalnya
"--filter=-C".

KLIRING DAFTAR FILTER ATURAN

Anda dapat menghapus daftar penyertaan/pengecualian saat ini dengan menggunakan tanda "!" aturan filter (seperti yang diperkenalkan
di bagian FILTER ATURAN di atas). Daftar "saat ini" adalah daftar aturan global
(jika aturan ditemukan saat mem-parsing opsi filter) atau satu set per-direktori
aturan (yang diwarisi dalam sub-daftar mereka sendiri, sehingga subdirektori dapat menggunakan ini untuk menghapus
keluar dari aturan orang tua).

PENANGKATAN TERMASUK TIDAK TERMASUK POLA

Seperti disebutkan sebelumnya, pola penyertaan/pengecualian global ditambatkan pada "akar"
transfer" (sebagai lawan dari pola per-direktori, yang ditambatkan di file gabungan
direktori). Jika Anda menganggap transfer sebagai subpohon nama yang dikirim dari
pengirim ke penerima, transfer-root adalah tempat pohon mulai diduplikasi di
direktori tujuan. Akar ini mengatur pola mana yang dimulai dengan / cocok.

Karena pencocokan relatif terhadap akar-transfer, mengubah garis miring pada a
jalur sumber atau mengubah penggunaan Anda atas --relatif opsi memengaruhi jalur yang perlu Anda gunakan
dalam pencocokan Anda (selain mengubah berapa banyak pohon file yang diduplikasi pada
tuan rumah tujuan). Contoh-contoh berikut menunjukkan hal ini.

Katakanlah kita ingin mencocokkan dua file sumber, satu dengan jalur absolut dari
"/home/me/foo/bar", dan satu dengan jalur "/home/you/bar/baz". Berikut adalah bagaimana berbagai
pilihan perintah berbeda untuk transfer 2-sumber:

Contoh cmd: rsync -a /home/me /home/you /dest
+/- pola: /me/foo/bar
+/- pola: /you/bar/baz
File target: /tujuan/saya/foo/bar
File target: /tujuan/Anda/bar/baz

Contoh cmd: rsync -a /home/me/ /home/you/ /dest
+/- pola: /foo/bar (tidak ada catatan "saya")
+/- pola: /bar/baz (catatan hilang "Anda")
File target: /tujuan/foo/bar
File target: /tujuan/bar/baz

Contoh cmd: rsync -a --relative /home/me/ /home/you /dest
+/- pola: /home/me/foo/bar (perhatikan path lengkap)
+/- pola: /home/you/bar/baz (sama)
File target: /tujuan/home/me/foo/bar
File target: /tujuan/rumah/anda/bar/baz

Contoh cmd: cd / Home; rsync -a --relative me/foo you/ /dest
+/- pola: /me/foo/bar (dimulai pada jalur yang ditentukan)
+/- pola: /you/bar/baz (sama)
File target: /tujuan/saya/foo/bar
File target: /tujuan/Anda/bar/baz

Cara termudah untuk melihat nama apa yang harus Anda filter adalah dengan hanya melihat output ketika
menggunakan --bertele-tele dan beri tanda / di depan nama (gunakan --lari-kering pilihan jika Anda tidak
belum siap untuk menyalin file apa pun).

PER-DIREKTORI ATURAN DAN DELETE

Tanpa opsi hapus, aturan per direktori hanya relevan di sisi pengirim, jadi Anda
dapat merasa bebas untuk mengecualikan file gabungan itu sendiri tanpa memengaruhi transfer. Ke
buat ini mudah, pengubah 'e' menambahkan pengecualian ini untuk Anda, seperti yang terlihat di dua ini
perintah yang setara:

rsync -av --filter=': .excl' --exclude=.excl Host:src/dir /dest
rsync -av --filter=':e .excl' host:src/dir /dest

Namun, jika Anda ingin menghapus di sisi penerima DAN Anda ingin beberapa file menjadi
dikecualikan dari dihapus, Anda harus yakin bahwa pihak penerima tahu apa
file untuk dikecualikan. Cara termudah adalah dengan memasukkan file gabungan per-direktori di
transfer dan gunakan --hapus-setelah, karena ini memastikan bahwa pihak penerima mendapatkan semua
aturan pengecualian yang sama dengan sisi pengirim sebelum mencoba menghapus apa pun:

rsync -avF --delete-after Host:src/dir /dest

Namun, jika file gabungan bukan bagian dari transfer, Anda harus menentukan
beberapa aturan pengecualian global (yaitu ditentukan pada baris perintah), atau Anda harus mempertahankan
Anda sendiri per-direktori menggabungkan file di sisi penerima. Contoh yang pertama adalah ini
(anggap bahwa file .rules jarak jauh mengecualikan diri mereka sendiri):

rsync -av --filter=': .rules' --filter='. /saya/extra.rules'
--hapus host:src/dir/tujuan

Dalam contoh di atas, file extra.rules dapat memengaruhi kedua sisi transfer, tetapi (pada
sisi pengirim) aturan tunduk pada aturan yang digabungkan dari file .rules
karena mereka ditentukan setelah aturan penggabungan per direktori.

Dalam satu contoh terakhir, sisi jarak jauh mengecualikan file .rsync-filter dari
transfer, tetapi kami ingin menggunakan file .rsync-filter kami sendiri untuk mengontrol apa yang akan dihapus
pihak penerima. Untuk melakukan ini, kita harus secara khusus mengecualikan file gabungan per-direktori
(agar tidak terhapus) dan kemudian masukkan aturan ke dalam file lokal untuk mengontrol apa
lain tidak harus dihapus. Seperti salah satu perintah ini:

rsync -av --filter=':e /.rsync-filter' --delete \
host:src/dir/tujuan
rsync -avFF --hapus host:src/dir /dest

Batch MODE

Mode batch dapat digunakan untuk menerapkan rangkaian pembaruan yang sama ke banyak sistem yang identik. Memperkirakan
satu memiliki pohon yang direplikasi pada sejumlah host. Sekarang anggaplah beberapa perubahan telah
telah dibuat ke pohon sumber ini dan perubahan itu perlu disebarkan ke host lain.
Untuk melakukan ini menggunakan mode batch, rsync dijalankan dengan opsi tulis-batch untuk diterapkan
perubahan yang dilakukan pada pohon sumber ke salah satu pohon tujuan. Kelompok tulis
opsi menyebabkan klien rsync menyimpan dalam "file batch" semua informasi yang diperlukan untuk
ulangi operasi ini terhadap pohon tujuan lain yang identik.

Menghasilkan file batch setelah menyimpan harus melakukan status file, checksum, dan data
pembuatan blok lebih dari sekali saat memperbarui beberapa pohon tujuan. Multicast
protokol transport dapat digunakan untuk mentransfer file pembaruan batch secara paralel ke banyak
host sekaligus, alih-alih mengirim data yang sama ke setiap host satu per satu.

Untuk menerapkan perubahan yang direkam ke pohon tujuan lain, jalankan rsync dengan read-batch
opsi, menentukan nama file batch yang sama, dan pohon tujuan. Sinkronisasi
memperbarui pohon tujuan menggunakan informasi yang disimpan dalam file batch.

Untuk kenyamanan Anda, file skrip juga dibuat saat opsi tulis-batch digunakan:
itu akan dinamai sama dengan file batch dengan ".sh" ditambahkan. File skrip ini
berisi baris perintah yang cocok untuk memperbarui pohon tujuan menggunakan yang terkait
berkas batch. Itu dapat dieksekusi menggunakan shell Bourne (atau mirip Bourne), secara opsional lewat
dalam nama jalur pohon tujuan alternatif yang kemudian digunakan sebagai pengganti yang asli
jalur tujuan. Ini berguna ketika jalur pohon tujuan pada host saat ini
berbeda dari yang digunakan untuk membuat file batch.

contoh:

$ rsync --write-batch=foo -a Host:/source/dir/ /adest/dir/
$scp foo* jarak jauh:
$ ssh jarak jauh ./foo.sh /bdest/dir/

$ rsync --write-batch=foo -a /sumber/dir/ /adest/dir/
$ ssh remote rsync --read-batch=- -a /bdest/dir/

Dalam contoh ini, rsync digunakan untuk memperbarui /adest/dir/ dari /source/dir/ dan
informasi untuk mengulangi operasi ini disimpan di "foo" dan "foo.sh". Tuan rumah "jauh"
kemudian diperbarui dengan kumpulan data yang masuk ke direktori /bdest/dir. NS
perbedaan antara dua contoh mengungkapkan beberapa fleksibilitas yang Anda miliki dalam cara Anda
berurusan dengan batch:

o Contoh pertama menunjukkan bahwa salinan awal tidak harus lokal -- Anda bisa
dorong atau tarik data ke/dari host jarak jauh menggunakan sintaks shell jarak jauh atau
sintaks daemon rsync, seperti yang diinginkan.

o Contoh pertama menggunakan file "foo.sh" yang dibuat untuk mendapatkan opsi rsync yang tepat
saat menjalankan perintah read-batch pada host jarak jauh.

o Contoh kedua membaca data batch melalui input standar sehingga file batch
tidak perlu disalin ke mesin jarak jauh terlebih dahulu. Contoh ini menghindari
skrip foo.sh karena perlu menggunakan yang dimodifikasi --baca-batch pilihan, tapi kamu
dapat mengedit file skrip jika Anda ingin menggunakannya (pastikan tidak
opsi lain mencoba menggunakan input standar, seperti "--kecuali-dari=-"
pilihan).

Peringatan:

Opsi read-batch mengharapkan pohon tujuan yang diperbarui menjadi identik dengan
pohon tujuan yang digunakan untuk membuat kumpulan file pembaruan batch. Ketika perbedaan
antara pohon tujuan ditemui pembaruan mungkin dibuang dengan peringatan
(jika file tampaknya sudah mutakhir) atau pembaruan file dapat dicoba dan
kemudian, jika file gagal diverifikasi, pembaruan dibuang dengan kesalahan. Ini berarti bahwa
harus aman untuk menjalankan kembali operasi baca-batch jika perintah terputus. Jika kamu
ingin memaksa pembaruan batch untuk selalu dicoba terlepas dari ukuran file dan
tanggal, gunakan -I pilihan (saat membaca batch). Jika terjadi kesalahan, tujuan
pohon mungkin akan dalam keadaan diperbarui sebagian. Dalam hal ini, rsync dapat digunakan dalam
mode operasi reguler (non-batch) untuk memperbaiki pohon tujuan.

Versi rsync yang digunakan di semua tujuan setidaknya harus sama baru dengan versi sebelumnya
menghasilkan file batch. Rsync akan mati dengan kesalahan jika versi protokol di
file batch terlalu baru untuk ditangani oleh rsync pembacaan batch. Lihat juga --protokol
opsi untuk cara membuat rsync menghasilkan file batch yang dapat dilakukan oleh rsync lama
memahami. (Perhatikan bahwa file batch mengubah format di versi 2.6.3, jadi campur versi
lebih tua dari itu dengan versi yang lebih baru tidak akan berfungsi.)

Saat membaca file batch, rsync akan memaksa nilai opsi tertentu untuk mencocokkan data
dalam file batch jika Anda tidak menyetelnya sama dengan perintah penulisan batch. Lainnya
pilihan dapat (dan harus) diubah. Misalnya --tulis-batch berubah menjadi --baca-batch,
--file-dari dijatuhkan, dan --Saring/--termasuk/--mengecualikan pilihan tidak diperlukan
kecuali salah satu dari --menghapus opsi ditentukan.

Kode yang membuat file BATCH.sh mengubah opsi filter/sertakan/kecualikan menjadi
satu daftar yang ditambahkan sebagai dokumen "di sini" ke file skrip shell. Lanjutan
pengguna dapat menggunakan ini untuk mengubah daftar pengecualian jika ada perubahan pada apa yang dihapus oleh --menghapus
diinginkan. Pengguna biasa dapat mengabaikan detail ini dan hanya menggunakan skrip shell sebagai cara yang mudah
cara menjalankan yang sesuai --baca-batch perintah untuk data batch.

Mode batch asli di rsync didasarkan pada "rsync+", tetapi versi terbaru menggunakan yang baru
implementasi.

SIMBOLIS LINK

Tiga perilaku dasar dimungkinkan ketika rsync menemukan tautan simbolik di sumbernya
direktori.

Secara default, tautan simbolik tidak ditransfer sama sekali. Pesan "melewati non-reguler"
file dipancarkan untuk setiap symlink yang ada.

If --link ditentukan, maka symlink dibuat ulang dengan target yang sama di
tujuan. Perhatikan bahwa --Arsip menyiratkan --link.

If --salin-tautan ditentukan, maka symlink "diciutkan" dengan menyalin referensinya,
daripada symlink.

Rsync juga dapat membedakan tautan simbolik "aman" dan "tidak aman". Contoh di mana ini
mungkin digunakan adalah cermin situs web yang ingin memastikan bahwa modul rsync yang
disalin tidak termasuk tautan simbolik ke / etc / passwd di bagian publik situs.
Menggunakan --salin-tautan-tidak aman akan menyebabkan tautan apa pun disalin sebagai file yang mereka tunjuk
tempat tujuan. Menggunakan --tautan-aman akan menyebabkan tautan tidak aman dihilangkan sama sekali.
(Perhatikan bahwa Anda harus menentukan --link untuk --tautan-aman memiliki efek apa pun.)

Tautan simbolik dianggap tidak aman jika merupakan symlink absolut (mulai dengan /), kosong,
atau jika mengandung cukup komponen ".." untuk naik dari direktori yang sedang disalin.

Berikut ringkasan tentang bagaimana opsi symlink ditafsirkan. Daftarnya berurutan
diutamakan, jadi jika kombinasi opsi Anda tidak disebutkan, gunakan baris pertama yaitu
subset lengkap dari opsi Anda:

--salin-tautan
Ubah semua symlink menjadi file normal (tidak meninggalkan symlink untuk opsi lain untuk
memengaruhi).

--link --salin-tautan-tidak aman
Ubah semua symlink yang tidak aman menjadi file dan duplikat semua symlink yang aman.

--salin-tautan-tidak aman
Ubah semua symlink yang tidak aman menjadi file, lewati semua symlink yang aman dengan berisik.

--link --tautan-aman
Gandakan symlink yang aman dan lewati yang tidak aman.

--link
Gandakan semua symlink.

DIAGNOSTIK

rsync terkadang menghasilkan pesan kesalahan yang mungkin tampak sedikit samar. Yang itu
tampaknya yang paling membingungkan adalah "ketidakcocokan versi protokol -- apakah shell Anda bersih?".

Pesan ini biasanya disebabkan oleh skrip startup Anda atau fasilitas shell jarak jauh yang memproduksi
sampah yang tidak diinginkan di aliran yang digunakan rsync untuk pengangkutannya. Cara mendiagnosis
masalah ini adalah menjalankan shell jarak jauh Anda seperti ini:

ssh remotehost /bin/benar > keluar.dat

kemudian lihat out.dat. Jika semuanya bekerja dengan benar maka out.dat harus menjadi nol
berkas panjang. Jika Anda mendapatkan kesalahan di atas dari rsync maka Anda mungkin akan menemukan
bahwa out.dat berisi beberapa teks atau data. Lihatlah isinya dan coba cari tahu apa itu
memproduksinya. Penyebab paling umum adalah skrip startup shell yang tidak dikonfigurasi dengan benar (seperti:
sebagai .cshrc atau .profile) yang berisi pernyataan keluaran untuk login non-interaktif.

Jika Anda mengalami masalah men-debug pola filter, coba tentukan -vv .
Pada tingkat verbositas ini rsync akan menunjukkan mengapa setiap file individual disertakan atau
dikecualikan.

EXIT NILAI

0 Keberhasilan

1 Sintaks atau kesalahan penggunaan

2 Ketidakcocokan protokol

3 Kesalahan memilih file input/output, direktori

4 Tindakan yang diminta tidak didukung: upaya telah dilakukan untuk memanipulasi file 64-bit pada a
platform yang tidak dapat mendukung mereka; atau opsi ditentukan yang didukung oleh
klien dan bukan oleh server.

5 Kesalahan memulai protokol klien-server

6 Daemon tidak dapat menambahkan ke file log

10 Kesalahan dalam soket I/O

11 Kesalahan dalam file I/O

12 Kesalahan dalam aliran data protokol rsync

13 Kesalahan dengan diagnostik program

14 Kesalahan dalam kode IPC

20 Menerima SIGUSR1 atau SIGINT

21 Beberapa kesalahan dikembalikan oleh waitpid()

22 Kesalahan mengalokasikan buffer memori inti

23 Transfer sebagian karena kesalahan

24 Transfer sebagian karena file sumber yang hilang

25 Batas --max-delete menghentikan penghapusan

30 Batas waktu dalam pengiriman/penerimaan data

35 Batas waktu menunggu koneksi daemon

LINGKUNGAN VARIABEL

CVSIGNOR
Variabel lingkungan CVSIGNORE melengkapi pola abaikan apa pun di .cvsignore
file. Lihat --cvs-tidak termasuk pilihan untuk lebih jelasnya.

RSYNC_ICONV
Tentukan default --ikonv pengaturan menggunakan variabel lingkungan ini. (Pertama didukung
tahun 3.0.0.)

RSYNC_PROTECT_ARGS
Tentukan nilai numerik bukan nol jika Anda menginginkan --melindungi-args pilihan untuk menjadi
diaktifkan secara default, atau nilai nol untuk memastikan bahwa itu dinonaktifkan secara default.
(Pertama didukung di 3.1.0.)

RSYNC_RSH
Variabel lingkungan RSYNC_RSH memungkinkan Anda untuk mengganti shell default yang digunakan sebagai
transportasi untuk rsync. Opsi baris perintah diizinkan setelah perintah
nama, seperti di -e .

RSYNC_PROXY
Variabel lingkungan RSYNC_PROXY memungkinkan Anda untuk mengarahkan klien rsync Anda ke
gunakan proxy web saat menghubungkan ke daemon rsync. Anda harus mengatur RSYNC_PROXY ke a
nama host: pasangan port.

RSYNC_PASSWORD
Menyetel RSYNC_PASSWORD ke kata sandi yang diperlukan memungkinkan Anda menjalankan yang diautentikasi
koneksi rsync ke daemon rsync tanpa campur tangan pengguna. Perhatikan bahwa ini tidak
tidak memberikan kata sandi ke transport shell jarak jauh seperti ssh; untuk belajar bagaimana melakukannya
itu, lihat dokumentasi shell jarak jauh.

PENGGUNA or NAMA LOGO
Variabel lingkungan USER atau LOGNAME digunakan untuk menentukan default
nama pengguna dikirim ke daemon rsync. Jika tidak ada yang disetel, nama pengguna default ke
"bukan siapa-siapa".

HOME Variabel lingkungan HOME digunakan untuk menemukan file .cvsignore default pengguna.

Gunakan rsync online menggunakan layanan onworks.net