.TH "rsync" "1" "13 Aug 2026" "rsync 3.5.0" "User Commands" .\" prefix=/usr .P .SH "نام (NAME)" .P rsync \- ابزاری سریع و چندکاره برای رونوشت محلی و راه‌دور فایل‌ها .P .SH "خلاصه دستور (SYNOPSIS)" .P .nf Local: rsync [OPTION...] SRC... [DEST] Access via remote shell: Pull: rsync [OPTION...] [USER@]HOST:SRC... [DEST] Push: rsync [OPTION...] SRC... [USER@]HOST:DEST Access via rsync daemon: Pull: rsync [OPTION...] [USER@]HOST::SRC... [DEST] rsync [OPTION...] rsync://[USER@]HOST[:PORT]/SRC... [DEST] Push: rsync [OPTION...] SRC... [USER@]HOST::DEST rsync [OPTION...] SRC... rsync://[USER@]HOST[:PORT]/DEST .fi .P استفاده تنها با یک آرگومان SRC و بدون آرگومان DEST به جای رونوشت، پرونده‌های مبدأ را فهرست می‌کند. .P نسخه برخط این صفحه راهنما (شامل پیوندهای متقابل میان مباحث) در نشانی زیر در دسترس است: .UR https://download.samba.org/pub/rsync/rsync.1 .UE . .P .SH "توضیحات (DESCRIPTION)" .P ابزار Rsync یک ابزار سریع و فوق‌العاده چندکاره برای رونوشت پرونده‌ها است. این ابزار می‌تواند پرونده‌ها را به صورت محلی، از/به یک میزبان دیگر از طریق یک پوسته راه‌دور، یا از/به یک دیمن rsync راه‌دور کپی کند. این برنامه گزینه‌های متعددی ارائه می‌دهد که تمام جنبه‌های رفتاری آن را کنترل کرده و امکان تعیین بسیار انعطاف‌پذیر مجموعه‌ای از پرونده‌ها را برای رونوشت فراهم می‌سازد. Rsync به دلیل الگوریتم انتقال دلتای (delta-transfer) خود مشهور است؛ این الگوریتم حجم داده‌های ارسال‌شده در شبکه را با ارسال تنها تفاوت‌های بین پرونده‌های مبدأ و پرونده‌های موجود در مقصد کاهش می‌دهد. Rsync به‌طور گسترده برای پشتیبان‌گیری، آینه‌سازی و به عنوان یک دستور رونوشت بهبود‌یافته برای استفاده روزمره به کار می‌رود. .P ابزار Rsync پرونده‌هایی را که نیاز به انتقال دارند (به‌طور پیش‌فرض) با استفاده از الگوریتم «بررسی سریع» پیدا می‌کند که به دنبال پرونده‌هایی با تغییر در اندازه یا زمان آخرین تغییر می‌گردد. هرگونه تغییر در سایر ویژگی‌های حفظ‌شده (طبق درخواست گزینه‌ها)، هنگامی که بررسی سریع نشان دهد داده‌های پرونده نیازی به به‌روزرسانی ندارند، مستقیماً روی پرونده مقصد اعمال می‌شود. .P برخی از ویژگی‌های دیگر rsync عبارتند از: .P .IP o پشتیبانی از رونوشت پیوندهای سخت و نرم، دستگاه‌ها، مالکان، گروه‌ها و مجوزها .IP o گزینه‌های exclude و exclude-from مشابه با GNU tar .IP o حالت استثنای CVS برای نادیده گرفتن همان پرونده‌هایی که CVS نادیده می‌گیرد .IP o امکان استفاده از هر پوسته راه‌دور شفاف، از جمله ssh یا rsh .IP o عدم نیاز به دسترسی‌های کاربر ارشد (super-user) .IP o خط‌لوله‌ای کردن انتقال پرونده‌ها برای به حداقل رساندن هزینه‌های تاخیر .IP o پشتیبانی از دیمن‌های ناشناس یا احراز هویت شده rsync (ایده‌آل برای آینه‌سازی) .P .SH "کلیات (GENERAL)" .P ابزار rsync فایل‌ها را به یک میزبان راه‌دور، از آن، یا به صورت محلی روی میزبان فعلی کپی می‌کند. این ابزار از کپی فایل‌ها بین دو میزبان راه‌دور مختلف پشتیبانی نمی‌کند. .P برای ارتباط rsync با یک سیستم راه‌دور دو روش وجود دارد: استفاده از برنامه شل راه‌دور به عنوان بستر انتقال (مانند ssh یا rsh)، یا برقراری ارتباط مستقیم با دیمن rsync از طریق TCP. بستر انتقال شل راه‌دور زمانی استفاده می‌شود که مسیر مبدأ یا مقصد پس از مشخصه میزبان، حاوی یک دونقطه (:) به عنوان جداکننده باشد. در این حالت، فرایند محلی rsync از برنامه شل راه‌دور برای راه‌اندازی فرایند rsync روی سیستم راه‌دور استفاده می‌کند. سپس دو فرایند rsync از طریق برنامه شل راه‌دور با یکدیگر ارتباط برقرار می‌کنند تا انتقال مورد نظر انجام شود. در این حالت، فایل‌های قابل دسترسی در سیستم راه‌دور همان مواردی هستند که برای شناسه کاربری (user ID) اجراکننده فرایند rsync راه‌دور در دسترس باشند. .P ارتباط مستقیم با دیمن rsync زمانی رخ می‌دهد که مسیر مبدأ یا مقصد پس از مشخصه میزبان حاوی دو دونقطه (::) باشد، یا یک نشانی اینترنتی rsync:// مشخص شده باشد. در این حالت، فرایند دیمن rsync راه‌دور بر اساس پیکربندی خود، تنها به مجموعه‌های خاصی از فایل‌ها به نام ماژول دسترسی می‌دهد. همچنین برقراری ارتباط با دیمن rsync از طریق بستر انتقال شل راه‌دور ممکن است؛ برای جزئیات به بخش USING RSYNC-DAEMON FEATURES VIA A REMOTE-SHELL CONNECTION مراجعه کنید. .P به عنوان یک حالت خاص، اگر تنها یک آرگومان مبدأ بدون مقصد مشخص شود، فایل‌ها در قالبی شبیه به "\fBls\ \-l\fP" فهرست می‌شوند. .P اگر هیچ‌کدام از مسیرهای مبدأ یا مقصد میزبان راه‌دوری را مشخص نکنند، کپی به صورت محلی انجام می‌شود (گزینه \fB\-\-list\-only\fP را نیز ببینید). .P ابزار rsync بخش محلی را کلاینت و بخش راه‌دور را سرور می‌نامد. نباید سرور را با دیمن rsync اشتباه گرفت. یک دیمن همواره سرور است، اما سرور می‌تواند دیمن یا فرایندی باشد که توسط شل راه‌دور ایجاد شده است. اگر انتقال محلی باشد، زیرفرایند rsync که محتوای فایل‌های در حال انتقال را دریافت می‌کند، سرور خواهد بود. .P .SH "راه‌اندازی (SETUP)" .P بیشتر توزیع‌های لینوکس rsync را به صورت بسته‌ای ارائه می‌دهند که با استفاده از مدیر بسته قابل نصب است. اگر به هر دلیلی نیاز به ساخت و نصب rsync از روی کد منبع دارید، برای دستورالعمل‌های نصب به فایل README.md مراجعه کنید. .P پس از نصب، می‌توانید از rsync برای هر ماشینی که از طریق شل راه‌دور به آن دسترسی دارید یا دیمن rsync روی آن فعال است، استفاده کنید. برای انتقال‌های راه‌دور، rsync معمولاً از ssh برای ارتباطات خود استفاده می‌کند. همچنین می‌توانید با استفاده از گزینه خط فرمان \fB\-e\fP یا با مقداردهی متغیر محیطی \fBRSYNC_RSH\fP، هر شل راه‌دور دلخواهی را مشخص کنید. .P توجه داشته باشید که rsync باید روی هر دو ماشین مبدأ و مقصد نصب شده باشد. .P .SH "کاربرد (USAGE)" .P شما از rsync به روشی مشابه با سایر دستورهای کپی فایل مانند cp و rcp استفاده می‌کنید. باید یک مبدأ و یک مقصد مشخص کنید که یکی از آن‌ها می‌تواند راه‌دور باشد. .P شاید بهترین راه برای توضیح ساختار دستور، استفاده از چند مثال باشد: .RS 4 .P .nf rsync -t *.c foo:src/ .fi .RE .P این دستور همه فایل‌های منطبق با الگوی \fB*.c\fP را از پوشه فعلی به پوشه src در ماشین foo منتقل می‌کند. اگر هر یک از فایل‌ها از قبل روی سیستم راه‌دور موجود باشد، پروتکل به‌روزرسانی راه‌دور rsync برای به‌روزرسانی فایل تنها با ارسال تفاوت‌های داده استفاده می‌شود. توجه داشته باشید که بسط کاراکترهای عام در خط فرمان (\fB*.c\fP) به فهرستی از فایل‌ها، پیش از اجرای rsync توسط شل انجام می‌شود و نه توسط خود rsync (مشابه سایر برنامه‌های سازگار با استاندارد Posix). .RS 4 .P .nf rsync -avz foo:src/bar /data/tmp .fi .RE .P این دستور تمام فایل‌ها را به‌صورت بازگشتی از دایرکتوری src/bar در ماشین foo به دایرکتوری /data/tmp/bar در ماشین محلی منتقل می‌کند. فایل‌ها در حالت آرشیو منتقل می‌شوند که تضمین می‌کند پیوندهای نمادین، دستگاه‌ها، مشخصه‌ها، دسترسی‌ها، مالکیت‌ها و غیره در حین انتقال حفظ شوند. علاوه بر این، از فشرده‌سازی برای کاهش حجم بخش‌های داده‌ای در طول انتقال استفاده خواهد شد. .RS 4 .P .nf rsync -avz foo:src/bar/ /data/tmp .fi .RE .P وجود یک اسلش در انتهای مسیر مبدأ، این رفتار را تغییر می‌دهد تا از ایجاد یک سطح دایرکتوری اضافی در مقصد جلوگیری شود. می‌توانید اسلش پایانی / در مبدأ را به معنای «رونوشت محتویات این دایرکتوری» در برابر «رونوشت دایرکتوری با نام آن» در نظر بگیرید؛ اما در هر دو حالت، مشخصه‌های دایرکتوری مبدأ به دایرکتوری مقصد منتقل می‌شوند. به عبارت دیگر، هر یک از دستورهای زیر فایل‌ها را به یک روش رونوشت می‌کنند، از جمله در تنظیم مشخصه‌های /dest/foo: .RS 4 .P .nf rsync -av /src/foo /dest rsync -av /src/foo/ /dest/foo .fi .RE .P همچنین توجه داشته باشید که ارجاعات میزبان و ماژول برای رونوشت محتویات دایرکتوری پیش‌فرض، نیازی به اسلش انتهایی ندارند. برای مثال، هر دوی این دستورها محتویات دایرکتوری راه‌دور را در "/dest" رونوشت می‌کنند: .RS 4 .P .nf rsync -av host: /dest rsync -av host::module /dest .fi .RE .P همچنین می‌توانید از rsync در حالت کاملاً محلی استفاده کنید، جایی که در نام مبدأ و مقصد کاراکتر ':' وجود ندارد. در این حالت، مانند یک دستور copy بهبودیافته عمل می‌کند. .P در نهایت، می‌توانید تمام ماژول‌های در دسترس (قابل فهرست‌بندی) از یک دیمن rsync مشخص را با حذف نام ماژول مشاهده کنید: .RS 4 .P .nf rsync somehost.mydomain.com:: .fi .RE .P .SH "رونوشت با نام متفاوت (COPYING TO A DIFFERENT NAME)" .P هنگامی که می‌خواهید یک دایرکتوری را با نامی دیگر رونوشت کنید، یک اسلش در انتهای مسیر دایرکتوری مبدأ قرار دهید تا محتویات آن درون دایرکتوری مقصد دلخواه شما قرار گیرد: .RS 4 .P .nf rsync -ai foo/ bar/ .fi .RE .P ابزار rsync همچنین قابلیت رونوشت یک فایل تکی به مقصد با نامی متفاوت را دارد. قواعد این عملیات عبارتند از: .P .IP o فهرست انتقال باید تنها شامل یک مورد باشد (یک فایل یا یک دایرکتوری خالی) .IP o عنصر نهایی مسیر مقصد نباید به عنوان یک دایرکتوری وجود داشته باشد .IP o مسیر مقصد نباید با یک اسلش انتهایی مشخص شده باشد .P تحت این شرایط، rsync از مسیر مقصد مشخص‌شده به عنوان نام فایل مقصد استفاده خواهد کرد (به‌جای ساخت نام فایل با استفاده از آخرین عنصر مسیر مبدأ). بهتر است از این شیوه تنها هنگام رونوشت یک فایل استفاده شود، و برای رونوشت یک دایرکتوری از شیوه اسلش انتهایی بالا استفاده گردد. .P مثال زیر فایل \fBfoo.c\fP را با نام \fBbar.c\fP در دایرکتوری \fBsave\fP رونوشت می‌کند (با این فرض که \fBbar.c\fP یک دایرکتوری نیست): .RS 4 .P .nf rsync -ai src/foo.c save/bar.c .fi .RE .P قاعده رونوشت تک‌موردی در صورتی که یک الگوی عامه‌پسند (wildcard) برای مبدأ تنها به یک مورد منتهی شود و مقصد، هرچند بدون اسلش انتهایی مشخص شده، به عنوان یک دایرکتوری در نظر گرفته شده باشد اما آن دایرکتوری وجود نداشته باشد، می‌تواند نتایج غیرمنتظره‌ای ایجاد کند. برای مثال، اگر \fBsrc/*.c\fP با یک فایل مطابقت داشته باشد و \fBsave/dir\fP وجود نداشته باشد، این حالت احتمالاً به شکلی گیج‌کننده نام فایل مقصد را \fBsave/dir\fP می‌گذارد: .RS 4 .P .nf rsync -ai src/*.c save/dir .fi .RE .P برای جلوگیری از چنین پیشامدی، یا مطمئن شوید که دایرکتوری مقصد وجود دارد یا مسیر مقصد را با یک اسلش انتهایی مشخص کنید: .RS 4 .P .nf rsync -ai src/*.c save/dir/ .fi .RE .P .SH "ترتیب انتقال مرتب‌شده (SORTED TRANSFER ORDER)" .P ابزار rsync همواره نام فایل‌های مشخص‌شده را در فهرست انتقال داخلی خود مرتب می‌کند. این کار ادغام محتویات دایرکتوری‌های هم‌نام را مدیریت کرده و حذف نام فایل‌های تکراری را آسان می‌سازد. با این حال، می‌تواند منجر به انتقال فایل‌ها با ترتیبی متفاوت از آنچه در خط فرمان مشخص شده است شود. .P اگر نیاز دارید فایل خاصی پیش از فایلی دیگر منتقل شود، تنها راه تضمین‌شده برای آن، جداسازی فایل‌ها در فراخوانی‌های مجزای rsync است. اگر ظاهر شدن فایل‌های مقصد تقریباً در یک زمان کفایت می‌کند، استفاده از \fB\-\-delay\-updates\fP را در نظر بگیرید که بر ترتیب انتقال مرتب‌شده اثری نمی‌گذارد، اما فاز به‌روزرسانی نهایی فایل‌ها را بسیار سریع‌تر به انجام می‌رساند. .P .SH "امنیت (SECURITY)" .P ابزار rsync غالباً در بستر شبکه و با دسترسی‌های بالا اجرا می‌شود، بنابراین ارزش دارد به این فکر کنید که به چه کسی و با چه چیزهایی اعتماد می‌کنید. این بخش یک راهنمای عملی برای استفاده ایمن است؛ فایل \fBSECURITY.md\fP پروژه، مدل کامل تهدیدها و موارد باقیمانده به ازای هر پلتفرم را شرح می‌دهد. .P .SS "استفاده از یک انتقال احرازهویت‌شده و رمزنگاری‌شده" .P یک انتقال سادهٔ \fBhost:path\fP از طریق پوستهٔ راه‌دور شما (به‌طور پیش‌فرض ssh) اجرا می‌شود که طرف مقابل را احراز هویت کرده و اتصال را رمزگذاری می‌کند\ \-\- این حالت پیش‌فرضِ امن است. یک اتصال مستقیم دیمن (\fBhost::module\fP یا \fBrsync://\fP) \fBرمزگذاری‌نشده است\fP و احراز هویت آن نسبتاً ضعیف است، بنابراین داده‌های حساس را روی یک شبکهٔ غیرقابل‌اعتماد ارسال نکنید. به‌جای آن، آن را از طریق ssh تونل کنید (بخش USING RSYNC-DAEMON FEATURES VIA A REMOTE-SHELL CONNECTION را ببینید) یا آن را با TLS از طریق \fBrsync-ssl\fP(1) بسته‌بندی کرده و \fBRSYNC_SSL_CA_CERT\fP را تنظیم نمایید تا زنجیرهٔ گواهی سرور \fBو\fP نام میزبان بررسی و تأیید شوند. هنگامی که باید گذرواژهٔ دیمن را به‌صورت غیرتعاملی ارائه دهید، آن را به‌جای خط فرمان، درون یک \fB\-\-password\-file\fP که فقط توسط شما قابل خواندن است (حالت ۶۰۰) قرار دهید. .P .SS "رونوشت از میزبان فرستندهٔ غیرقابل‌اعتماد" .P هنگام دریافت از یک میزبان راه‌دور، rsync اقداماتی انجام می‌دهد تا اطمینان حاصل کند که یک فرایند rsync راه‌دورِ خراب یا نفوذ‌یافته نتواند باعث شود که فرایند rsync محلی به فایل‌هایی فراتر از محدودهٔ درخواستی دسترسی پیدا کند. برنامهٔ rsync تضمین می‌کند که فهرست فایل‌های در حال انتقال در داخل درخت درخواستی باقی بماند، و هرگاه یک فهرست فایل حاوی مسیر مطلق یا نسبی باشد که سعی در خروج از ریشهٔ انتقال داشته باشد، متوقف خواهد شد. همچنین تأیید می‌کند که هیچ آرگومان مبدأ اضافی به انتقال افزوده نشده باشد و فهرست فایل‌ها از قواعد مستثنی‌سازی (exclude) که به فرستنده ارسال شده‌اند پیروی کند. .P برای کسانی که می‌خواهند احتیاط بیشتری به خرج دهند، امن‌ترین روش این است که فایل‌های راه‌دور غیرقابل‌اعتماد را درون یک پوشهٔ مقصد اختصاصی رونوشت کنند. برای مثال، به‌جای رونوشت به پوشهٔ خانگی‌تان: .RS 4 .P .nf rsync -aiv host1:dir1 ~ .fi .RE .P یک پوشهٔ \(dqhost1-files\(dq را به محتوای راه‌دور اختصاص دهید: .RS 4 .P .nf rsync -aiv host1:dir1 ~/host1-files .fi .RE .P برای جزئیات بیشتر گزینهٔ \fB\-\-trust\-sender\fP را ببینید. .P .SS "رونوشت میان فایل‌سیستم‌های حفظ‌کنندهٔ بزرگی و کوچکی حروف و ناوابسته به آن" .P رونوشت از یک فایل‌سیستم حفظ‌کنندهٔ حالت حروف به فایل‌سیستم ناوابسته به حروف نیازمند احتیاط است، زیرا این احتمال وجود دارد که پس از حذف تمایز میان حروف بزرگ و کوچک، نام یک پیوند نمادین با نام یک فایل یا پوشه هم‌پوشانی پیدا کند، که می‌تواند به نتایج بالقوه خطرناکی مانند نوشته‌شدن فایل‌ها در خارج از سلسله‌مراتب پوشهٔ مقصد بیانجامد. اگر مجبور به انجام چنین رونوشتی هستید، پیوندهای نمادین را با \fB\-\-no\-links\fP غیرفعال کنید یا درهم‌ریزی (munging) پیوندهای نمادین را با \fB\-\-munge\-links\fP فعال نمایید (و مطمئن شوید که گزینهٔ محلی یا راه‌دورِ مناسب را به کار می‌برید). البته این کار تضمین نمی‌کند که یک رونوشت کامل از تمامی فایل‌ها دریافت کنید (چرا که ممکن است در صورت تداخل نام‌ها امکان‌پذیر نباشد)؛ راه‌حل بالقوه بهتر ساخت یک فهرست امن از نام فایل‌ها و ارسال آن به \fB\-\-files\-from\fP است. .P .SS "پیوندهای نمادین (SYMBOLIC LINKS)" .P یک فرستندهٔ مخرب می‌تواند پیوندهای نمادینی قرار دهد که به خارج از درخت مقصد اشاره دارند (برای مثال به \fB/etc/passwd\fP). از \fB\-\-safe\-links\fP برای نادیده گرفتن هر پیوند نمادینی که به خارج از مجموعهٔ فایل‌های در حال انتقال اشاره می‌کند استفاده کنید، یا از \fB\-\-munge\-links\fP برای ذخیرهٔ هر پیوند نمادین به شکلی که روی دیسک غیرقابل‌استفاده ولی بعداً قابل‌بازیابی باشد بهره ببرید؛ گزینهٔ \fB\-\-no\-links\fP پیوندهای نمادین را به‌طور کامل حذف می‌کند. بخش پیوندهای نمادین (SYMBOLIC LINKS) را برای نحوهٔ تعامل این گزینه‌ها ببینید. .P به‌طور جداگانه، مسیرهای پوشه و پرونده‌ای که \fIشما\fP در خط فرمان مشخص می‌کنید\ \-\- \fB\-\-backup\-dir\fP، \fB\-\-temp\-dir\fP، \fB\-\-partial\-dir\fP، دایرکتوری‌های پایه \fB\-\-link\-dest\fP/\fB\-\-compare\-dest\fP/\fB\-\-copy\-dest\fP، \fB\-\-log\-file\fP، \fB\-\-files\-from\fP/\fB\-\-include\-from\fP/\fB\-\-exclude\-from\fP، پرونده‌های ادغام \fB\-\-filter\fP، \fB\-\-write\-batch\fP/\fB\-\-read\-batch\fP، و خود مقصد\ \-\- به گونه‌ای ارزیابی می‌شوند که یک مؤلفه پیوند نمادین تنها در صورتی دنبال شود که مالک آن شما یا root باشید؛ پیوند نمادین قرار داده شده توسط مهاجم در امتداد یکی از این مسیرها رد می‌شود. \fB\-\-insecure\-links\fP این محافظت را غیرفعال می‌کند (رفتار تاریخی دنبال‌کردن هرگونه پیوند نمادین را بازمی‌گرداند)؛ تنها زمانی از آن استفاده کنید که تمام دایرکتوری‌های درون آن مسیرها قابل اعتماد باشند، و هرگز در مسیری که کاربر غیرممتاز امکان نوشتن روی آن دارد استفاده نکنید. .P .SS "استفاده از چکسام‌های قوی" .P برنامه rsync قوی‌ترین چکسامی را که هر دو طرف پشتیبانی می‌کنند به‌طور خودکار مذاکره می‌کند، بنابراین به‌روز نگه داشتن نسخه‌های محلی و راه‌دور rsync در حد معقول معمولاً تمام چیزی است که نیاز است. شما می‌توانید این انتخاب را با \fB\-\-checksum\-choice\fP (\fB\-\-cc\fP، به عنوان مثال \fB\-\-cc=sha1\fP یا یکی از گونه‌های xxHash) تثبیت کنید یا مذاکره را با متغیر محیطی \fBRSYNC_CHECKSUM_LIST\fP محدود نمایید؛ تنها همتاهای بسیار قدیمی به MD4/MD5 تنزل می‌یابند. این چکسام پیش از انتقال «آیا این پرونده نیاز به به‌روزرسانی دارد؟» جدا از چکسام کل پرونده است که rsync به‌طور معمول پس از آن برای تأیید صحت هر پرونده منتقل‌شده محاسبه می‌کند (هنگامی که \fB\-\-checksum\-choice=none\fP اجبار شود، تأیید صحت غیرفعال است). .P .SS "نسخه پروتکل" .P کلاینت و سرور به‌طور خودکار جدیدترین پروتکلی را که هر دو پشتیبانی می‌کنند مذاکره می‌نمایند، بنابراین یک جفت به‌روز هم‌اکنون از جدیدترین نسخه استفاده می‌کند؛ \fB\-\-protocol\fP صرفاً یک نسخه قدیمی‌تر را برای سازگاری \fIاجبار می‌کند\fP و نباید برای تنزل دادن یک اتصال استفاده شود. بنابراین اجتناب از پروتکل‌های قدیمی وابسته به اجرای نسخه به‌روز rsync در هر دو طرف است (پروتکل پایین‌تر از ۳۰ همچنین چکیده احراز هویت ضعیف MD4 را در اتصال دیمن اجبار می‌کند\ \-\- بخش AUTHENTICATION STRENGTH از \fBrsyncd.conf\fP(5) را ببینید). .P .SH "استفاده پیشرفته (ADVANCED USAGE)" .P نحو درخواست چند پرونده از یک میزبان راه‌دور با مشخص کردن آرگومان‌های میزبان راه‌دور اضافی با همان ساختار اولی، یا با حذف نام میزبان انجام می‌شود. برای نمونه، همه این‌ها کار می‌کنند: .RS 4 .P .nf rsync -aiv host:file1 :file2 host:file{3,4} /dest/ rsync -aiv host::modname/file{1,2} host::modname/extra /dest/ rsync -aiv host::modname/first ::extra-file{1,2} /dest/ .fi .RE .P توجه داشته باشید که اتصال دیمن تنها از دسترسی به یک ماژول در هر دستور رونوشت پشتیبانی می‌کند، بنابراین اگر ابتدای مسیر بعدی با modname مسیر نخست آغاز نشود، فرض می‌شود که مسیری درون همان ماژول است (مانند extra-file1 و extra-file2 که در بالا دریافت شدند). .P از آنجا که نسخه‌های بسیار قدیمی rsync (پیش از 3.0.0، منتشر شده در مارس ۲۰۰۸) تنها اجازه تعیین یک آرگومان مبدا راه‌دور را می‌دادند، برخی افراد به جداسازی فاصله‌ها توسط شل راه‌دور برای شکستن یک آرگومان به چند مسیر تکیه می‌کردند. چنین رفتار غیرشهودی دیگر به‌طور پیش‌فرض پشتیبانی نمی‌شود، اگرچه می‌توانید همان‌طور که در بند بعدی توضیح داده شده آن را درخواست کنید. اکنون rsync (از نسخه 3.2.4) نام پرونده‌ها را به گونه‌ای به شل راه‌دور ارسال می‌کند تا نویسه‌های وارد شده توسط شما حفظ شوند. بنابراین، اگر پرونده‌ای با فاصله در نامش بخواهید، این همان چیزی است که rsync راه‌دور به دنبال آن می‌گردد: .RS 4 .P .nf rsync -aiv host:'a simple file.pdf' /dest/ .fi .RE .P اگر از اسکریپت‌هایی استفاده می‌کنید که برای اعمال دستی نقل‌قول‌های اضافی (quoting) به آرگومان‌های راه‌دور rsync نوشته شده‌اند، یا بر تفکیک آرگومان‌های راه‌دور تکیه دارند، می‌توانید از rsync بخواهید تا اجازه دهد اسکریپت شما گریزدهی (escaping) اضافی را مدیریت کند. این کار با افزودن گزینهٔ \fB\-\-old\-args\fP به اجرای rsync در اسکریپت (که نیازمند نسخه جدید rsync است) یا صدور RSYNC_OLD_ARGS=1 و RSYNC_PROTECT_ARGS=0 (که با نسخه‌های قدیمی یا جدید rsync کار می‌کند) انجام می‌شود. .P .SH "اتصال به یک دیمن RSYNC (CONNECTING TO AN RSYNC DAEMON)" .P یک دیمن rsync روشی برای دسترسی کنترل‌شده به یک یا چند سلسله‌مراتب پوشه در یک سیستم بدون نیاز به ارائه دسترسی پوسته فراهم می‌کند. هر سلسله‌مراتب پوشه یک «ماژول» (module) نامیده می‌شود. نام‌ها، پوشه‌ها، مجوزهای دسترسی و غیره برای هر ماژول توسط فایل پیکربندی دیمن rsync تعریف می‌شوند که در \fBrsyncd.conf\fP(5) شرح داده شده است. اتصالات به یک دیمن rsync معمولاً از پورت TCP شمارهٔ 873 استفاده می‌کنند. مدیر سیستم معمولاً مقدمات اجرای دیمن rsync را فراهم می‌کند؛ برای اطلاعات بیشتر درباره نحوه انجام این کار، به بخش «راه‌اندازی دیمن RSYNC برای پذیرش اتصالات» در زیر مراجعه کنید. .P از دید کلاینت، استفاده از rsync برای دسترسی به یک دیمن rsync شبیه به استفاده از آن با یک پوسته راه‌دور است، به جز اینکه: .P .IP o به‌جای نحو تک‌دونقطه (پوسته راه‌دور)، از نحو دو‌دونقطه (::) یا نحو نشانی اینترنتی rsync:// استفاده کنید. .IP o اولین عنصر «مسیر» در واقع نام یک ماژول است. .IP o آرگومان‌های مبدأ راه‌دور اضافی می‌توانند از نحو اختصاری که نام میزبان و/یا نام ماژول را حذف می‌کند استفاده کنند، همان‌طور که در «استفاده پیشرفته (ADVANCED USAGE)» توضیح داده شده است. .IP o دیمن راه‌دور ممکن است هنگام اتصال یک «پیام روز» (message of the day) چاپ کند. .IP o اگر فقط میزبان را مشخص کنید (بدون ماژول یا مسیر)، فهرستی از ماژول‌های قابل دسترس در دیمن در خروجی نمایش داده می‌شود. .IP o اگر یک مسیر مبدأ راه‌دور بدون مقصد مشخص کنید، فهرستی از فایل‌های منطبق در دیمن راه‌دور خروجی داده می‌شود. .IP o برای تماس مستقیم با یک دیمن rsync، گزینهٔ \fB\-\-rsh\fP (\fB\-e\fP) باید حذف شود. در صورت استفاده، rsync از برنامه پوسته راه‌دور مشخص‌شده برای شروع دیمن rsync در سیستم راه‌دور استفاده خواهد کرد. برای اطلاعات در مورد این حالت عملکرد، به بخش «استفاده از قابلیت‌های دیمن RSYNC از طریق اتصال پوسته راه‌دور» مراجعه کنید. .P یک مثال که تمام فایل‌های موجود در یک ماژول راه‌دور به نام "src" را کپی می‌کند: .RS 4 .P .nf rsync -av host::src /dest .fi .RE .P برخی ماژول‌ها در دیمن راه‌دور ممکن است به احراز هویت نیاز داشته باشند. در این صورت، هنگام اتصال یک درخواست گذرواژه دریافت خواهید کرد. می‌توانید با تنظیم متغیر محیطی \fBRSYNC_PASSWORD\fP با گذرواژه مورد نظر یا با استفاده از گزینهٔ \fB\-\-password\-file\fP از درخواست گذرواژه جلوگیری کنید. این کار ممکن است هنگام نوشتن اسکریپت با rsync مفید باشد. .P هشدار: در برخی سیستم‌ها، متغیرهای محیطی برای تمام کاربران قابل مشاهده هستند. در چنین سیستم‌هایی استفاده از \fB\-\-password\-file\fP توصیه می‌شود. .P می‌توانید اتصال را از طریق یک پروکسی وب با تنظیم متغیر محیطی \fBRSYNC_PROXY\fP به یک جفت hostname:port که به پروکسی وب شما اشاره دارد، برقرار کنید. توجه داشته باشید که پیکربندی پروکسی وب شما باید از اتصالات پروکسی به پورت 873 پشتیبانی کند. .P همچنین می‌توانید با تنظیم متغیر محیطی \fBRSYNC_CONNECT_PROG\fP با دستوراتی که مایلید به‌جای برقراری اتصال مستقیم سوکت اجرا شوند، یک اتصال دیمن را با استفاده از یک برنامه به عنوان پروکسی برقرار کنید. این رشته می‌تواند شامل گریز "%H" برای نمایش نام میزبان مشخص‌شده در دستور rsync باشد (بنابراین در صورتی که به یک "%" تنها در رشته خود نیاز دارید از "%%" استفاده کنید). برای مثال: .RS 4 .P .nf export RSYNC_CONNECT_PROG='ssh proxyhost nc %H 873' rsync -av targethost1::module/src/ /dest/ rsync -av rsync://targethost2/module/src/ /dest/ .fi .RE .P دستور مشخص‌شده در بالا از ssh برای اجرای nc (netcat) روی proxyhost استفاده می‌کند که همه داده‌ها را به درگاه 873 (دیمن rsync) روی targethost (%H) هدایت می‌نماید. .P همچنین توجه داشته باشید که اگر متغیر محیطی \fBRSYNC_SHELL\fP تنظیم شده باشد، آن برنامه برای اجرای دستور \fBRSYNC_CONNECT_PROG\fP به‌جای استفاده از پوسته پیش‌فرض فراخوانی \fBsystem()\fP به کار گرفته خواهد شد. .P .SH "استفاده از قابلیت‌های دیمن RSYNC از طریق اتصال پوسته راه‌دور (USING RSYNC-DAEMON FEATURES VIA A REMOTE-SHELL CONNECTION)" .P گاهی اوقات استفاده از قابلیت‌های مختلف دیمن rsync (مانند ماژول‌های نام‌گذاری‌شده) بدون نیاز به باز کردن اتصالات سوکت جدید روی سیستم، فراتر از آنچه از قبل برای دسترسی به پوسته راه‌دور لازم است، مفید خواهد بود. rsync از اتصال به میزبان با استفاده از پوسته راه‌دور و سپس ایجاد یک سرور «دیمن» یک‌بارمصرف که انتظار دارد فایل پیکربندی خود را در دایرکتوری خانگی کاربر راه‌دور بخواند، پشتیبانی می‌کند. این قابلیت در صورتی که بخواهید داده‌های یک انتقال به سبک دیمن را رمزگذاری کنید کاربردی است. با این حال، از آنجا که دیمن توسط کاربر راه‌دور راه‌اندازی می‌شود، ممکن است نتوانید از قابلیت‌هایی که نیازمند دسترسی ریشه (root) هستند، مانند chroot یا تعیین شناسه کاربری (user ID) استفاده کنید. (برای روشی دیگر جهت رمزگذاری انتقال دیمن، می‌توانید از ssh برای تونل کردن یک درگاه محلی به ماشین راه‌دور استفاده کنید و یک دیمن معمولی rsync را روی آن میزبان راه‌دور طوری پیکربندی کنید که فقط اتصالات از "localhost" را بپذیرد.) .P از دیدگاه کاربر، انتقال دیمن از طریق اتصال پوسته راه‌دور تقریباً از همان نحو خط فرمان انتقال معمولی دیمن rsync استفاده می‌کند، با این تفاوت که باید برنامه پوسته راه‌دور را صریحاً در خط فرمان با گزینه \fB\-\-rsh=COMMAND\fP مشخص کنید. (تنظیم RSYNC_RSH در متغیرهای محیطی این قابلیت را فعال نخواهد کرد.) برای مثال: .RS 4 .P .nf rsync -av --rsh=ssh host::module /dest .fi .RE .P پیشوند "user@" پیش از نام میزبان در این حالت هم‌زمان دو هدف را برآورده می‌کند: هم مقدار rsync-user است (که برای ورود به ماژولی که نیاز به احراز هویت کاربر دارد استفاده می‌شود) و هم به‌طور پیش‌فرض به عنوان کاربر ورود به سیستم به پوسته راه‌دور ارسال می‌شود. بنابراین شکل ساده .RS 4 .P .nf rsync -av --rsh=ssh user@host::module /dest .fi .RE .P دستور \fBssh\ \-l\ user\ host\fP را اجرا می‌کند و "user" را به عنوان rsync-user به ماژول تحویل می‌دهد؛ هر دو مجبور به داشتن نام یکسان هستند. .P اگر نیاز دارید که ورود به پوسته راه‌دور (ssh) از نام متفاوتی نسبت به rsync-user استفاده کند، یک گزینه صریح '\-l' به دستور ssh در فرمان پوسته راه‌دور بدهید. هنگامی که از قبل برای ssh مشخص شده باشد که با کدام کاربر وارد شود، rsync دیگر گزینه \&'\-l' اختصاصی خود را اضافه نمی‌کند؛ بنابراین پیشوند "user@" فقط به عنوان rsync-user استفاده می‌شود. برای مثال، با استفاده از شکل کوتاه گزینه \fB\-\-rsh\fP: .RS 4 .P .nf rsync -av -e "ssh -l ssh-user" rsync-user@host::module /dest .fi .RE .P در اینجا "ssh-user" در سطح ssh استفاده می‌شود در حالی که "rsync-user" برای ورود به "module" به کار می‌رود. .P در این راه‌اندازی، دیمن توسط دستور ssh که به سیستم دسترسی دارد آغاز می‌شود (در صورت تمایل، می‌تواند از طریق پروندهٔ \fB~/.ssh/authorized_keys\fP اجباری شود). با این حال، هنگام دسترسی مستقیم به یک دیمن، باید از قبل راه‌اندازی شده باشد. .P .SH "راه‌اندازی دیمن RSYNC برای پذیرش اتصال‌ها (STARTING AN RSYNC DAEMON TO ACCEPT CONNECTIONS)" .P به منظور اتصال به یک دیمن rsync، سیستم راه‌دور باید از قبل دیمنی در حال اجرا داشته باشد (یا باید چیزی مانند inetd را پیکربندی کرده باشد تا یک دیمن rsync برای اتصال‌های ورودی روی یک درگاه مشخص ایجاد کند). برای اطلاعات کامل در مورد نحوهٔ راه‌اندازی دیمنی که اتصالات سوکت ورودی را مدیریت می‌کند، به صفحهٔ راهنمای \fBrsyncd.conf\fP(5)، پروندهٔ پیکربندی دیمن مراجعه کنید. این صفحهٔ راهنما شامل جزئیات کامل برای نحوهٔ اجرای دیمن، از جمله پیکربندی‌های مستقل (stand-alone) و inetd است. .P اگر از یکی از روش‌های انتقال پوستهٔ راه‌دور برای انتقال استفاده می‌کنید، نیازی به راه‌اندازی دستی دیمن rsync نیست. .P .SH "مثال‌ها (EXAMPLES)" .P در اینجا چند مثال از نحوهٔ استفاده از rsync آورده شده است. .P برای پشتیبان‌گیری از یک دایرکتوری خانگی، که شامل پرونده‌های بزرگ MS Word و پوشه‌های ایمیل است، می‌توان از یک وظیفهٔ زمان‌بندی‌شدهٔ cron به ازای هر کاربر استفاده کرد که این دستور را روزانه اجرا کند: .RS 4 .P .nf rsync -aiz . bkhost:backup/joe/ .fi .RE .P برای انتقال چند پرونده از یک میزبان راه‌دور به میزبان محلی، می‌توانید اجرا کنید: .RS 4 .P .nf rsync -aiv --remove-source-files rhost:/tmp/{file1,file2}.c ~/src/ .fi .RE .P .SH "خلاصه گزینه‌ها (OPTION SUMMARY)" .P در اینجا خلاصه‌ای کوتاه از گزینه‌های موجود در rsync آورده شده است. هر گزینه همچنین در ادامهٔ این صفحهٔ راهنما، توضیحات مفصل مخصوص به خود را دارد. .P .nf --verbose, -v افزایش پرگویی (verbosity) --info=FLAGS جزئیات دقیق گزارش اطلاعاتی --debug=FLAGS جزئیات دقیق گزارش اشکال‌زدایی --stderr=e|a|c تغییر حالت خروجی stderr (پیش‌فرض: errors) --quiet, -q فرونشاندن پیام‌های غیرخطا --no-motd فرونشاندن MOTD در حالت دیمن --checksum, -c صرف‌نظر بر اساس چِک‌سام، نه زمان تغییر و اندازه --archive, -a حالت آرشیو معادل -rlptgoD است (بدون -A,-X,-U,-N,-H) --no-OPTION غیرفعال‌کردن یک OPTION ضمنی (مانند --no-D) --recursive, -r پیمایش بازگشتی در دایرکتوری‌ها --inc-recursive, --i-r فعال‌کردن بازگشت افزایشی --no-inc-recursive غیرفعال‌کردن بازگشت افزایشی --no-i-r مشابه --no-inc-recursive --relative, -R استفاده از نام‌های مسیر نسبی --no-implied-dirs عدم ارسال دایرکتوری‌های ضمنی همراه با --relative --backup, -b تهیه نسخه پشتیبان (به --suffix و --backup-dir مراجعه کنید) --backup-dir=DIR تهیه نسخه پشتیبان در سلسله‌مراتبی بر پایهٔ DIR --suffix=SUFFIX پسوند پشتیبان (پیش‌فرض ~ بدون --backup-dir) --update, -u صرف‌نظر از پرونده‌هایی که در گیرنده جدیدتر هستند --inplace به‌روزرسانی درجا در پرونده‌های مقصد --append الحاق داده‌ها به پرونده‌های کوتاه‌تر --append-verify مشابه --append با احتساب داده‌های قدیمی در چِک‌سام پرونده --dirs, -d انتقال دایرکتوری‌ها بدون پیمایش بازگشتی --old-dirs عملکرد مشابه --dirs هنگام ارتباط با rsync قدیمی --old-d مشابه --old-dirs --mkpath ایجاد اجزای ناموجود مسیر در مقصد --links, -l رونوشت از پیوندهای نمادین به عنوان پیوند نمادین --copy-links, -L تبدیل پیوند نمادین به پرونده/دایرکتوری مرجع --copy-unsafe-links تنها پیوندهای نمادین «ناامن» تبدیل می‌شوند --safe-links نادیده‌گرفتن پیوندهای نمادین که به بیرون درخت اشاره دارند --insecure-links دنبال‌کردن پیوندهای نمادین متعلق به مهاجم در مسیرهای عملگر --confine-root=DIR رد مسیرهای عملگری که به خارج از DIR حل می‌شوند --munge-links تغییر شکل پیوندهای نمادین برای ایمن و غیرقابل استفاده کردن آن‌ها --copy-dirlinks, -k تبدیل پیوند نمادینِ دایرکتوری به دایرکتوری مرجع --keep-dirlinks, -K رفتار با پیوند نمادینِ دایرکتوری در گیرنده به عنوان دایرکتوری --hard-links, -H حفظ پیوندهای سخت --perms, -p حفظ مجوزها --executability, -E حفظ قابلیت اجرا --chmod=CHMOD اثرگذاری بر مجوزهای پرونده و/یا دایرکتوری --acls, -A حفظ ACLها (متضمن --perms) --xattrs, -X حفظ ویژگی‌های گسترش‌یافته --owner, -o حفظ مالک (تنها کاربر ارشد) --group, -g حفظ گروه --devices حفظ پرونده‌های دستگاه (تنها کاربر ارشد) --copy-devices رونوشت از محتوای دستگاه به عنوان پرونده عادی --write-devices نوشتن در دستگاه‌ها به عنوان پرونده (متضمن --inplace) --specials حفظ پرونده‌های ویژه --drop-D گیرنده ایجاد دستگاه‌ها/پرونده‌های ویژه را رد می‌کند -D مشابه --devices --specials --times, -t حفظ زمان‌های تغییر --atimes, -U حفظ زمان‌های دسترسی (استفاده) --open-noatime جلوگیری از تغییر atime در پرونده‌های بازشده --crtimes, -N حفظ زمان‌های ایجاد (تازگی) --omit-dir-times, -O صرف‌نظر از دایرکتوری‌ها در --times --omit-link-times, -J صرف‌نظر از پیوندهای نمادین در --times --super گیرنده برای اقدامات کاربر ارشد تلاش می‌کند --fake-super ذخیره/بازیابی ویژگی‌های ممتاز با استفاده از xattrs --sparse, -S تبدیل توالی‌های بایت پوچ به بلوک‌های تُنُک (sparse) --preallocate تخصیص فضای پرونده‌های مقصد پیش از نوشتن آن‌ها --dry-run, -n اجرای آزمایشی بدون اعمال هیچ تغییری --whole-file, -W رونوشت کامل پرونده‌ها (بدون الگوریتم انتقال تفاضلی) --no-whole-file, --no-W استفاده از الگوریتم انتقال تفاضلی --checksum-choice=STR انتخاب الگوریتم چِک‌سام (همچنین --cc) --one-file-system, -x عدم عبور از مرزهای سیستم‌پرونده --block-size=SIZE, -B اجبار به استفاده از اندازه بلوک ثابت برای چِک‌سام --rsh=COMMAND, -e مشخص‌کردن پوستهٔ راه‌دور مورد استفاده --rsync-path=PROGRAM مشخص‌کردن برنامهٔ rsync برای اجرا در رایانه راه‌دور --existing صرف‌نظر از ایجاد پرونده‌های جدید در گیرنده --ignore-non-existing صرف‌نظر از ایجاد پرونده‌های جدید در گیرنده --ignore-existing صرف‌نظر از به‌روزرسانی پرونده‌های موجود در گیرنده --remove-source-files فرستنده پرونده‌های همگام‌شده را حذف می‌کند (به جز دایرکتوری) --del نام مستعار برای --delete-during --delete حذف پرونده‌های اضافی از دایرکتوری‌های مقصد --delete-before گیرنده پیش از انتقال حذف می‌کند، نه حین آن --delete-during گیرنده حین انتقال حذف می‌کند --delete-delay یافتن حذفیات حین انتقال، حذف پس از آن --delete-after گیرنده پس از انتقال حذف می‌کند، نه حین آن --delete-excluded همچنین حذف پرونده‌های مستثنی‌شده از دایرکتوری‌های مقصد --ignore-missing-args نادیده‌گرفتن آرگومان‌های مبدا ناموجود بدون اعلام خطا --delete-missing-args حذف آرگومان‌های مبدا ناموجود از مقصد --ignore-errors حذف حتی در صورت وجود خطاهای I/O --force اجبار به حذف دایرکتوری‌ها حتی در صورت خالی نبودن --max-delete=NUM عدم حذف بیش از NUM پرونده --max-size=SIZE عدم انتقال هر پرونده بزرگ‌تر از SIZE --min-size=SIZE عدم انتقال هر پرونده کوچک‌تر از SIZE --max-alloc=SIZE تغییر محدودیت مربوط به تخصیص حافظه --partial نگه‌داشتن پرونده‌های ناقص منتقل‌شده --partial-dir=DIR قرار دادن پرونده‌های ناقص منتقل‌شده در DIR --delay-updates قرار دادن تمام پرونده‌های به‌روزرسانی‌شده در جای خود در پایان --prune-empty-dirs, -m حذف زنجیره‌های دایرکتوری خالی از فهرست پرونده‌ها --numeric-ids عدم نگاشت مقادیر uid/gid بر اساس نام کاربر/گروه --usermap=STRING نگاشت سفارشی نام کاربری --groupmap=STRING نگاشت سفارشی نام گروه --chown=USER:GROUP نگاشت ساده نام کاربری/نام گروه --timeout=SECONDS تنظیم مهلت زمانی I/O بر حسب ثانیه --contimeout=SECONDS تنظیم مهلت زمانی اتصال به دیمن بر حسب ثانیه --ignore-times, -I عدم صرف‌نظر از پرونده‌هایی با اندازه و زمان یکسان --size-only صرف‌نظر از پرونده‌هایی که اندازه یکسان دارند --modify-window=NUM, -@ تنظیم دقت برای مقایسه‌های زمان تغییر --temp-dir=DIR, -T ایجاد پرونده‌های موقت در دایرکتوری DIR --fuzzy, -y یافتن پروندهٔ مشابه به عنوان مبنا در صورت نبود پروندهٔ مقصد --compare-dest=DIR همچنین مقایسه پرونده‌های مقصد نسبت به DIR --copy-dest=DIR ... و شامل کردن رونوشت پرونده‌های بدون تغییر --link-dest=DIR پیوند سخت به پرونده‌های موجود در DIR در صورت عدم تغییر --compress, -z فشرده‌سازی داده‌های پرونده حین انتقال --compress-choice=STR انتخاب الگوریتم فشرده‌سازی (همچنین --zc) --compress-level=NUM تنظیم صریح سطح فشرده‌سازی (همچنین --zl) --compress-threads=NUM تنظیم صریح رشته‌های فشرده‌سازی (همچنین --zt) --skip-compress=LIST صرف‌نظر از فشرده‌سازی پرونده‌ها با پسوند موجود در LIST --cvs-exclude, -C نادیده‌گرفتن خودکار پرونده‌ها به همان روش CVS --filter=RULE, -f افزودن یک RULE برای فیلتر کردن پرونده‌ها -F مشابه --filter='dir-merge /.rsync-filter' تکرار: --filter='- .rsync-filter' --exclude=PATTERN مستثنی‌کردن پرونده‌های منطبق با PATTERN --exclude-from=FILE خواندن الگوهای استثنا از FILE --include=PATTERN عدم استثنای پرونده‌های منطبق با PATTERN --include-from=FILE خواندن الگوهای شمول از FILE --files-from=FILE خواندن فهرست نام‌های پرونده‌های مبدا از FILE --from0, -0 تمام پرونده‌های *-from/filter با 0 از هم جدا می‌شوند --old-args غیرفعال‌کردن شیوهٔ مدرن حفاظت از آرگومان --secluded-args, -s استفاده از پروتکل برای ارسال ایمن آرگومان‌ها --trust-sender اعتماد به فهرست پرونده‌های فرستندهٔ راه‌دور --copy-as=USER[:GROUP] مشخص‌کردن کاربر و گروه اختیاری برای رونوشت --address=ADDRESS نشانی مقیدسازی (bind) برای سوکت خروجی به دیمن --port=PORT مشخص‌کردن شماره درگاه جایگزین با دونقطه دوتایی --sockopts=OPTIONS مشخص‌کردن گزینه‌های سفارشی TCP --blocking-io استفاده از I/O مسدودکننده برای پوستهٔ راه‌دور --outbuf=N|L|B تنظیم بافر خروجی روی None، Line، یا Block --stats ارائه برخی آمارهای انتقال پرونده --8-bit-output, -8 عدم تغییر نویسه‌های با بیت بالا در خروجی --human-readable, -h نمایش اعداد در قالبی خوانا برای انسان --progress نمایش پیشرفت حین انتقال -P مشابه --partial --progress --itemize-changes, -i ارائه خلاصهٔ تغییرات برای همهٔ به‌روزرسانی‌ها --remote-option=OPT, -M ارسال OPTION تنها به سمت راه‌دور --out-format=FORMAT خروجی به‌روزرسانی‌ها با استفاده از FORMAT مشخص‌شده --log-file=FILE ثبت وقایع جاری در پروندهٔ FILE مشخص‌شده --log-file-format=FMT ثبت وقایع به‌روزرسانی‌ها با استفاده از FMT مشخص‌شده --password-file=FILE خواندن گذرواژهٔ دسترسی به دیمن از FILE --early-input=FILE استفاده از FILE برای ورودی اجرای زودهنگام دیمن --list-only فهرست‌کردن پرونده‌ها به جای رونوشت گرفتن از آن‌ها --bwlimit=RATE محدودکردن پهنای باند I/O سوکت --stop-after=MINS توقف rsync پس از سپری شدن MINS دقیقه --stop-at=y-m-dTh:m توقف rsync در نقطهٔ زمانی مشخص‌شده --fsync اجرای fsync روی تک‌تک پرونده‌های نوشته‌شده --write-batch=FILE نوشتن به‌روزرسانی دسته‌ای در FILE --only-write-batch=FILE مشابه --write-batch اما بدون به‌روزرسانی مقصد --read-batch=FILE خواندن به‌روزرسانی دسته‌ای از FILE --protocol=NUM اجبار به استفاده از نسخهٔ پروتکل قدیمی‌تر --iconv=CONVERT_SPEC درخواست تبدیل مجموعه نویسه‌های (charset) نام پرونده‌ها --checksum-seed=NUM تنظیم بذر چِک‌سام بلوک/پرونده (پیشرفته) --ipv4, -4 ترجیح دادن IPv4 --ipv6, -6 ترجیح دادن IPv6 --version, -V نمایش نسخه + سایر اطلاعات و خروج --help, -h (*) نمایش این راهنما (* گزینه -h تنها در صورتی که به تنهایی بیاید راهنما است) .fi .fi .P برنامه rsync می‌تواند به عنوان یک دیمن (daemon) نیز اجرا شود، که در این صورت گزینه‌های زیر پذیرفته می‌شوند: .P .nf --daemon run as an rsync daemon --address=ADDRESS bind to the specified address --bwlimit=RATE limit socket I/O bandwidth --config=FILE specify alternate rsyncd.conf file --dparam=OVERRIDE, -M override global daemon config parameter --no-detach do not detach from the parent --port=PORT listen on alternate port number --log-file=FILE override the "log file" setting --log-file-format=FMT override the "log format" setting --sockopts=OPTIONS specify custom TCP options --verbose, -v increase verbosity --ipv4, -4 prefer IPv4 --ipv6, -6 prefer IPv6 --help, -h show this help (when used with --daemon) .fi .P .SH "گزینه‌ها (OPTIONS)" .P برنامه rsync هم گزینه‌های طولانی (دو خط تیره + کلمه) و هم کوتاه (یک خط تیره + حرف) را می‌پذیرد. فهرست کامل گزینه‌های موجود در زیر شرح داده شده است. اگر یک گزینه را بتوان به بیش از یک روش مشخص کرد، گزینه‌ها با ویرگول از یکدیگر جدا شده‌اند. برخی از گزینه‌ها فقط دارای حالت طولانی هستند و حالت کوتاه ندارند. .P اگر گزینه‌ای پارامتر دریافت کند، آن پارامتر فقط بعد از حالت طولانی فهرست می‌شود، هرچند که برای حالت کوتاه نیز باید تعیین شود. هنگام مشخص کردن یک پارامتر، می‌توانید از قالب‌های \fB\-\-option=param\fP، \fB\-\-option\ param\fP، \fB\-o=param\fP، \fB\-o\ param\fP، یا \fB\-oparam\fP استفاده کنید (حالت‌های آخر فرض می‌کنند که گزینه شما دارای یک حالت کوتاه است). .P ممکن است لازم باشد پارامتر به نحوی داخل نقل‌قول قرار گیرد تا در حین پردازش خط فرمان توسط پوسته (shell) بدون تغییر باقی بماند. همچنین به یاد داشته باشید که علامت تیلدا (\fB~\fP) در ابتدای مسیر پرونده توسط پوسته جایگزین می‌شود، بنابراین اگر می‌خواهید پوسته محلی آن را بسط دهد، حتماً نام گزینه را با یک فاصله (به جای علامت مساوی) از مسیر جدا کنید. .P .IP "\fB\-\-help\fP" یک صفحه راهنمای کوتاه در شرح گزینه‌های موجود در rsync چاپ کرده و خارج می‌شود. همچنین می‌توانید از \fB\-h\fP به جای \fB\-\-help\fP استفاده کنید مشروط بر اینکه بدون هیچ گزینه یا آرگومان دیگری استفاده شود (چرا که در غیر این صورت به معنای \fB\-\-human\-readable\fP خواهد بود). .IP "\fB\-\-version\fP, \fB\-V\fP" نسخه rsync را به همراه اطلاعات دیگر چاپ کرده و خارج می‌شود. در صورت تکرار، اطلاعات با ساختار JSON خروجی داده می‌شوند که همچنان برای انسان خوانا است (فقط در سمت کلاینت). .IP خروجی شامل فهرستی از قابلیت‌های کامپایل‌شده، فهرستی از بهینه‌سازی‌ها، فهرست پیش‌فرض الگوریتم‌های checksum، فهرست پیش‌فرض الگوریتم‌های فشرده‌سازی، فهرست پیش‌فرض شیوه‌های احراز هویت دیمن، پیوندی به وب‌سایت rsync و چند مورد دیگر است. .IP "\fB\-\-verbose\fP, \fB\-v\fP" این گزینه میزان اطلاعاتی را که در طول انتقال دریافت می‌کنید افزایش می‌دهد. به طور پیش‌فرض، rsync بدون خروجی متنی کار می‌کند. یک گزینه \fB\-v\fP تنها، اطلاعاتی درباره پرونده‌های در حال انتقال و یک خلاصه کوتاه در پایان ارائه می‌دهد. استفاده از دو گزینه \fB\-v\fP اطلاعاتی درباره پرونده‌های نادیده‌گرفته‌شده و جزئیات کمی بیشتر در پایان ارائه می‌کند. استفاده از بیش از دو گزینه \fB\-v\fP تنها زمانی باید به کار رود که در حال اشکال‌زدایی (debug) برنامه rsync هستید. .IP خلاصه پایان کار، تعداد بایت‌های ارسال‌شده به rsync راه‌دور (که در یک رونوشت محلی همان سمت گیرنده است)، تعداد بایت‌های دریافت شده از میزبان راه‌دور، و میانگین بایت بر ثانیه داده‌های منتقل‌شده در کل مدت زمان اجرای rsync را گزارش می‌دهد. خط دوم اندازه کل (به بایت) را نشان می‌دهد، که مجموع اندازه تمام پرونده‌هایی است که rsync آن‌ها را برای انتقال بررسی کرده است. همچنین مقدار «speedup» را نشان می‌دهد که حاصل تقسیم اندازه کل پرونده‌ها بر مجموع بایت‌های ارسال‌شده و دریافت‌شده است (که صرفاً یک شاخص تقریبی است و مقدار بیشتر آن مطلوب‌تر است). توجه داشته باشید که این مقادیر بایتی را می‌توان با استفاده از گزینه‌های \fB\-\-human\-readable\fP (یا \fB\-\-no\-human\-readable\fP) خواناتر (یا با جزئیات عددی دقیق‌تر) کرد. .IP گزینه \fB\-v\fP معادل تنظیم گروه‌هایی از گزینه‌های \fB\-\-info\fP و \fB\-\-debug\fP است. شما می‌توانید این گزینه‌های جدیدتر را علاوه بر \fB\-\-verbose\fP یا به جای آن استفاده کنید، چرا که هر تنظیم دقیق (fine-grained) بر تنظیمات ضمنی \fB\-v\fP مقدم است. هر دو گزینه \fB\-\-info\fP و \fB\-\-debug\fP دارای متن راهنمایی هستند که مشخص می‌کند دقیقاً چه پرچم‌هایی برای هر سطح افزایش پرگویی (verbosity) تنظیم می‌شوند (از \fB\-\-info=help\fP یا \fB\-\-debug=help\fP برای مشاهده آن‌ها استفاده کنید). .IP با این حال، به یاد داشته باشید که تنظیم «\fBmax\ verbosity\fP» دیمن، حداکثر مقدار پرچم‌های مجزای قابل تنظیم در سمت دیمن را محدود می‌کند. برای نمونه، اگر حداکثر ۲ باشد، هر پرچم info و/یا debug که مقداری بالاتر از مقدار تنظیم‌شده توسط \fB\-vv\fP داشته باشد، در گزارش‌های دیمن به سطح \fB\-vv\fP تنزل خواهد یافت. .IP "\fB\-\-info=FLAGS\fP" این گزینه به شما امکان کنترل دقیق بر خروجی اطلاعاتی که می‌خواهید ببینید را می‌دهد. نام هر پرچم مجزا می‌تواند با یک شماره سطح همراه باشد؛ 0 به معنای غیرفعال کردن آن خروجی، 1 سطح خروجی پیش‌فرض، و اعداد بالاتر افزایش‌دهنده خروجی آن پرچم هستند (برای مواردی که از سطوح بالاتر پشتیبانی می‌کنند). از \fB\-\-info=help\fP برای مشاهده تمام نام پرچم‌های موجود، خروجی آن‌ها و اینکه چه پرچم‌هایی برای هر افزایش سطح پرگویی اضافه می‌شوند استفاده کنید. چند مثال: .RS 4 .IP .nf rsync -a --info=progress2 src/ dest/ rsync -avv --info=stats2,misc1,flist0 src/ dest/ .fi .RE .IP توجه داشته باشید که خروجی \fB\-\-info=name\fP تحت تأثیر گزینه‌های \fB\-\-out\-format\fP و \fB\-\-itemize\-changes\fP (\fB\-i\fP) قرار دارد. برای اطلاعات بیشتر درباره نحوه و زمان ارسال خروجی، آن گزینه‌ها را ببینید. .IP این گزینه در نسخه 3.1.0 (منتشر شده در سپتامبر 2013) اضافه شد، بنابراین rsync قدیمی‌تر در سمت سرور ممکن است تلاش‌های شما برای کنترل دقیق را رد کند. همچنین هنگام تعامل با یک دیمن، هشدار «\fBmax\ verbosity\fP» در بالا را ببینید. .IP "\fB\-\-debug=FLAGS\fP" این گزینه به شما امکان کنترل دقیق بر خروجی اشکال‌زدایی (debug) که می‌خواهید ببینید را می‌دهد. نام هر پرچم مجزا می‌تواند با یک شماره سطح همراه باشد؛ 0 به معنای غیرفعال کردن آن خروجی، 1 سطح خروجی پیش‌فرض، و اعداد بالاتر افزایش‌دهنده خروجی آن پرچم هستند (برای مواردی که از سطوح بالاتر پشتیبانی می‌کنند). از \fB\-\-debug=help\fP برای مشاهده تمام نام پرچم‌های موجود، خروجی آن‌ها و پرچم‌های اضافه‌شده با هر افزایش سطح پرگویی استفاده کنید. چند مثال: .RS 4 .IP .nf rsync -avvv --debug=none src/ dest/ rsync -avA --del --debug=del2,acl src/ dest/ .fi .RE .IP توجه داشته باشید که برخی پیام‌های اشکال‌زدایی تنها در صورت مشخص شدن گزینه \fB\-\-stderr=all\fP در خروجی ظاهر می‌شوند، به‌ویژه پیام‌های مربوط به اشکال‌زدایی I/O و بافر. .IP این گزینه توسط کلاینت به سمت سرور ارسال نمی‌شود، بنابراین می‌توانید مقادیر اشکال‌زدایی متفاوتی را برای هر سمت انتقال مشخص کنید. این قابلیت همچنین به شما امکان می‌دهد گزینه‌های اشکال‌زدایی را مشخص کنید که تنها در یکی از نسخه‌های rsync وجود دارند. اگر می‌خواهید گزینه یکسانی را در هر دو سمت تکرار کنید، استفاده از بسط آکولاد (brace expansion) روشی آسان برای صرفه‌جویی در تایپ است. این روش در zsh و bash کار می‌کند: .RS 4 .IP .nf rsync -aiv {-M,}--debug=del2 src/ dest/ .fi .RE .IP "\fB\-\-stderr=errors|all|client\fP" این گزینه کنترل می‌کند که کدام فرآیندها در stderr خروجی تولید کنند و آیا پیام‌های اطلاع‌رسانی به جای stdout به stderr ارسال شوند یا خیر. رشته‌های حالت را می‌توان تا یک حرف تکی مخفف کرد. ۳ انتخاب ممکن عبارتند از: .IP .RS .IP o \fBerrors\fP \- (پیش‌فرض) باعث می‌شود تمام فرایندهای rsync خطاها را مستقیماً به stderr ارسال کنند، حتی اگر فرایند در سمت دوردست انتقال باشد. پیام‌های اطلاعاتی از طریق جریان پروتکل به سمت کلاینت ارسال می‌شوند. اگر stderr در دسترس نباشد (مثلاً هنگام اتصال مستقیم با یک دیمن از طریق سوکت) ارسال خطاها به جریان پروتکل واگذار می‌شود. .IP o \fBall\fP \- باعث می‌شود تمام پیام‌های rsync (اطلاعاتی و خطا) از تمام فرایندهای (ممکن) مستقیماً روی stderr نوشته شوند. این کار باعث می‌شود stderr به‌صورت خط‌به‌خط بافر شود (به‌جای بدون بافر بودن) و امکان تفکیک پیام‌های اطلاعاتی و خطا بر اساس دستگیره فایل را از بین می‌برد. برای کسانی که اشکال‌زدایی می‌کنند یا از چندین سطح پرحرفی استفاده می‌کنند، این گزینه می‌تواند به جلوگیری از مسدود شدن جریان انتقال کمک کند (که باید از هرگونه احتمال قفل شدن ناشی از بن‌بست جلوگیری کند). همچنین به \fB\-\-debug\fP اجازه می‌دهد تا برخی پیام‌های اضافی مرتبط با I/O را فعال کند. .IP o \fBclient\fP \- باعث می‌شود تمام پیام‌های rsync از طریق جریان پروتکل به سمت کلاینت ارسال شوند. یک فرایند کلاینت تمام پیام‌ها را خروجی می‌دهد، خطاها روی stderr و پیام‌های اطلاعاتی روی stdout. این حالت در نسخه‌های قدیمی‌تر rsync پیش‌فرض \fBبود\fP، اما زمانی که حجم زیادی از داده‌های انتقال پیش از پیام‌ها قرار دارد می‌تواند باعث تاخیر در نمایش خطا شود. اگر پرونده‌ها را به یک rsync قدیمی‌تر ارسال می‌کنید، ممکن است بخواهید از \fB\-\-stderr=all\fP استفاده کنید زیرا این ساختار چندین نسخه است که وجود دارد. .RE .IP برنامه rsync همچنین گزینه‌های قدیمی \fB\-\-msgs2stderr\fP و \fB\-\-no\-msgs2stderr\fP را به ترتیب معادل تنظیمات \fBall\fP و \fBclient\fP می‌پذیرد و در صورتی که rsync دوردست نسخه قدیمی‌تری باشد، هنگام ارسال تنظیمات غیرپیش‌فرض به سمت دوردست از آن‌ها استفاده می‌کند. .IP "\fB\-\-quiet\fP, \fB\-q\fP" این گزینه مقدار اطلاعاتی را که در طول انتقال به شما داده می‌شود کاهش می‌دهد، به‌ویژه پیام‌های اطلاعاتی را از سمت کارساز دوردست سرکوب می‌کند. این گزینه هنگام فراخوانی rsync از طریق cron مفید است. .IP "\fB\-\-no\-motd\fP" این گزینه بر اطلاعاتی که توسط کلاینت در شروع انتقال دیمن خروجی داده می‌شود تأثیر می‌گذارد. این گزینه متن پیام روز (MOTD) را سرکوب می‌کند، اما بر فهرست ماژول‌هایی که دیمن در پاسخ به درخواست "rsync host::" ارسال می‌کند نیز تأثیر می‌گذارد (به دلیل محدودیت در پروتکل rsync)، بنابراین اگر می‌خواهید فهرست ماژول‌ها را از دیمن درخواست کنید، این گزینه را نادیده بگیرید. .IP "\fB\-\-ignore\-times\fP, \fB\-I\fP" به طور معمول rsync از هر پرونده‌ای که از قبل اندازه یکسان و برچسب زمانی ویرایش یکسانی داشته باشد صرف‌نظر می‌کند. این گزینه رفتار «بررسی سریع» را خاموش کرده و باعث می‌شود همه پرونده‌ها به‌روزرسانی شوند. .IP این گزینه می‌تواند در مقایسه با \fB\-\-ignore\-existing\fP و \fB\-\-ignore\-non\-existing\fP گیج‌کننده باشد، از این جهت که آن گزینه‌ها باعث می‌شوند rsync پرونده‌های کمتری را منتقل کند، در حالی که این گزینه باعث می‌شود rsync پرونده‌های بیشتری را انتقال دهد. .IP "\fB\-\-size\-only\fP" این گزینه الگوریتم «بررسی سریع» rsync را برای یافتن پرونده‌هایی که نیاز به انتقال دارند تغییر می‌دهد؛ آن را از حالت پیش‌فرضِ انتقال پرونده‌هایی با اندازه تغییریافته یا زمان آخرین ویرایش تغییریافته، به صرفاً جستجوی پرونده‌هایی که فقط اندازه آن‌ها تغییر کرده تبدیل می‌کند. این مورد زمانی مفید است که استفاده از rsync را پس از یک سیستم آینه‌ای دیگر آغاز می‌کنید که ممکن است برچسب‌های زمانی را دقیقاً حفظ نکرده باشد. .IP "\fB\-\-modify\-window=NUM\fP, \fB\-@\fP" هنگام مقایسه دو برچسب زمانی، اگر اختلاف آن‌ها بیشتر از مقدار modify-window نباشد، rsync آن‌ها را برابر در نظر می‌گیرد. مقدار پیش‌فرض 0 است که تنها ثانیه‌های صحیح را مطابقت می‌دهد. اگر یک مقدار منفی تعیین کنید (و نسخه گیرنده حداقل 3.1.3، منتشرشده در ژانویه 2018 باشد)، نانوثانیه‌ها نیز در نظر گرفته خواهند شد. تعیین مقدار 1 برای رونوشت‌ها به/از سیستم‌های پرونده FAT ویندوز مایکروسافت مفید است، زیرا FAT زمان‌ها را با دقت 2 ثانیه‌ای نشان می‌دهد (به زمان‌ها اجازه می‌دهد تا حداکثر 1 ثانیه با نسخه اصلی تفاوت داشته باشند). .IP اگر می‌خواهید تمام انتقال‌های شما به‌طور پیش‌فرض نانوثانیه‌ها را مقایسه کنند، می‌توانید یک پرونده \fB~/.popt\fP ایجاد کرده و این خطوط را در آن قرار دهید: .RS 4 .IP .nf rsync alias -a -a@-1 rsync alias -t -t@-1 .fi .RE .IP با قرار گرفتن این مقدار به عنوان پیش‌فرض، باید گزینهٔ \fB\-\-modify\-window=0\fP (یا \fB\-@0\fP) را برای بازنویسی آن و نادیده گرفتن نانوثانیه‌ها مشخص کنید؛ به عنوان مثال اگر در حال رونوشت بین ext3 و ext4 هستید، یا rsync دریافت‌کننده قدیمی‌تر از نسخهٔ 3.1.3 است. .IP "\fB\-\-checksum\fP, \fB\-c\fP" این گزینه روش بررسی rsync برای تشخیص تغییر فایل‌ها و نیاز آن‌ها به انتقال را تغییر می‌دهد. بدون این گزینه، rsync از یک «بررسی سریع» استفاده می‌کند که (به‌طور پیش‌فرض) مطابقت اندازه و زمان آخرین تغییر هر فایل را بین فرستنده و گیرنده بررسی می‌کند. این گزینه این رفتار را تغییر می‌دهد تا برای هر فایلی که اندازهٔ یکسانی دارد، یک چِک‌سام (checksum) مقایسه شود. تولید چک‌سام‌ها به این معنی است که هر دو طرف I/O دیسک زیادی را برای خواندن تمام داده‌های فایل‌های موجود در انتقال صرف می‌کنند، بنابراین این کار می‌تواند سرعت را به میزان قابل توجهی کاهش دهد (و این مورد قبل از هرگونه خواندنی است که برای انتقال فایل‌های تغییریافته انجام می‌شود). .IP طرف فرستنده چک‌سام‌های خود را هنگام پویش سامانهٔ پرونده که فهرست فایل‌های موجود را می‌سازد، تولید می‌کند. گیرنده چک‌سام‌های خود را هنگام پویش برای فایل‌های تغییریافته تولید می‌کند و برای هر فایلی که اندازه‌ای برابر با فایل متناظر در فرستنده داشته باشد، چک‌سام محاسبه می‌کند: فایل‌هایی با اندازهٔ تغییریافته یا چک‌سام تغییریافته برای انتقال انتخاب می‌شوند. .IP توجه داشته باشید که rsync معمولاً با بررسی یک چک‌سام از کل فایل که هنگام انتقال فایل تولید می‌شود، تأیید می‌کند که هر فایل \fIمنتقل‌شده\fP به درستی در طرف گیرنده بازسازی شده است؛ اما این تأیید خودکار پس از انتقال، هیچ ارتباطی با بررسی پیش از انتقال این گزینه برای پرسش «آیا این فایل نیاز به به‌روزرسانی دارد؟» ندارد. .IP چک‌سامِ مورد استفاده به‌طور خودکار بین کلاینت و سرور توافق می‌شود، اما می‌توان آن را با استفاده از گزینهٔ \fB\-\-checksum\-choice\fP (\fB\-\-cc\fP) یا متغیر محیطی که در بخش مربوط به آن گزینه توضیح داده شده است، بازنویسی کرد. .IP "\fB\-\-archive\fP, \fB\-a\fP" این گزینه معادل \fB\-rlptgoD\fP است. روشی سریع برای بیان این است که رونوشت بازگشتی می‌خواهید و می‌خواهید تقریباً همه چیز حفظ شود. توجه داشته باشید که این گزینه شامل حفظ ACLها (\fB\-A\fP)، ویژگی‌های پیشرفته xattrs (\fB\-X\fP)، زمان‌های دسترسی atimes (\fB\-U\fP)، زمان‌های ساخت crtimes (\fB\-N\fP)، یا یافتن و حفظ پیوندهای سخت (\fB\-H\fP) \fBنمی‌شود\fP. .IP تنها استثنا برای هم‌ارزی بالا زمانی است که \fB\-\-files\-from\fP مشخص شده باشد، که در این حالت \fB\-r\fP اعمال نمی‌شود. .IP "\fB\-\-no\-OPTION\fP" می‌توانید یک یا چند گزینهٔ ضمنی را با افزودن پیشوند "-no" به ابتدای نام گزینه خاموش کنید. همهٔ گزینه‌های مثبت دارای معادل نقیض نیستند، اما بسیاری از آن‌ها این‌گونه هستند؛ از جمله مواردی که می‌توان برای غیرفعال کردن یک گزینهٔ ضمنی استفاده کرد (مانند \fB\-\-no\-D\fP، \fB\-\-no\-perms\fP) یا مواردی که در شرایط مختلف پیش‌فرض‌های متفاوتی دارند (مانند \fB\-\-no\-whole\-file\fP، \fB\-\-no\-blocking\-io\fP، \fB\-\-no\-dirs\fP). هر گزینهٔ نقیض معتبر، هر دو نام کوتاه و بلند گزینه را پس از پیشوند "-no" می‌پذیرد (مانند \fB\-\-no\-R\fP که همان \fB\-\-no\-relative\fP است). .IP به عنوان مثال، اگر می‌خواهید از \fB\-\-archive\fP (\fB\-a\fP) استفاده کنید اما گزینهٔ \fB\-\-owner\fP (\fB\-o\fP) را نمی‌خواهید، به جای تبدیل \fB\-a\fP به \fB\-rlptgD\fP، می‌توانید \fB\-a\ \-\-no\-o\fP (یا \fB\-\-archive\ \-\-no\-owner\fP) را مشخص کنید. .IP ترتیب گزینه‌ها مهم است: اگر \fB\-\-no\-r\ \-a\fP را مشخص کنید، گزینهٔ \fB\-r\fP در نهایت فعال خواهد شد، که برعکس \fB\-a\ \-\-no\-r\fP است. همچنین توجه داشته باشید که عوارض جانبی گزینهٔ \fB\-\-files\-from\fP وابسته به موقعیت مکانی نیست، زیرا بر وضعیت پیش‌فرض چندین گزینه اثر می‌گذارد و معنای \fB\-a\fP را کمی تغییر می‌دهد (برای جزئیات بیشتر به گزینهٔ \fB\-\-files\-from\fP مراجعه کنید). .IP "\fB\-\-recursive\fP, \fB\-r\fP" این به rsync می‌گوید که دایرکتوری‌ها را به‌صورت بازگشتی رونوشت کند. همچنین \fB\-\-dirs\fP (\fB\-d\fP) را برای گزینه‌ای که امکان پویش یک تک‌دایرکتوری را فراهم می‌کند، ببینید. .IP برای توضیحات مربوط به بازگشت افزایشی جهت ساخت فهرست فایل‌ها برای انتقال، گزینهٔ \fB\-\-inc\-recursive\fP را ببینید. .IP "\fB\-\-inc\-recursive\fP, \fB\-\-i\-r\fP" این گزینه بازگشت‌پذیری افزایشی را هنگام پویش فایل‌ها به‌طور صریح فعال می‌کند؛ این ویژگی هنگام استفاده از گزینه \fB\-\-recursive\fP و در صورتی که هر دو طرف انتقال rsync نسخه 3.0.0 (منتشر شده در مارس ۲۰۰۸) یا جدیدتر را اجرا کنند، به‌طور پیش‌فرض فعال است. .IP بازگشت‌پذیری افزایشی حافظه بسیار کمتری نسبت به حالت غیر‌افزایشی مصرف می‌کند و انتقال را نیز سریع‌تر آغاز می‌کند (زیرا نیازی به پویش کل ساختار درختی پیش از شروع انتقال فایل‌ها ندارد). اگر هیچ بازگشت‌پذیری در فایل‌های مبدأ فعال نباشد، این گزینه تأثیری نخواهد داشت. .IP برخی گزینه‌ها نیازمند آگاهی rsync از کل فهرست فایل‌ها هستند، بنابراین این گزینه‌ها حالت بازگشت‌پذیری افزایشی را غیرفعال می‌کنند. این موارد عبارتند از: .IP .RS .IP o \fB\-\-delete\-before\fP (پیش‌فرض قدیمی \fB\-\-delete\fP) .IP o \fB\-\-delete\-after\fP .IP o \fB\-\-prune\-empty\-dirs\fP .IP o \fB\-\-delay\-updates\fP .RE .IP جهت سازگاری با بازگشت‌پذیری افزایشی، \fB\-\-delete\-during\fP حالت پیش‌فرض حذف برای \fB\-\-delete\fP است. .IP یکی از اثرات جانبی بازگشت‌پذیری افزایشی این است که زیرپوشه‌های ناموجود درون پوشه‌ای که به‌صورت بازگشتی پویش می‌شود، (به‌طور پیش‌فرض) قبل از پیمایش درون آن زیرپوشه‌ها ایجاد می‌شوند. این ایجاد زودهنگام (در مقایسه با بازگشت‌پذیری غیر‌افزایشی) به rsync اجازه می‌دهد زمان تغییر دایرکتوری تکمیل‌شده را بلافاصله تنظیم کند (بدون نیاز به معطل ماندن تا پایان رونوشت بازگشتی مجموعه فایل‌ها). با این حال، این دایرکتوری‌های اولیه هنوز mode، mtime یا مالکیت نهایی خود را ندارند\ \-\- آن‌ها تا زمان شروع واقعی رونوشت زیرپوشه، دسترسی‌های محدودکننده‌تری خواهند داشت. با استفاده از گزینه \fB\-\-omit\-dir\-times\fP می‌توان از این رفتار ساخت زودهنگام جلوگیری کرد. .IP بازگشت‌پذیری افزایشی را می‌توان با استفاده از گزینه \fB\-\-no\-inc\-recursive\fP (\fB\-\-no\-i\-r\fP) غیرفعال کرد. .IP "\fB\-\-no\-inc\-recursive\fP, \fB\-\-no\-i\-r\fP" الگوریتم بازگشت‌پذیری افزایشی گزینه \fB\-\-recursive\fP را غیرفعال می‌کند. این امر باعث می‌شود rsync قبل از شروع انتقال فایل‌ها، کل فهرست فایل‌ها را پویش کند. برای اطلاعات بیشتر \fB\-\-inc\-recursive\fP را ببینید. .IP "\fB\-\-relative\fP, \fB\-R\fP" استفاده از مسیرهای نسبی. بدین معنا که نام مسیرهای کامل مشخص‌شده در خط فرمان به جای فقط بخش انتهایی نام فایل‌ها، به سرور ارسال می‌شوند. این ویژگی به‌ویژه زمانی مفید است که می‌خواهید چندین دایرکتوری مختلف را به‌طور همزمان ارسال کنید. برای مثال، این دستور: .RS 4 .IP .nf rsync -av /foo/bar/baz.c remote:/tmp/ .fi .RE .IP فایلی با نام baz.c در /tmp/ روی ماشین دوردست ایجاد می‌کند. اگر در عوض از این دستور استفاده کنید: .RS 4 .IP .nf rsync -avR /foo/bar/baz.c remote:/tmp/ .fi .RE .IP آن‌گاه فایلی به نام /tmp/foo/bar/baz.c روی ماشین دوردست ایجاد می‌شود و مسیر کامل آن حفظ می‌گردد. این بخش‌های اضافی مسیر \(dqدایرکتوری‌های ضمنی\(dq نامیده می‌شوند (مانند دایرکتوری‌های \(dqfoo\(dq و \(dqfoo/bar\(dq در مثال بالا). .IP ابزار rsync همیشه این دایرکتوری‌های ضمنی را به عنوان دایرکتوری‌های واقعی در فهرست فایل‌ها ارسال می‌کند، حتی اگر یکی از بخش‌های مسیر در سمت فرستنده در واقع یک پیوند نمادین (symlink) باشد. این کار از برخی رفتارهای کاملاً غیرمنتظره هنگام رونوشت مسیر کامل فایلی که در مسیر خود پیوند نمادین دارد، جلوگیری می‌کند. اگر می‌خواهید یک پیوند نمادین در سمت سرور را تکثیر کنید، هم خود پیوند نمادین را از طریق مسیرش و هم دایرکتوری مرجع را از طریق مسیر واقعی‌اش لحاظ کنید. اگر در سمت فرستنده با نسخه قدیمی‌تر rsync سروکار دارید، ممکن است نیاز به استفاده از گزینه \fB\-\-no\-implied\-dirs\fP داشته باشید. .IP همچنین امکان محدود کردن مقدار اطلاعات مسیری که به عنوان دایرکتوری‌های ضمنی برای هر مسیر مشخص‌شده ارسال می‌شود، وجود دارد. با یک نسخه مدرن rsync در سمت فرستنده (از نسخه 2.6.7، منتشر شده در مارس ۲۰۰۶)، می‌توانید یک نقطه و یک اسلش در مسیر مبدأ درج کنید، مانند این: .RS 4 .IP .nf rsync -avR /foo/./bar/baz.c remote:/tmp/ .fi .RE .IP این دستور /tmp/bar/baz.c را در رایانه گیرنده ایجاد می‌کند. (توجه داشته باشید که بعد از نقطه حتماً باید اسلش بیاید، بنابراین «/foo/.» کوتاه نخواهد شد.) برای نسخه‌های قدیمی‌تر rsync، لازم است برای محدود کردن مسیر مبدأ، دایرکتوری را تغییر دهید. برای مثال، هنگام ارسال فایل‌ها: .RS 4 .IP .nf (cd /foo; rsync -avR bar/baz.c remote:/tmp/) .fi .RE .IP (توجه داشته باشید که پرانتزها دو دستور را در یک زیرپوسته قرار می‌دهند تا دستور «cd» برای دستورات بعدی اعمال نشود.) اگر در حال دریافت فایل‌ها از یک نسخه قدیمی‌تر rsync هستید، از این روش استفاده کنید (اما فقط برای انتقال‌های غیردیمن): .RS 4 .IP .nf rsync -avR --rsync-path="cd /foo; rsync" \\ remote:bar/baz.c /tmp/ .fi .RE .IP "\fB\-\-no\-implied\-dirs\fP" این گزینه بر رفتار پیش‌فرض گزینه \fB\-\-relative\fP تأثیر می‌گذارد. هنگامی که مشخص شود، ویژگی‌های دایرکتوری‌های ضمنی برگرفته از نام‌های مبدأ در انتقال لحاظ نمی‌شوند. این بدان معناست که بخش‌های مسیر مربوطه در سیستم مقصد در صورت وجود بدون تغییر باقی می‌مانند، و هرگونه دایرکتوری ضمنیِ ناموجود با ویژگی‌های پیش‌فرض ایجاد می‌شود. این کار حتی اجازه می‌دهد تا این بخش‌های مسیر ضمنی تفاوت‌های بزرگی داشته باشند، مانند اینکه در سمت گیرنده یک پیوند نمادین به یک دایرکتوری باشند. .IP به عنوان مثال، اگر یک آرگومان خط فرمان یا یک ورودی files-from به rsync بگوید پرونده «path/foo/file» را منتقل کند، دایرکتوری‌های «path» و «path/foo» هنگام استفاده از \fB\-\-relative\fP ضمنی تلقی می‌شوند. اگر «path/foo» در سیستم مقصد یک پیوند نمادین به «bar» باشد، rsync گیرنده در حالت عادی «path/foo» را حذف می‌کند، آن را مجدداً به عنوان یک دایرکتوری می‌سازد، و پرونده را در دایرکتوری جدید دریافت می‌کند. با \fB\-\-no\-implied\-dirs\fP، rsync گیرنده پیوند نمادینِ موجودِ «path/foo» را در جای خود باقی می‌گذارد و آن را دنبال می‌کند، بنابراین پرونده از طریق پیوند نمادین نوشته شده و در نهایت به «path/bar» می‌رسد. به پیامد امنیتی توجه کنید: یک پیوند نمادین به دایرکتوری از پیش موجود در درون درخت مقصد، محل نوشته شدن پرونده را تغییر جهت می‌دهد؛ بنابراین فقط زمانی از \fB\-\-no\-implied\-dirs\fP استفاده کنید که به بخش‌های مسیر موجود در مقصد اعتماد دارید. (پیوند نمادینی که هدف آن مطلق باشد یا از درخت مقصد خارج شود، همچنان توسط تحلیل‌گر مسیر امن رد می‌شود و دنبال نمی‌گردد.) روش دیگر برای حفظ این پیوند، استفاده از گزینه \fB\-\-keep\-dirlinks\fP است (که همچنین بر پیوندهای نمادین به دایرکتوری‌ها در بقیه انتقال نیز تأثیر خواهد گذاشت). .IP هنگام دریافت فایل‌ها از یک نسخه rsync قدیمی‌تر از 3.0.0 (مارس ۲۰۰۸)، در صورتی که سمت فرستنده پیوند نمادینی در مسیر درخواستی شما داشته باشد و بخواهید دایرکتوری‌های ضمنی به عنوان دایرکتوری‌های معمولی منتقل شوند، ممکن است نیاز به استفاده از این گزینه داشته باشید. .IP "\fB\-\-backup\fP, \fB\-b\fP" با این گزینه، پرونده‌های مقصد از قبل موجود با انتقال یا حذف هر پرونده تغییر نام پیدا می‌کنند (یعنی هر پرونده‌ای که قرار است حذف شود یا رونویسی گردد، در عوض تغییر نام می‌یابد). شما می‌توانید با استفاده از گزینه‌های \fB\-\-backup\-dir\fP و \fB\-\-suffix\fP کنترل کنید که پرونده پشتیبان به کجا برود و چه پسوندی (در صورت وجود) اضافه شود. .IP اگر \fB\-\-backup\-dir\fP را مشخص نکنید: .RS .IP .IP 1. گزینه \fB\-\-omit\-dir\-times\fP به اجبار فعال خواهد شد .IP 2. استفاده از \fB\-\-delete\fP (بدون \fB\-\-delete\-excluded\fP)، باعث می‌شود rsync یک قاعده فیلتر "protect" برای پسوند پشتیبان به انتهای همه فیلترهای موجود شما اضافه کند که شبیه این است: \fB\-f\ "P\ *~"\fP. این قاعده از حذف پرونده‌های پشتیبان‌گیری‌شده قبلی جلوگیری می‌کند. .RE .IP توجه داشته باشید که اگر قواعد فیلتر خودتان را ارائه می‌دهید، ممکن است نیاز باشد قاعده exclude/protect خود را به‌صورت دستی در جایی بالاتر در فهرست قرار دهید تا اولویت کافی برای مؤثر بودن داشته باشد (به عنوان مثال اگر قواعد شما شامل یک استثنا/درج پایانی \fB*\fP باشد، قاعده خودکار اضافه‌شده هرگز در دسترس نخواهد بود). .IP "\fB\-\-backup\-dir=DIR\fP" این گزینه به طور ضمنی گزینه \fB\-\-backup\fP را فعال می‌کند و به rsync می‌گوید تمام پشتیبان‌ها را در دایرکتوری مشخص‌شده در سمت گیرنده ذخیره کند. این مورد می‌تواند برای پشتیبان‌گیری‌های افزایشی استفاده شود. شما همچنین می‌توانید با استفاده از گزینه \fB\-\-suffix\fP یک پسوند پشتیبان مشخص کنید (در غیر این صورت پرونده‌های پشتیبان‌گیری‌شده در دایرکتوری مشخص‌شده نام اصلی پرونده خود را حفظ خواهند کرد). .IP توجه داشته باشید که اگر یک مسیر نسبی مشخص کنید، دایرکتوری پشتیبان نسبت به دایرکتوری مقصد خواهد بود، بنابراین احتمالاً می‌خواهید یک مسیر مطلق یا مسیری که با "../" شروع می‌شود مشخص کنید. اگر یک دیمن rsync گیرنده باشد، دایرکتوری پشتیبان نمی‌تواند خارج از سلسله‌مراتب مسیر ماژول باشد، بنابراین مراقبت بیشتری به خرج دهید تا به‌طور ناخواسته در دایرکتوری پشتیبان حذفی انجام ندهید یا کپی نکنید. .IP "\fB\-\-suffix=SUFFIX\fP" این گزینه به شما اجازه می‌دهد پسوند پشتیبان پیش‌فرض استفاده‌شده با گزینه \fB\-\-backup\fP (\fB\-b\fP) را لغو کنید. در صورتی که \fB\-\-backup\-dir\fP مشخص نشده باشد، پسوند پیش‌فرض یک \fB~\fP است، در غیر این صورت یک رشته خالی است. .IP "\fB\-\-update\fP, \fB\-u\fP" این گزینه rsync را مجبور می‌کند از هر پرونده‌ای که در مقصد وجود دارد و زمان ویرایش آن جدیدتر از پرونده مبدأ است، صرف‌نظر کند. (اگر یک پرونده موجود در مقصد زمان ویرایشی برابر با پرونده مبدأ داشته باشد، در صورت متفاوت بودن اندازه‌ها به‌روزرسانی خواهد شد.) .IP توجه داشته باشید که این موضوع روی رونوشت دایرکتوری‌ها، پیوندهای نمادین یا سایر پرونده‌های خاص تأثیری ندارد. همچنین، تفاوت نوع شیء بین فرستنده و گیرنده همیشه برای به‌روزرسانی به اندازه کافی مهم تلقی می‌شود، صرف‌نظر از اینکه چه تاریخی روی اشیاء ثبت شده باشد. به عنوان مثال، اگر مبدأ دارای یک دایرکتوری باشد در حالی که مقصد دارای یک پرونده است، انتقال بدون توجه به برچسب‌های زمانی انجام خواهد شد. .IP این گزینه یک TRANSFER RULE است، بنابراین انتظار هیچ‌گونه اثر جانبی استثناکردن را نداشته باشید. .IP یک هشدار برای کسانی که ترکیب \fB\-\-inplace\fP با \fB\-\-update\fP را انتخاب می‌کنند: یک انتقال قطع‌شده، پرونده‌ای ناقص با زمان ویرایش بسیار جدید در سمت گیرنده به جا می‌گذارد، بنابراین اجرای مجدد انتقال احتمالاً پرونده قطع‌شده را ادامه \fBنخواهد\fP داد. به این ترتیب، معمولاً بهتر است از ترکیب این گزینه با \fB\-\-inplace\fP خودداری کنید، مگر اینکه مراحل دستی برای رسیدگی به پرونده‌های ناتمام و قطع‌شده ایجاد کرده باشید. .IP "\fB\-\-inplace\fP" این گزینه نحوه انتقال پرونده توسط rsync را هنگام نیاز به به‌روزرسانی داده‌های آن تغییر می‌دهد: به جای روش پیش‌فرض ایجاد یک نسخه جدید از پرونده و انتقال آن به محل مربوطه پس از تکمیل، rsync داده‌های به‌روزرسانی‌شده را مستقیماً روی پرونده مقصد می‌نویسد. .IP این کار چندین اثر دارد: .IP .RS .IP o پیوندهای سخت (Hard links) شکسته نمی‌شوند. این بدان معناست که داده‌های جدید از طریق سایر پیوندهای سخت به پرونده مقصد نیز قابل مشاهده خواهند بود. علاوه‌بر این، تلاش برای رونوشت پرونده‌های مبدأ متفاوت روی پرونده مقصدی با پیوندهای چندگانه، منجر به یک «طناب‌کشی» و تغییر مداوم داده‌های مقصد به عقب و جلو می‌شود. .IP o پرونده‌های اجرایی (باینری‌های) در حال استفاده را نمی‌توان به‌روزرسانی کرد (سیستم‌عامل مانع این کار می‌شود، یا باینری‌هایی که سعی در بارگذاری داده‌های خود دارند دچار رفتار ناهنجار شده یا کرش می‌کنند). .IP o داده‌های پرونده در طول انتقال در وضعیتی ناسازگار خواهند بود و در صورت متوقف شدن انتقال یا شکست در به‌روزرسانی، به همان شکل باقی خواهند ماند. .IP o پرونده‌ای که rsync اجازه نوشتن روی آن را ندارد، قابل به‌روزرسانی نیست. در حالی که کاربر ارشد (super user) می‌تواند هر پرونده‌ای را به‌روزرسانی کند، کاربر عادی برای باز کردن موفق پرونده جهت نوشتن، نیاز به داشتن مجوز نوشتن دارد. .IP o کارایی الگوریتم delta-transfer برنامه rsync ممکن است کاهش یابد اگر بخشی از داده‌های پرونده مقصد قبل از رونوشت شدن به موقعیت بعدی در پرونده، بازنویسی شوند. این موضوع در صورت استفاده از \fB\-\-backup\fP صدق نمی‌کند، زیرا rsync آن‌قدر هوشمند است که از پرونده پشتیبان به‌عنوان پرونده مبنا برای انتقال استفاده کند. .RE .IP هشدار: نباید از این گزینه برای به‌روزرسانی پرونده‌هایی که توسط دیگران در حال دسترسی هستند استفاده کنید، بنابراین هنگام استفاده از این مورد برای رونوشت دقت کنید. .IP این گزینه برای انتقال پرونده‌های بزرگ با تغییرات مبتنی بر بلوک یا داده‌های الحاقی، و همچنین در سیستم‌هایی با گلوگاه دیسک (و نه گلوگاه شبکه) مفید است. همچنین می‌تواند از تغییر کامل محتوای پرونده‌ای با تغییرات جزئی در اسنپ‌شات سامانه‌های پرونده با قابلیت copy-on-write جلوگیری کند. .IP این گزینه به‌طور ضمنی \fB\-\-partial\fP را فعال می‌کند (زیرا انتقال متوقف‌شده پرونده را حذف نمی‌کند)، اما با \fB\-\-partial\-dir\fP و \fB\-\-delay\-updates\fP تداخل دارد. .IP "\fB\-\-append\fP" این حالت رونوشت ویژه فقط برای به‌روزرسانی پرونده‌هایی کاربرد دارد که مشخصاً در حال رشد و بزرگ‌تر شدن هستند؛ یعنی هرگونه محتوای موجود در سمت گیرنده دقیقاً مشابه محتوای موجود در سمت فرستنده است. استفاده از \fB\-\-append\fP در صورتی که ۱۰۰٪ مطمئن نباشید تمام پرونده‌های موجود در فرایند انتقال اشتراکی و در حال رشد هستند \fBمی‌تواند خطرناک باشد\fP. بنابراین باید از قواعد فیلتر استفاده کنید تا پرونده‌هایی که با این معیار همخوانی ندارند حذف شوند. .IP برنامه rsync این پرونده‌های در حال رشد را در محل (in-place) بدون اعتبارسنجی محتوای موجود در پرونده به‌روزرسانی می‌کند (تنها محتوای الحاقی را اعتبارسنجی می‌کند). rsync از پرونده‌های سمت گیرنده که کوچک‌تر از پرونده متناظر در سمت فرستنده نیستند صرف‌نظر می‌کند. همچنین پرونده‌هایی را که اندازه آن‌ها در سمت فرستنده هنگام مذاکرات ارسال کاهش می‌یابد نادیده می‌گیرد (rsync در صورت وقوع این اتفاق درباره پرونده «تقلیل‌یافته» هشدار می‌دهد). .IP این امر تداخلی با به‌روزرسانی ویژگی‌های غیرمحتوایی پرونده (مانند مجوزها، مالکیت و غیره) در زمانی که پرونده نیازی به انتقال ندارد ایجاد نمی‌کند، و همچنین بر به‌روزرسانی پوشه‌ها یا پرونده‌های غیرعادی تأثیری ندارد. .IP "\fB\-\-append\-verify\fP" این حالت رونوشت ویژه شبیه به \fB\-\-append\fP عمل می‌کند، با این تفاوت که تمام داده‌های پرونده در اعتبارسنجی جمع‌کنترلی (checksum) گنجانده می‌شوند که باعث کارایی کمتر اما امنیت بالقوه بیشتر می‌شود. این گزینه در صورتی که ۱۰۰٪ مطمئن نباشید تمامی پرونده‌های انتقال اشتراکی و در حال رشد هستند \fBمی‌تواند خطرناک باشد\fP. برای جزئیات بیشتر گزینه \fB\-\-append\fP را ببینید. .IP نکته: پیش از rsync نسخه 3.0.0 (مارس ۲۰۰۸)، گزینه \fB\-\-append\fP مانند \fB\-\-append\-verify\fP عمل می‌کرد؛ بنابراین اگر با یک نسخه قدیمی‌تر rsync تعامل دارید (یا انتقال از پروتکل قدیمی‌تر از ۳۰ استفاده می‌کند)، مشخص کردن هر یک از گزینه‌های الحاق، یک انتقال از نوع \fB\-\-append\-verify\fP را آغاز خواهد کرد. .IP "\fB\-\-dirs\fP, \fB\-d\fP" به سمت فرستنده اعلام می‌کند که هر دایرکتوری مشاهده‌شده را شامل شود. برعکس \fB\-\-recursive\fP، محتوای یک دایرکتوری کپی نمی‌شود مگر اینکه نام دایرکتوری مشخص‌شده «.» باشد یا با یک اسلش پایانی خاتمه یابد (مانند «.»، «dir/.»، «dir/» و غیره). بدون این گزینه یا گزینه \fB\-\-recursive\fP، برنامه rsync تمام دایرکتوری‌هایی را که با آن‌ها مواجه می‌شود نادیده می‌گیرد (و برای هرکدام پیامی صادر می‌کند). اگر هر دو گزینه \fB\-\-dirs\fP و \fB\-\-recursive\fP را مشخص کنید، \fB\-\-recursive\fP اولویت خواهد داشت. .IP در صورتی که \fB\-\-recursive\fP مشخص نشده باشد، گزینه \fB\-\-dirs\fP به‌طور ضمنی توسط گزینه \fB\-\-files\-from\fP یا گزینه \fB\-\-list\-only\fP (شامل استفاده ضمنی از \fB\-\-list\-only\fP) فعال می‌شود (تا دایرکتوری‌ها در فهرست دیده شوند). در صورت تمایل به غیرفعال‌سازی این حالت، \fB\-\-no\-dirs\fP (یا \fB\-\-no\-d\fP) را مشخص کنید. .IP همچنین گزینه کمکی سازگاری عقبروی \fB\-\-old\-dirs\fP را ببینید. .IP "\fB\-\-old\-dirs\fP, \fB\-\-old\-d\fP" این راهکار کمکی برای سازگاری عقبروی به rsync می‌گوید از ترفند \fB\-r\ \-\-exclude='/*/*'\fP استفاده کند تا یک rsync قدیمی‌تر راه‌دور بتواند بدون پیمایش بازگشتی، محتوای یک تک‌دایرکتوری را فهرست کند. .IP "\fB\-\-mkpath\fP" تمام بخش‌های ناموجود در مسیر مقصد را ایجاد می‌کند. .IP به‌طور پیش‌فرض، rsync تنها آخرین بخش از مسیر مقصد را در صورت عدم وجود ایجاد می‌کند. اگر هر بخش دیگری وجود نداشته باشد خطا محسوب می‌شود، زیرا این امر به شناسایی اشتباهات در تعیین مسیر مقصد کمک می‌کند. با این گزینه، rsync تمام بخش‌های ناموجود مسیر مقصد را ایجاد می‌کند، دقیقاً مانند زمانی که دستور \fBmkdir\ \-p\ $DEST_PATH\fP در سمت گیرنده اجرا شده باشد. .IP هنگام تعیین مسیر مقصد، قرار دادن یک اسلش در انتها تضمین می‌کند که کل مسیر به‌عنوان نام‌های دایرکتوری برای ایجاد در نظر گرفته شوند، حتی زمانی که فهرست فایل‌ها فقط شامل یک مورد باشد. برای جزئیات کامل در مورد نحوه تصمیم‌گیری rsync درباره ایجاد شدن یا نشدن آخرین بخش مسیر مقصد به‌عنوان دایرکتوری، بخش COPYING TO A DIFFERENT NAME را ببینید. .IP اگر می‌خواهید دایرکتوری‌های مقصدِ تازه‌ساخته‌شده با دایرکتوری‌های سمت فرستنده مطابقت داشته باشند، باید به‌جای \fB\-\-mkpath\fP از \fB\-\-relative\fP (\fB\-R\fP) استفاده کنید. برای نمونه، دو دستور زیر منجر به درخت مقصد یکسانی می‌شوند، اما فقط دستور دوم تضمین می‌کند که بخش‌های "some/extra/path" با دایرکتوری‌های سمت فرستنده مطابقت داشته باشند: .RS 4 .IP .nf rsync -ai --mkpath host:some/extra/path/*.c some/extra/path/ rsync -aiR host:some/extra/path/*.c ./ .fi .RE .IP "\fB\-\-links\fP, \fB\-l\fP" پیوندهای نمادین را به فایل‌های منتقل‌شده اضافه می‌کند، به‌جای اینکه با صدور یک هشدار پر سر و صدای "non-regular file" برای هر پیوند نمادین مواجه‌شده، آن‌ها را نادیده بگیرد. همچنین می‌توانید با مشخص کردن \fB\-\-info=nonreg0\fP این هشدار را بی‌صدا کنید. .IP رفتار پیش‌فرض با پیوندهای نمادین، بازتولید مقدار بدون تغییر هر پیوند نمادین در سمت گیرنده است. .IP برای اطلاعات چندگزینه‌ای، بخش پیوندهای نمادین (SYMBOLIC LINKS) را ببینید. .IP "\fB\-\-copy\-links\fP, \fB\-L\fP" فرستنده هر پیوند نمادین موجود در انتقال را با دنبال کردن زنجیره پیوند به فایل یا دایرکتوری مرجع، به موردِ هدف تبدیل می‌کند. اگر زنجیره پیوند نمادین شکسته باشد، خطایی صادر شده و فایل از فرایند انتقال کنار گذاشته می‌شود. .IP از آنجا که هیچ پیوند نمادینی در فرایند انتقال باقی نمی‌ماند، این گزینه جایگزین هر گزینه دیگری می‌شود که بر پیوندهای نمادین در انتقال تأثیر می‌گذارد. .IP این گزینه نحوه رفتار با پیوندهای نمادین موجود در سمت گیرنده را تغییر نمی‌دهد. .IP اگر نیاز دارید که یک پیوند نمادین به یک دایرکتوری در سمت گیرنده به‌عنوان یک دایرکتوری واقعی در نظر گرفته شود، گزینه \fB\-\-keep\-dirlinks\fP (\fB\-K\fP) را ببینید. .IP برای اطلاعات چندگزینه‌ای بخش SYMBOLIC LINKS را ببینید. .IP "\fB\-\-copy\-unsafe\-links\fP" این گزینه به rsync می‌گوید تا مرجع پیوندهای نمادینی که به خارج از درخت کپی‌شده اشاره می‌کنند را کپی کند. با پیوندهای نمادین مطلق نیز مانند فایل‌های معمولی رفتار می‌شود، و همچنین با هر پیوند نمادینی در خود مسیر مبدأ هنگام استفاده از \fB\-\-relative\fP به همین شکل برخورد می‌شود. .IP یک پیوند نمادین بر اساس یک بررسی متنی روی مقدار آن، بدون ارزیابی آن روی دیسک، ناامن تشخیص داده می‌شود. یک مقصد مطلق یا خالی همیشه ناامن است. یک مقصد نسبی در صورتی ناامن است که مؤلفه‌های ".." آن به بالاتر از بالاترین سطح انتقال صعود کنند؛ یک ".." که در هر جایی غیر از پیشوند ابتدایی ظاهر شود (یک "/.." تعبیه‌شده یا انتهایی) نیز ناامن در نظر گرفته می‌شود. بالاترین سطح بر اساس نحوه مشخص شدن مبدأ تعیین می‌شود: یک اسلش انتهایی در مبدأ (مثلاً کپی شدن "/src/subdir/" به "/dest/subdir") خود آن دایرکتوری را بالاترین سطح قرار می‌دهد، بنابراین یک پیوند نمادین نباید به بالاتر از آن اشاره کند؛ بدون اسلش انتهایی (مثلاً کپی شدن "/src/subdir" به "/dest/")، والد مبدأ ("/src") بالاترین سطح است، بنابراین "subdir" نامی درون انتقال است و یک پیوند نمادین نسبی می‌تواند به هر نام دیگری درون آن اشاره کند. .IP توجه داشته باشید که پیوندهای نمادین امن تنها در صورتی کپی می‌شوند که \fB\-\-links\fP نیز مشخص شده یا به طور ضمنی فعال شده باشد. گزینه \fB\-\-copy\-unsafe\-links\fP در صورت ترکیب با \fB\-\-copy\-links\fP هیچ اثر اضافی ندارد. .IP برای اطلاعات چندگزینه‌ای بخش SYMBOLIC LINKS را ببینید. .IP "\fB\-\-safe\-links\fP" این به rsync گیرنده می‌گوید هر پیوند نمادینی در انتقال را که به خارج از درخت کپی‌شده اشاره می‌کند، نادیده بگیرد. تمام پیوندهای نمادین مطلق نیز نادیده گرفته می‌شوند. .IP از آنجا که این نادیده‌گیری در سمت گیرنده رخ می‌دهد، حتی اگر سمت فرستنده پیوندهای نمادین را تغییر داده باشد (هنگام استفاده از \fB\-\-munge\-links\fP) همچنان مؤثر خواهد بود. همچنین بر حذف‌ها تأثیر می‌گذارد، زیرا حضور فایل در انتقال، هنگامی که پیوند نمادین ناامن تشخیص داده شده و رد می‌شود، از حذف هر فایل متناظر در گیرنده جلوگیری می‌کند. .IP این گزینه هیچ اثری ندارد مگر اینکه با \fB\-\-links\fP (یا گزینه‌ای که شامل \fB\-\-links\fP است مانند \fB\-\-archive\fP) ترکیب شود، زیرا بدون \fB\-\-links\fP هیچ پیوند نمادینی در انتقال وجود نخواهد داشت. اثر آن توسط \fB\-\-copy\-unsafe\-links\fP جایگزین می‌شود. .IP استفاده از این گزینه همراه با \fB\-\-relative\fP ممکن است نتایج غیرمنتظره‌ای به همراه داشته باشد. .IP برای اطلاعات چندگزینه‌ای بخش SYMBOLIC LINKS را ببینید. .IP "\fB\-\-insecure\-links\fP" به‌طور پیش‌فرض، rsync مسیرهای دایرکتوری و فایلی را که \fBعملگر\fP در خط فرمان مشخص می‌کند، با یک پیمایش تدافعی درخت دایرکتوری ارزیابی می‌کند که \fBتنها زمانی یک مؤلفه پیوند نمادین را دنبال می‌کند که متعلق به uid\ 0 یا کاربر در حال اجرا باشد\fP، و پیوند متعلق به هر کاربر دیگری را رد می‌کند. این کار مانع از آن می‌شود که مهاجمی که می‌تواند درون یکی از آن دایرکتوری‌ها بنویسد، پیوند نمادینی قرار دهد که rsync دارای دسترسی بالا را به مقصدی خارج از درخت مورد نظر هدایت کند، در حالی که همچنان پیوندهای نمادین خود کاربر ارائه‌دهنده را معتبر می‌شمارد. این قاعده برای مسیرهای مطلق و نسبی یکسان است. این مورد برای دایرکتوری مقصد و پارامترهای گزینه‌های زیر اعمال می‌شود: \fB\-\-backup\-dir\fP، \fB\-\-temp\-dir\fP/\fB\-T\fP، \fB\-\-partial\-dir\fP، \fB\-\-link\-dest\fP، \fB\-\-compare\-dest\fP، \fB\-\-copy\-dest\fP، \fB\-\-log\-file\fP، \fB\-\-password\-file\fP، \fB\-\-files\-from\fP، \fB\-\-include\-from\fP، \fB\-\-exclude\-from\fP، فایل‌های ادغام \fB\-\-filter\fP، \fB\-\-write\-batch\fP و \fB\-\-read\-batch\fP. .IP گزینه \fB\-\-insecure\-links\fP آن سازوکار تدافعی را غیرفعال می‌کند و رفتار پیشین مبنی بر دنبال کردن هر پیوند نمادینی در آن مسیرها را بازمی‌گرداند. تنها زمانی از آن استفاده کنید که به تمام دایرکتوری‌های موجود در هر مسیر ارائه‌شده توسط کاربر کاملاً اعتماد دارید، چرا که خطرات هدایت پیوند نمادین را که این پیمایش مانع آن می‌شد مجدداً پدیدار می‌سازد. .IP این گزینه \fBفقط محلی\fP است: به سمت دوردست انتقال ارسال نمی‌شود. یک همتای پوسته دوردست که به غیرفعال‌سازی این سازوکار نیاز دارد باید آن را در آنجا تنظیم کند (مثلاً از طریق \fB\-\-rsync\-path\fP)، و یک دیمن هرگز آن را نمی‌پذیرد\ \-\- دیمنی که \fB\-\-insecure\-links\fP را از کلاینت دریافت کند درخواست را رد می‌کند. مدیر دیمنی که رفتار قدیمی را برای یک ماژول مورد اعتماد تکی می‌خواهد، به جای آن "\fBinsecure\ links\ =\ yes\fP" را در بخش مربوط به آن ماژول در \fBrsyncd.conf\fP(5) تنظیم می‌کند؛ یک کلاینت هرگز نمی‌تواند آن را فعال کند. .IP برای اطلاعات درباره چندگزینه‌ای، بخش «پیوندهای نمادین (SYMBOLIC LINKS)» را ببینید. .IP "\fB\-\-confine\-root=DIR\fP" محل حل‌شدن مسیرهای فهرست‌شده تحت \fB\-\-insecure\-links\fP را محدود می‌کند: هر مسیری که به خارج از DIR ختم شود رد می‌شود، حتی اگر تمام پیوندهای نمادین در طول آن متعلق به کاربری معتمد باشند. پیمایش مالکیت می‌پرسد چه کسی پیوند را ایجاد کرده است؛ این گزینه می‌پرسد مسیر به کجا ختم شده است. .IP مقدار DIR باید مطلق باشد. به‌طور پیش‌فرض هیچ‌چیز محدود نمی‌شود و \fB\-\-confine\-root=/\fP هیچ اثری ندارد. .IP این گزینه برای پوشش‌هایی (wrapper) وجود دارد که یک دایرکتوری محدودشده را روی پوسته راه‌دور ارائه می‌دهند؛ \fBrrsync\fP که همراه این برنامه عرضه می‌شود از این دسته است و هر زمان که دایرکتوری محدودشده آن «\fB/\fP» نباشد، این گزینه را به‌طور خودکار ارسال می‌کند. چنین پوششی می‌تواند argv تحویل‌داده‌شده را بررسی کند، اما قواعد فیلتر از طریق پروتکل منتقل می‌شوند: یک کلاینت می‌تواند در قاعده dir-merge نام فایلی ادغامی خارج از دایرکتوری محدودشده را مشخص کند و سرور را وادار به خواندن آن به‌صورت قواعد فیلتر نماید. در یک دریافت (pull) که نه به \fB\-\-delete\fP نیاز دارد و نه به هیچ پرگویی، چرا که یک ادغام فقط-استثنا (تغییردهنده «\fB\-\fP») هر خط را به یک الگو تبدیل می‌کند و کلاینت محتویات فایل را از روی این که کدام‌یک از نام‌های خودش حذف شده‌اند می‌خواند. محدود کردن بازکردن فایل این روزنه را می‌بندد؛ فایل ادغامی درون DIR همچنان مانند گذشته کار خواهد کرد. .IP یک دیمن این گزینه را نادیده می‌گیرد\ \-\- دایرکتوری ماژول آن از پیش مرز تعیین‌شده است، و این گزینه در argv عرضه‌شده توسط کلاینت می‌رسد، بنابراین پذیرفتن آن تنها می‌تواند ماژول را گسترش دهد. .IP استفاده از \fB\-\-insecure\-links\fP در کنار آن پذیرفته نمی‌شود. این انصراف، رفتار بازکردن سنتی را بازمی‌گرداند که از پیمایشِ اعمال‌کننده ریشه صرف‌نظر می‌کند، بنابراین استفاده هم‌زمان از هر دو در عمل و در سکوت به‌معنای عدم اعمال هیچ‌گونه محدودیتی خواهد بود. .IP همانند \fB\-\-drop\-D\fP، این گزینه به سمت راه‌دور ارسال نمی‌شود: قرار است به تنهایی بر روی یک طرف اتصال اعمال گردد. .IP "\fB\-\-munge\-links\fP" این گزینه فقط بر یک طرف انتقال تأثیر می‌گذارد و به rsync می‌گوید هنگام دریافت فایل‌ها مقادیر پیوندهای نمادین را دستکاری (munge) کند، یا هنگام ارسال فایل‌ها مقادیر پیوندهای نمادین را از حالت دستکاری خارج (unmunge) کند. «دستکاری» مقصد پیوند نمادین را تغییر می‌دهد تا پیوند نتواند با موفقیت دنبال شود، اما امکان بازیابی مقصد اصلی پیوند نمادین را فراهم نگه می‌دارد. «بازگردانی دستکاری» این فرآیند را معکوس می‌کند تا پیوند نمادین به مقصد اصلی اشاره نماید. .IP این گزینه می‌تواند در سمت سرور بدون اطلاع کلاینت فعال شود، مانند فایل پیکربندی دیمن rsync یا از طریق گزینه‌ای که به اسکریپت rrsync (یا همان rsync محدودشده) داده می‌شود. هنگام تعیین در سمت کلاینت، اگر سمت کلاینت دارای پیوندهای نمادین دستکاری‌شده است یا به آن‌ها نیاز دارد، گزینه را به‌صورت عادی تعیین کنید، یا از \fB\-M\-\-munge\-links\fP استفاده کنید تا گزینه را به سرور بدهید هنگامی که سرور دارای پیوندهای نمادین دستکاری‌شده است یا به آن‌ها نیاز دارد. توجه داشته باشید که در انتقال محلی، کلاینت فرستنده است، بنابراین تعیین مستقیم گزینه پیوندهای نمادین را از دستکاری خارج می‌کند، در حالی که تعیین آن به‌عنوان گزینه راه‌دور، پیوندهای نمادین را دستکاری می‌کند. .IP این گزینه هنگام ارسال به یک دیمن از طریق \fB\-\-remote\-option\fP هیچ اثری ندارد زیرا دیمن تمایل به دستکاری پیوندهای نمادین را از طریق پارامتر «\fBmunge\ symlinks\fP» خود پیکربندی می‌کند. .IP مقدار پیوند نمادین هنگامی که در حال انتقال است دستکاری یا بازگردانی می‌شود، بنابراین هر گزینه‌ای که پیوندهای نمادین را به غیر پیوند نمادین تبدیل می‌کند، پیش از دستکاری/بازگردانی رخ می‌دهد \fBبه‌جز\fP \fB\-\-safe\-links\fP، که انتخابی است که گیرنده انجام می‌دهد، بنابراین تصمیم خود را بر اساس مقدار دستکاری‌شده/بازگردانی‌شده اتخاذ می‌کند. این بدان معناست که اگر گیرنده قابلیت دستکاری را فعال کرده باشد، استفاده از \fB\-\-safe\-links\fP باعث نادیده گرفته شدن تمام پیوندهای نمادین خواهد شد (چرا که دستکاری همه آن‌ها را مطلق می‌کند). .IP روشی که rsync برای دستکاری پیوند نمادین استفاده می‌کند، افزودن پیشوند رشته "/rsyncd-munged/" به مقدار آن است. این کار در صورتی که دایرکتوری /rsyncd-munged وجود نداشته باشد، از استفاده شدن پیوند جلوگیری می‌کند. هنگامی که این گزینه فعال است، اگر آن مسیر یک دایرکتوری یا پیوند نمادین به یک دایرکتوری باشد، rsync از اجرا خودداری می‌کند (اگرچه این بررسی فقط در هنگام راه‌اندازی انجام می‌شود). همچنین برای روشی جهت دستکاری/بازگردانی درجا یک یا چند پیوند نمادین، اسکریپت پایتون "munge-symlinks" را در دایرکتوری support از کد منبع ببینید. .IP "\fB\-\-copy\-dirlinks\fP, \fB\-k\fP" این گزینه باعث می‌شود سمت فرستنده با پیوند نمادین به یک دایرکتوری به گونه‌ای رفتار کند که گویی یک دایرکتوری واقعی است. این ویژگی زمانی مفید است که نمی‌خواهید پیوندهای نمادین به غیر دایرکتوری‌ها تحت تأثیر قرار گیرند، وضعیتی که هنگام استفاده از \fB\-\-copy\-links\fP رخ می‌دهد. .IP بدون این گزینه، اگر سمت فرستنده یک دایرکتوری را با یک پیوند نمادین به دایرکتوری جایگزین کرده باشد، سمت گیرنده هر چیزی را که در مسیر پیوند نمادین جدید قرار دارد حذف می‌کند، از جمله ساختار سلسله‌مراتبی دایرکتوری (تا زمانی که \fB\-\-force\fP یا \fB\-\-delete\fP فعال باشد). .IP همچنین گزینه مشابه \fB\-\-keep\-dirlinks\fP را برای سمت گیرنده ببینید. .IP گزینه \fB\-\-copy\-dirlinks\fP بر تمام پیوندهای نمادین به دایرکتوری‌ها در مبدأ اعمال می‌شود. اگر می‌خواهید فقط چند پیوند نمادین مشخص را دنبال کنید، ترفندی که می‌توانید استفاده کنید ارسال آن‌ها به عنوان آرگومان‌های مبدأ اضافی با یک اسلش در انتها است، در حالی که از \fB\-\-relative\fP برای تطابق درست مسیرها استفاده می‌کنید. برای مثال: .RS 4 .IP .nf rsync -r --relative src/./ src/./follow-me/ dest/ .fi .RE .IP برای اطلاعات چندگزینه‌ای، بخش پیوندهای نمادین (SYMBOLIC LINKS) را ببینید. .IP "\fB\-\-keep\-dirlinks\fP, \fB\-K\fP" این گزینه باعث می‌شود سمت گیرنده با پیوند نمادین به یک دایرکتوری طوری رفتار کند که گویی دایرکتوری واقعی است، اما فقط در صورتی که با یک دایرکتوری واقعی از فرستنده مطابقت داشته باشد. بدون این گزینه، پیوند نمادین گیرنده حذف شده و با یک دایرکتوری واقعی جایگزین می‌شود. .IP برای مثال، فرض کنید دایرکتوری "foo" را منتقل می‌کنید که حاوی فایل "file" است، اما در گیرنده، "foo" یک پیوند نمادین به دایرکتوری "bar" است. بدون \fB\-\-keep\-dirlinks\fP، گیرنده پیوند نمادین "foo" را حذف کرده، آن را دوباره به صورت یک دایرکتوری می‌سازد و فایل را درون دایرکتوری جدید دریافت می‌کند. با \fB\-\-keep\-dirlinks\fP، گیرنده پیوند نمادین را نگه می‌دارد و "file" در نهایت به "bar" منتقل می‌شود. .IP یک نکته هشدار: اگر از \fB\-\-keep\-dirlinks\fP استفاده می‌کنید، باید یا به تمام پیوندهای نمادین در نسخه رونوشت اعتماد داشته باشید، یا گزینه \fB\-\-munge\-links\fP را در سمت گیرنده فعال کنید! اگر این امکان وجود داشته باشد که یک کاربر غیرقابل اعتماد پیوند نمادین خود را به هر دایرکتوری واقعی بسازد، آن کاربر می‌تواند (در رونوشت بعدی) پیوند نمادین را با یک دایرکتوری واقعی جایگزین کرده و بر محتوای هر دایرکتوری که پیوند نمادین به آن ارجاع دارد تأثیر بگذارد. برای نسخه‌های پشتیبان، بهتر است به جای پیوند نمادین، از چیزی مانند bind mount برای اصلاح ساختار سلسله‌مراتبی گیرنده استفاده کنید. .IP همچنین گزینه مشابه \fB\-\-copy\-dirlinks\fP را برای سمت فرستنده ببینید. .IP برای اطلاعات چندگزینه‌ای، بخش پیوندهای نمادین (SYMBOLIC LINKS) را ببینید. .IP "\fB\-\-hard\-links\fP, \fB\-H\fP" این گزینه به rsync می‌گوید تا فایل‌های دارای پیوند سخت (hard link) را در مبدأ جستجو کند و فایل‌های متناظر در مقصد را به یکدیگر پیوند دهد. بدون این گزینه، با فایل‌های دارای پیوند سخت در مبدأ طوری رفتار می‌شود که انگار فایل‌های جداگانه‌ای هستند. .IP این گزینه لزوماً تضمین نمی‌کند که الگوی پیوندهای سخت در مقصد دقیقاً با مبدأ مطابقت داشته باشد. مواردی که ممکن است مقصد در نهایت با پیوندهای سخت اضافی مواجه شود شامل این موارد است: .IP .RS .IP o اگر مقصد شامل پیوندهای سخت اضافه باشد (پیوندهای بیشتر نسبت به آنچه در فهرست فایل‌های مبدأ موجود است)، الگوریتم کپی آن‌ها را به‌طور صریح حذف نمی‌کند. با این حال، اگر یک یا چند مسیر تفاوت محتوایی داشته باشند، روند عادی به‌روزرسانی فایل آن پیوندهای اضافی را از بین می‌برد (مگر اینکه از گزینه \fB\-\-inplace\fP استفاده کنید). .IP o اگر یک دایرکتوری \fB\-\-link\-dest\fP مشخص کنید که شامل پیوندهای سخت است، پیوند دادن فایل‌های مقصد با فایل‌های \fB\-\-link\-dest\fP می‌تواند به دلیل وابستگی‌های \fB\-\-link\-dest\fP باعث شود برخی مسیرها در مقصد به یکدیگر پیوند یابند. .RE .IP توجه داشته باشید که rsync تنها می‌تواند پیوندهای سخت بین فایل‌هایی را که درون مجموعه انتقال قرار دارند تشخیص دهد. اگر rsync فایلی را به‌روزرسانی کند که اتصالات پیوند سخت اضافی با فایل‌های خارج از مجموعه انتقال دارد، آن پیوند شکسته خواهد شد. اگر وسوسه شده‌اید که از گزینه \fB\-\-inplace\fP برای جلوگیری از این شکستگی استفاده کنید، بسیار مراقب باشید که بدانید فایل‌های شما چگونه به‌روزرسانی می‌شوند تا مطمئن شوید هیچ تغییر ناخواسته‌ای به دلیل پیوندهای سخت باقی‌مانده رخ ندهد (و برای هشدارهای بیشتر به گزینه \fB\-\-inplace\fP مراجعه کنید). .IP اگر بازگشت تدریجی فعال باشد (گزینه \fB\-\-inc\-recursive\fP را ببینید)، rsync ممکن است یک فایل پیوند‌سخت‌شده‌ی ناموجود را پیش از آنکه متوجه شود پیوند دیگری برای آن محتوا در جای دیگری از سلسله‌مراتب وجود دارد منتقل کند. این موضوع روی دقت انتقال تأثیری نمی‌گذارد (یعنی اینکه کدام فایل‌ها به هم پیوند سخت دارند)، فقط بر کارایی آن اثر می‌گذارد (یعنی کپی کردن داده‌ها برای یک نسخه جدید و زودهنگام از فایل پیوند‌سخت‌شده‌ای که می‌توانست بعداً در طول انتقال در عضو دیگری از مجموعه فایل‌های دارای پیوند سخت پیدا شود). یکی از راه‌های جلوگیری از این ناکارآمدی، غیرفعال کردن بازگشت تدریجی با استفاده از گزینه \fB\-\-no\-inc\-recursive\fP است. .IP "\fB\-\-perms\fP, \fB\-p\fP" این گزینه باعث می‌شود rsync در سمت گیرنده، مجوزهای مقصد را مطابق با مجوزهای مبدأ تنظیم کند. (همچنین به گزینه \fB\-\-chmod\fP برای روشی جهت تغییر آنچه rsync به عنوان مجوزهای مبدأ در نظر می‌گیرد مراجعه کنید.) .IP هنگامی که این گزینه \fIخاموش\fP باشد، مجوزها به شرح زیر تنظیم می‌شوند: .IP .RS .IP o فایل‌های موجود (از جمله فایل‌های به‌روزشده) مجوزهای فعلی خود را حفظ می‌کنند، هرچند گزینه \fB\-\-executability\fP ممکن است فقط مجوز اجرای فایل را تغییر دهد. .IP o بیت‌های مجوز «عادی» فایل‌های جدید برابر با مجوزهای فایل مبدأ پس از اعمال ماسک مجوزهای پیش‌فرض دایرکتوری گیرنده تنظیم می‌شوند (چه umask فرایند گیرنده باشد یا مجوزهای مشخص‌شده از طریق ACL پیش‌فرض دایرکتوری مقصد)، و بیت‌های مجوز ویژه آن‌ها غیرفعال می‌شوند؛ مگر در حالتی که یک دایرکتوری جدید بیت setgid را از دایرکتوری والد خود به ارث ببرد. .RE .IP بنابراین، هنگامی که هر دو گزینه \fB\-\-perms\fP و \fB\-\-executability\fP غیرفعال باشند، رفتار rsync مشابه سایر ابزارهای کپی فایل مانند \fBcp\fP(1) و \fBtar\fP(1) خواهد بود. .IP خلاصه: برای اعمال مجوزهای مبدأ به فایل‌های مقصد (هم قدیمی و هم جدید)، از \fB\-\-perms\fP استفاده کنید. برای دادن مجوزهای پیش‌فرض مقصد به فایل‌های جدید (در حالی که فایل‌های موجود بدون تغییر باقی بمانند)، مطمئن شوید گزینه \fB\-\-perms\fP خاموش است و از \fB\-\-chmod=ugo=rwX\fP استفاده کنید (که تضمین می‌کند تمام بیت‌های ماسک‌نشده فعال شوند). اگر مایلید تایپ این رفتار دوم ساده‌تر شود، می‌توانید یک نام مستعار popt برای آن تعریف کنید، مانند قرار دادن این خط در فایل \fB~/.popt\fP (دستور زیر گزینه \fB\-Z\fP را تعریف می‌کند و شامل \fB\-\-no\-g\fP برای استفاده از گروه پیش‌فرض دایرکتوری مقصد است): .RS 4 .IP .nf rsync alias -Z --no-p --no-g --chmod=ugo=rwX .fi .RE .IP سپس می‌توانید از این گزینه جدید در دستوری مانند زیر استفاده کنید: .RS 4 .IP .nf rsync -avZ src/ dest/ .fi .RE .IP (هشدار: دقت کنید که \fB\-a\fP بعد از \fB\-Z\fP قرار نگیرد، در غیر این صورت دو گزینه \fB\-\-no\-*\fP ذکرشده در بالا را دوباره فعال خواهد کرد.) .IP توجه داشته باشید که اگر rsync راه‌دور قدیمی‌تر از 2.6.7 (مارس ۲۰۰۶) و گیرنده باشد، رفتار برنامه در هنگام غیرفعال بودن \fB\-\-perms\fP ممکن است با موارد شرح‌داده‌شده در بالا تفاوت داشته باشد. .IP "\fB\-\-executability\fP, \fB\-E\fP" این گزینه باعث می‌شود rsync در صورت فعال نبودن \fB\-\-perms\fP، وضعیت قابل‌اجرا بودن یا نبودن پرونده‌های عادی را حفظ کند. یک پرونده عادی در صورتی قابل‌اجرا تلقی می‌شود که حداقل یکی از مجوزهای \(aqx\(aq آن فعال باشد. هنگامی که وضعیت قابل‌اجرا بودن پرونده مقصد با پرونده مبدأ متناظر تفاوت داشته باشد، rsync مجوزهای پرونده مقصد را به شرح زیر تغییر می‌دهد: .IP .RS .IP o برای غیرقابل‌اجرا کردن یک پرونده، rsync تمام مجوزهای \(aqx\(aq آن را غیرفعال می‌کند. .IP o برای قابل‌اجرا کردن یک پرونده، rsync هر مجوز \(aqx\(aq را که مجوز \(aqr\(aq متناظر آن فعال باشد، فعال می‌کند. .RE .IP اگر \fB\-\-perms\fP فعال باشد، این گزینه نادیده گرفته می‌شود. .IP "\fB\-\-acls\fP, \fB\-A\fP" این گزینه باعث می‌شود rsync فهرست‌های کنترل دسترسی (ACLهای) مقصد را مطابق با ACLهای مبدأ به‌روزرسانی کند. این گزینه همچنین شامل \fB\-\-perms\fP نیز می‌شود. .IP سیستم‌های مبدأ و مقصد برای کارکرد صحیح این گزینه باید مدخل‌های ACL سازگار داشته باشند. برای روشی جهت پشتیبان‌گیری و بازیابی ACLهای ناسازگار، گزینه \fB\-\-fake\-super\fP را ببینید. .IP "\fB\-\-xattrs\fP, \fB\-X\fP" این گزینه باعث می‌شود rsync صفت‌های گسترش‌یافته مقصد را مطابق با مقادیر مبدأ به‌روزرسانی کند. .IP برای سیستم‌هایی که از فضاهای نام صفت‌های گسترش‌یافته پشتیبانی می‌کنند، رونوشت‌برداری توسط کاربر ارشد تمام فضاهای نام به‌جز system.* را کپی می‌کند. یک کاربر عادی تنها فضای نام user.* را کپی می‌کند. برای امکان پشتیبان‌گیری و بازیابی فضاهای نام غیرکاربری به عنوان یک کاربر عادی، گزینه \fB\-\-fake\-super\fP را ببینید. .IP فیلتر کردن نام‌های فوق می‌تواند با استفاده از یک یا چند گزینه فیلتر به همراه تغییردهنده \fBx\fP بازنویسی و جایگزین شود. هنگامی که یک قاعده فیلتر مؤثر بر xattr را مشخص می‌کنید، rsync مستلزم آن است که فیلتر کردن system/user خود و همچنین هرگونه فیلتر اضافی برای این‌که چه نام‌های xattr کپی شوند و چه نام‌هایی مجاز به حذف باشند را تعیین کنید. برای مثال، برای نادیده گرفتن فضای نام system، می‌توانید این‌طور مشخص کنید: .RS 4 .IP .nf --filter='-x system.*' .fi .RE .IP برای نادیده گرفتن تمام فضاهای نام به‌جز فضای نام user، می‌توانید یک تطابق نفی‌شده user را مشخص کنید: .RS 4 .IP .nf --filter='-x! user.*' .fi .RE .IP برای جلوگیری از حذف هرگونه صفت، می‌توانید یک قاعده مخصوص گیرنده مشخص کنید که تمام نام‌ها را مستثنی کند: .RS 4 .IP .nf --filter='-xr *' .fi .RE .IP توجه داشته باشید که گزینه \fB\-X\fP مقادیر xattr ویژه rsync (مانند موارد مورد استفاده توسط \fB\-\-fake\-super\fP) را کپی نمی‌کند، مگر این‌که گزینه را تکرار کنید (مثلاً \fB\-XX\fP). این حالت \(dqرونوشت تمام xattrs\(dq را نمی‌توان با \fB\-\-fake\-super\fP استفاده کرد. .IP "\fB\-\-chmod=CHMOD\fP" این گزینه به rsync می‌گوید یک یا چند حالت «chmod» جدا شده با ویرگول را روی دسترسی پرونده‌های در حال انتقال اعمال کند. مقدار حاصل به‌گونه‌ای در نظر گرفته می‌شود که گویی دسترسی‌های ارائه‌شده توسط سمت فرستنده برای پرونده بوده است؛ بدین معنی که در صورت فعال نبودن \fB\-\-perms\fP، این گزینه ممکن است روی پرونده‌های موجود بی‌اثر به نظر برسد. .IP علاوه بر قواعد معمول تجزیه که در صفحه‌ی راهنمای \fBchmod\fP(1) مشخص شده است، می‌توانید با افزودن پیشوند 'D' موردی را تعیین کنید که فقط برای یک پوشه اعمال شود، یا با افزودن پیشوند 'F' موردی را تعیین کنید که فقط روی یک پرونده اعمال گردد. برای نمونه، عبارت زیر اطمینان حاصل می‌کند که تمام پوشه‌ها نشان set-gid دریافت کنند، هیچ پرونده‌ای توسط دیگران قابل‌نوشتن نباشد، هر دو توسط کاربر و گروه قابل‌نوشتن باشند، و هر دو قابلیت اجرایی یکسانی در تمام بیت‌ها داشته باشند: .RS 4 .IP .nf --chmod=Dg+s,ug+w,Fo-w,+X .fi .RE .IP استفاده از شماره‌های حالت هشت‌هشتی (اکتال) نیز مجاز است: .RS 4 .IP .nf --chmod=D2775,F664 .fi .RE .IP حالت‌های نمادین رونوشت دسترسی نیز مجاز هستند، مانند \fBg=u\fP، \fBo=g\fP یا \fBg-o\fP. یک مورد رونوشت دسترسی تنها می‌تواند از یک کلاس (\fBu\fP، \fBg\fP یا \fBo\fP) رونوشت بردارد و نمی‌تواند با حروف دسترسی \fBrwxXst\fP در یک مورد یکسان ترکیب شود. زمانی که به هر دو رفتار نیاز دارید از موارد جدا شده با ویرگول استفاده کنید، مانند \fBg=o,o=\fP. .IP یک مورد رونوشت دسترسی \fB=\fP همچنین بیت ویژه را برای هر کلاس مقصدی که به‌روزرسانی می‌کند پاک می‌کند (\fBu\fP بیت setuid را پاک می‌کند، \fBg\fP بیت setgid را پاک می‌کند، و \fBo\fP بیت sticky را پاک می‌کند)، که مطابق با رفتار \fBchmod\fP در گنو است. .IP تعیین چندین گزینه \fB\-\-chmod\fP نیز مجاز است، زیرا هر گزینه اضافی صرفاً به انتهای فهرست تغییرات اعمالی افزوده می‌شود. .IP برای چگونگی اعمال مقدار دسترسی حاصل بر روی پرونده‌های در حال انتقال، گزینه‌های \fB\-\-perms\fP و \fB\-\-executability\fP را ببینید. .IP "\fB\-\-owner\fP, \fB\-o\fP" این گزینه باعث می‌شود rsync مالک هر شیءِ سیستم‌فایل مقصد (پرونده، پوشه و غیره) را همانند شیءِ مبدأ تنظیم کند، اما تنها در صورتی که rsync گیرنده به‌عنوان کاربر ارشد (super-user) اجرا شده باشد (همچنین گزینه‌های \fB\-\-super\fP و \fB\-\-fake\-super\fP را ببینید). بدون این گزینه، مالک پرونده‌های جدید و/یا انتقال‌یافته روی کاربر فراخوان در سمت گیرنده تنظیم می‌شود. .IP حفظ مالکیت به‌طور پیش‌فرض نام‌های منطبق را پیوند می‌دهد، اما در برخی شرایط ممکن است به استفاده از شناسه عددی (ID) بازگردد (همچنین برای توضیحات کامل گزینه \fB\-\-numeric\-ids\fP را ببینید). .IP "\fB\-\-group\fP, \fB\-g\fP" این گزینه باعث می‌شود rsync گروه هر شیءِ سیستم‌فایل مقصد (پرونده، پوشه و غیره) را همانند شیءِ مبدأ تنظیم کند. اگر برنامه گیرنده به‌عنوان کاربر ارشد اجرا نشود (یا اگر \fB\-\-no\-super\fP مشخص شده باشد)، تنها گروه‌هایی حفظ می‌شوند که کاربر فراخوان در سمت گیرنده عضو آن‌ها است. بدون این گزینه، گروه روی گروه پیش‌فرض کاربر فراخوان در سمت گیرنده تنظیم می‌شود. .IP حفظ اطلاعات گروه به‌طور پیش‌فرض نام‌های منطبق را پیوند می‌دهد، اما در برخی شرایط ممکن است به استفاده از شناسه عددی (ID) بازگردد (همچنین برای توضیحات کامل گزینه \fB\-\-numeric\-ids\fP را ببینید). .IP "\fB\-\-devices\fP" این گزینه باعث می‌شود rsync پرونده‌های دستگاه کاراکتری و بلوکی را برای بازسازی این دستگاه‌ها به سیستم راه‌دور انتقال دهد. اگر rsync گیرنده به‌عنوان کاربر ارشد اجرا نشود، rsync بدون نمایش پیام از ایجاد پرونده‌های دستگاه صرف‌نظر می‌کند (همچنین گزینه‌های \fB\-\-super\fP و \fB\-\-fake\-super\fP را ببینید). .IP در حالت پیش‌فرض، rsync در صورت تنظیم نبودن این گزینه، برای هر پرونده دستگاهی که با آن مواجه شود یک هشدار "non-regular file" صادر می‌کند. می‌توانید با مشخص کردن \fB\-\-info=nonreg0\fP این هشدار را بی‌صدا کنید. .IP "\fB\-\-specials\fP" این گزینه باعث می‌شود rsync پرونده‌های خاص، مانند سوکت‌های نام‌گذاری‌شده و fifoها را انتقال دهد. اگر rsync دریافت‌کننده با دسترسی ابرکاربر اجرا نشود، rsync بدون تولید پیام از ایجاد پرونده‌های خاص صرف‌نظر می‌کند (همچنین گزینه‌های \fB\-\-super\fP و \fB\-\-fake\-super\fP را ببینید). .IP در حالت پیش‌فرض، rsync در صورت تنظیم نبودن این گزینه، برای هر پرونده خاصی که با آن مواجه شود یک هشدار "non-regular file" صادر می‌کند. می‌توانید با مشخص کردن \fB\-\-info=nonreg0\fP این هشدار را بی‌صدا کنید. .IP "\fB\-D\fP" گزینه \fB\-D\fP معادل "\fB\-\-devices\fP \fB\-\-specials\fP" است. .IP "\fB\-\-drop\-D\fP" این گزینه به rsync دریافت‌کننده اعلام می‌کند که بدون توجه به نوع درخواست انتقال، از ایجاد پرونده‌های دستگاه و پرونده‌های خاص خودداری کند. ورودی‌های مربوط به آن‌ها دقیقاً مانند حالتی که \fB\-D\fP استفاده نشده باشد، با همان هشدار معمول "non-regular file" نادیده گرفته می‌شوند. .IP این گزینه با \fB\-\-no\-D\fP تفاوت دارد، زیرا فقط موارد ایجاد شده را تغییر می‌دهد، نه نحوه کدگذاری فهرست پرونده‌ها را. گزینه \fB\-\-no\-D\fP همچنین فیلدهای rdev را که پرونده‌های دستگاه و پرونده‌های خاص در بستر انتقال حمل می‌کنند غیرفعال می‌سازد، بنابراین اعمال آن به‌تنهایی در یک سمت اتصال باعث عدم تطابق دو طرف درباره کدگذاری شده و انتقال با شکست مواجه می‌شود. در نتیجه \fB\-\-drop\-D\fP می‌تواند به‌تنهایی در سمت دریافت‌کننده اضافه شود که هدف اصلی وجود آن نیز همین است\ \-\- پوسته واسط \fBrrsync\fP از آن برای جلوگیری از ایجاد پرونده‌های دستگاه و پرونده‌های خاص توسط کلاینت‌ها در یک دایرکتوری محدودشده استفاده می‌کند. گره‌هایی که از قبل در آنجا موجود باشند دست‌نخورده باقی می‌مانند. .IP از آنجا که این گزینه فقط مانع ایجاد می‌شود، هیچ تأثیری روی rsync ارسال‌کننده ندارد. .IP این گزینه به سمت راه‌دور ارسال نمی‌شود، زیرا هدف اصلی آن اعمال شدن به‌تنهایی روی یک سمت اتصال است. بنابراین فقط بر فرایند rsync که گزینه را به آن داده‌اید اثر می‌گذارد و نه هیچ فرایند دیگری: در یک رونوشت محلی، یا در سمت دریافت‌کننده فراخوانی \fB\-\-server\fP مانند آنچه rrsync ایجاد می‌کند. برای تنظیم آن روی یک دریافت‌کننده راه‌دور از خط فرمان، آن را به طور صریح با \fB\-\-remote\-option\fP (\fB\-M\fP) ارسال کنید: .RS 4 .IP .nf rsync -av -M--drop-D src/ host:dest/ .fi .RE .IP ارسال یک گزینه ساده \fB\-\-drop\-D\fP به عملیات ارسال (push) فقط بر ارسال‌کننده محلی تأثیر می‌گذارد و در آنجا هیچ کاری انجام نمی‌دهد. .IP "\fB\-\-copy\-devices\fP" این گزینه به rsync اعلام می‌کند که با یک دستگاه در سمت ارسال‌کننده مانند یک پرونده معمولی رفتار کند و اجازه دهد محتوای آن در یک پرونده مقصد معمولی کپی شود (یا در صورتی که \fB\-\-write\-devices\fP نیز مشخص شده باشد، در یک دستگاه دیگر). .IP این گزینه به طور پیش‌فرض توسط دیمن rsync رد می‌شود. .IP "\fB\-\-write\-devices\fP" این گزینه به rsync اعلام می‌کند که با یک دستگاه در سمت دریافت‌کننده مانند یک پرونده معمولی رفتار کند و اجازه نوشتن داده‌های پرونده را در یک دستگاه بدهد. .IP این گزینه متضمن گزینه \fB\-\-inplace\fP است. .IP در استفاده از این گزینه احتیاط کنید، زیرا باید بدانید چه دستگاه‌هایی در سمت دریافت‌کننده انتقال وجود دارند، به‌ویژه زمانی که rsync به عنوان کاربر root اجرا می‌شود. .IP این گزینه به طور پیش‌فرض توسط دیمن rsync رد می‌شود. .IP "\fB\-\-times\fP, \fB\-t\fP" این گزینه به rsync اعلام می‌کند که زمان‌های تغییر پرونده‌های مقصد (شامل دایرکتوری‌ها، پیوندهای نمادین، دستگاه‌ها و غیره) را مطابق با پرونده‌های منبع تنظیم کند. توجه داشته باشید که در صورت عدم استفاده از این گزینه، بهینه‌سازی مربوط به نادیده گرفتن پرونده‌های تغییرنیافته کارایی نخواهد داشت؛ به عبارت دیگر، نبود \fB\-t\fP (یا \fB\-a\fP) باعث می‌شود انتقال بعدی طوری رفتار کند که گویی از \fB\-\-ignore\-times\fP (\fB\-I\fP) استفاده شده است، که موجب به‌روزرسانی تمام پرونده‌ها می‌شود. (اگرچه الگوریتم انتقال تفاضلی rsync در صورت عدم تغییر واقعی پرونده‌ها فرایند به‌روزرسانی را نسبتاً کارآمد می‌کند، اما استفاده از \fB\-t\fP نتیجه بسیار بهتری دارد.) .IP اگر پروتکل مورد توافق قدیمی‌تر از 30 باشد\ \-\- معمولاً به این دلیل که rsync سمت راه‌دور قدیمی‌تر از 3.0.0 (مارس 2008) است، یا اگر \fB\-\-protocol\fP آن را تحمیل کند\ \-\- بازه زمان‌های تغییر قابل انتقال محدود خواهد بود. اگر فایل‌هایی قدیمی‌تر از 1970 دارید، مطمئن شوید که فایل‌های اجرایی rsync شما ارتقا یافته‌اند تا تمام بازه تاریخ‌ها قابل انتقال باشد. .IP "\fB\-\-atimes\fP, \fB\-U\fP" این گزینه به rsync می‌گوید زمان‌های دسترسی (استفاده) فایل‌های مقصد را برابر با مقدار فایل‌های مبدأ قرار دهد. .IP در صورت تکرار، گزینه \fB\-\-open\-noatime\fP را نیز تنظیم می‌کند، که می‌تواند به شما کمک کند سیستم‌های فرستنده و گیرنده بدون نیاز به اجرای مجدد rsync پس از انتقال فایل، زمان دسترسی یکسانی روی فایل‌های منتقل‌شده داشته باشند. .IP "\fB\-\-open\-noatime\fP" این گزینه به rsync می‌گوید فایل‌ها را با پرچم O_NOATIME باز کند (روی سیستم‌هایی که از آن پشتیبانی می‌کنند) تا از تغییر زمان دسترسی فایل‌های در حال انتقال جلوگیری شود. اگر سیستم‌عامل شما از پرچم O_NOATIME پشتیبانی نکند، rsync بدون اخطار این گزینه را نادیده می‌گیرد. همچنین توجه داشته باشید که برخی سیستم‌های فایل به گونه‌ای سوار (mount) شده‌اند که حتی بدون تنظیم پرچم O_NOATIME نیز atime را هنگام دسترسی خواندن به‌روزرسانی نمی‌کنند. .IP "\fB\-\-crtimes\fP, \fB\-N,\fP" این گزینه به rsync می‌گوید زمان‌های ساخت (newness) فایل‌های مقصد را برابر با مقدار فایل‌های مبدأ قرار دهد. سیستم‌عامل و سیستم فایل شما باید از تنظیم زمان‌های ساخت دلخواه (birth) پشتیبانی کنند تا این گزینه فعال شود. .IP "\fB\-\-omit\-dir\-times\fP, \fB\-O\fP" این گزینه به rsync می‌گوید هنگام حفظ زمان‌های تغییر، دسترسی و ساخت، پوشه‌ها را نادیده بگیرد. اگر پوشه‌ها در سمت گیرنده از طریق NFS به اشتراک گذاشته شده‌اند، استفاده از \fB\-O\fP ایده خوبی است. اگر از \fB\-\-backup\fP بدون \fB\-\-backup\-dir\fP استفاده کنید، این گزینه به صورت خودکار اعمال می‌شود. .IP این گزینه همچنین اثر جانبی جلوگیری از ایجاد زودهنگام زیرپوشه‌های ناموجود را هنگام فعال بودن بازگشت افزایشی دارد، همان‌طور که در بخش \fB\-\-inc\-recursive\fP توضیح داده شده است. .IP "\fB\-\-omit\-link\-times\fP, \fB\-J\fP" این گزینه به rsync می‌گوید هنگام حفظ زمان‌های تغییر، دسترسی و ساخت، پیوندهای نمادین را نادیده بگیرد. .IP "\fB\-\-super\fP" این گزینه به سمت گیرنده می‌گوید برای فعالیت‌های کاربر ارشد (super-user) تلاش کند، حتی اگر rsync سمت گیرنده توسط کاربر ارشد اجرا نشده باشد. این فعالیت‌ها شامل موارد زیر است: حفظ مالکان از طریق گزینه \fB\-\-owner\fP، حفظ تمام گروه‌ها (نه فقط گروه‌های کاربر فعلی) از طریق گزینه \fB\-\-group\fP، و رونوشت دستگاه‌ها از طریق گزینه \fB\-\-devices\fP. این قابلیت برای سیستم‌هایی که بدون نیاز به کاربر ارشد اجازه چنین فعالیت‌هایی را می‌دهند و همچنین برای اطمینان از دریافت خطا در صورتی که سمت گیرنده به عنوان کاربر ارشد اجرا نشده باشد، مفید است. برای غیرفعال کردن فعالیت‌های کاربر ارشد، کاربر ارشد می‌تواند از \fB\-\-no\-super\fP استفاده کند. .IP "\fB\-\-fake\-super\fP" هنگامی که این گزینه فعال باشد، rsync با ذخیره/بازیابی ویژگی‌های دارای مجوز از طریق ویژگی‌های گسترش‌یافته ویژه که به هر فایل پیوست شده‌اند (در صورت نیاز)، فعالیت‌های کاربر ارشد را شبیه‌سازی می‌کند. این شامل مالک و گروه فایل (اگر پیش‌فرض نباشد)، اطلاعات دستگاه فایل (دستگاه‌ها و فایل‌های ویژه به عنوان فایل‌های متنی خالی ایجاد می‌شوند)، و هر بیت مجوزی که اجازه تنظیم آن را روی فایل واقعی نمی‌دهیم (مثلاً برای امنیت، فایل واقعی u-s,g-s,o-t را دریافت می‌کند) یا مواردی که دسترسی مالک را محدود می‌کند (از آنجا که کاربر ارشد واقعی همیشه می‌تواند به یک فایل دسترسی داشته باشد/آن را تغییر دهد، فایل‌هایی که ایجاد می‌کنیم همیشه توسط کاربر ایجادکننده قابل دسترسی/تغییر هستند) می‌شود. این گزینه همچنین ACLها (در صورت مشخص شدن \fB\-\-acls\fP) و ویژگی‌های گسترش‌یافته غیرکاربر (در صورت مشخص شدن \fB\-\-xattrs\fP) را پشتیبانی می‌کند. .IP این روشی مناسب برای پشتیبان‌گیری از داده‌ها بدون استفاده از کاربر ارشد و برای ذخیره ACLها از سیستم‌های ناسازگار است. .IP گزینه \fB\-\-fake\-super\fP فقط روی سمتی تأثیر می‌گذارد که گزینه در آن استفاده شده است. برای تأثیرگذاری روی سمت راه‌دور یک اتصال پوسته راه‌دور، از گزینه \fB\-\-remote\-option\fP (\fB\-M\fP) استفاده کنید: .RS 4 .IP .nf rsync -av -M--fake-super /src/ host:/dest/ .fi .RE .IP برای یک رونوشت محلی، این گزینه هم بر مبدأ و هم بر مقصد تأثیر می‌گذارد. اگر می‌خواهید در یک رونوشت محلی این گزینه فقط برای فایل‌های مقصد فعال شود، \fB\-M\-\-fake\-super\fP را مشخص کنید. اگر می‌خواهید در یک رونوشت محلی این گزینه فقط برای فایل‌های مبدأ فعال شود، \fB\-\-fake\-super\fP را با \fB\-M\-\-super\fP ترکیب کنید. .IP این گزینه توسط هر دو گزینه \fB\-\-super\fP و \fB\-\-no\-super\fP بازنویسی و لغو می‌شود. .IP همچنین تنظیم \fBfake\ super\fP را در فایل rsyncd.conf دیمن ببینید. .IP "\fB\-\-sparse\fP, \fB\-S\fP" تلاش برای مدیریت بهینه فایل‌های کم‌پشت (sparse) تا فضای کمتری در مقصد اشغال کنند. این ویژگی به پشتیبانی سیستم‌فایل مقصد از فایل‌های کم‌پشت بستگی دارد، یعنی فایل‌هایی که بخش‌هایی از آن‌ها فاقد بلوک‌های دیسک متناظر هستند زیرا تماماً حاوی بایت‌های صفر هستند. .IP در صورت ترکیب با \fB\-\-inplace\fP، فایل ایجادشده ممکن است در نهایت فاقد بلوک‌های کم‌پشت باشد (بسته به نوع سیستم‌فایل و نسخه هسته)، مگر اینکه گزینه \fB\-\-whole\-file\fP نیز اعمال شده باشد. توجه داشته باشید که نسخه‌های rsync قدیمی‌تر از 3.1.3 (ژانویه ۲۰۱۸) ترکیب \fB\-\-sparse\fP و \fB\-\-inplace\fP را رد می‌کنند. .IP "\fB\-\-preallocate\fP" این گزینه به گیرنده می‌گوید که پیش از نوشتن داده‌ها در فایل، هر فایل مقصد را به اندازه نهایی آن پیش‌تخصیص دهد. rsync فقط از پشتیبانی واقعی پیش‌تخصیص در سطح سیستم‌فایل ارائه‌شده توسط فراخوان سیستمی \fBfallocate\fP(2) در لینوکس یا \fBposix_fallocate\fP(3) در Cygwin استفاده می‌کند، نه پیاده‌سازی کند glibc که در هر بلوک یک بایت پوچ (null) می‌نویسد. .IP بدون این گزینه، فایل‌های بزرگ‌تر ممکن است به‌طور کاملاً پیوسته روی سیستم‌فایل قرار نگیرند، اما با این گزینه احتمالاً rsync عملیات رونوشت را با سرعت کمتری انجام می‌دهد. اگر مقصد یک سیستم‌فایل با پشتیبانی از extent نباشد (مانند ext4، xfs، NTFS و غیره)، این گزینه ممکن است اصلاً هیچ تأثیر مثبتی نداشته باشد. .IP در صورت ترکیب با \fB\-\-sparse\fP، فایل تنها در صورتی دارای بلوک‌های کم‌پشت خواهد بود (در مقایسه با توالی‌های تخصیص‌یافته از بایت‌های صفر) که نسخه هسته و نوع سیستم‌فایل از ایجاد حفره‌ها در داده‌های تخصیص‌یافته پشتیبانی کنند. .IP "\fB\-\-dry\-run\fP, \fB\-n\fP" باعث می‌شود rsync یک اجرای آزمایشی انجام دهد که هیچ تغییری ایجاد نمی‌کند و خروجی آن تا حد زیادی مشابه یک اجرای واقعی است. این گزینه بیش از همه در ترکیب با گزینه‌های \fB\-\-verbose\fP (\fB\-v\fP) و/یا \fB\-\-itemize\-changes\fP (\fB\-i\fP) استفاده می‌شود تا پیش از اجرای واقعی دستور rsync، عملکرد آن مشاهده شود. .IP خروجی \fB\-\-itemize\-changes\fP قرار است در یک اجرای آزمایشی و اجرای واقعی پس از آن دقیقاً یکسان باشد (به‌جز تغییرات خارجی در مبدأ یا مقصد و شکست در فراخوان‌های سیستمی)؛ در غیر این صورت، این یک باگ است. سایر خروجی‌ها باید عمدتاً بدون تغییر بمانند، اما ممکن است در برخی موارد متفاوت باشند. به‌ویژه، یک اجرای آزمایشی داده‌های واقعی را برای انتقال فایل ارسال نمی‌کند، بنابراین \fB\-\-progress\fP هیچ تأثیری ندارد، آمارهای \(dqbytes sent\(dq، \(dqbytes received\(dq، \(dqliteral data\(dq و \(dqmatched data\(dq بسیار کوچک هستند، و مقدار \(dqspeedup\(dq معادل اجرایی است که نیازی به انتقال فایل نبوده است. .IP "\fB\-\-whole\-file\fP, \fB\-W\fP" این گزینه الگوریتم انتقال تفاضلی (delta-transfer) را در rsync غیرفعال می‌کند و باعث ارسال کامل تمام فایل‌های منتقل‌شده می‌شود. اگر پهنای باند بین ماشین‌های مبدأ و مقصد بیشتر از پهنای باند به دیسک باشد (به‌ویژه زمانی که \(dqدیسک\(dq در واقع یک سیستم‌فایل شبکه‌ای است)، استفاده از این گزینه می‌تواند انتقال را سریع‌تر کند. این حالت پیش‌فرض است وقتی که هر دو مسیر مبدأ و مقصد به‌صورت محلی مشخص شده باشند، اما تنها در صورتی که هیچ گزینه نوشتن دسته‌ای (batch-writing) فعال نباشد. .IP "\fB\-\-no\-whole\-file\fP, \fB\-\-no\-W\fP" غیرفعال کردن به‌روزرسانی کامل فایل در زمانی که به‌طور پیش‌فرض برای انتقال محلی فعال است. این کار معمولاً rsync را کند می‌کند، اما اگر تلاش می‌کنید نوشتن در فایل مقصد را به حداقل برسانید (در صورت ترکیب با \fB\-\-inplace\fP) یا برای آزمایش الگوریتم به‌روزرسانی مبتنی بر چکسام، می‌تواند مفید باشد. .IP همچنین گزینه \fB\-\-whole\-file\fP را ببینید. .IP "\fB\-\-checksum\-choice=STR\fP, \fB\-\-cc=STR\fP" این گزینه الگوریتم‌های چکسام را بازنویسی و جایگزین می‌کند. اگر یک نام الگوریتم مشخص شود، هم برای چکسام‌های انتقال و هم برای چکسام‌های پیش‌از‌انتقال استفاده می‌شود (توجه داشته باشید که چکسام پیش‌از‌انتقال تنها در صورت تعیین \fB\-\-checksum\fP انجام می‌گیرد). اگر دو نام جداشده با کاما ارائه شوند، نام اول بر چکسام‌های انتقال و نام دوم بر چکسام‌های پیش‌از‌انتقال تأثیر می‌گذارد. .IP گزینه‌های چک‌سامی که ممکن است بتوانید استفاده کنید عبارتند از: .IP .RS .IP o \fBauto\fP (انتخاب خودکار پیش‌فرض) .IP o \fBxxh128\fP .IP o \fBxxh3\fP .IP o \fBxxh64\fP (همچنین با نام \fBxxhash\fP) .IP o \fBmd5\fP .IP o \fBmd4\fP .IP o \fBsha1\fP .IP o \fBnone\fP .RE .IP برای مشاهده فهرست پیش‌فرض چک‌سام‌های کامپایل‌شده در نسخه خود (که ممکن است با فهرست بالا تفاوت داشته باشد)، دستور \fBrsync\ \-\-version\fP را اجرا کنید. .IP اگر برای نام اول (یا تنها نام) مقدار «none» مشخص شود، گزینه \fB\-\-whole\-file\fP اجباری شده و هیچ اعتبارسنجی چک‌سامی روی داده‌های منتقل‌شده انجام نمی‌شود. اگر برای نام دوم (یا تنها نام) مقدار «none» تعیین شود، گزینه \fB\-\-checksum\fP قابل استفاده نخواهد بود. .IP گزینه «auto» پیش‌فرض است، که در آن rsync انتخاب الگوریتم خود را بر اساس یک مذاکره میان کلاینت و سرور به شرح زیر انجام می‌دهد: .IP هنگامی که هر دو سمت انتقال حداقل نسخه 3.2.0 (منتشر شده در ژوئن ۲۰۲۰) باشند، هر سمت الگوریتم ترجیحی خود را که در فهرست طرف مقابل نیز وجود دارد انتخاب می‌کند. هر دو سمت فهرست‌های خود را با اولویت از قوی‌ترین مرتب می‌کنند، بنابراین بر روی قوی‌ترین انتخاب مشترک همگرا می‌شوند. اگر هیچ چک‌سام مشترکی یافت نشود، rsync با خطا خارج می‌شود. اگر rsync راه دور بیش از حد قدیمی باشد و از مذاکره چک‌سام پشتیبانی نکند، مقداری بر اساس نسخه پروتکل انتخاب می‌شود (که بسته به قدمت پروتکل، بین MD5 و انواع مختلف MD4 انتخاب می‌کند). .IP ترتیب پیش‌فرض را می‌توان با تنظیم متغیر محیطی \fBRSYNC_CHECKSUM_LIST\fP روی فهرستی از نام‌های چک‌سام مجاز با فاصله‌گذاری سفارشی کرد. اگر رشته شامل نویسه «\fB&\fP» باشد، به دو بخش «رشته کلاینت & رشته سرور» تقسیم می‌شود، در غیر این صورت همان رشته برای هر دو اعمال می‌گردد. اگر رشته (یا بخشی از رشته) فاقد نویسه‌های غیرفاصله‌ای باشد، فهرست چک‌سام پیش‌فرض استفاده می‌شود. این روش به شما اجازه نمی‌دهد چک‌سام انتقال را جدا از چک‌سام پیش‌انتقال مشخص کنید، و مقدار «auto» و تمام نام‌های چک‌سام ناشناخته را نادیده می‌گیرد. فهرستی که تنها شامل نام‌های نامعتبر باشد منجر به شکست مذاکره می‌شود. .IP استفاده از گزینه \fB\-\-checksum\-choice\fP این فهرست متغیر محیطی را بازنویسی می‌کند. .IP "\fB\-\-one\-file\-system\fP, \fB\-x\fP" این گزینه به rsync اعلام می‌کند که هنگام پیمایش بازگشتی، از مرز سیستم‌فایل عبور نکند. این کار مانع از توانایی کاربر برای تعیین مواردی از چندین سیستم‌فایل جهت کپی نمی‌شود، بلکه تنها پیمایش بازگشتی rsync را در ساختار درختی هر دایرکتوری مشخص‌شده توسط کاربر محدود می‌کند، و همچنین پیمایش مشابه را در سمت گیرنده هنگام حذف اعمال می‌نماید. همچنین به یاد داشته باشید که rsync یک اتصال «bind» به همان دستگاه را به عنوان عضوی از همان سیستم‌فایل در نظر می‌گیرد. .IP اگر این گزینه تکرار شود، rsync تمام دایرکتوری‌های نقطه اتصال (mount-point) را از کپی حذف می‌کند. در غیر این صورت، یک دایرکتوری خالی در هر نقطه اتصالی که با آن روبرو می‌شود قرار می‌دهد (با استفاده از ویژگی‌های دایرکتوری متصل‌شده، زیرا ویژگی‌های دایرکتوری نقطه اتصال زیرین غیرقابل دسترسی هستند). .IP اگر به rsync گفته شده باشد پیوندهای نمادین را باز کند (از طریق \fB\-\-copy\-links\fP یا \fB\-\-copy\-unsafe\-links\fP)، پیوند نمادین به یک دایرکتوری روی دستگاه دیگر مانند یک نقطه اتصال در نظر گرفته می‌شود. پیوندهای نمادین به موارد غیردایرکتوری تحت تأثیر این گزینه قرار نمی‌گیرند. .IP "\fB\-\-ignore\-non\-existing\fP, \fB\-\-existing\fP" این به rsync می‌گوید از ایجاد پرونده‌هایی (شامل دایرکتوری‌ها) که هنوز در مقصد وجود ندارند صرف‌نظر کند. اگر این گزینه با گزینه \fB\-\-ignore\-existing\fP ترکیب شود، هیچ پرونده‌ای به‌روزرسانی نخواهد شد (که در صورتی که تمام خواسته شما حذف پرونده‌های اضافی باشد می‌تواند مفید باشد). .IP این گزینه یک TRANSFER RULE است، بنابراین انتظار هیچ‌گونه اثر جانبی ناشی از استثنا (exclude) را نداشته باشید. .IP "\fB\-\-ignore\-existing\fP" این به rsync می‌گوید از به‌روزرسانی پرونده‌هایی که از قبل در مقصد وجود دارند صرف‌نظر کند (این گزینه دایرکتوری‌های موجود را نادیده \fIنمی‌گیرد\fP، وگرنه هیچ کاری انجام نمی‌شد). همچنین ببینید \fB\-\-ignore\-non\-existing\fP. .IP این گزینه یک TRANSFER RULE است، بنابراین انتظار هیچ‌گونه اثر جانبی ناشی از استثنا (exclude) را نداشته باشید. .IP این گزینه می‌تواند برای کسانی که با استفاده از گزینه \fB\-\-link\-dest\fP پشتیبان‌گیری می‌کنند، زمانی که نیاز به ادامه یک پشتیبان‌گیری قطع‌شده دارند مفید باشد. از آنجا که اجرای \fB\-\-link\-dest\fP درون یک سلسله‌مراتب دایرکتوری جدید رونوشت می‌شود (در صورت استفاده صحیح)، استفاده از \fB\-\-ignore\-existing\fP تضمین می‌کند که پرونده‌های از قبل پردازش‌شده دستکاری نشوند (که از تغییر در دسترسی‌های پرونده‌های دارای پیوند سخت جلوگیری می‌کند). این بدان معناست که این گزینه فقط به پرونده‌های موجود در خود سلسله‌مراتب مقصد نگاه می‌کند. .IP هنگامی که \fB\-\-info=skip2\fP استفاده شود، rsync پیام‌های \(dqFILENAME exists (INFO)\(dq را نمایش می‌دهد که در آن INFO نشان‌دهنده یکی از موارد \(dqtype change\(dq، \(dqsum change\(dq (نیازمند \fB\-c\fP)، \(dqfile change\(dq (بر اساس بررسی سریع)، \(dqattr change\(dq، یا \(dquptodate\(dq است. استفاده از \fB\-\-info=skip1\fP (که همچنین توسط ۲ گزینه \fB\-v\fP اعمال می‌شود) پیام موجود بودن را بدون پسوند INFO چاپ می‌کند. .IP "\fB\-\-remove\-source\-files\fP" این به rsync می‌گوید پرونده‌هایی (به معنای غیر دایرکتوری‌ها) را از سمت فرستنده حذف کند که بخشی از انتقال بوده و با موفقیت در سمت گیرنده تکثیر شده‌اند. .IP توجه داشته باشید که فقط باید از این گزینه برای پرونده‌های مبدأ در وضعیت پایدار و غیرفعال استفاده کنید. اگر از این گزینه برای انتقال پرونده‌هایی که در یک دایرکتوری خاص ایجاد می‌شوند به میزبانی دیگر استفاده می‌کنید، مطمئن شوید پرونده‌های تکمیل‌شده به داخل دایرکتوری مبدأ تغییر نام داده می‌شوند، نه اینکه مستقیماً در آن نوشته شوند، تا rsync به‌هیچ‌وجه نتواند پرونده‌ای را که هنوز به طور کامل نوشته نشده منتقل کند. اگر نمی‌توانید ابتدا پرونده‌ها را در دایرکتوری دیگری بنویسید، باید از یک شیوه نام‌گذاری استفاده کنید که به rsync اجازه دهد از انتقال پرونده‌های ناتمام خودداری کند (مثلاً نام‌گذاری پرونده به \(dqfoo.new\(dq هنگام نوشتن، تغییر نام آن به \(dqfoo\(dq پس از اتمام، و سپس استفاده از گزینه \fB\-\-exclude=\(aq*.new\(aq\fP برای انتقال rsync). .IP اگر اندازه یا زمان ویرایش پرونده بدون تغییر نمانده باشد، rsync از حذف در سمت فرستنده صرف‌نظر کرده و یک خطا چاپ می‌کند. .IP اگر رونوشت محلی باشد، rsync اطمینان حاصل می‌کند فرستنده پرونده‌ای را که گیرنده به‌تازگی تأیید کرده حذف نکند؛ مانند زمانی که کاربر به اشتباه مسیر دایرکتوری مبدأ و مقصد را یکسان تعیین کرده باشد. .IP "\fB\-\-delete\fP" این به rsync می‌گوید پرونده‌های اضافی را از سمت گیرنده (آن‌هایی که در سمت فرستنده وجود ندارند) حذف کند، اما فقط برای دایرکتوری‌هایی که در حال همگام‌سازی هستند. شما باید از rsync خواسته باشید کل دایرکتوری را ارسال کند (مانند \(dq\fBdir\fP\(dq یا \(dq\fBdir/\fP\(dq)، نه اینکه همه پرونده‌های درون یک دایرکتوری را از طریق نویسه عمومی درخواست کنید (مانند \(dq\fBdir/*\fP\(dq)؛ چرا که نویسه عمومی توسط پوسته باز می‌شود و بنابراین rsync درخواستی برای انتقال تک‌تک پرونده‌ها دریافت می‌کند، نه دایرکتوری والد پرونده‌ها. پرونده‌هایی که از انتقال مستثنی شده‌اند نیز از حذف شدن مستثنی می‌شوند، مگر اینکه از گزینه \fB\-\-delete\-excluded\fP استفاده کنید یا قواعد را طوری مشخص کنید که فقط در سمت فرستنده تطبیق داده شوند (بخش اصلاح‌کننده‌های include/exclude در قسمت FILTER RULES را ببینید). .IP این گزینه هیچ اثری ندارد مگر اینکه \fB\-\-recursive\fP یا \fB\-\-dirs\fP (\fB\-d\fP) فعال باشد. در حالت دوم، حذف فقط در دایرکتوری‌هایی رخ می‌دهد که محتوای آن‌ها در حال رونوشت شدن است. .IP این گزینه در صورت استفاده نادرست می‌تواند خطرناک باشد! توصیه می‌شود ابتدا با استفاده از گزینه \fB\-\-dry\-run\fP (\fB\-n\fP) یک اجرای آزمایشی انجام دهید تا ببینید چه پرونده‌هایی قرار است حذف شوند. .IP اگر سمت فرستنده هرگونه خطای ورودی/خروجی (I/O) را تشخیص دهد، حذف فایل‌ها در مقصد به‌طور خودکار غیرفعال خواهد شد. این کار برای جلوگیری از خرابی‌های موقت سیستم‌فایل (مانند خطاهای NFS) در سمت فرستنده است که ممکن است باعث حذف گسترده فایل‌ها در مقصد شود. می‌توانید این رفتار را با گزینه \fB\-\-ignore\-errors\fP لغو کنید. .IP گزینه \fB\-\-delete\fP می‌تواند بدون تداخل با یکی از گزینه‌های \-\-delete\-WHEN و همچنین \fB\-\-delete\-excluded\fP ترکیب شود. با این حال، اگر هیچ‌یک از گزینه‌های \fB\-\-delete\-WHEN\fP مشخص نشده باشد، rsync هنگام ارتباط با rsync نسخه 3.0.0 (مارس ۲۰۰۸) یا جدیدتر الگوریتم \fB\-\-delete\-during\fP را انتخاب می‌کند، یا هنگام ارتباط با نسخه‌های قدیمی‌تر rsync الگوریتم \fB\-\-delete\-before\fP را برمی‌گزیند. همچنین \fB\-\-delete\-delay\fP و \fB\-\-delete\-after\fP را ببینید. .IP "\fB\-\-delete\-before\fP" درخواست می‌کند که حذف فایل‌ها در سمت گیرنده پیش از شروع انتقال انجام شود. برای جزئیات بیشتر درباره حذف فایل، \fB\-\-delete\fP (که به‌طور ضمنی اعمال می‌شود) را ببینید. .IP حذف قبل از انتقال زمانی مفید است که سیستم‌فایل با کمبود فضا مواجه باشد و حذف فایل‌های اضافی به امکان‌پذیر شدن انتقال کمک کند. با این حال، این کار باعث ایجاد تاخیر قبل از شروع انتقال می‌شود و این تاخیر ممکن است باعث اتمام مهلت زمانی انتقال شود (اگر \fB\-\-timeout\fP مشخص شده باشد). همچنین rsync را مجبور می‌کند از الگوریتم بازگشتی قدیمی و غیر‌افزایشی استفاده کند که نیازمند اسکن یک‌باره تمام فایل‌های موجود در انتقال به حافظه است (به \fB\-\-recursive\fP مراجعه کنید). .IP "\fB\-\-delete\-during\fP, \fB\-\-del\fP" درخواست می‌کند که حذف فایل‌ها در سمت گیرنده به‌صورت افزایشی همگام با انجام انتقال صورت گیرد. اسکن حذف در هر دایرکتوری درست پیش از بررسی همان دایرکتوری برای به‌روزرسانی‌ها انجام می‌شود، بنابراین رفتاری شبیه به نسخه کارآمدتر \fB\-\-delete\-before\fP دارد، از جمله انجام حذف‌ها پیش از به‌روزرسانی فایل‌های فیلتر هر دایرکتوری. برای جزئیات بیشتر درباره حذف فایل، \fB\-\-delete\fP (که به‌طور ضمنی اعمال می‌شود) را ببینید. .IP "\fB\-\-delete\-delay\fP" درخواست می‌کند که فایل‌های حذفی در سمت گیرنده در طول انتقال محاسبه شوند (مانند \fB\-\-delete\-during\fP)، و سپس پس از اتمام انتقال حذف گردند. این گزینه هنگام ترکیب با \fB\-\-delay\-updates\fP و/یا \fB\-\-fuzzy\fP مفید است و کارآمدتر از استفاده از \fB\-\-delete\-after\fP است، اما ممکن است رفتار متفاوتی داشته باشد، زیرا \fB\-\-delete\-after\fP عملیات حذف را در یک گذر جداگانه پس از انجام تمام به‌روزرسانی‌ها محاسبه می‌کند. اگر تعداد فایل‌های حذف‌شده از بافر داخلی سرریز کند، یک فایل موقت در سمت گیرنده برای نگهداری نام‌ها ایجاد خواهد شد (این فایل در حالی که باز است حذف می‌شود، بنابراین نباید آن را در طول انتقال مشاهده کنید). اگر ایجاد فایل موقت با شکست مواجه شود، rsync تلاش می‌کند به استفاده از \fB\-\-delete\-after\fP بازگردد (که اگر \fB\-\-recursive\fP در حال انجام اسکن افزایشی باشد، قادر به انجام آن نخواهد بود). برای جزئیات بیشتر درباره حذف فایل، \fB\-\-delete\fP (که به‌طور ضمنی اعمال می‌شود) را ببینید. .IP "\fB\-\-delete\-after\fP" درخواست می‌کند که حذف فایل‌ها در سمت گیرنده پس از اتمام انتقال انجام شود. این گزینه زمانی مفید است که فایل‌های ادغام (merge) دایرکتوری جدیدی را به‌عنوان بخشی از انتقال ارسال می‌کنید و می‌خواهید استثناهای آن‌ها برای مرحله حذفِ انتقال فعلی اعمال شوند. همچنین rsync را مجبور می‌کند از الگوریتم بازگشتی قدیمی و غیر‌افزایشی استفاده کند که نیازمند اسکن یک‌باره تمام فایل‌های موجود در انتقال به حافظه است (به \fB\-\-recursive\fP مراجعه کنید). برای جزئیات بیشتر درباره حذف فایل، \fB\-\-delete\fP (که به‌طور ضمنی اعمال می‌شود) را ببینید. .IP همچنین گزینه \fB\-\-delete\-delay\fP را ببینید که ممکن است انتخاب سریع‌تری برای کسانی باشد که فقط می‌خواهند حذف‌ها در پایان انتقال رخ دهد. .IP "\fB\-\-delete\-excluded\fP" این گزینه تمام قواعد بدون اصلاح‌کننده استثنا/شمول (exclude/include) را به قواعد سمت سرور تبدیل می‌کند که بر حذف‌های سمت گیرنده تاثیری نمی‌گذارند. .IP به‌طور پیش‌فرض، یک استثنا یا شمول هم دارای اثر در سمت سرور (برای «پنهان کردن» و «نشان دادن» فایل‌ها هنگام ساخت فهرست فایل سرور) و هم دارای اثر در سمت گیرنده (برای «محافظت» و «به خطر انداختن» فایل‌ها هنگام وقوع حذف‌ها) است. با هر قاعده‌ای که فاقد اصلاح‌کننده برای تعیین سمت اجرای آن باشد، طوری رفتار خواهد شد که گویی فقط یک قاعده سمت سرور است و از هرگونه اثر «محافظت» آن قواعد جلوگیری می‌شود. .IP یک قاعده همچنان می‌تواند برای هر دو طرف اعمال شود حتی با مشخص شدن این گزینه، اگر به قاعده هر دو حرف تغییردهنده فرستنده و گیرنده داده شده باشد (مانند \fB\-f'\-sr\ foo'\fP). قواعد محافظت/ریسک سمت گیرنده نیز می‌توانند صراحتاً مشخص شوند تا حذف‌ها محدود شوند. این کار شما را از ویرایش دسته‌ای از قواعد \fB\-f'\-\ foo'\fP به قواعد \fB\-f'\-s\ foo'\fP (یا همان \fB\-f'H\ foo'\fP) بی‌نیاز می‌کند (به‌علاوه شامل‌کردن‌های متناظر). .IP برای اطلاعات بیشتر بخش \fBقواعد فیلتر (FILTER RULES)\fP را ببینید. برای جزئیات بیشتر در مورد حذف، گزینه \fB\-\-delete\fP (که ضمنی است) را مشاهده کنید. .IP "\fB\-\-ignore\-missing\-args\fP" هنگامی که rsync در ابتدا پرونده‌های مبدأ صراحتاً درخواست‌شده (مانند آرگومان‌های خط فرمان یا ورودی‌های \fB\-\-files\-from\fP) را پردازش می‌کند، معمولاً اگر پرونده پیدا نشود یک خطا در نظر گرفته می‌شود. این گزینه آن خطا را نادیده می‌گیرد و برای انتقال پرونده تلاشی نمی‌کند. این امر بر خطاهای بعدی ناشی از ناپدید شدن پرونده (vanished-file) تأثیری ندارد اگر پرونده‌ای در ابتدا موجود بوده و بعداً دیگر در آنجا نباشد. .IP "\fB\-\-delete\-missing\-args\fP" این گزینه رفتار گزینه (ضمنی) \fB\-\-ignore\-missing\-args\fP را یک گام فراتر می‌برد: هر آرگومان مفقود به یک درخواست حذف برای پرونده مقصد متناظر در سمت گیرنده تبدیل خواهد شد (در صورت وجود داشتن). اگر پرونده مقصد یک دایرکتوری غیرخالی باشد، تنها در صورتی با موفقیت حذف خواهد شد که \fB\-\-force\fP یا \fB\-\-delete\fP فعال باشند. به‌جز این، این گزینه از هر نوع پردازش حذف دیگری مستقل است. .IP پرونده‌های مبدأ مفقود توسط مدخل‌های ویژه فهرست پرونده نمایش داده می‌شوند که در خروجی \fB\-\-list\-only\fP به‌صورت یک مدخل "\fB*missing\fP" نشان داده می‌شوند. .IP "\fB\-\-ignore\-errors\fP" به \fB\-\-delete\fP می‌گوید حتی در صورت وجود خطاهای I/O، به کار خود ادامه داده و پرونده‌ها را حذف کند. .IP "\fB\-\-force\fP" این گزینه به rsync می‌گوید در صورتی که قرار است یک دایرکتوری غیرخالی با یک غیردایرکتوری جایگزین شود، آن را حذف کند. این تنها زمانی مرتبط است که حذف‌ها فعال نباشند (برای جزئیات \fB\-\-delete\fP را ببینید). .IP "\fB\-\-max\-delete=NUM\fP" این گزینه به rsync می‌گوید بیش از NUM پرونده یا دایرکتوری را حذف نکند. اگر از این حد فراتر رود، از تمام حذف‌های بعدی تا پایان انتقال صرف‌نظر می‌شود. در پایان، rsync یک هشدار (شامل تعداد حذف‌های نادیده‌گرفته‌شده) صادر کرده و با کد خطای 25 خارج می‌شود (مگر اینکه شرایط خطای مهم‌تری نیز رخ داده باشد). .IP می‌توانید \fB\-\-max\-delete=0\fP را مشخص کنید تا در مورد هر پرونده اضافی در مقصد بدون حذف هیچ‌یک از آن‌ها هشدار داده شود. هشدار: یک کلاینت rsync قدیمی‌تر از 3.0.0 (مارس ۲۰۰۸) با \fB\-\-max\-delete=0\fP مانند نامحدود رفتار می‌کند، بنابراین اگر ممکن است دستور توسط چنین rsync قدیمی اجرا شود، از \fB\-\-max\-delete=\-1\fP استفاده کنید. (یک کلاینت 3.0.0 یا جدیدتر با هدایت گزینه به‌صورت \fB\-\-max\-delete=\-1\fP از سیستم راه‌دور قدیمی محافظت می‌کند.) .IP "\fB\-\-max\-size=SIZE\fP" این گزینه به rsync می‌گوید از انتقال هر پرونده‌ای که بزرگتر از SIZE مشخص‌شده باشد خودداری کند. یک مقدار عددی می‌تواند با یک رشته برای تعیین واحدهای عددی پسونددهی شود یا بدون پسوند برای مشخص کردن بایت رها شود، و مقدار عددی می‌تواند دارای بخش کسری باشد، مانند \fB\-\-max\-size=1.5m\fP. .IP این گزینه یک TRANSFER RULE است، بنابراین انتظار هیچ اثر جانبی ناشی از مستثنی‌سازی (exclude) را نداشته باشید. .IP حرف اول رشته واحدها می‌تواند \fBB\fP (بایت)، \fBK\fP (کیلو)، \fBM\fP (مگا)، \fBG\fP (گیگا)، \fBT\fP (ترا) یا \fBP\fP (پتا) باشد. اگر رشته یک نویسه تکی باشد یا "ib" به آن اضافه شده باشد (مانند "G" یا "GiB")، واحدها مضاربی از ۱۰۲۴ هستند. اگر از یک پسوند دو حرفی استفاده کنید که به "B" ختم می‌شود (مانند "kb")، واحدهایی به دست می‌آورید که مضاربی از ۱۰۰۰ هستند. حروف رشته می‌توانند هر ترکیبی از حروف بزرگ و کوچک باشند که می‌خواهید استفاده کنید. .IP در نهایت، اگر رشته به "+1" یا "\-1" ختم شود، به اندازه یک بایت در جهت نشان‌داده‌شده تغییر مکان می‌یابد. بزرگ‌ترین مقدار ممکن معمولاً \fB8192P-1\fP است. .IP مثال‌ها: \fB\-\-max\-size=1.5mb-1\fP برابر با ۱۴۹۹۹۹۹ بایت است، و \fB\-\-max\-size=2g+1\fP برابر با ۲۱۴۷۴۸۳۶۴۹ بایت است. .IP "\fB\-\-min\-size=SIZE\fP" این گزینه به rsync می‌گوید از انتقال هر پرونده‌ای که کوچکتر از SIZE مشخص‌شده باشد خودداری کند، که می‌تواند به عدم انتقال پرونده‌های کوچک و زائد کمک کند. برای شرح SIZE و اطلاعات دیگر، گزینه \fB\-\-max\-size\fP را ببینید. .IP "\fB\-\-max\-alloc=SIZE\fP" به‌طور پیش‌فرض rsync هر malloc/realloc منفرد را به اندازه‌ای در حدود 1GB محدود می‌کند. برای بیشتر کاربران این محدودیت به خوبی عمل کرده و از خطای پروتکلی که منجر به درخواست مقادیر بسیار زیاد حافظه توسط rsync می‌شود جلوگیری می‌کند. با این حال، اگر در یک انتقال میلیون‌ها پرونده دارید، سرور حافظه زیادی دارد و نمی‌خواهید انتقال خود را به چندین بخش تقسیم کنید، می‌توانید حد مجاز هر تخصیص را افزایش دهید تا به rsync اجازه مصرف حافظه بیشتری داده شود. .IP به یاد داشته باشید که این محدودیتی برای اندازه کل حافظه تخصیص‌یافته نیست، بلکه مقداری برای بررسی سلامت هر تخصیص منفرد است. .IP برای توضیحات درباره چگونگی تعیین SIZE گزینه \fB\-\-max\-size\fP را ببینید. پسوند پیش‌فرض در صورت مشخص نشدن، بایت است. .IP از نسخه 3.2.7، مقدار 0 روشی آسان برای تعیین SIZE_MAX (بزرگ‌ترین حد ممکن) بود. با این حال، از نسخه 3.5.0 به بعد، مقدار 0 به دلایل امنیتی نامعتبر دانسته و رد می‌شود (یک سقف 0 بایتی می‌تواند برای غیرفعال کردن محدودیت تخصیص استفاده شود که ممکن است منجر به حمله انکار سرویس از طریق اتمام حافظه گردد). اگر حد بسیار بالایی می‌خواهید، یک مقدار بزرگ صریح تعیین کنید. .IP می‌توانید با استفاده از متغیر محیطی \fBRSYNC_MAX_ALLOC\fP و مقادیر SIZE پشتیبانی‌شده توسط این گزینه، یک مقدار پیش‌فرض تنظیم کنید. اگر rsync در سمت مقصد گزینه \fB\-\-max\-alloc\fP را متوجه نشود، می‌توانید مقدار محیطی را با مشخص کردن \fB\-\-max\-alloc=1g\fP بازنویسی کنید، که باعث می‌شود rsync از ارسال گزینه به سمت مقصد خودداری کند (زیرا \(dq1G\(dq پیش‌فرض است). .IP "\fB\-\-block\-size=SIZE\fP, \fB\-B\fP" این گزینه اندازه بلوک استفاده‌شده در الگوریتم انتقال دلتای rsync را به یک مقدار ثابت تحمیل می‌کند. این مقدار به‌طور عادی بر اساس اندازه هر پرونده‌ای که به‌روزرسانی می‌شود انتخاب می‌گردد. برای جزئیات به گزارش فنی مراجعه کنید. .IP مقدار SIZE را می‌توان با یک پسوند تعیین کرد، همان‌طور که در گزینه \fB\-\-max\-size\fP توضیح داده شده است. .IP "\fB\-\-rsh=COMMAND\fP, \fB\-e\fP" این گزینه به شما اجازه می‌دهد تا یک برنامه پوسته راه‌دور جایگزین برای ارتباط بین نسخه‌های محلی و راه‌دور rsync انتخاب کنید. معمولاً rsync به‌طور پیش‌فرض برای استفاده از ssh پیکربندی شده است. .IP اگر این گزینه همراه با \fB[user@]host::module/path\fP استفاده شود، آن‌گاه پوسته راه‌دور \fICOMMAND\fP برای اجرای یک دیمن rsync روی میزبان راه‌دور استفاده خواهد شد و تمامی داده‌ها به جای اتصال سوکت مستقیم به یک دیمن در حال اجرای rsync در میزبان راه‌دور، از طریق آن اتصال پوسته راه‌دور منتقل می‌شوند. بخش USING RSYNC-DAEMON FEATURES VIA A REMOTE-SHELL CONNECTION در بالا را ببینید. .IP متغیر محیطی \fBRSYNC_PORT\fP زمانی که اتصال دیمن از طریق یک اتصال پوسته راه‌دور برقرار می‌شود، تنظیم خواهد شد. اگر پورت پیش‌فرض دیمن فرض شود، مقدار آن روی 0 قرار می‌گیرد، یا روی مقدار پورت rsync تنظیم می‌شود که از طریق گزینه \fB\-\-port\fP یا یک مقدار پورت غیرخالی در نشانی \fBrsync://\fP مشخص شده است (برای مثال \fBrsync://host.example.com:984\fP). این مورد زمانی مفید است که برنامه در حال اجرا واقعاً rsync نبوده بلکه اسکریپت کمکی مانند SSL یا stunnel باشد؛ اسکریپت می‌تواند از \fBRSYNC_PORT\fP برای تشخیص اتصال به پورت پیش‌فرض یا جایگزین استفاده کند. .IP آرگومان‌های خط فرمان در COMMAND مجاز هستند، به شرطی که COMMAND به عنوان یک آرگومان واحد به rsync ارائه شود. برای جداسازی دستور و آرگومان‌ها از یکدیگر باید از فاصله (نه تب یا سایر فاصله‌های خالی) استفاده کنید، و می‌توانید برای حفظ فاصله‌ها در یک آرگومان از نقل‌قول تکی یا دوتایی (اما نه بک‌اسلش) استفاده کنید. توجه داشته باشید که تکرار نقل‌قول تکی در یک رشته با نقل‌قول تکی، یک نقل‌قول تکی ایجاد می‌کند؛ همچنین برای نقل‌قول‌های دوتایی نیز چنین است (هرچند باید توجه داشته باشید که کدام نقل‌قول‌ها توسط پوسته شما و کدام نقل‌قول‌ها توسط rsync پردازش می‌شوند). چند مثال: .RS 4 .IP .nf -e 'ssh -p 2234' -e 'ssh -o "ProxyCommand nohup ssh firewall nc -w1 %h %p"' .fi .RE .IP (توجه داشته باشید که کاربران ssh می‌توانند به‌جای این کار، گزینه‌های اتصال مختص هر میزبان را در پروندهٔ .ssh/config خود سفارشی‌سازی کنند.) .IP همچنین می‌توانید برنامهٔ پوستهٔ راه‌دور را با استفاده از متغیر محیطی \fBRSYNC_RSH\fP مشخص کنید که همان دامنهٔ مقادیر \fB\-e\fP را می‌پذیرد. .IP همچنین گزینهٔ \fB\-\-blocking\-io\fP را ببینید که تحت تأثیر این گزینه قرار می‌گیرد. .IP "\fB\-\-rsync\-path=PROGRAM\fP" از این گزینه برای تعیین برنامه‌ای که باید جهت راه‌اندازی rsync روی ماشین راه‌دور اجرا شود، استفاده کنید. معمولاً زمانی کاربرد دارد که rsync در مسیر پیش‌فرض پوستهٔ راه‌دور قرار ندارد (مانند \fB\-\-rsync\-path=/usr/local/bin/rsync\fP). توجه داشته باشید که PROGRAM به‌کمک یک پوسته اجرا می‌شود، بنابراین می‌تواند هر برنامه، اسکریپت، یا دنباله‌ای از دستورات باشد، تا زمانی که ورودی و خروجی استاندارد مورد استفادهٔ rsync برای ارتباط را مختل نکند. .IP یک نمونهٔ کاربردی، تنظیم یک دایرکتوری پیش‌فرض متفاوت روی ماشین راه‌دور برای استفاده همراه با گزینهٔ \fB\-\-relative\fP است. برای نمونه: .RS 4 .IP .nf rsync -avR --rsync-path="cd /a/b && rsync" host:c/d /e/ .fi .RE .IP "\fB\-\-remote\-option=OPTION\fP, \fB\-M\fP" این گزینه برای شرایط پیشرفته‌تری استفاده می‌شود که در آن‌ها می‌خواهید برخی اثرات تنها به یک سمت از انتقال محدود شود. برای نمونه، اگر می‌خواهید \fB\-\-log\-file=FILE\fP و \fB\-\-fake\-super\fP را به سیستم راه‌دور ارسال کنید، آن را به این صورت مشخص کنید: .RS 4 .IP .nf rsync -av -M --log-file=foo -M--fake-super src/ dest/ .fi .RE .IP اگر می‌خواهید گزینه‌ای که به‌طور معمول بر هر دو سمت اثر می‌گذارد تنها بر سمت محلی انتقال تأثیر بگذارد، نقیض آن را به سمت راه‌دور ارسال کنید. مانند این: .RS 4 .IP .nf rsync -av -x -M--no-x src/ dest/ .fi .RE .IP در استفاده از این قابلیت محتاط باشید، زیرا ممکن است گزینه‌ای را تغییر دهید که باعث شود rsync برداشت متفاوتی از داده‌های مورد انتظار بعدی روی سوکت پیدا کند و با خطایی مبهم متوقف شود. .IP توجه داشته باشید که باید برای هر گزینهٔ راه‌دوری که می‌خواهید ارسال کنید، یک گزینهٔ \fB\-M\fP جداگانه به کار ببرید. در نسخه‌های قدیمی‌تر rsync، وجود هرگونه فاصله در آرگومان remote-option می‌توانست باعث تقسیم آن به آرگومان‌های راه‌دور مجزا شود، اما این کار در rsync امروزی نیازمند استفاده از \fB\-\-old\-args\fP است. .IP هنگام انجام انتقال محلی، سمت «محلی» فرستنده و سمت «راه‌دور» گیرنده است. .IP توجه داشته باشید برخی از نسخه‌های کتابخانهٔ تحلیل گزینهٔ popt دارای باگی هستند که مانع از استفاده از یک آرگومان چسبیدهٔ حاوی علامت مساوی در کنار حرف کوتاه گزینه می‌شود (مانند \fB\-M\-\-log\-file=/tmp/foo\fP). اگر این باگ نسخهٔ popt شما را تحت تأثیر قرار داده است، می‌توانید از نسخهٔ popt ارائه‌شده همراه با rsync استفاده کنید. .IP "\fB\-\-cvs\-exclude\fP, \fB\-C\fP" این یک میان‌بر کاربردی برای مستثنی کردن دامنهٔ گسترده‌ای از پرونده‌ها است که معمولاً نمی‌خواهید بین سیستم‌ها منتقل شوند. این گزینه از الگوریتمی مشابه با CVS برای تعیین نادیده گرفتن پرونده استفاده می‌کند. .IP فهرست موارد استثنا با موارد زیر مقداردهی اولیه می‌شود (این موارد اولیه به عنوان زوال‌پذیر\ \-\- علامت‌گذاری شده‌اند؛ بخش قواعد فیلتر (FILTER RULES) را ببینید): .RS 4 .IP \fBRCS\fP \fBSCCS\fP \fBCVS\fP \fBCVS.adm\fP \fBRCSLOG\fP \fBcvslog.*\fP \fBtags\fP \fBTAGS\fP \fB.make.state\fP \fB.nse_depinfo\fP \fB*~\fP \fB#*\fP \fB.#*\fP \fB,*\fP \fB_$*\fP \fB*$\fP \fB*.old\fP \fB*.bak\fP \fB*.BAK\fP \fB*.orig\fP \fB*.rej\fP \fB.del-*\fP \fB*.a\fP \fB*.olb\fP \fB*.o\fP \fB*.obj\fP \fB*.so\fP \fB*.exe\fP \fB*.Z\fP \fB*.elc\fP \fB*.ln\fP \fBcore\fP \fB.svn/\fP \fB.git/\fP \fB.hg/\fP \fB.bzr/\fP .RE .IP سپس، فایل‌های فهرست‌شده در $HOME/.cvsignore و هر فایلی که در متغیر محیطی CVSIGNORE آمده باشد به فهرست اضافه می‌شوند (تمام نام‌های cvsignore با فاصله از هم جدا می‌شوند). .IP در نهایت، هر فایلی که در همان پوشه با یک فایل .cvsignore قرار داشته باشد و با یکی از الگوهای فهرست‌شده در آن مطابقت کند نادیده گرفته می‌شود. برخلاف فایل‌های فیلتر/استثنای rsync، این الگوها بر اساس فاصله از هم تفکیک می‌شوند. برای اطلاعات بیشتر به راهنمای \fBcvs\fP(1) مراجعه کنید. .IP اگر \fB\-C\fP را با قواعد \fB\-\-filter\fP خود ترکیب می‌کنید، باید توجه داشته باشید که این استثناهای CVS صرف‌نظر از محل قرارگیری \fB\-C\fP در خط فرمان، به انتهای قواعد شما اضافه می‌شوند. این مسئله باعث می‌شود نسبت به قواعدی که صریحاً تعیین کرده‌اید اولویت پایین‌تری داشته باشند. اگر می‌خواهید محل درج این استثناهای CVS در قواعد فیلتر خود را کنترل کنید، باید گزینه خط فرمانی \fB\-C\fP را حذف کرده و از ترکیب \fB\-\-filter=:C\fP و \fB\-\-filter=\-C\fP استفاده کنید (چه در خط فرمان یا با قرار دادن قواعد ":C" و "\-C" در یک فایل فیلتر در کنار سایر قواعدتان). گزینه نخست، پویش پوشه‌به‌پوشه برای فایل .cvsignore را فعال می‌کند. گزینه دوم، استثناهای CVS اشاره‌شده در بالا را یک‌باره وارد می‌کند. .IP "\fB\-\-filter=RULE\fP, \fB\-f\fP" این گزینه امکان افزودن قواعد برای مستثنی کردن انتخابی فایل‌های مشخص از فهرست فایل‌های در حال انتقال را فراهم می‌کند. این قابلیت بیشترین کاربرد را در ترکیب با انتقال بازگشتی دارد. .IP می‌توانید به تعداد دلخواه از گزینه \fB\-\-filter\fP در خط فرمان برای ساخت فهرست فایل‌های استثنا استفاده کنید. اگر فیلتر شامل فاصله است، حتماً آن را درون علامت نقل‌قول قرار دهید تا پوسته، قاعده را به عنوان یک آرگومان واحد به rsync تحویل دهد. می‌توانید به جای فاصله از زیرخط (_) برای جداسازی قاعده از آرگومان آن استفاده کنید. .IP برای اطلاعات دقیق درباره این گزینه، بخش قواعد فیلتر (FILTER RULES) را ببینید. .IP "\fB\-F\fP" گزینه \fB\-F\fP روشی خلاصه‌نویسی برای افزودن دو قاعده \fB\-\-filter\fP به دستور شما است. نخستین باری که استفاده شود، خلاصه‌ای از این قاعده است: .RS 4 .IP .nf --filter='dir-merge /.rsync-filter' .fi .RE .IP این گزینه به rsync می‌گوید در سلسله‌مراتب به دنبال فایل‌های .rsync-filter مربوط به هر دایرکتوری بگردد و از قواعد آن‌ها برای فیلتر کردن فایل‌ها در انتقال استفاده کند. اگر \fB\-F\fP تکرار شود، خلاصه‌ای از این قاعده خواهد بود: .RS 4 .IP .nf --filter='exclude .rsync-filter' .fi .RE .IP این کار خود فایل‌های .rsync-filter را از فرایند انتقال مستثنی می‌کند. .IP برای اطلاعات دقیق درباره نحوه کارکرد این گزینه‌ها بخش «قواعد فیلتر (FILTER RULES)» را ببینید. .IP "\fB\-\-exclude=PATTERN\fP" این گزینه شکل ساده‌شده‌ای از گزینه \fB\-\-filter\fP است که یک قاعده مستثنی‌سازی (exclude) را مشخص می‌کند و اجازه استفاده از ساختار نحوی کامل تجزیه قواعد فیلتر عادی را نمی‌دهد. این معادل با مشخص کردن \fB\-f'\-\ PATTERN'\fP است. .IP برای اطلاعات دقیق درباره این گزینه بخش «قواعد فیلتر (FILTER RULES)» را ببینید. .IP "\fB\-\-exclude\-from=FILE\fP" این گزینه به گزینه \fB\-\-exclude\fP مربوط است، اما یک FILE حاوی الگوهای مستثنی‌سازی (یک الگو در هر خط) را مشخص می‌کند. خطوط خالی در فایل نادیده گرفته می‌شوند، همچنین کامنت‌های تمام‌خطی که با '\fB;\fP' یا '\fB#\fP' شروع می‌شوند نادیده گرفته می‌شوند (قواعد نام فایلی که شامل این کاراکترها هستند تحت تأثیر قرار نمی‌گیرند). .IP اگر خطی با "\fB\-\ \fP" (خط تیره، فاصله) یا "\fB+\ \fP" (مثبت، فاصله) آغاز شود، نوع قاعده به‌طور صریح به عنوان مستثنی‌سازی یا گنجاندن مشخص می‌شود (به ترتیب). هر قاعده‌ای بدون چنین پیشوندی به عنوان مستثنی‌سازی در نظر گرفته می‌شود. .IP اگر خطی فقط شامل "\fB!\fP" باشد، قواعد فیلتر فعلی پیش از افزودن هر قاعده دیگر پاک‌سازی می‌شوند. .IP اگر \fIFILE\fP برابر با '\fB\-\fP' باشد، فهرست از ورودی استاندارد خوانده خواهد شد. .IP "\fB\-\-include=PATTERN\fP" این گزینه شکل ساده‌شده‌ای از گزینه \fB\-\-filter\fP است که یک قاعده گنجاندن (include) را مشخص می‌کند و اجازه استفاده از ساختار نحوی کامل تجزیه قواعد فیلتر عادی را نمی‌دهد. این معادل با مشخص کردن \fB\-f'+\ PATTERN'\fP است. .IP برای اطلاعات دقیق درباره این گزینه بخش «قواعد فیلتر (FILTER RULES)» را ببینید. .IP "\fB\-\-include\-from=FILE\fP" این گزینه به گزینه \fB\-\-include\fP مربوط است، اما یک FILE حاوی الگوهای گنجاندن (یک الگو در هر خط) را مشخص می‌کند. خطوط خالی در فایل نادیده گرفته می‌شوند، همچنین کامنت‌های تمام‌خطی که با '\fB;\fP' یا '\fB#\fP' شروع می‌شوند نادیده گرفته می‌شوند (قواعد نام فایلی که شامل این کاراکترها هستند تحت تأثیر قرار نمی‌گیرند). .IP اگر خطی با "\fB\-\ \fP" (خط تیره، فاصله) یا "\fB+\ \fP" (مثبت، فاصله) آغاز شود، نوع قاعده به‌طور صریح به عنوان مستثنی‌سازی یا گنجاندن مشخص می‌شود (به ترتیب). هر قاعده‌ای بدون چنین پیشوندی به عنوان گنجاندن در نظر گرفته می‌شود. .IP اگر خطی فقط شامل "\fB!\fP" باشد، قواعد فیلتر فعلی پیش از افزودن هر قاعده دیگر پاک‌سازی می‌شوند. .IP اگر \fIFILE\fP برابر با '\fB\-\fP' باشد، فهرست از ورودی استاندارد خوانده خواهد شد. .IP "\fB\-\-files\-from=FILE\fP" استفاده از این گزینه به rsync می‌گوید فهرست دقیق فایل‌ها برای انتقال را از FILE (یا در صورتی که FILE برابر با '\fB\-\fP' باشد، از ورودی استاندارد) بخواند. همچنین رفتار پیش‌فرض rsync را تغییر می‌دهد تا انتقال صرفاً فایل‌ها و دایرکتوری‌های مشخص‌شده آسان‌تر شود: .IP .RS .IP o گزینهٔ \fB\-\-relative\fP (\fB\-R\fP) به‌طور ضمنی فعال است، که اطلاعات مسیر مشخص‌شده برای هر مورد در پرونده را حفظ می‌کند (در صورت تمایل به غیرفعال‌کردن آن از \fB\-\-no\-relative\fP یا \fB\-\-no\-R\fP استفاده کنید). .IP o گزینهٔ \fB\-\-dirs\fP (\fB\-d\fP) به‌طور ضمنی فعال است، که دایرکتوری‌های مشخص‌شده در فهرست را در مقصد ایجاد می‌کند، به جای آنکه با ایجاد سر و صدا از آن‌ها صرف‌نظر کند (در صورت تمایل به غیرفعال‌کردن آن از \fB\-\-no\-dirs\fP یا \fB\-\-no\-d\fP استفاده کنید). .IP o رفتار گزینهٔ \fB\-\-archive\fP (\fB\-a\fP) شامل گزینهٔ \fB\-\-recursive\fP (\fB\-r\fP) نمی‌شود، بنابراین در صورت نیاز، آن را صراحتاً مشخص کنید. .IP o این اثرات جانبی، حالت پیش‌فرض rsync را تغییر می‌دهند، بنابراین موقعیت گزینهٔ \fB\-\-files\-from\fP در خط فرمان تأثیری بر نحوهٔ پردازش سایر گزینه‌ها ندارد (به عنوان مثال \fB\-a\fP قبل یا بعد از \fB\-\-files\-from\fP یکسان عمل می‌کند، همان‌طور که \fB\-\-no\-R\fP و سایر گزینه‌ها عمل می‌کنند). .RE .IP نام‌های پرونده‌ای که از FILE خوانده می‌شوند همگی نسبت به دایرکتوری مبدأ نسبی هستند: هرگونه اسلش ابتدایی حذف می‌شود، و مؤلفه‌های ".." برطرف می‌شوند تا یک مدخل نتواند به بالاتر از دایرکتوری مبدأ برود\ \-\- به عنوان مثال "../foo" به عنوان "foo" در داخل دایرکتوری مبدأ در نظر گرفته می‌شود. مدخلی که پس از این برطرف‌سازی همچنان حاوی یک ".." فعال باشد (موردی که قابل خلاصه‌سازی نباشد) با خطا رد می‌شود. مدخل‌های خالی و همچنین یادداشت‌های کل مدخل که با '\fB;\fP' یا '\fB#\fP' آغاز می‌شوند، نادیده گرفته می‌شوند. برای مثال، این دستور را در نظر بگیرید: .RS 4 .IP .nf rsync -a --files-from=/tmp/foo /usr remote:/backup .fi .RE .IP اگر پروندهٔ /tmp/foo حاوی رشتهٔ "bin" (یا حتی "/bin") باشد، دایرکتوری /usr/bin به صورت /backup/bin در میزبان راه‌دور ایجاد خواهد شد. اگر حاوی "bin/" باشد (به اسلش انتهایی توجه کنید)، محتویات بی‌واسطهٔ دایرکتوری نیز بدون نیاز به ذکر صریح در پرونده ارسال خواهد شد. در هر دو حالت، اگر گزینهٔ \fB\-r\fP فعال باشد، کل ساختار سلسله‌مراتبی آن دایرکتوری نیز منتقل می‌شود (به یاد داشته باشید که \fB\-r\fP باید صراحتاً همراه با \fB\-\-files\-from\fP مشخص شود، زیرا به‌طور ضمنی از \fB\-a\fP ناشی نمی‌شود). همچنین توجه داشته باشید که اثر گزینهٔ \fB\-r\fP (که به‌طور پیش‌فرض فعال است) تنها بازتولید اطلاعات مسیری است که از پرونده خوانده شده است\ \-\- این گزینه تکثیر مسیر مشخص‌شده در مبدأ (/usr در این مورد) را تحمیل نمی‌کند. .IP علاوه بر این، در صورتی که عبارت ":host" را در جلوی نام پرونده مشخص کنید، پروندهٔ \fB\-\-files\-from\fP می‌تواند به جای میزبان محلی از میزبان راه‌دور خوانده شود (میزبان باید با یکی از دو طرف انتقال مطابقت داشته باشد). به عنوان یک میانبر، می‌توانید فقط از پیشوند ":" استفاده کنید که به معنای «استفاده از طرف راه‌دور انتقال» است. برای مثال: .RS 4 .IP .nf rsync -a --files-from=:/path/file-list src:/ /tmp/copy .fi .RE .IP این دستور تمامی پرونده‌های مشخص‌شده در پروندهٔ /path/file-list را که در میزبان راه‌دور "src" قرار داشت رونوشت می‌کند. .IP اگر گزینه‌های \fB\-\-iconv\fP و \fB\-\-secluded\-args\fP مشخص شده باشند و نام‌های پروندهٔ \fB\-\-files\-from\fP از یک میزبان به میزبان دیگر ارسال شوند، نام پرونده‌ها از مجموعه‌نویسهٔ (charset) میزبان فرستنده به مجموعه‌نویسهٔ میزبان گیرنده ترجمه خواهند شد. .IP نکته: مرتب‌سازی فهرست پرونده‌ها در ورودی \fB\-\-files\-from\fP به rsync کمک می‌کند تا کارآمدتر عمل کند، زیرا از پیمایش مجدد اجزای مسیری که بین مدخل‌های مجاور مشترک هستند جلوگیری می‌کند. اگر ورودی مرتب نشده باشد، ممکن است برخی از اجزای مسیر (دایرکتوری‌های ضمنی) چندین بار پویش شوند، و rsync در نهایت پس از تبدیل آن‌ها به عناصر فهرست پرونده، موارد تکراری را حذف خواهد کرد. .IP "\fB\-\-from0\fP, \fB\-0\fP" این گزینه به rsync اعلام می‌کند که قواعد یا نام‌های فایلی که از یک فایل می‌خواند با نویسه تهی (\(aq\e0\(aq) خاتمه می‌یابند، نه با NL، CR یا CR+LF. این مورد بر \fB\-\-exclude\-from\fP، \fB\-\-include\-from\fP، \fB\-\-files\-from\fP و هر فایل ادغام‌شده مشخص‌شده در قاعده \fB\-\-filter\fP تأثیر می‌گذارد. بر \fB\-\-cvs\-exclude\fP تأثیری ندارد (زیرا تمام نام‌های خوانده‌شده از فایل .cvsignore با فضای خالی تفکیک می‌شوند). .IP "\fB\-\-old\-args\fP" این گزینه به rsync می‌گوید از مقادیر آرگومان‌های ارسالی به سمت راه‌دور در برابر تفکیک ناخواسته کلمات یا سایر تفاسیر نادرست محافظت نکند. همچنین به کلاینت اجازه می‌دهد به جای ایجاد خطا، با یک آرگومان خالی مانند یک \(dq.\(dq رفتار کند. .IP پیش‌فرض در rsync امروزی این است که نویسه‌های «فعال در شل» (شامل فاصله‌ها) در آرگومان‌های ارسالی به شل راه‌دور با بک‌اسلش گریزدهی (escape) شوند. نویسه‌های عامه‌پسند (wildcard) شامل \fB*\fP، \fB?\fP، \fB[\fP و \fB]\fP در آرگومان‌های نام فایل گریزدهی نمی‌شوند (امکان بسط آن‌ها به چندین نام فایل فراهم می‌ماند)، در حالی که در آرگومان‌های گزینه‌ها مانند \fB\-\-usermap\fP محافظت می‌شوند. .IP اگر اسکریپتی دارید که نیازمند تفکیک آرگومان به سبک قدیمی در نام‌های فایل است، این گزینه را یک بار مشخص کنید. اگر شل راه‌دور با هر نوع گریزدهی بک‌اسلش مشکل دارد، این گزینه را دو بار مشخص کنید. .IP امکان کنترل این تنظیم از طریق متغیر محیطی \fBRSYNC_OLD_ARGS\fP نیز وجود دارد. با مقدار \(dq1\(dq، rsync به صورت پیش‌فرض روی تنظیم تک‌گزینه‌ای قرار می‌گیرد. با مقدار \(dq2\(dq (یا بیشتر)، پیش‌فرض روی تنظیم گزینه تکرارشده قرار می‌گیرد. با مقدار \(dq0\(dq، رفتار پیش‌فرض گریزدهی اعمال می‌شود. متغیر محیطی همواره توسط گزینه‌های مثبت یا منفیِ دستی بازنویسی می‌شود (گزینه منفی \fB\-\-no\-old\-args\fP است). .IP توجه داشته باشید این گزینه بررسی امنیتی اضافی را نیز غیرفعال می‌کند؛ بررسی‌ای که مانع از گنجاندن موارد سطح‌بالای ناخواسته در فهرست فایل‌ها توسط فرستنده راه‌دور می‌شود. این اثر جانبی لازم است زیرا هنگام تفسیر آرگومان‌ها توسط شل راه‌دور، پیش‌بینی دقیق نام‌ها ممکن نیست. .IP این گزینه با گزینه \fB\-\-secluded\-args\fP تداخل دارد. .IP "\fB\-\-secluded\-args\fP, \fB\-s\fP" این گزینه تمام نام‌های فایل و اکثر گزینه‌ها را به جای خط فرمانِ شل راه‌دور، از طریق پروتکل به rsync راه‌دور ارسال می‌کند؛ این امر احتمال تغییر آن‌ها توسط شل راه‌دور را از بین می‌برد. نویسه‌های عامه‌پسند به جای شل، توسط rsync در میزبان راه‌دور بسط داده می‌شوند. .IP بدون این گزینه، rsync برای جلوگیری از مسائلی چون تفکیک فاصله و عوارض ناخواسته نویسه‌های خاص، آرگومان‌ها را با بک‌اسلش گریزدهی می‌کند که معمولاً برای جلوگیری از تغییرات شل کافی است. این گزینه زمانی کاربرد دارد که تبدیل مجموعه نویسه‌های آرگومان برای میزبان راه‌دور لازم باشد، شل راه‌دور با روش پیش‌فرض گریزدهی سازگار نباشد، یا نیاز به دور زدن خط فرمان شل راه‌دور برای اکثر گزینه‌ها و آرگومان‌ها وجود داشته باشد. .IP این گزینه با نسخه‌های rsync راه‌دور قبل از 3.0.0 (مارس ۲۰۰۸) ناسازگار است. همچنین عیب رد شدن توسط شل‌های محدودشده (restricted shells) را دارد که مقادیر تمام گزینه‌ها را جهت امنیت بررسی می‌کنند. .IP در صورت ترکیب این گزینه با \fB\-\-iconv\fP، آرگومان‌های مربوط به سمت راه‌دور از مجموعه نویسه‌های محلی به راه‌دور ترجمه می‌شوند. این ترجمه قبل از بسط نویسه‌های عامه‌پسند رخ می‌دهد. گزینه \fB\-\-files\-from\fP را نیز ببینید. .IP کنترل این تنظیم از طریق متغیر محیطی \fBRSYNC_PROTECT_ARGS\fP نیز ممکن است. با مقدار غیرصفر، به طور پیش‌فرض فعال و در غیر این صورت غیرفعال خواهد بود. هر دو وضعیت با مشخص کردن دستی نسخه مثبت یا منفی این گزینه بازنویسی می‌شوند (نسخه‌های منفی \fB\-\-no\-s\fP و \fB\-\-no\-secluded\-args\fP هستند). متغیر محیطی غیرصفرِ \fBRSYNC_OLD_ARGS\fP نیز بر این متغیر محیطی تقدم دارد. .IP این گزینه با گزینه \fB\-\-old\-args\fP تداخل دارد. .IP این گزینه قبلاً \fB\-\-protect\-args\fP نامیده می‌شد (قبل از ۳.۲.۶، سپتامبر ۲۰۲۲) و آن نام قدیمی‌تر همچنان می‌تواند استفاده شود (اگرچه مشخص کردن آن به صورت \fB\-s\fP همیشه ساده‌ترین و سازگارترین انتخاب است). .IP "\fB\-\-trust\-sender\fP" این گزینه دو بررسی اعتبارسنجی اضافی را که یک کلاینت محلی روی فهرست فایل ایجاد شده توسط فرستنده راه‌دور انجام می‌دهد، غیرفعال می‌کند. این گزینه تنها زمانی باید استفاده شود که به فرستنده اعتماد داشته باشید که مورد مخربی در فهرست فایل قرار نمی‌دهد (چیزی که احتمالاً می‌تواند از طریق یک rsync دستکاری‌شده، یک شل دستکاری‌شده، یا برخی دستکاری‌های مشابه دیگر انجام شود). .IP به‌طور معمول، کلاینت rsync هنگام دریافت فایل‌ها از یک rsync راه‌دور، دو بررسی اعتبارسنجی اضافی را انجام می‌دهد: .IP .RS .IP o بررسی می‌کند که موارد آرگومان اضافی در ابتدای انتقال اضافه نشده باشند. .IP o بررسی می‌کند که هیچ‌کدام از موارد موجود در فهرست فایل، نام‌هایی نباشند که باید مستثنی می‌شدند (اگر قواعد فیلتر مشخص شده باشند). .RE .IP توجه داشته باشید که اگر گزینه‌ای با اعتبارسنجی تداخل داشته باشد، گزینه‌های مختلف می‌توانند یک یا هر دوی این بررسی‌ها را غیرفعال کنند. برای مثال: .IP .RS .IP o استفاده از یک فایل فیلتر به ازای هر دایرکتوری (per-directory)، قواعد فیلتری را می‌خواند که فقط سرور از آن‌ها مطلع است، بنابراین بررسی فیلتر غیرفعال می‌شود. .IP o استفاده از گزینه \fB\-\-old\-args\fP به فرستنده اجازه می‌دهد آرگومان‌های درخواست‌شده را دستکاری کند، بنابراین بررسی آرگومان غیرفعال می‌شود. .IP o خواندن فهرست files-from از سمت سرور بدین معنی است که کلاینت فهرست آرگومان‌ها را نمی‌داند، بنابراین بررسی آرگومان غیرفعال می‌شود. .IP o استفاده از \fB\-\-read\-batch\fP هر دو بررسی را غیرفعال می‌کند زیرا محتویات فایل دسته‌ای هنگام ایجاد آن تأیید شده است. .RE .IP اگر تطبیق الگوی اضافی سرعت کار را در یک انتقال بسیار بزرگ کاهش می‌دهد، این گزینه ممکن است به یک کلاینت یا سرور کم‌توان کمک کند. همچنین می‌تواند برای انتقال از یک فرستنده قابل اعتماد به عنوان یک راهکار موقت در صورت وجود باگ در منطق اعتبارسنجی استفاده شود. .IP هنگام استفاده از این گزینه، ایده خوبی است که یک دایرکتوری مقصد اختصاصی تعیین کنید، همان‌طور که در بخش SECURITY مورد بحث قرار گرفته است. .IP "\fB\-\-copy\-as=USER[:GROUP]\fP" این گزینه به rsync دستور می‌دهد که از USER و (در صورت تعیین پس از دو نقطه) از GROUP برای عملیات کپی استفاده کند. این تنها در صورتی کار می‌کند که کاربری که rsync را اجرا می‌کند، توانایی تغییر کاربر را داشته باشد. اگر گروه مشخص نشده باشد، از گروه‌های پیش‌فرض کاربر استفاده می‌شود. .IP این گزینه می‌تواند به کاهش خطر در مواردی کمک کند که rsync به عنوان root اجرا می‌شود، و در حال کپی به داخل یا خارج از دایرکتوری‌ای است که ممکن است تغییرات زنده‌ای در آن رخ دهد، و شما می‌خواهید مطمئن شوید که اقدامات خواندن یا نوشتن در سطح root روی فایل‌های سیستمی امکان‌پذیر نیست. در حالی که می‌توانید به جای آن، کل rsync را به عنوان کاربر تعیین‌شده اجرا کنید، گاهی اوقات نیاز است اعتبارنامه‌های دسترسی به میزبان در سطح root استفاده شود؛ بنابراین این ویژگی به rsync اجازه می‌دهد پس از برقراری ارتباط remote-shell یا دیمن، دسترسی root را برای بخش کپیِ عملیات رها کند. .IP این گزینه تنها روی یک طرف انتقال تأثیر می‌گذارد مگر اینکه انتقال محلی باشد، که در این صورت روی هر دو طرف اثر می‌گذارد. از \fB\-\-remote\-option\fP برای تأثیرگذاری روی طرف راه‌دور استفاده کنید، مانند \fB\-M\-\-copy\-as=joe\fP. برای یک انتقال محلی، فایل پشتیبانی lsh (یا lsh.sh) یک اسکریپت کمکی شل محلی ارائه می‌دهد که می‌تواند برای تعیین مشخصه میزبان \(dqlocalhost:\(dq یا \(dqlh:\(dq بدون نیاز به راه‌اندازی هیچ شل راه‌دوری استفاده شود، که به شما امکان می‌دهد گزینه‌های راه‌دوری را تعیین کنید که بر طرفی از انتقال که از مشخصه میزبان استفاده می‌کند اثر بگذارد (و استفاده از نام میزبان \(dqlh\(dq از بازنویسی دایرکتوری راه‌دور به دایرکتوری خانگی کاربر جلوگیری می‌کند). .IP برای مثال، دستور rsync زیر فایل‌های محلی را با عنوان کاربر "joe" می‌نویسد: .RS 4 .IP .nf sudo rsync -aiv --copy-as=joe host1:backups/joe/ /home/joe/ .fi .RE .IP این کار باعث می‌شود مالکیت تمام فایل‌ها برای کاربر "joe" تنظیم شود، گروه‌ها به گروه‌های دردسترس آن کاربر محدود شوند، و سوءاستفاده زمانی (timed exploit) از مسیر برای اعمال تغییر روی فایلی که کاربر joe اجازه تغییر آن را ندارد، غیرممکن شود. .IP دستور زیر یک رونوشت محلی را با عنوان کاربر "joe" در دایرکتوری "dest/" انجام می‌دهد (با این فرض که support/lsh را در دایرکتوری درون $PATH خود نصب کرده باشید): .RS 4 .IP .nf sudo rsync -aive lsh -M--copy-as=joe src/ lh:dest/ .fi .RE .IP "\fB\-\-temp\-dir=DIR\fP, \fB\-T\fP" این گزینه به rsync دستور می‌دهد تا هنگام ساخت رونوشت‌های موقت از فایل‌های منتقل‌شده در سمت گیرنده، از DIR به عنوان دایرکتوری موقت کاری (scratch) استفاده کند. رفتار پیش‌فرض، ساخت هر فایل موقت در همان دایرکتوری فایل مقصد مربوطه است. نام فایل‌های موقت درون DIR مشخص‌شده دارای پیشوند نقطه اضافی نخواهد بود، هرچند همچنان یک پسوند تصادفی به آن‌ها اضافه می‌شود. .IP این گزینه بیشتر زمانی استفاده می‌شود که پارتیشن دیسک گیرنده فضای خالی کافی برای نگهداری رونوشتی از بزرگ‌ترین فایل در حال انتقال را نداشته باشد. در این حالت (یعنی زمانی که دایرکتوری موقت روی پارتیشن دیسک دیگری قرار دارد)، rsync قادر نخواهد بود هر فایل موقت دریافت شده را مستقیماً بر روی فایل مقصد مربوطه تغییر نام دهد، بلکه در عوض باید آن را در محل مقصد رونوشت کند. rsync این کار را با بازنویسی فایل روی فایل مقصد انجام می‌دهد؛ به این معنی که فایل مقصد در طول این رونوشت شامل داده‌های ناقص و بریده‌شده خواهد بود. اگر این کار بدین شکل انجام نمی‌شد، ممکن بود فایل قدیمی همچنان فضای دیسک را اشغال کند (اگر برنامه‌ای آن را باز نگه داشته باشد)، و در نتیجه فضای کافی برای قرارگیری نسخه جدید روی دیسک به صورت هم‌زمان وجود نداشته باشد. .IP اگر از این گزینه به دلایلی غیر از کمبود فضای دیسک استفاده می‌کنید، ممکن است بخواهید آن را با گزینه \fB\-\-delay\-updates\fP ترکیب کنید؛ این کار تضمین می‌کند که تمام فایل‌های رونوشت‌شده در زیردایرکتوری‌هایی در سلسله‌مراتب مقصد قرار بگیرند و منتظر پایان انتقال بمانند. اگر فضای کافی برای تکثیر تمام فایل‌های ورودی در پارتیشن مقصد ندارید، راه دیگر برای اعلام این موضوع به rsync که بیش از حد نگران فضای دیسک نیستید، استفاده از گزینه \fB\-\-partial\-dir\fP با یک مسیر نسبی است؛ زیرا این به rsync می‌گوید ذخیره موقت یک رونوشت از یک تک‌فایل در یک زیردایرکتوری درون سلسله‌مراتب مقصد مجاز است، و rsync از partial-dir به عنوان یک محیط آماده‌سازی برای آوردن فایل رونوشت‌شده استفاده کرده و سپس آن را از آنجا به محل اصلی تغییر نام می‌دهد. (مشخص کردن \fB\-\-partial\-dir\fP با یک مسیر مطلق این اثر جانبی را ندارد.) .IP "\fB\-\-fuzzy\fP, \fB\-y\fP" این گزینه به rsync می‌گوید که باید به دنبال یک فایل پایه برای هر فایل مقصدی که وجود ندارد بگردد. با این گزینه، rsync در همان دایرکتوریِ فایل مقصد، به دنبال فایلی با اندازه و زمان تغییر یکسان، یا فایلی با نام مشابه می‌گردد. در صورت پیدا شدن، rsync از فایل پایه فازی برای افزایش سرعت انتقال استفاده می‌کند. .IP اگر این گزینه تکرار شود، پایش فازی در دایرکتوری‌های مقصد جایگزین منطبقی که از طریق \fB\-\-compare\-dest\fP، \fB\-\-copy\-dest\fP، یا \fB\-\-link\-dest\fP مشخص شده‌اند نیز انجام خواهد شد. .IP توجه داشته باشید که استفاده از گزینه \fB\-\-delete\fP ممکن است فایل‌های منطبق فازی بالقوه را حذف کند؛ بنابراین اگر نیاز به جلوگیری از این موضوع دارید، از \fB\-\-delete\-after\fP استفاده کنید یا برخی استثنائات نام فایل را مشخص نمایید. .IP "\fB\-\-compare\-dest=DIR\fP" این گزینه به rsync دستور می‌دهد تا از \fIDIR\fP روی ماشین مقصد به عنوان یک سلسله‌مراتب اضافی برای مقایسه فایل‌های مقصد هنگام انجام انتقال‌ها استفاده کند (در صورتی که فایل‌ها در دایرکتوری مقصد موجود نباشند). اگر فایلی در \fIDIR\fP یافت شود که با فایل فرستنده یکسان باشد، آن فایل به دایرکتوری مقصد منتقل نخواهد شد. این ویژگی برای ایجاد یک پشتیبان پراکنده (sparse backup) تنها از فایل‌هایی که نسبت به پشتیبان قبلی تغییر کرده‌اند کاربرد دارد. این گزینه معمولاً برای رونوشت در یک دایرکتوری خالی (یا تازه ساخته‌شده) استفاده می‌شود. .IP می‌توان چندین دایرکتوری \fB\-\-compare\-dest\fP مشخص کرد، که باعث می‌شود rsync فهرست را به ترتیب تعیین‌شده برای یافتن یک تطابق دقیق جستجو کند. اگر تطابقی یافت شود که تنها در مشخصه‌ها تفاوت دارد، یک رونوشت محلی ایجاد شده و مشخصه‌ها به‌روزرسانی می‌شوند. اگر تطابقی پیدا نشود، یک پرونده مبنا از یکی از \fIDIRs\fP انتخاب خواهد شد تا سرعت انتقال را بهبود بخشد. .IP اگر \fIDIR\fP یک مسیر نسبی باشد، نسبت به دایرکتوری مقصد سنجیده می‌شود. همچنین \fB\-\-copy\-dest\fP و \fB\-\-link\-dest\fP را ببینید. .IP نکته: در صورتی که تطابق دقیقی در یکی از سلسله‌مراتب‌های compare-dest یافت شود، rsync پرونده را از یک ساختار مقصد غیرخالی حذف می‌کند تا نتیجه نهایی بیشتر شبیه به یک رونوشت تازه باشد. .IP "\fB\-\-copy\-dest=DIR\fP" این گزینه رفتاری مانند \fB\-\-compare\-dest\fP دارد، اما rsync پرونده‌های بدون تغییرِ یافت‌شده در \fIDIR\fP را نیز با استفاده از یک رونوشت محلی به دایرکتوری مقصد کپی می‌کند. این قابلیت برای انتقال به یک مقصد جدید بدون دست‌زدن به پرونده‌های موجود، و سپس تغییر مسیر آنی (flash-cutover) پس از انتقال موفقیت‌آمیز تمام پرونده‌ها، کاربردی است. .IP می‌توان چندین دایرکتوری \fB\-\-copy\-dest\fP مشخص کرد، که باعث می‌شود rsync فهرست را به ترتیب تعیین‌شده برای یافتن یک پرونده بدون تغییر جستجو کند. اگر تطابقی یافت نشود، یک پرونده مبنا از یکی از \fIDIRs\fP انتخاب خواهد شد تا به افزایش سرعت انتقال کمک کند. .IP اگر \fIDIR\fP یک مسیر نسبی باشد، نسبت به دایرکتوری مقصد سنجیده می‌شود. همچنین \fB\-\-compare\-dest\fP و \fB\-\-link\-dest\fP را ببینید. .IP "\fB\-\-link\-dest=DIR\fP" این گزینه مشابه \fB\-\-copy\-dest\fP عمل می‌کند، با این تفاوت که پرونده‌های بدون تغییر از \fIDIR\fP به دایرکتوری مقصد پیوند سخت (hard link) می‌شوند. پرونده‌ها باید در تمام مشخصه‌های حفظ‌شده (مانند مجوزهای دسترسی و در صورت امکان مالکیت) یکسان باشند تا بتوانند به یکدیگر پیوند داده شوند. یک مثال: .RS 4 .IP .nf rsync -av --link-dest=$PWD/prior_dir host:src_dir/ new_dir/ .fi .RE .IP اگر پرونده‌ها پیوند نمی‌خورند، مشخصه‌های آن‌ها را دوباره بررسی کنید. همچنین بررسی کنید که آیا برخی مشخصه‌ها خارج از کنترل rsync تحمیل می‌شوند یا خیر؛ مانند گزینه سوار کردنی (mount option) که کاربر root را به یک کاربر منفرد محدود می‌کند (squish)، یا یک درایو جداشدنی را با مالکیت عمومی سوار می‌کند (مانند گزینه \(dqIgnore ownership on this volume\(dq در OS X). .IP می‌توان چندین دایرکتوری \fB\-\-link\-dest\fP تعیین کرد، که موجب می‌شود rsync فهرست را به ترتیب تعیین‌شده برای یافتن تطابق دقیق جستجو کند (محدودیت ۲۰ دایرکتوری برای این حالت وجود دارد). اگر تطابقی یافت شود که تنها در مشخصه‌ها تفاوت دارد، یک رونوشت محلی ایجاد شده و مشخصه‌ها به‌روزرسانی می‌شوند. در صورت عدم یافتن تطابق، یک پرونده مبنا از یکی از \fIDIRs\fP انتخاب خواهد شد تا به افزایش سرعت انتقال کمک کند. .IP هر سیستم‌پرونده‌ای قادر به ایجاد پیوند سخت برای یک پیوند نمادین (symlink)، گره دستگاه (device node)، لوله FIFO یا سوکت نیست، و سیستم‌پرونده مقصد لزوماً نباید مشابه سامانه‌ای باشد که rsync روی آن ساخته شده است\ \-\- ساخت‌های macOS روی APFS هستند که این امکان را دارد، اما ممکن است روی HFS+ بنویسند که از آن پشتیبانی نمی‌کند. در صورتی که مقصد از پیوند زدن چنین ورودی‌ای امتناع کند، به جای آن کپی می‌شود و انتقال ادامه می‌یابد؛ بنابراین تنها همان ورودی مزیت صرفه‌جویی در فضا را از دست می‌دهد. این قاعده برای هر نوع خطای امتناع اعمال می‌شود، زیرا خطا به تنهایی علت را مشخص نمی‌کند: فراخوان link(2) خطای \fBEPERM\fP را هم برای سیستم‌پرونده فاقد قابلیت پیوند سخت و هم برای رد مجوز عادی گزارش می‌دهد. پرونده‌های معمولی همیشه به همین شکل رفتار کرده‌اند. .IP یک حالت پوشش داده نشده است. با گزینه \fB\-\-hard\-links\fP (\fB\-H\fP)، گروهی از چنین ورودی‌هایی که در مبدأ به \fIیکدیگر\fP پیوند سخت دارند، نیازمند یک پیوند دوم، از عضو اول به سایرین، در داخل خود مقصد هستند. در جایی که این پیوند نیز رد شود\ \-\- مقصدی که به‌طور کلی قادر به پیوند سخت آن نوع داده نیست\ \-\- اعضای بعدی ساخته نمی‌شوند و انتقال با شکست مواجه می‌شود. استفاده از \fB\-\-link\-dest\fP روی یک سیستم‌پرونده دیگر مشکلی ندارد: در آن حالت فقط پیوند به \fIDIR\fP غیرممکن است، و پیوندهای درون ساختار مقصد همچنان با موفقیت ایجاد می‌شوند. .IP این گزینه هنگام رونوشت به یک ساختار سلسله‌مراتبی مقصدِ خالی بهترین بازدهی را دارد، زیرا ممکن است مشخصه‌های پرونده‌های موجود تغییر یابد و این امر می‌تواند از طریق پیوندهای سخت روی پرونده‌های مقصدِ جایگزین اثر بگذارد. همچنین، گزارش جزئیات تغییرات (itemizing) ممکن است کمی مبهم شود. توجه داشته باشید که تا پیش از نسخه 3.1.0 (سپتامبر ۲۰۱۳)، در صورتی که پرونده مقصد از قبل وجود داشت، تطابق دقیق دایرکتوری جایگزین هرگز پیدا نمی‌شد (و به مقصد پیوند داده نمی‌شد). .IP توجه داشته باشید که اگر این گزینه را با \fB\-\-ignore\-times\fP ترکیب کنید، rsync هیچ فایلی را به یکدیگر پیوند نخواهد داد زیرا فقط فایل‌های یکسان را به عنوان جایگزینی برای انتقال فایل پیوند می‌دهد، نه به عنوان یک بررسی اضافی پس از به‌روزرسانی فایل. .IP اگر \fIDIR\fP یک مسیر نسبی باشد، نسبت به دایرکتوری مقصد سنجیده می‌شود. همچنین گزینه‌های \fB\-\-compare\-dest\fP و \fB\-\-copy\-dest\fP را ببینید. .IP توجه داشته باشید نسخه‌های rsync قبل از 2.6.1 (آوریل ۲۰۰۴) باگی داشتند که در صورت تعیین (یا ضمنی بودن) \fB\-\-owner\fP (\fB\-o\fP)، می‌توانست مانع از کارکرد درست \fB\-\-link\-dest\fP برای کاربر غیر ریشه شود. می‌توانید با اجتناب از گزینه \fB\-o\fP (یا استفاده از \fB\-\-no\-o\fP) هنگام ارسال به یک rsync راه‌دور بسیار قدیمی، این باگ را دور بزنید. .IP "\fB\-\-compress\fP, \fB\-z\fP" با این گزینه، rsync داده‌های فایل را هنگام ارسال به ماشین مقصد فشرده می‌کند که مقدار داده‌های در حال انتقال را کاهش می‌دهد\ \-\- قابلیتی که روی اتصال‌های کند مفید است. .IP برنامه rsync از چندین روش فشرده‌سازی پشتیبانی می‌کند و یکی را برای شما انتخاب خواهد کرد، مگر اینکه با استفاده از گزینه \fB\-\-compress\-choice\fP (\fB\-\-zc\fP) انتخاب را اجبار کنید. .IP دستور \fBrsync\ \-\-version\fP را اجرا کنید تا فهرست پیش‌فرض فشرده‌سازی کامپایل‌شده در نسخه خود را ببینید. .IP هنگامی که هر دو طرف انتقال حداقل نسخه 3.2.0 (ژوئن ۲۰۲۰) باشند، هر طرف الگوریتم با بالاترین اولویت خود را که در فهرست طرف مقابل نیز وجود دارد انتخاب می‌کند. هر دو طرف فهرست‌های خود را با اولویت قوی‌ترین مرتب می‌کنند، بنابراین بر سر قوی‌ترین انتخاب مشترک توافق می‌کنند. اگر هیچ روش فشرده‌سازی مشترکی یافت نشود، rsync با یک خطا خارج می‌شود. اگر rsync راه‌دور بیش از حد قدیمی باشد و نتواند از مذاکره چکسام پشتیبانی کند، فهرست آن "zlib" فرض می‌شود. .IP ترتیب پیش‌فرض را می‌توان با تنظیم متغیر محیطی \fBRSYNC_COMPRESS_LIST\fP روی فهرستی از نام‌های فشرده‌سازی مجاز که با فاصله جدا شده‌اند، سفارشی‌سازی کرد. اگر رشته حاوی نویسه "\fB&\fP" باشد، به صورت "client string & server string" تفکیک می‌شود، در غیر این صورت همان رشته برای هر دو طرف اعمال می‌شود. اگر رشته (یا بخشی از رشته) فاقد نویسه‌های غیرفاصله‌ای باشد، فهرست فشرده‌سازی پیش‌فرض استفاده می‌شود. هر نام فشرده‌سازی ناشناخته از فهرست حذف می‌شود، اما فهرستی که تنها شامل نام‌های نامعتبر باشد منجر به شکست مذاکره خواهد شد. .IP برخی از نسخه‌های قدیمی‌تر rsync وجود دارند که برای رد کردن گزینه \fB\-z\fP و الزام به استفاده از \fB\-zz\fP پیکربندی شده بودند، زیرا کتابخانه فشرده‌سازی آن‌ها با روش فشرده‌سازی پیش‌فرض zlib سازگار نبود. معمولاً می‌توانید این رفتار غیرعادی را نادیده بگیرید، مگر اینکه سرور rsync خطا دهد و از شما بخواهد \fB\-zz\fP را مشخص کنید. .IP "\fB\-\-compress\-choice=STR\fP, \fB\-\-zc=STR\fP" این گزینه می‌تواند برای بازنویسی مذاکره خودکار الگوریتم فشرده‌سازی که هنگام استفاده از \fB\-\-compress\fP رخ می‌دهد، استفاده شود. این گزینه به معنی فعال بودن \fB\-\-compress\fP است، مگر اینکه "none" مشخص شده باشد که در این صورت به معنی \fB\-\-no\-compress\fP خواهد بود. .IP گزینه‌های فشرده‌سازی که ممکن است قادر به استفاده از آن‌ها باشید عبارتند از: .IP .RS .IP o \fBzstd\fP .IP o \fBlz4\fP .IP o \fBzlibx\fP .IP o \fBzlib\fP .IP o \fBnone\fP .RE .IP دستور \fBrsync\ \-\-version\fP را اجرا کنید تا فهرست پیش‌فرض فشرده‌سازی کامپایل‌شده در نسخه خود را ببینید (که ممکن است با فهرست بالا تفاوت داشته باشد). .IP توجه داشته باشید اگر خطایی درباره گزینه‌ای به نام \fB\-\-old\-compress\fP یا \fB\-\-new\-compress\fP مشاهده کردید، این تلاش rsync برای ارسال گزینه \fB\-\-compress\-choice=zlib\fP یا \fB\-\-compress\-choice=zlibx\fP به شیوه‌ای سازگار با گذشته است که نسخه‌های بیشتری از rsync آن را درک می‌کنند. این خطا نشان می‌دهد که نسخه قدیمی‌تر rsync روی سرور به شما اجازه تحمیل نوع فشرده‌سازی را نمی‌دهد. .IP توجه داشته باشید که الگوریتم فشرده‌سازی «zlibx» صرفاً همان الگوریتم «zlib» است که داده‌های منطبق‌شده از جریان فشرده‌سازی آن مستثنی شده‌اند (جهت تلاش برای سازگاری بیشتر با یک پیاده‌سازی خارجی zlib). .IP "\fB\-\-compress\-level=NUM\fP, \fB\-\-zl=NUM\fP" صراحتاً سطح فشرده‌سازی مورد استفاده را به‌جای استفاده از پیش‌فرض تنظیم کنید (نگاه کنید به \fB\-\-compress\fP، \fB\-z\fP). تا زمانی که سطح انتخاب‌شده یک سطح «عدم فشرده‌سازی» برای الگوریتم فشرده‌سازی فعال نباشد، گزینه \fB\-\-compress\fP به‌طور ضمنی اعمال می‌شود (برای مثال، فشرده‌سازی zlib سطح 0 را به‌عنوان «خاموش» در نظر می‌گیرد). .IP مقادیر سطح بسته به چکسام فعال متفاوت است. از آنجا که rsync به‌طور پیش‌فرض بر سر انتخاب چکسام مذاکره می‌کند (زمانی که rsync سمت راه‌دور به اندازه کافی جدید باشد)، ترکیب این گزینه با یک گزینه \fB\-\-compress\-choice\fP (\fB\-\-zc\fP) می‌تواند مفید باشد مگر اینکه از انتخاب فعال مطمئن باشید. برای مثال: .RS 4 .IP .nf rsync -aiv --zc=zstd --zl=22 host:src/ dest/ .fi .RE .IP برای فشرده‌سازی zlib و zlibx مقادیر معتبر از 1 تا 9 هستند که 6 مقدار پیش‌فرض است. مشخص کردن \fB\-\-zl=0\fP فشرده‌سازی را خاموش می‌کند، و مشخص کردن \fB\-\-zl=\-1\fP سطح پیش‌فرض 6 را انتخاب می‌کند. .IP برای فشرده‌سازی zstd مقادیر معتبر از \-131072 تا 22 هستند که 3 مقدار پیش‌فرض است. مشخص کردن 0 مقدار پیش‌فرض 3 را انتخاب می‌کند. .IP برای فشرده‌سازی lz4 هیچ سطحی وجود ندارد، بنابراین مقدار همیشه 0 است. .IP اگر مقداری بیش از حد بزرگ یا بیش از حد کوچک مشخص کنید، عدد بدون هشدار به یک مقدار معتبر محدود می‌شود. این به شما امکان می‌دهد چیزی مانند \fB\-\-zl=999999999\fP را مشخص کنید و مطمئن باشید که صرف‌نظر از الگوریتم انتخاب‌شده، حداکثر سطح فشرده‌سازی را دریافت خواهید کرد. .IP اگر می‌خواهید از سطح فشرده‌سازی فعال مطلع شوید، \fB\-\-debug=nstr\fP را مشخص کنید تا نتایج «رشته مذاکره‌شده» را ببینید. این مورد خروجی‌ای شبیه به "\fBClient\ compress:\ zstd\ (level\ 3)\fP" را (به‌همراه انتخاب چکسام فعال) گزارش می‌دهد. .IP "\fB\-\-compress\-threads=NUM\fP, \fB\-\-zt=NUM\fP" تعداد ریسه‌های مورد نیاز برای ایجاد هنگام فشرده‌سازی داده‌ها را تنظیم کنید. تنظیم این گزینه روی 1 یا بیشتر به کتابخانه فشرده‌سازی دستور می‌دهد 1 یا چند ریسه برای فشرده‌سازی ایجاد کند. در حالت ایده‌آل، اگر انتقال در سمت فرستنده محدود به پردازنده باشد، افزایش تعداد ریسه‌ها سرعت انتقال را افزایش می‌دهد. .IP این گزینه تأثیری بر خارج کردن از حالت فشرده ندارد. .IP الگوریتم‌های فشرده‌سازی که امکان استفاده از ریسه‌ها را می‌دهند: .IP .RS .IP o \fBzstd\fP (فقط زمانی که libzstd با پشتیبانی از ریسه‌بندی کامپایل شده باشد) .RE .IP اگر یکی از الگوریتم‌های بالا به‌عنوان \fB\-\-compression\-choice\fP انتخاب نشده باشد یا فشرده‌سازی فعال نباشد، این گزینه نادیده گرفته می‌شود. .IP "\fB\-\-skip\-compress=LIST\fP" \fBنکته:\fP در حال حاضر هیچ روش فشرده‌سازی از تغییرات فشرده‌سازی به‌ازای هر فایل پشتیبانی نمی‌کند، بنابراین این گزینه هیچ تأثیری ندارد. .IP فهرست پسوندهای فایلی را که تا حد امکان کمتر فشرده می‌شوند، بازنویسی کنید. rsync می‌تواند سطح فشرده‌سازی را به‌صورت مجزا برای هر فایل و بر اساس پسوند فایل تنظیم کند. اگر الگوریتم فشرده‌سازی دارای سطح «خاموش» باشد، هیچ فشرده‌سازی برای آن فایل‌ها رخ نمی‌دهد. سایر الگوریتم‌هایی که از تغییر برخط سطح جریان پشتیبانی می‌کنند، سطح فشرده‌سازی را به حداقل می‌رسانند تا مصرف پردازنده برای یک فایل منطبق تا حد امکان کاهش یابد. .IP مقدار \fBLIST\fP باید یک یا چند پسوند پرونده (بدون نقطه) باشد که با اسلش (\fB/\fP) از هم جدا شده‌اند. می‌توانید یک رشته خالی مشخص کنید تا نشان دهید هیچ پرونده‌ای نباید نادیده گرفته شود. .IP تطبیق ساده رده‌های نویسه‌ای پشتیبانی می‌شود: هر کدام باید شامل فهرستی از حروف داخل قلاب‌ها باشد (برای نمونه هیچ رده خاصی مانند \(dq[:alpha:]\(dq پشتیبانی نمی‌شود و '\-' معنای خاصی ندارد). .IP نویسه‌های ستاره (\fB*\fP) و علامت سوال (\fB?\fP) هیچ معنای خاصی ندارند. .IP در اینجا مثالی آمده است که ۶ پسوند را برای صرف‌نظر کردن مشخص می‌کند (زیرا ۱ مورد از ۵ قاعده با ۲ پسوند مطابقت دارد): .RS 4 .IP .nf --skip-compress=gz/jpg/mp[34]/7z/bz2 .fi .RE .IP پسوندهای پیش‌فرض پرونده در فهرست skip-compress در این نسخه از rsync عبارتند از: .RS 4 .IP 3g2 3gp 7z aac ace apk avi bz2 deb dmg ear f4v flac flv gpg gz iso jar jpeg jpg lrz lz lz4 lzma lzo m1a m1v m2a m2ts m2v m4a m4b m4p m4r m4v mka mkv mov mp1 mp2 mp3 mp4 mpa mpeg mpg mpv mts odb odf odg odi odm odp ods odt oga ogg ogm ogv ogx opus otg oth otp ots ott oxt png qt rar rpm rz rzip spx squashfs sxc sxd sxg sxm sxw sz tbz tbz2 tgz tlz ts txz tzo vob war webm webp xz z zip zst .RE .IP این فهرست در همه شرایط به جز یک مورد با فهرست \fB\-\-skip\-compress\fP شما جایگزین خواهد شد: رونوشت از یک دیمن rsync، پسوندهای نادیده‌گرفته‌شده شما را به فهرست فایل‌های فشرده‌نشده خود اضافه می‌کند (و ممکن است فهرست آن با یک پیش‌فرض متفاوت پیکربندی شده باشد). .IP "\fB\-\-numeric\-ids\fP" با این گزینه، rsync به جای استفاده از نام‌های کاربری و گروهی و نگاشت آن‌ها در هر دو طرف، شناسه‌های عددی (ID) گروه و کاربر را منتقل می‌کند. .IP به طور پیش‌فرض، rsync از نام کاربری و نام گروه برای تعیین مالکیت فایل‌ها استفاده می‌کند. شناسه ویژه uid 0 و گروه ویژه 0 هرگز از طریق نام‌های کاربر/گروه نگاشت نمی‌شوند، حتی اگر گزینه \fB\-\-numeric\-ids\fP مشخص نشده باشد. .IP اگر کاربر یا گروهی در سیستم مبدأ نامی نداشته باشد یا در سیستم مقصد مطابقتی برای آن پیدا نشود، شناسه عددی از سیستم مبدأ به جای آن استفاده می‌شود. همچنین به تنظیم \fBuse\ chroot\fP در صفحه راهنمای rsyncd.conf برای نکاتی درباره چگونگی تأثیر تنظیمات chroot بر توانایی rsync در جستجوی نام‌های کاربران و گروه‌ها و کارهایی که می‌توانید در این مورد انجام دهید مراجعه کنید. .IP "\fB\-\-usermap=STRING\fP, \fB\-\-groupmap=STRING\fP" این گزینه‌ها به شما اجازه می‌دهند کاربرانی و گروه‌هایی را مشخص کنید که باید توسط سمت دریافت‌کننده به مقادیر دیگری نگاشت شوند. مقدار \fBSTRING\fP شامل یک یا چند جفت مقدار \fBFROM\fP:\fBTO\fP است که با ویرگول از هم جدا شده‌اند. هر مقدار منطبق \fBFROM\fP از سمت فرستنده با یک مقدار \fBTO\fP از سمت گیرنده جایگزین می‌شود. شما می‌توانید نام‌های کاربری یا شناسه‌های کاربری را برای مقادیر \fBFROM\fP و \fBTO\fP مشخص کنید، همچنین مقدار \fBFROM\fP می‌تواند یک رشته دارای نویسه عمومی (wild-card) باشد که با نام‌های فرستنده مطابقت داده می‌شود (نویسه‌های عمومی با شماره‌های ID مطابقت داده نمی‌شوند، اگرچه برای این‌که چرا یک '\fB*\fP' با همه چیز مطابقت دارد به ادامه مطلب نگاه کنید). شما می‌توانید به جای آن، محدوده‌ای از شماره‌های ID را از طریق یک بازه شامل شونده مشخص کنید: LOW-HIGH. برای مثال: .RS 4 .IP .nf --usermap=0-99:nobody,wayne:admin,*:normal --groupmap=usr:1,1:usr .fi .RE .IP نخستین تطابق در فهرست، موردی است که استفاده می‌شود. شما باید تمام نگاشت‌های کاربر خود را با استفاده از یک گزینه \fB\-\-usermap\fP واحد، و/یا تمام نگاشت‌های گروه خود را با استفاده از یک گزینه \fB\-\-groupmap\fP واحد مشخص کنید. .IP توجه داشته باشید که نام فرستنده برای کاربر و گروه 0 به گیرنده ارسال نمی‌شود، بنابراین باید این مقادیر را با استفاده از 0 تطبیق دهید، یا از نام‌های معتبر در سمت گیرنده (معمولاً "root") استفاده کنید. همه نام‌های دیگر \fBFROM\fP با نام‌های در حال استفاده در سمت فرستنده مطابقت دارند. همه نام‌های \fBTO\fP با نام‌های در حال استفاده در سمت گیرنده مطابقت دارند. .IP هر شناسه‌ای (ID) که در سمت فرستنده نامی نداشته باشد، به منظور تطبیق به عنوان یک نام خالی در نظر گرفته می‌شود. این امر به آن‌ها اجازه می‌دهد از طریق یک "\fB*\fP" یا با استفاده از یک نام خالی مطابقت داده شوند. برای مثال: .RS 4 .IP .nf --usermap=:nobody --groupmap=*:nobody .fi .RE .IP یک مقدار خالی \fBFROM\fP تنها با شناسه‌های بدون نام در سمت فرستنده مطابقت دارد. این یک نویسه عمومی برای کاربران یا گروه‌های دارای نام نیست؛ زمانی که می‌خواهید هر نام در سمت فرستنده را نگاشت کنید از "\fB*\fP" استفاده کنید. .IP هنگامی که گزینه \fB\-\-numeric\-ids\fP استفاده می‌شود، فرستنده هیچ نامی ارسال نمی‌کند، بنابراین با تمام شناسه‌ها به عنوان شناسه‌های دارای نام خالی رفتار می‌شود. این بدان معناست که اگر می‌خواهید این شناسه‌های بدون نام را به مقادیر دیگری نگاشت کنید، باید مقادیر عددی \fBFROM\fP را مشخص کنید. .IP برای کارکرد گزینه \fB\-\-usermap\fP، گیرنده باید به عنوان کاربر ارشد (super-user) اجرا شود (همچنین گزینه‌های \fB\-\-super\fP و \fB\-\-fake\-super\fP را ببینید). برای کارکرد گزینه \fB\-\-groupmap\fP، گیرنده باید دسترسی لازم برای تنظیم آن گروه را داشته باشد. .IP گزینه \fB\-\-usermap\fP به معنای فعال بودن گزینه \fB\-\-owner\fP (\fB\-o\fP) است، و گزینه \fB\-\-groupmap\fP به معنای فعال بودن گزینه \fB\-\-group\fP (\fB\-g\fP) است (زیرا rsync برای کارکرد گزینه‌های نگاشت نیاز به فعال بودن این گزینه‌ها دارد). .IP یک کلاینت قدیمی rsync ممکن است برای جلوگیری از خطا درباره نویسه‌های عام (wildcard) به استفاده از \fB\-s\fP نیاز داشته باشد، اما یک rsync مدرن این موضوع را به‌طور خودکار مدیریت می‌کند. .IP "\fB\-\-chown=USER:GROUP\fP" این گزینه اجبار می‌کند که مالکیت تمام فایل‌ها به USER با گروه GROUP تغییر کند. این رابطی ساده‌تر نسبت به استفاده مستقیم از \fB\-\-usermap\fP و \fB\-\-groupmap\fP است، اما در لایه‌های داخلی با استفاده از همان گزینه‌ها پیاده‌سازی شده و بنابراین نمی‌توان آن‌ها را ترکیب کرد. اگر USER یا GROUP خالی باشد، هیچ نگاشتی برای کاربر/گروه نادیده‌گرفته‌شده رخ نخواهد داد. اگر GROUP خالی باشد، می‌توان دو‌نقطه انتهایی را حذف کرد، اما اگر USER خالی باشد، باید دونقطه ابتدایی مشخص شود. .IP اگر "\fB\-\-chown=foo:bar\fP" را مشخص کنید، دقیقاً معادل مشخص کردن "\fB\-\-usermap=*:foo\ \-\-groupmap=*:bar\fP" است، تنها ساده‌تر (و با همان گزینه‌های ضمنی \fB\-\-owner\fP و/یا \fB\-\-group\fP). .IP یک کلاینت قدیمی rsync ممکن است برای جلوگیری از خطا درباره نویسه‌های عام (wildcard) به استفاده از \fB\-s\fP نیاز داشته باشد، اما یک rsync مدرن این موضوع را به‌طور خودکار مدیریت می‌کند. .IP "\fB\-\-timeout=SECONDS\fP" این گزینه به شما امکان می‌دهد حداکثر زمان انتظار ورودی/خروجی (I/O) را بر حسب ثانیه تنظیم کنید. اگر داده‌ای برای مدت زمان مشخص‌شده منتقل نشود، rsync خارج خواهد شد. مقدار پیش‌فرض 0 است، که به معنای نبود زمان انتظار است. .IP "\fB\-\-contimeout=SECONDS\fP" این گزینه به شما اجازه می‌دهد مدت زمانی را که rsync برای موفقیت‌آمیز بودن اتصال به یک دیمن rsync منتظر می‌ماند تعیین کنید. اگر زمان انتظار به پایان برسد، rsync با یک خطا خارج می‌شود. .IP "\fB\-\-address=ADDRESS\fP" به‌طور پیش‌فرض rsync هنگام اتصال به یک دیمن rsync به آدرس عمومی (wildcard) متصل (bind) می‌شود. گزینه \fB\-\-address\fP به شما اجازه می‌دهد یک آدرس IP مشخص (یا نام میزبان) را برای اتصال تعیین کنید. .IP همچنین نسخه دیمن گزینه \fB\-\-address\fP را ببینید. .IP "\fB\-\-port=PORT\fP" این گزینه یک شماره پورت TCP جایگزین را به جای پورت پیش‌فرض 873 مشخص می‌کند. این تنها زمانی لازم است که از نحو دو‌دونقطه (::) برای اتصال به یک دیمن rsync استفاده می‌کنید (زیرا ساختار URL روشی برای تعیین پورت به عنوان بخشی از URL دارد). .IP همچنین نسخه دیمن گزینه \fB\-\-port\fP را ببینید. .IP "\fB\-\-sockopts=OPTIONS\fP" این گزینه می‌تواند سرگرمی بی‌پایانی برای افرادی باشد که دوست دارند سیستم‌های خود را تا بالاترین حد ممکن تنظیم کنند. می‌توانید انواع گزینه‌های سوکت را تنظیم کنید که ممکن است انتقال را سریع‌تر (یا کندتر!) کنند. برای جزئیات مربوط به برخی از گزینه‌هایی که ممکن است قادر به تنظیم آن‌ها باشید، راهنمای فراخوانی سیستمی \fBsetsockopt()\fP را بخوانید. به‌طور پیش‌فرض هیچ گزینه سوکت خاصی تنظیم نشده است. این گزینه تنها بر اتصالات سوکت مستقیم به یک دیمن rsync راه‌دور تأثیر می‌گذارد. .IP همچنین نسخه دیمن گزینه \fB\-\-sockopts\fP را ببینید. .IP "\fB\-\-blocking\-io\fP" این گزینه به rsync دستور می‌دهد هنگام راه‌اندازی انتقال پوسته راه‌دور از I/O مسدودکننده (blocking) استفاده کند. اگر پوسته راه‌دور rsh یا remsh باشد، پیش‌فرض rsync استفاده از I/O مسدودکننده است، در غیر این صورت پیش‌فرض استفاده از I/O غیرمسدودکننده است. (توجه داشته باشید که ssh استفاده از I/O غیرمسدودکننده را ترجیح می‌دهد.) .IP "\fB\-\-outbuf=MODE\fP" این گزینه حالت بافر خروجی را تنظیم می‌کند. این حالت می‌تواند None (یا همان Unbuffered)، Line، یا Block (یا همان Full) باشد. می‌توانید برای حالت حتی یک تک‌حرف مشخص کنید، و از حروف بزرگ یا کوچک استفاده کنید. .IP کاربرد اصلی این گزینه تغییر بافرسازی از Full به Line است زمانی که خروجی rsync به یک فایل یا پایپ ارسال می‌شود. .IP "\fB\-\-itemize\-changes\fP, \fB\-i\fP" یک فهرست تفکیک‌شده ساده از تغییراتی که روی هر فایل اعمال می‌شود را درخواست می‌کند، شامل تغییرات ویژگی‌ها. این دقیقاً مشابه تعیین \fB\-\-out\-format='%i\ %n%L'\fP است. اگر این گزینه را تکرار کنید، فایل‌های بدون تغییر نیز خروجی داده می‌شوند، اما تنها در صورتی که نسخه rsync دریافت‌کننده حداقل 2.6.7 (مارس 2006) باشد. می‌توانید از \fB\-vv\fP در نسخه‌های قدیمی‌تر rsync استفاده کنید، اما این کار خروجی سایر پیام‌های پرحرف را نیز فعال می‌کند. .IP نویسه گریز "%i" دارای خروجی رمزی با طول ۱۱ حرف است. قالب کلی مانند رشته \fBYXcstpoguax\fP است، که در آن \fBY\fP با نوع به‌روزرسانی در حال انجام، \fBX\fP با نوع پرونده جایگزین می‌شود، و سایر حروف نشان‌دهنده ویژگی‌هایی هستند که در صورت تغییر یافتن ممکن است در خروجی نمایش داده شوند. .IP انواع به‌روزرسانی که جایگزین \fBY\fP می‌شوند به شرح زیر است: .IP .RS .IP o علامت \fB<\fP به این معنی است که یک پرونده به میزبان راه‌دور منتقل می‌شود (ارسال‌شده). .IP o علامت \fB>\fP به این معنی است که یک پرونده به میزبان محلی منتقل می‌شود (دریافت‌شده). .IP o علامت \fBc\fP به این معنی است که یک تغییر/ایجاد محلی برای مورد رخ می‌دهد (مانند ایجاد یک دایرکتوری یا تغییر یک پیوند نمادین و غیره). .IP o علامت \fBh\fP به این معنی است که مورد یک پیوند سخت به موردی دیگر است (نیازمند \fB\-\-hard\-links\fP). .IP o علامت \fB.\fP به این معنی است که مورد به‌روزرسانی نمی‌شود (اگرچه ممکن است ویژگی‌هایی داشته باشد که در حال تغییر هستند). .IP o علامت \fB*\fP به این معنی است که باقی‌مانده بخش خروجی جزئی‌بندی‌شده شامل یک پیام است (مانند "deleting"). .RE .IP انواع پرونده که جایگزین \fBX\fP می‌شوند عبارتند از: \fBf\fP برای یک پرونده، \fBd\fP برای یک دایرکتوری، \fBL\fP برای یک پیوند نمادین، \fBD\fP برای یک دستگاه، و \fBS\fP برای یک پرونده ویژه (مانند سوکت‌های نام‌گذاری‌شده و fifoها). .IP سایر حروف موجود در رشته نشان می‌دهند که آیا برخی از ویژگی‌های پرونده تغییر کرده‌اند یا خیر، به شرح زیر: .IP .RS .IP o "\fB.\fP" \- ویژگی بدون تغییر است. .IP o "\fB+\fP" \- پرونده به‌تازگی ایجاد شده است. .IP o "\fB\ \fP" \- تمام ویژگی‌ها بدون تغییر هستند (تمام نقطه‌ها به فاصله تبدیل می‌شوند). .IP o "\fB?\fP" \- تغییر نامشخص است (زمانی که rsync راه‌دور قدیمی باشد). .IP o یک حرف نشان می‌دهد که یک ویژگی در حال به‌روزرسانی است. .RE .IP ویژگی مرتبط با هر حرف به شرح زیر است: .IP .RS .IP o حرف \fBc\fP یا به این معنی است که یک پرونده عادی دارای جمع‌آزمای (checksum) متفاوتی است (نیازمند \fB\-\-checksum\fP) یا اینکه یک پیوند نمادین، دستگاه، یا پرونده ویژه مقدار تغییریافته‌ای دارد. توجه داشته باشید اگر در حال ارسال پرونده‌ها به یک rsync پیش از 3.0.1 (آوریل ۲۰۰۸) هستید، این پرچم تغییر فقط برای پرونده‌های عادی با تفاوت checksum نمایش داده خواهد شد. .IP o حرف \fBs\fP به این معنی است که اندازه یک پرونده عادی متفاوت است و با انتقال پرونده به‌روزرسانی خواهد شد. .IP o حرف \fBt\fP به این معنی است که زمان ویرایش متفاوت است و به مقدار فرستنده به‌روزرسانی می‌شود (نیازمند \fB\-\-times\fP). مقدار جایگزین \fBT\fP به این معنی است که زمان ویرایش روی زمان انتقال تنظیم خواهد شد؛ این حالت زمانی رخ می‌دهد که یک پرونده/پیوند نمادین/دستگاه بدون \fB\-\-times\fP به‌روزرسانی شود و یا زمانی که یک پیوند نمادین تغییر کرده و گیرنده نتواند زمان آن را تنظیم کند. .IP o حرف \fBp\fP به این معنی است که دسترسی‌ها (permissions) متفاوت هستند و به مقدار فرستنده به‌روزرسانی می‌شوند (نیازمند \fB\-\-perms\fP). .IP o حرف \fBo\fP به این معنی است که مالک متفاوت است و به مقدار فرستنده به‌روزرسانی می‌شود (نیازمند \fB\-\-owner\fP و دسترسی‌های کاربر ارشد). .IP o حرف \fBg\fP به این معنی است که گروه متفاوت است و به مقدار فرستنده به‌روزرسانی می‌شود (نیازمند \fB\-\-group\fP و مجوز لازم برای تعیین گروه). .IP o .IP .RS .IP o حروف \fBu\fP|\fBn\fP|\fBb\fP بیانگر اطلاعات زیر هستند: حرف \fBu\fP به این معنی است که زمان دسترسی (استفاده) متفاوت است و به مقدار فرستنده به‌روزرسانی می‌شود (نیازمند \fB\-\-atimes\fP) .IP o حرف \fBn\fP به این معنی است که زمان ایجاد (تازگی) متفاوت است و به مقدار فرستنده به‌روزرسانی می‌شود (نیازمند \fB\-\-crtimes\fP) .IP o حرف \fBb\fP به این معنی است که هر دو زمان دسترسی و ایجاد در حال به‌روزرسانی هستند .RE .IP o حرف \fBa\fP به این معنی است که اطلاعات ACL در حال تغییر است. .IP o حرف \fBx\fP به این معنی است که اطلاعات ویژگی‌های توسعه‌یافته (extended attributes) در حال تغییر است. .RE .IP یک خروجی دیگر نیز ممکن است: هنگام حذف فایل‌ها، "%i" برای هر موردی که حذف می‌شود رشته "\fB*deleting\fP" را خروجی می‌دهد (با این فرض که با نسخه به اندازه کافی جدیدی از rsync کار می‌کنید که موارد حذفی را لاگ می‌کند نه اینکه آنها را به شکل پیام پرجزئیات نمایش دهد). .IP "\fB\-\-out\-format=FORMAT\fP" به شما امکان می‌دهد دقیقاً مشخص کنید که کلاینت rsync در هر به‌روزرسانی چه چیزی را به کاربر خروجی دهد. این قالب یک رشته متنی شامل توالی‌های گریز تک‌نویسه‌ای درون‌متنی است که با نویسه درصد (%) مشخص می‌شوند. اگر هر یک از گزینه‌های \fB\-\-info=name\fP یا \fB\-v\fP مشخص شده باشد، قالب پیش‌فرض "%n%L" در نظر گرفته می‌شود (این قالب فقط نام فایل و در صورت پیوند بودن، مقصد آن را نشان می‌دهد). برای فهرست کامل نویسه‌های گریز معتبر، تنظیم \fBlog\ format\fP را در صفحه راهنمای rsyncd.conf ببینید. .IP مشخص کردن گزینه \fB\-\-out\-format\fP به معنی فعال شدن گزینه \fB\-\-info=name\fP است، که هر فایل، پوشه و غیره را که به‌صورت اساسی به‌روزرسانی شده ذکر می‌کند (یک فایل منتقل‌شده، یک پیوند نمادین/دستگاه از نو ایجاد‌شده یا یک پوشه دستکاری‌شده). علاوه بر این، اگر توالی گریز تغییرات جزئی (%i) در رشته موجود باشد (برای مثال اگر گزینه \fB\-\-itemize\-changes\fP استفاده شده باشد)، گزارش‌گیری نام‌ها افزایش می‌یابد تا هر موردی را که به هر نحوی تغییر کرده ذکر کند (تا زمانی که نسخه سمت دریافت‌کننده حداقل 2.6.4 باشد). برای توضیحات خروجی "%i" گزینه \fB\-\-itemize\-changes\fP را ببینید. .IP برنامه rsync رشته out-format را پیش از انتقال فایل خروجی می‌دهد مگر اینکه یکی از توالی‌های گریز آمار انتقال درخواست شده باشد، که در آن صورت ثبت گزارش در پایان انتقال فایل انجام می‌شود. هنگامی که این ثبت گزارش دیرهنگام فعال باشد و \fB\-\-progress\fP نیز مشخص شده باشد، rsync همچنین نام فایل در حال انتقال را پیش از اطلاعات پیشرفت آن خروجی می‌دهد (که البته با خروجی out-format دنبال می‌شود). .IP "\fB\-\-log\-file=FILE\fP" این گزینه باعث می‌شود rsync گزارش عملیات خود را در یک فایل بنویسد. این مشابه ثبت گزارشی است که یک دیمن انجام می‌دهد، اما می‌تواند برای سمت کلاینت و/یا سمت سرور یک انتقال غیردیمن درخواست شود. در صورت مشخص شدن به عنوان گزینه کلاینت، ثبت گزارش انتقال با قالب پیش‌فرض "%i %n%L" فعال می‌شود. در صورت تمایل به تغییر این رفتار، گزینه \fB\-\-log\-file\-format\fP را ببینید. .IP نمونه دستور زیر از سمت راه‌دور درخواست می‌کند رخدادها را ثبت کند: .RS 4 .IP .nf rsync -av --remote-option=--log-file=/tmp/rlog src/ dest/ .fi .RE .IP این گزینه زمانی که نیاز به عیب‌یابی علت بسته‌شدن غیرمنتظره اتصال داشته باشید بسیار مفید است. .IP همچنین نسخه دیمن گزینه \fB\-\-log\-file\fP را ببینید. .IP "\fB\-\-log\-file\-format=FORMAT\fP" به شما امکان می‌دهد دقیقاً مشخص کنید چه اطلاعاتی به ازای هر به‌روزرسانی در فایل مشخص‌شده توسط گزینه \fB\-\-log\-file\fP (که برای تأثیرگذاری این گزینه باید مشخص شده باشد) ثبت شود. اگر یک رشته خالی تعیین کنید، پرونده‌های به‌روزرسانی‌شده در فایل گزارش ذکر نخواهند شد. برای فهرستی از نویسه‌های گریز ممکن، تنظیم \fBlog\ format\fP را در صفحه راهنمای rsyncd.conf ببینید. .IP قالب (FORMAT) پیش‌فرض مورد استفاده در صورتی که \fB\-\-log\-file\fP تعیین شده باشد و این گزینه مشخص نشده باشد '%i %n%L' است. .IP همچنین نسخه دیمن گزینه \fB\-\-log\-file\-format\fP را ببینید. .IP "\fB\-\-stats\fP" این به rsync می‌گوید تا مجموعه‌ای مفصل از آمار انتقال فایل را چاپ کند، که به شما امکان می‌دهد میزان اثربخشی الگوریتم انتقال تفاضلی (delta-transfer) rsync را برای داده‌های خود ارزیابی کنید. این گزینه در صورت ترکیب با ۰ یا ۱ گزینه \fB\-v\fP معادل \fB\-\-info=stats2\fP است، یا در صورت ترکیب با ۲ یا تعداد بیشتری گزینه \fB\-v\fP معادل \fB\-\-info=stats3\fP خواهد بود. .IP آمار کنونی به شرح زیر است: .IP .RS .IP o \fBNumber\ of\ files\fP تعداد کل «پرونده‌ها» (به معنای عام) است که شامل پوشه‌ها، پیوندهای نمادین و غیره می‌شود. در ادامه تعداد کل، فهرستی از تعداد بر اساس نوع فایل خواهد آمد (اگر مجموع غیرصفر باشد). برای مثال: "(reg: 5, dir: 3, link: 2, dev: 1, special: 1)" مجموع پرونده‌های عادی، پوشه‌ها، پیوندهای نمادین، دستگاه‌ها و پرونده‌های خاص را فهرست می‌کند. اگر هر مقداری ۰ باشد، به طور کامل از فهرست حذف می‌شود. .IP o \fBNumber\ of\ created\ files\fP تعداد «پرونده‌هایی» (به معنای عام) است که ایجاد شده‌اند (در مقایسه با به‌روزرسانی‌شده‌ها). در ادامه تعداد کل، فهرستی از تعداد بر اساس نوع فایل خواهد آمد (اگر مجموع غیرصفر باشد). .IP o \fBNumber\ of\ deleted\ files\fP تعداد «پرونده‌هایی» (به معنای عام) است که حذف شده‌اند. در ادامه تعداد کل، فهرستی از تعداد بر اساس نوع فایل خواهد آمد (اگر مجموع غیرصفر باشد). توجه داشته باشید که این خط تنها در صورتی چاپ می‌شود که حذف‌ها فعال باشند، و فقط در صورتی که پروتکل توافق‌شده حداقل ۳۱ باشد (پیش‌فرض زمانی که هر دو طرف نسخه ۳.۱.۰، سپتامبر ۲۰۱۳، یا جدیدتر باشند). .IP o \fBNumber\ of\ regular\ files\ transferred\fP تعداد پرونده‌های عادی است که از طریق الگوریتم delta-transfer در rsync به‌روزرسانی شده‌اند، که شامل دایرکتوری‌ها، پیوندهای نمادین و غیره نمی‌شود. .IP o \fBTotal\ file\ size\fP مجموع کل حجم تمام پرونده‌ها در انتقال است. این مقدار شامل حجم پوشه‌ها یا پرونده‌های خاص نمی‌شود، اما حجم پیوندهای نمادین را در بر می‌گیرد. .IP o \fBTotal\ transferred\ file\ size\fP مجموع کل حجم پرونده‌ها فقط برای فایل‌های منتقل‌شده است. .IP o \fBLiteral\ data\fP مقدار داده‌های نامنطبق به‌روزرسانی فایل است که فرستنده مجبور به ارسال آن به گیرنده شده تا بتواند پرونده‌های به‌روزرسانی‌شده را بازسازی کند. .IP o \fBMatched\ data\fP مقدار داده‌ای است که گیرنده هنگام بازسازی فایل‌های به‌روزرسانی‌شده به طور محلی دریافت کرده است. .IP o \fBFile\ list\ size\fP حجم داده‌های فهرست پرونده هنگام ارسال آن از فرستنده به گیرنده است. این مقدار به دلیل فشرده‌سازی برخی داده‌های تکراری هنگام ارسال فهرست توسط rsync، از اندازه فهرست پرونده در حافظه کمتر است. .IP o \fBFile\ list\ generation\ time\fP تعداد ثانیه‌هایی است که فرستنده صرف ایجاد فهرست پرونده کرده است. وجود این مورد نیازمند نسخه جدیدی از rsync در سمت ارسال‌کننده است. .IP o \fBFile\ list\ transfer\ time\fP مدت زمان (به ثانیه) صرف شده توسط فرستنده برای ارسال فهرست پرونده‌ها به گیرنده است. .IP o \fBTotal\ bytes\ sent\fP مجموع تمام بایت‌هایی است که rsync از سمت کلاینت به سمت سرور ارسال کرده است. .IP o \fBTotal\ bytes\ received\fP مجموع تمام بایت‌های غیرپیامی است که rsync در سمت کلاینت از سمت سرور دریافت کرده است. بایت‌های «غیرپیامی» به این معنی است که بایت‌های پیام‌های پرگو (verbose) ارسال‌شده از سرور محاسبه نمی‌شوند، که این کار آمار را یکدست‌تر می‌کند. .RE .IP "\fB\-\-8\-bit\-output\fP, \fB\-8\fP" این گزینه به rsync می‌گوید تمام نویسه‌های بیت‌بالا (high-bit) را در خروجی (خروجی استاندارد یا خطای استاندارد) بدون گریز (unescaped) رها کند، به‌جای اینکه معتبر بودن آن‌ها را در لوکال (locale) فعلی بررسی کرده و موارد نامعتبر را با نویسه گریز جایگزین کند. تمام نویسه‌های کنترلی (به‌جز تب‌ها) صرف‌نظر از تنظیمات این گزینه، همیشه گریز داده می‌شوند (escaped). .IP قاعده گریز که از نسخه 2.6.7 (مارس ۲۰۰۶) آغاز شد، چاپ یک بک‌اسلش واقعی (\fB\\\fP) و یک هش (\fB#\fP) به همراه دقیقاً ۳ رقم در مبنای هشت (اکتال) است. برای نمونه، نویسه خط جدید به‌صورت «\fB\\#012\fP» چاپ می‌شود. یک بک‌اسلش واقعی در نام پرونده گریز داده نمی‌شود، مگر اینکه بلافاصله پس از آن یک علامت هش و ۳ رقم (0-9) بیاید. .IP "\fB\-\-human\-readable\fP, \fB\-h\fP" چاپ اعداد در قالبی خواناتر برای انسان. ۳ سطح ممکن وجود دارد: .RS .IP .IP 1. چاپ اعداد با یک جداکننده بین هر ۳ رقم (کاما یا نقطه، بسته به اینکه ممیز اعشاری با نقطه نشان داده می‌شود یا کاما). .IP 2. چاپ اعداد در مضارب ۱۰۰۰ (همراه با پسوند نویسه‌ای برای واحدهای بزرگ‌تر\ \-\- زیر را ببینید). .IP 3. چاپ اعداد در مضارب ۱۰۲۴. .RE .IP پیش‌فرض، سطح ۱ خوانایی برای انسان است. هر گزینه \fB\-h\fP سطح را یک واحد افزایش می‌دهد. با مشخص کردن گزینه \fB\-\-no\-human\-readable\fP (\fB\-\-no\-h\fP) می‌توانید سطح را به ۰ برسانید (تا اعداد به‌صورت ارقام خالص چاپ شوند). .IP حروف یکاها که در سطوح ۲ و ۳ اضافه می‌شوند عبارتند از: \fBK\fP (کیلو)، \fBM\fP (مگا)، \fBG\fP (گیگا)، \fBT\fP (ترا)، یا \fBP\fP (پتا). برای نمونه، یک پرونده ۱۲۳۴۵۶۷ بایتی در سطح ۲ به‌صورت 1.23M نمایش داده خواهد شد (با فرض اینکه ممیز اعشاری محلی شما نقطه باشد). .IP یادداشت سازگاری رو‌به‌عقب: نسخه‌های rsync پیش از 3.1.0 (سپتامبر ۲۰۱۳) از سطح ۱ خوانایی برای انسان پشتیبانی نمی‌کنند و پیش‌فرض آن‌ها سطح ۰ است. بنابراین، مشخص کردن یک یا دو گزینه \fB\-h\fP در نسخه‌های قدیم و جدید رفتار مشابهی خواهد داشت، تا زمانی که پیش از یک یا چند گزینه \fB\-h\fP گزینه \fB\-\-no\-h\fP را تعیین نکرده باشید. برای مشاهده یک تفاوت، گزینه \fB\-\-list\-only\fP را ببینید. .IP "\fB\-\-partial\fP" به‌طور پیش‌فرض، اگر انتقال قطع شود rsync هر پرونده منتقل‌شده به‌صورت نیمه‌کاره را حذف می‌کند. در برخی شرایط نگه داشتن پرونده‌های ناقص مطلوب‌تر است. استفاده از گزینه \fB\-\-partial\fP به rsync می‌گوید پرونده ناقص را نگه دارد که این امر انتقال مجدد باقی‌مانده پرونده در آینده را بسیار سریع‌تر می‌کند. .IP "\fB\-\-partial\-dir=DIR\fP" این گزینه رفتار گزینه \fB\-\-partial\fP را تغییر می‌دهد و هم‌زمان فعال بودن آن را نیز اعمال می‌کند. این روش ارتقایافته مدیریت پرونده‌های ناقص، هر پرونده نیمه‌کاره را به‌جای نوشتن مستقیم در پرونده مقصد، درون \fIDIR\fP مشخص‌شده قرار می‌دهد. در انتقال بعدی، rsync از پرونده موجود در این پوشه به عنوان داده برای افزایش سرعت ازسرگیری انتقال استفاده می‌کند و پس از انجام هدفش، آن را حذف خواهد کرد. .IP توجه داشته باشید که اگر \fB\-\-whole\-file\fP مشخص شده باشد (یا به‌طور ضمنی اعمال گردد)، هرگونه پرونده درون partial-dir که برای یک پرونده در حال به‌روزرسانی یافت شود، حذف خواهد شد (زیرا rsync پرونده‌ها را بدون استفاده از الگوریتم انتقال تفاضلی delta-transfer می‌فرستد). .IP برنامه rsync در صورت عدم وجود \fIDIR\fP آن را ایجاد می‌کند، اما فقط آخرین دایرکتوری را\ \-\- نه تمام مسیر را. این امر استفاده از یک مسیر نسبی (مانند "\fB\-\-partial\-dir=.rsync-partial\fP") را آسان می‌کند تا rsync دایرکتوری فایل‌های ناقص (partial-directory) را در صورت نیاز درون دایرکتوری فایل مقصد ایجاد کرده و هنگام حذف فایل ناقص، دوباره آن را پاک کند. توجه داشته باشید که این حذف دایرکتوری فقط برای مسیرهای نسبی انجام می‌شود، زیرا انتظار می‌رود مسیر مطلق برای دایرکتوری‌ای باشد که به عملیات partial-dir اختصاص یافته است. .IP اگر مقدار partial-dir یک مسیر مطلق نباشد، rsync یک قاعده استثنا (exclude) را به انتهای تمام قواعد استثنای موجود شما اضافه می‌کند. این کار از ارسال هرگونه فایل‌های partial-dir که ممکن است در سمت ارسال‌کننده وجود داشته باشند جلوگیری کرده و همچنین مانع از حذف نابهنگام موارد partial-dir در سمت گیرنده می‌شود. به عنوان مثال: گزینه \fB\-\-partial\-dir\fP بالا معادل این استثنای «فاسدشدنی» (perishable) را در انتهای سایر قواعد فیلتر اضافه می‌کند: \fB\-f\ '\-p\ .rsync-partial/'\fP .IP اگر قواعد استثنای سفارشی خود را تعیین می‌کنید، ممکن است لازم باشد قاعده استثنا/پنهان‌سازی/محافظت (exclude/hide/protect) خود را برای partial-dir اضافه کنید زیرا: .RS .IP .IP 1. قاعده اضافه‌شده به‌صورت خودکار ممکن است در انتهای سایر قواعد شما بی‌اثر باشد، یا .IP 2. ممکن است بخواهید انتخاب استثنای rsync را بازنویسی (override) کنید. .RE .IP به عنوان مثال، اگر می‌خواهید rsync دایرکتوری‌های partial به‌جامانده را پاک‌سازی کند، باید \fB\-\-delete\-after\fP را مشخص کرده و یک قاعده فیلتر «ریسک» (risk) اضافه کنید، مانند \fB\-f\ 'R\ .rsync-partial/'\fP. از استفاده از \fB\-\-delete\-before\fP یا \fB\-\-delete\-during\fP خودداری کنید، مگر اینکه نیازی نداشته باشید rsync در حین اجرای فعلی از داده‌های partial-dir به‌جامانده استفاده کند. .IP مهم: دایرکتوری partial-dir نباید توسط سایر کاربران قابل نوشتن باشد، در غیر این صورت یک خطر امنیتی محسوب می‌شود! مثلاً از "/tmp" اجتناب کنید! .IP همچنین می‌توانید مقدار partial-dir را با متغیر محیطی \fBRSYNC_PARTIAL_DIR\fP تنظیم کنید. تنظیم این متغیر در محیط، فعال‌سازی \fB\-\-partial\fP را تحمیل نمی‌کند، بلکه مشخص می‌کند در صورت تعیین \fB\-\-partial\fP، فایل‌های ناقص در کجا قرار گیرند. به عنوان مثال، به جای استفاده از \fB\-\-partial\-dir=.rsync-tmp\fP همراه با \fB\-\-progress\fP، می‌توانید \fBRSYNC_PARTIAL_DIR=.rsync-tmp\fP را در محیط خود مقداردهی کرده و سپس از گزینه \fB\-P\fP برای فعال کردن استفاده از پوشه .rsync-tmp جهت انتقال‌های ناقص بهره ببرید. تنها مواقعی که گزینه \fB\-\-partial\fP این مقدار محیطی را بررسی نمی‌کند عبارتند از: .RS .IP .IP 1. زمانی که \fB\-\-inplace\fP مشخص شده باشد (زیرا \fB\-\-inplace\fP با \fB\-\-partial\-dir\fP تداخل دارد)، و .IP 2. زمانی که \fB\-\-delay\-updates\fP مشخص شده باشد (پایین را ببینید). .RE .IP هنگامی که یک نسخه جدید rsync انتقال یک فایل در partial-dir را از سر می‌گیرد، آن فایل ناقص اکنون به‌جای ایجاد یک رونوشت دیگر از فایل موقت، درجا (in-place) به‌روزرسانی می‌شود (بنابراین حداکثر فضای اشغالی dest + tmp خواهد بود، به جای dest + partial + tmp). این قابلیت نیازمند آن است که هر دو طرف انتقال حداقل دارای نسخه 3.2.0 (ژوئن 2020) باشند. .IP برای اهداف تنظیمات "\fBrefuse\ options\fP" در پیکربندی دیمن، گزینه \fB\-\-partial\-dir\fP به‌معنای فعال‌سازی ضمنی \fB\-\-partial\fP \fIنیست\fP. این بدان منظور است که بتوان از رد کردن گزینه \fB\-\-partial\fP برای جلوگیری از رونویسی فایل‌های مقصد با انتقال ناقص استفاده کرد، در حالی که همچنان استفاده از شیوه امن‌تر ارائه‌شده توسط \fB\-\-partial\-dir\fP مجاز باشد. .IP "\fB\-\-delay\-updates\fP" این گزینه فایل موقت حاصل از هر فایل به‌روزرسانی‌شده را تا پایان انتقال در یک پوشه نگهدارنده قرار می‌دهد، و در آن هنگام تمام فایل‌ها به‌سرعت و پشت سر هم به جای اصلی خود تغییر نام پیدا می‌کنند. این کار باعث می‌شود به‌روزرسانی فایل‌ها به حالت اتمیک (اتمام یک‌باره) نزدیک‌تر شود. به‌طور پیش‌فرض فایل‌ها در پوشه‌ای با نام \fB.~tmp~\fP درون دایرکتوری مقصد هر فایل قرار می‌گیرند، اما اگر گزینه \fB\-\-partial\-dir\fP را مشخص کرده باشید، به جای آن از آن پوشه استفاده خواهد شد. توضیحات بخش \fB\-\-partial\-dir\fP را برای بررسی نحوه مستثنی شدن این پوشه \fB.~tmp~\fP از انتقال، و نحوه پاک‌سازی پوشه‌های قدیمی \fB.~tmp~\fP به‌جامانده توسط rsync ببینید. با گزینه‌های \fB\-\-inplace\fP و \fB\-\-append\fP تداخل دارد. .IP این گزینه \fB\-\-no\-inc\-recursive\fP را فعال می‌کند زیرا برای پیمایش فهرست در انتها، به کل فهرست پرونده‌ها در حافظه نیاز دارد. .IP این گزینه در سمت گیرنده حافظه بیشتری مصرف می‌کند (یک بیت به ازای هر پرونده منتقل‌شده) و همچنین به فضای دیسک خالی کافی در سمت گیرنده برای نگهداری یک نسخه اضافی از تمام پرونده‌های به‌روزشده نیاز دارد. توجه داشته باشید که نباید از مسیر مطلق برای \fB\-\-partial\-dir\fP استفاده کنید مگر اینکه: .RS .IP .IP 1. هیچ احتمالی برای همنام بودن پرونده‌ها در انتقال وجود نداشته باشد (زیرا اگر مسیر مطلق باشد، تمام پرونده‌های به‌روزشده در یک پوشه واحد قرار می‌گیرند)، و .IP 2. هیچ نقطه اتصالی در سلسله‌مراتب وجود نداشته باشد (زیرا اگر نتوان نام پرونده‌های به‌روزشده با تاخیر را در محل اصلی تغییر داد، شکست خواهند خورد). .RE .IP همچنین برای یک الگوریتم به‌روزرسانی که حتی به حالت اتمیک نزدیک‌تر است (که از \fB\-\-link\-dest\fP و یک سلسله‌مراتب موازی از پرونده‌ها استفاده می‌کند)، اسکریپت پایتون "atomic-rsync" را در زیرپوشه "support" ببینید. .IP "\fB\-\-prune\-empty\-dirs\fP, \fB\-m\fP" این گزینه به rsync گیرنده می‌گوید که پوشه‌های خالی را از فهرست پرونده‌ها حذف کند، شامل پوشه‌های تودرتویی که فرزند غیرپوشه‌ای ندارند. این قابلیت برای جلوگیری از ایجاد مجموعه‌ای از پوشه‌های بی‌استفاده هنگام پیمایش بازگشتی سلسله‌مراتب پرونده‌ها توسط rsync فرستنده با استفاده از قواعد include/exclude/filter مفید است. .IP اگر از TRANSFER_RULES استفاده کنید، این گزینه ممکن است همچنان پوشه‌های خالی را در سمت گیرنده باقی بگذارد. .IP از آنجا که فهرست پرونده‌ها عملاً هرس می‌شود، این گزینه بر پوشه‌هایی که هنگام فعال بودن عملیات حذف پاک می‌شوند نیز تأثیر می‌گذارد. با این حال، به خاطر داشته باشید که پرونده‌ها و پوشه‌های مستثنی‌شده می‌توانند از حذف موارد موجود جلوگیری کنند، زیرا یک استثنا هم پرونده‌های مبدأ را پنهان می‌کند و هم از پرونده‌های مقصد محافظت می‌کند. برای نحوه جلوگیری از این مورد، گزینه قاعده فیلتر perishable را ببینید. .IP می‌توانید با استفاده از یک فیلتر سراسری "protect" از هرس شدن برخی پوشه‌های خالی از فهرست پرونده‌ها جلوگیری کنید. برای نمونه، این گزینه اطمینان می‌دهد که پوشه "emptydir" در فهرست پرونده‌ها حفظ می‌شود: .RS 4 .IP .nf --filter 'protect emptydir/' .fi .RE .IP این یک مثال است که تمام پرونده‌های ‎.pdf را در یک سلسله‌مراتب رونوشت می‌کند، فقط پوشه‌های مقصد لازم برای نگهداری پرونده‌های ‎.pdf را می‌سازد، و اطمینان حاصل می‌کند که هرگونه پرونده و پوشه اضافی در مقصد حذف شوند (توجه کنید که به جای یک exclude از فیلتر hide برای موارد غیرپوشه استفاده شده است): .RS 4 .IP .nf rsync -avm --del --include='*.pdf' -f 'hide,! */' src/ dest .fi .RE .IP اگر نمی‌خواهید پرونده‌های اضافی مقصد را حذف کنید، گزینه‌های سنتی‌تر \fB\-\-include='*/'\ \-\-exclude='*'\fP به جای فیلتر hide به‌خوبی کار خواهند کرد (اگر این روش برای شما طبیعی‌تر است). .IP "\fB\-\-progress\fP" این گزینه به rsync می‌گوید اطلاعات مربوط به پیشرفت انتقال را چاپ کند. این کار چیزی برای تماشا در اختیار کاربر قرار می‌دهد. در یک نسخه مدرن rsync، این مورد معادل تعیین \fB\-\-info=flist2,name,progress\fP است، اما هرگونه تنظیمات ارائه‌شده توسط کاربر برای این پرچم‌های info اولویت دارد (مانند \fB\-\-info=flist0\ \-\-progress\fP). .IP هنگامی که rsync در حال انتقال یک پرونده عادی است، خط پیشرفتی شبیه به این را به‌روزرسانی می‌کند: .RS 4 .IP .nf 782448 63% 110.64kB/s 0:00:04 .fi .RE .IP در این مثال، گیرنده ۷۸۲۴۴۸ بایت یا ۶۳٪ از پرونده فرستنده را بازسازی کرده است، که با نرخ ۱۱۰.۶۴ کیلوبایت بر ثانیه بازسازی می‌شود، و اگر نرخ فعلی تا انتها حفظ شود، انتقال در ۴ ثانیه به پایان خواهد رسید. .IP اگر الگوریتم انتقال تفاضلی (delta-transfer) rsync در حال استفاده باشد، این آمار می‌تواند گمراه‌کننده باشد. برای مثال، اگر پرونده فرستنده شامل پرونده پایه و به دنبال آن داده‌های اضافی باشد، زمانی که گیرنده به داده‌های لفظی (literal data) می‌رسد، نرخ گزارش‌شده احتمالاً به شدت افت خواهد کرد و پایان انتقال احتمالاً بسیار بیشتر از آنچه گیرنده در زمان اتمام بخش منطبق پرونده تخمین زده بود طول خواهد کشید. .IP هنگامی که انتقال پرونده پایان می‌یابد، rsync خط پیشرفت را با یک خط خلاصه جایگزین می‌کند که شبیه این است: .RS 4 .IP .nf 1,238,099 100% 146.38kB/s 0:00:08 (xfr#5, to-chk=169/396) .fi .RE .IP در این مثال، حجم کل پرونده ۱,۲۳۸,۰۹۹ بایت بوده، میانگین نرخ انتقال برای کل پرونده در طول ۸ ثانیه‌ای که تکمیل آن طول کشید ۱۴۶.۳۸ کیلوبایت بر ثانیه بوده، این پنجمین انتقال یک پرونده عادی در طول نشست فعلی rsync بوده است، و از مجموع ۳۹۶ پرونده موجود در فهرست پرونده‌ها (file-list)، ۱۶۹ پرونده دیگر برای بررسی توسط گیرنده باقی مانده است (تا بررسی شود که آیا به‌روز هستند یا خیر). .IP در یک پویش بازگشتی افزایشی (incremental recursion scan)، rsync تا زمانی که به پایان پویش نرسد تعداد کل پرونده‌ها در فهرست پرونده‌ها را نمی‌داند، اما از آنجا که انتقال پرونده‌ها را در حین پویش آغاز می‌کند، خطی با متن \(dqir\-chk\(dq (برای بررسی بازگشتی افزایشی) را به جای \(dqto\-chk\(dq تا زمانی که اندازه کامل فهرست را بفهمد نمایش می‌دهد، و در آن نقطه به استفاده از \(dqto\-chk\(dq تغییر وضعیت می‌دهد. بنابراین، مشاهده \(dqir\-chk\(dq به شما اطلاع می‌دهد که تعداد کل پرونده‌ها در فهرست پرونده‌ها همچنان افزایش خواهد یافت (و هر بار که این اتفاق می‌افتد، تعداد پرونده‌های باقی‌مانده برای بررسی به اندازه تعداد پرونده‌های اضافه‌شده به فهرست افزایش می‌یابد). .IP "\fB\-P\fP" گزینه \fB\-P\fP معادل \(dq\fB\-\-partial\fP \fB\-\-progress\fP\(dq است. هدف آن ساده‌تر کردن تعیین این دو گزینه برای انتقالی طولانی است که ممکن است دچار وقفه شود. .IP همچنین گزینه \fB\-\-info=progress2\fP وجود دارد که آمار را بر اساس کل انتقال خروجی می‌دهد، نه پرونده‌های جداگانه. اگر می‌خواهید وضعیت انتقال را بدون اسکرول شدن صفحه با نام‌های زیاد مشاهده کنید، از این پرچم بدون خروجی دادن نام پرونده استفاده کنید (برای مثال از \fB\-v\fP خودداری کنید یا \fB\-\-info=name0\fP را تعیین کنید). (برای استفاده از \fB\-\-info=progress2\fP نیازی به تعیین گزینه \fB\-\-progress\fP ندارید.) .IP در نهایت، می‌توانید با ارسال یک سیگنال SIGINFO یا SIGVTALRM به rsync، یک گزارش پیشرفت فوری دریافت کنید. در سیستم‌های BSD، سیگنال SIGINFO با فشردن کلیدهای Ctrl+T ایجاد می‌شود (لینوکس در حال حاضر از سیگنال SIGINFO پشتیبانی نمی‌کند). هنگامی که فرایند سمت کلاینت یکی از این سیگنال‌ها را دریافت می‌کند، پرچمی را برای خروجی دادن یک گزارش پیشرفت تکی تنظیم می‌کند که پس از پایان انتقال پرونده فعلی نمایش داده می‌شود (بنابراین اگر هنگام رسیدن سیگنال پرونده بزرگی در حال پردازش باشد، ممکن است کمی طول بکشد). یک نام پرونده (در صورت نیاز) خروجی داده می‌شود و پس از آن اطلاعات پیشرفت در قالب \fB\-\-info=progress2\fP می‌آید. اگر نمی‌دانید کدام‌یک از ۳ فرایند rsync فرایند کلاینت است، مشکلی ندارد که به همه آن‌ها سیگنال بفرستید (زیرا فرایندهای غیر کلاینت سیگنال را نادیده می‌گیرند). .IP هشدار: ارسال SIGVTALRM به نسخه‌های قدیمی‌تر rsync (پیش از ۳.۲.۰، ژوئن ۲۰۲۰) آن را خواهد کشت (kill). .IP "\fB\-\-password\-file=FILE\fP" این گزینه به شما اجازه می‌دهد گذرواژه‌ای را برای دسترسی به دیمن rsync از طریق یک پرونده یا از طریق ورودی استاندارد (اگر \fBFILE\fP برابر با \fB\-\fP باشد) فراهم کنید. پرونده باید فقط حاوی گذرواژه در خط اول باشد (تمام خطوط دیگر نادیده گرفته می‌شوند). اگر \fBFILE\fP برای همه قابل خواندن (world readable) باشد یا اگر دستور rsync اجراشده توسط کاربر root پرونده‌ای متعلق به غیر از root را بیابد، rsync با خطا خارج خواهد شد. .IP این گزینه گذرواژه‌ای را به بستر انتقال پوسته راه‌دور مانند ssh ارائه نمی‌دهد؛ برای یادگیری نحوه انجام آن، به مستندات پوسته راه‌دور مراجعه کنید. هنگام دسترسی به دیمن rsync با استفاده از یک پوسته راه‌دور به عنوان بستر انتقال، این گزینه تنها پس از اتمام احراز هویت پوسته راه‌دور اعمال می‌شود (یعنی اگر در پرونده پیکربندی دیمن نیز یک گذرواژه مشخص کرده باشید). .IP "\fB\-\-early\-input=FILE\fP" این گزینه به rsync اجازه می‌دهد تا سقف ۵ کیلوبایت داده را از طریق stdin به اسکریپت \(dqearly exec\(dq ارسال کند. یک کاربرد احتمالی این داده‌ها، ارائه یک راز به اسکریپت است که می‌توان از آن برای سوار کردن یک سیستم‌فایل رمزشده استفاده کرد (که باید آن را در اسکریپت \(dqpost-xfer exec\(dq پیاده‌سازی/unmount کنید). .IP نسخه دیمن باید حداقل 3.2.1 (ژوئن ۲۰۲۰) باشد. .IP "\fB\-\-list\-only\fP" این گزینه باعث می‌شود فایل‌های مبدأ به‌جای انتقال، فهرست شوند. اگر تنها یک آرگومان مبدأ وجود داشته باشد و مقصدی مشخص نشده باشد، این گزینه به‌طور ضمنی فعال در نظر گرفته می‌شود؛ بنابراین کاربردهای اصلی آن عبارتند از: .RS .IP .IP 1. تبدیل یک دستور کپی شامل آرگومان مقصد به یک دستور فهرست‌بندی فایل، یا .IP 2. امکان تعیین بیش از یک آرگومان مبدأ. نکته: حتماً مقصد را درج کنید. .RE .IP هشدار: به خاطر داشته باشید که یک آرگومان مبدأ دارای نویسه عام (wild-card) توسط پوسته به چندین آرگومان گسترش می‌یابد، بنابراین تلاش برای مشخص کردن یک آرگومان عام منفرد جهت فعال‌سازی خودکار این گزینه هرگز ایمن نیست. یک مثال ایمن: .RS 4 .IP .nf rsync -av --list-only foo* dest/ .fi .RE .IP این گزینه همیشه از قالب خروجی مشابه این استفاده می‌کند: .RS 4 .IP .nf drwxrwxr-x 4,096 2022/09/30 12:53:11 support -rw-rw-r-- 80 2005/01/11 10:37:37 support/Makefile .fi .RE .IP تنها گزینه‌ای که بر این شیوه خروجی تأثیر می‌گذارد، گزینه \fB\-\-human\-readable\fP (\fB\-h\fP) است. حالت پیش‌فرض، نمایش اندازه‌ها به صورت شمارش بایت با جداکننده‌های ارقام است (در ستونی با پهنای ۱۴ نویسه). تعیین حداقل یک گزینه \fB\-h\fP باعث می‌شود اندازه‌ها همراه با پسوند واحد نمایش داده شوند. اگر اندازه شمارش بایت به سبک قدیمی و بدون جداکننده‌های ارقام (و در ستونی با پهنای ۱۱ نویسه) را می‌خواهید، از \fB\-\-no\-h\fP استفاده کنید. .IP نکته سازگاری: هنگام درخواست فهرست راه‌دور فایل‌ها از یک rsync با نسخه 2.6.3 یا قدیمی‌تر (یعنی پیش از ۲۰۰۵)، در صورت درخواست فهرست غیربازگشتی ممکن است با خطا مواجه شوید. دلیل این امر آن است که فهرست کردن فایل‌ها مستلزم گزینه \fB\-\-dirs\fP بدون \fB\-\-recursive\fP است، و نسخه‌های قدیمی‌تر rsync این گزینه را ندارند. برای جلوگیری از این مشکل، یا گزینه \fB\-\-no\-dirs\fP را مشخص کنید (اگر نیازی به باز کردن محتوای دایرکتوری ندارید)، یا حالت بازگشتی را فعال کرده و محتوای زیرپوشه‌ها را مستثنی کنید: \fB\-r\ \-\-exclude='/*/*'\fP. .IP "\fB\-\-bwlimit=RATE\fP" این گزینه به شما اجازه می‌دهد حداکثر نرخ انتقال داده‌های ارسالی از طریق سوکت را بر حسب واحد بر ثانیه تعیین کنید. مقدار RATE می‌تواند یک پسوند رشته‌ای برای تعیین ضریب اندازه داشته باشد و می‌تواند یک مقدار اعشاری باشد (مانند \fB\-\-bwlimit=1.5m\fP). در صورت عدم تعیین پسوند، مقدار بر حسب واحدهای ۱۰۲۴ بایتی در نظر گرفته می‌شود (گویی \(dqK\(dq یا \(dqKiB\(dq اضافه شده است). برای توضیحات تمام پسوندهای موجود، گزینه \fB\-\-max\-size\fP را ببینید. مقدار 0 بیانگر عدم اعمال محدودیت است. .IP به دلایل سازگاری با گذشته، محدودیت نرخ به نزدیک‌ترین واحد KiB گرد خواهد شد، بنابراین هیچ نرخی کمتر از 1024 بایت بر ثانیه امکان‌پذیر نیست. .IP برنامه rsync داده‌ها را از طریق سوکت در بلوک‌هایی می‌نویسد، و این گزینه هم اندازه بلوک‌هایی که rsync می‌نویسد را محدود می‌کند و هم تلاش می‌کند نرخ انتقال میانگین را در حد درخواست‌شده نگه دارد. ممکن است مقداری حالت جهشی مشاهده شود که در آن rsync یک بلوک داده را نوشته و سپس برای رساندن نرخ میانگین به مقدار مطابق، به خواب می‌رود. .IP به دلیل بافرسازی داخلی داده‌ها، گزینه \fB\-\-progress\fP ممکن است بازتاب دقیقی از سرعت ارسال داده‌ها نباشد. دلیل این امر آن است که هنگام بافر شدن سریع داده‌ها، برخی فایل‌ها ممکن است طوری نمایش داده شوند که گویا به‌سرعت ارسال شده‌اند، در حالی که سایر فایل‌ها هنگام تخلیه بافر خروجی ممکن است بسیار کُند به نظر برسند. این مورد ممکن است در نسخه‌های بعدی برطرف شود. .IP همچنین نسخه دیمن گزینه \fB\-\-bwlimit\fP را ببینید. .IP "\fB\-\-stop\-after=MINS\fP, (\fB\-\-time\-limit=MINS\fP)" این گزینه به rsync می‌گوید پس از سپری شدن تعداد دقایق مشخص‌شده، رونوشت‌برداری را متوقف کند. .IP برای حداکثر انعطاف‌پذیری، rsync این گزینه را به rsync راه‌دور منتقل نمی‌کند، زیرا معمولاً کافی است که یک سمت اتصال طبق دستور خارج شود. این امر امکان استفاده از گزینه را حتی زمانی که تنها یک سمت اتصال از آن پشتیبانی می‌کند فراهم می‌سازد. در صورت نیاز، می‌توانید با استفاده از \fB\-\-remote\-option\fP (\fB\-M\fP) محدودیت زمانی را به سمت راه‌دور اعلام کنید. .IP نسخه \fB\-\-time\-limit\fP از این گزینه منسوخ شده است. .IP "\fB\-\-stop\-at=y-m-dTh:m\fP" این گزینه به rsync می‌گوید با رسیدن به نقطه زمانی مشخص‌شده، رونوشت‌برداری را متوقف کند. تاریخ و زمان می‌توانند به‌طور کامل در یک قالب عددی year-month-dayThour:minute (مانند 2000-12-31T23:59) در منطقه زمانی محلی مشخص شوند. می‌توانید اعداد تاریخ را به‌جای خط تیره با خط مورب (اسلش) جدا کنید. .IP مقدار همچنین می‌تواند به روش‌های گوناگون خلاصه شود، مانند مشخص کردن سال ۲ رقمی و/یا حذف مقادیر مختلف. در همه موارد، مقدار به‌عنوان نزدیک‌ترین نقطه زمانی ممکن که با اطلاعات ارائه‌شده مطابقت دارد در نظر گرفته می‌شود. اگر مقدار، زمان فعلی یا زمانی در گذشته را مشخص کند، rsync با خطا خارج می‌شود. .IP برای مثال، "1-30" تاریخ ۳۰ ژانویه بعدی (در نیمه‌شب به وقت محلی)، "14:00" ساعت ۱۴:۰۰ بعدی، "1" روز اول ماه بعدی در نیمه‌شب، "31" ماه بعدی که بتوان در روز سی‌ویکمش متوقف شد، و ":59" پنجاه و نهمین دقیقه بعدی بعد از ساعت را مشخص می‌کند. .IP برای حداکثر انعطاف‌پذیری، rsync این گزینه را به rsync راه‌دور منتقل نمی‌کند، زیرا معمولاً کافی است که یک سمت اتصال طبق دستور خارج شود. این امر امکان استفاده از گزینه را حتی زمانی که تنها یک سمت اتصال از آن پشتیبانی می‌کند فراهم می‌سازد. در صورت نیاز، می‌توانید با استفاده از \fB\-\-remote\-option\fP (\fB\-M\fP) محدودیت زمانی را به سمت راه‌دور اعلام کنید. به یاد داشته باشید که ممکن است میزبان راه‌دور منطقه زمانی پیش‌فرض متفاوتی نسبت به میزبان محلی شما داشته باشد. .IP "\fB\-\-fsync\fP" باعث می‌شود سمت گیرنده روی هر فایل تمام‌شده فراخوانی fsync انجام دهد. این امر ممکن است روند انتقال را کُند کند، اما هنگام به‌روزرسانی فایل‌های حیاتی می‌تواند موجب اطمینان خاطر شود. .IP "\fB\-\-write\-batch=FILE\fP" فایلی را ثبت می‌کند که بعداً می‌تواند با \fB\-\-read\-batch\fP روی یک مقصد یکسان دیگر اعمال شود. برای جزئیات بخش "حالت دسته‌ای (BATCH MODE)" و همچنین گزینه \fB\-\-only\-write\-batch\fP را ببینید. .IP این گزینه فهرست‌های مذاکره‌شده checksum و compress را لغو کرده و همیشه انتخابی بر پایه گزینه‌های قدیمی md5/md4/zlib را مذاکره می‌کند. این بدان معناست که حالت دسته‌ای با گزینه‌های فشرده‌سازی جدیدتر مانند zstd یا lz4 سازگار نیست. .IP "\fB\-\-only\-write\-batch=FILE\fP" مانند \fB\-\-write\-batch\fP عمل می‌کند، با این تفاوت که هنگام ایجاد بسته دسته‌ای، هیچ به‌روزرسانی روی سیستم مقصد انجام نمی‌شود. این به شما اجازه می‌دهد تغییرات را از روش‌های دیگر به سیستم مقصد منتقل کرده و سپس آن‌ها را از طریق \fB\-\-read\-batch\fP اعمال کنید. .IP توجه داشته باشید که می‌توانید دسته را مستقیماً روی یک رسانهٔ قابل‌حمل بنویسید: اگر ظرفیت این رسانه پیش از پایان انتقال پر شود، می‌توانید صرفاً همان انتقال ناقص را روی مقصد اعمال کرده و کل فرایند را برای دریافت مابقی تغییرات تکرار کنید (البته تا زمانی که با به‌روزرسانیِ ناقص سامانهٔ مقصد در حین انجام چرخهٔ چندمرحله‌ای به‌روزرسانی مشکلی نداشته باشید). .IP همچنین توجه داشته باشید که صرفه‌جویی در پهنای‌باند تنها هنگام ارسال (push) تغییرات به یک سامانهٔ راه‌دور رخ می‌دهد، چرا که این کار اجازه می‌دهد داده‌های دسته‌ای بدون نیاز به جریان روی شبکه به سمت دریافت‌کننده، از فرستنده مستقیماً به داخل پروندهٔ دسته‌ای هدایت شوند (هنگام دریافت یا pull، فرستنده در سمت راه‌دور قرار دارد و بنابراین نمی‌تواند پروندهٔ دسته‌ای را بنویسد). .IP "\fB\-\-read\-batch=FILE\fP" تمام تغییرات ذخیره‌شده در FILE را اعمال می‌کند؛ پرونده‌ای که پیش‌تر توسط \fB\-\-write\-batch\fP ایجاد شده است. اگر \fIFILE\fP برابر با \fB\-\fP باشد، داده‌های دسته‌ای از ورودی استاندارد خوانده خواهند شد. برای جزئیات بیشتر بخش «حالت دسته‌ای (BATCH MODE)» را ببینید. .IP "\fB\-\-protocol=NUM\fP" استفاده از یک نسخهٔ قدیمی‌تر پروتکل را اجباری می‌کند. این گزینه برای ایجاد یک پروندهٔ دسته‌ای که با نسخهٔ قدیمی‌تر rsync سازگار باشد کاربرد دارد. برای نمونه، اگر rsync 2.6.4 به همراه گزینهٔ \fB\-\-write\-batch\fP استفاده می‌شود، اما برای اجرای گزینهٔ \fB\-\-read\-batch\fP از rsync 2.6.3 استفاده خواهد شد، باید هنگام ایجاد پروندهٔ دسته‌ای از «\-\-protocol=28» استفاده کنید تا استفاده از نسخهٔ قدیمی‌تر پروتکل در پروندهٔ دسته‌ای اجباری شود (با این فرض که نمی‌توانید rsync را روی سامانهٔ خواننده ارتقا دهید). .IP "\fB\-\-iconv=CONVERT_SPEC\fP" ابزار rsync می‌تواند با استفاده از این گزینه، نام پرونده‌ها را بین مجموعه‌نویسه‌های مختلف تبدیل کند. استفاده از «.» به عنوان CONVERT_SPEC به rsync می‌گوید که مجموعه‌نویسهٔ پیش‌فرض را از طریق تنظیمات محلی (locale) بیابد. به‌علاوه، می‌توانید تبدیل مورد نظر را با مشخص کردن مجموعه‌نویسهٔ محلی و راه‌دور که با کاما جدا شده‌اند، به ترتیبِ \fB\-\-iconv=LOCAL,REMOTE\fP مشخص کنید، مانند \fB\-\-iconv=utf8,iso88591\fP. این ترتیب تضمین می‌کند که گزینه چه هنگام ارسال (push) و چه دریافت (pull) پرونده‌ها یکسان باقی بماند. در نهایت، می‌توانید با تعیین \fB\-\-no\-iconv\fP یا قرار دادن «\-» به عنوان CONVERT_SPEC هرگونه تبدیل را غیرفعال کنید. تنظیم پیش‌فرض این گزینه به سامانه بستگی دارد و از طریق متغیر محیطی \fBRSYNC_ICONV\fP نیز قابل تغییر است. .IP برای دریافت فهرستی از نام مجموعه‌نویسه‌هایی که کتابخانهٔ iconv محلی شما پشتیبانی می‌کند، می‌توانید دستور «\fBiconv\ \-\-list\fP» را اجرا کنید. .IP اگر گزینهٔ \fB\-\-secluded\-args\fP (\fB\-s\fP) را مشخص کنید، rsync نام پرونده‌هایی را که در خط فرمان مشخص کرده‌اید و به میزبان راه‌دور ارسال می‌شوند، تبدیل نویسه خواهد کرد. گزینهٔ \fB\-\-files\-from\fP را نیز ببینید. .IP توجه داشته باشید که rsync هیچ تبدیلی روی نام‌ها در پرونده‌های فیلتر (شامل پرونده‌های include/exclude) انجام نمی‌دهد. این بر عهدهٔ شماست که مطمئن شوید قواعدی تعیین می‌کنید که در هر دو طرف انتقال مطابقت داشته باشند. برای نمونه، اگر تفاوت‌هایی در نام پرونده‌ها در دو طرف وجود دارد که باید در نظر گرفته شوند، می‌توانید قواعد include/exclude اضافه‌ای تعیین کنید. .IP هنگامی که گزینهٔ \fB\-\-iconv\fP را به یک دیمن rsync ارسال می‌کنید که این قابلیت را مجاز می‌داند، دیمن بدون توجه به مجموعه‌نویسهٔ راه‌دوری که شما ارسال کرده‌اید، از مجموعه‌نویسهٔ مشخص‌شده در پارامتر پیکربندی «charset» خود استفاده می‌کند. بنابراین، می‌توانید برای انتقال با دیمن فقط مجموعه‌نویسهٔ محلی را مشخص کنید (مانند \fB\-\-iconv=utf8\fP). .IP "\fB\-\-ipv4\fP, \fB\-4\fP یا \fB\-\-ipv6\fP, \fB\-6\fP" به rsync اعلام می‌کند که هنگام ایجاد سوکت‌ها یا اجرای ssh، پروتکل IPv4/IPv6 را ترجیح دهد. این مورد روی سوکت‌هایی اثر می‌گذارد که rsync کنترل مستقیمی بر آن‌ها دارد؛ مانند سوکت خروجی هنگام برقراری ارتباط مستقیم با یک دیمن rsync، و همچنین ارسال گزینهٔ \fB\-4\fP یا \fB\-6\fP به ssh زمانی که rsync تشخیص می‌دهد ssh به عنوان پوستهٔ راه‌دور استفاده می‌شود. برای سایر پوسته‌های راه‌دور باید گزینهٔ «\fB\-\-rsh\ SHELL\ \-4\fP» (یا هر گزینهٔ اشاره‌گر IPv4/IPv6 دیگری که استفاده می‌کند) را مستقیماً مشخص کنید. .IP نسخهٔ مربوط به دیمن این گزینه‌ها را نیز ببینید. .IP اگر rsync بدون پشتیبانی از IPv6 کامپایل شده باشد، گزینهٔ \fB\-\-ipv6\fP بی‌اثر خواهد بود. در این صورت خروجی \fBrsync\ \-\-version\fP حاوی «\fBno\ IPv6\fP» خواهد بود. .IP "\fB\-\-checksum\-seed=NUM\fP" مقدار بذر (seed) مجموع‌وارسی را برابر با عدد صحیح NUM قرار می‌دهد. این بذر مجموع‌وارسی ۴ بایتی در محاسبهٔ مجموع‌وارسی هر بلوک و پروندهٔ MD4 گنجانده می‌شود (مجموع‌وارسی‌های جدیدتر پرونده از بذر استفاده نمی‌کنند). به طور پیش‌فرض، بذر مجموع‌وارسی توسط کارساز تولید می‌شود و پیش‌فرض آن خروجی فعلی \fBtime\fP() است. این گزینه برای تنظیم یک بذر مجموع‌وارسی مشخص استفاده می‌شود، که برای کاربردهایی که نیازمند مجموع‌وارسی بلوکی تکرارپذیر هستند یا مواردی که کاربر بذر مجموع‌وارسی تصادفی‌تری می‌خواهد، کاربرد دارد. تنظیم NUM روی ۰ باعث می‌شود rsync از مقدار پیش‌فرض \fBtime\fP() برای بذر مجموع‌وارسی استفاده کند. .P .SH "گزینه‌های دیمن (DAEMON OPTIONS)" .P گزینه‌های مجاز هنگام راه‌اندازی دیمن rsync به شرح زیر است: .P .IP "\fB\-\-daemon\fP" این گزینه به rsync اعلام می‌کند که باید به عنوان یک دیمن اجرا شود. دیمنی که راه‌اندازی می‌کنید با استفاده از کلاینت rsync و ساختار دستوری \fBhost::module\fP یا \fBrsync://host/module/\fP قابل دسترسی خواهد بود. .IP اگر ورودی استاندارد یک سوکت باشد، rsync فرض می‌کند که از طریق inetd اجرا شده است؛ در غیر این صورت از ترمینال فعلی جدا شده و به یک دیمن پس‌زمینه تبدیل می‌شود. دیمن در هر اتصال برقرار شده توسط کلاینت، فایل پیکربندی (rsyncd.conf) را می‌خواند و بر این اساس به درخواست‌ها پاسخ می‌دهد. .IP برای جزئیات بیشتر به صفحه راهنمای \fBrsyncd.conf\fP(5) مراجعه کنید. .IP "\fB\-\-address=ADDRESS\fP" به‌طور پیش‌فرض هنگامی که rsync با گزینه \fB\-\-daemon\fP به صورت دیمن اجرا می‌شود، به آدرس همه‌پذیر (wildcard) متصل می‌شود. گزینه \fB\-\-address\fP به شما اجازه می‌دهد تا یک آدرس IP مشخص (یا نام میزبان) را برای اتصال تعیین کنید. این قابلیت در ترکیب با گزینه \fB\-\-config\fP، امکان میزبانی مجازی (virtual hosting) را فراهم می‌سازد. .IP همچنین گزینه سراسری address در صفحه راهنمای rsyncd.conf و نسخه کلاینت گزینه \fB\-\-address\fP را ببینید. .IP "\fB\-\-bwlimit=RATE\fP" این گزینه به شما امکان می‌دهد حداکثر نرخ انتقال داده‌هایی را که دیمن روی سوکت ارسال می‌کند مشخص کنید. کلاینت همچنان می‌تواند مقدار \fB\-\-bwlimit\fP کمتری تعیین کند، اما مقدار بیشتر مجاز نخواهد بود. .IP برای برخی جزئیات بیشتر، نسخه کلاینت گزینه \fB\-\-bwlimit\fP را ببینید. .IP "\fB\-\-config=FILE\fP" این گزینه یک فایل پیکربندی جایگزین برای مقدار پیش‌فرض تعیین می‌کند. این گزینه تنها زمانی کاربرد دارد که \fB\-\-daemon\fP مشخص شده باشد. مقدار پیش‌فرض /etc/rsyncd.conf است مگر اینکه دیمن از طریق یک برنامه شل راه دور اجرا شود و کاربر راه دور ابرکاربر (super-user) نباشد؛ در این حالت پیش‌فرض، rsyncd.conf در دایرکتوری فعلی (معمولاً $HOME) است. .IP "\fB\-\-dparam=OVERRIDE\fP, \fB\-M\fP" این گزینه می‌تواند برای تنظیم یک پارامتر پیکربندی دیمن هنگام راه‌اندازی rsync در حالت دیمن استفاده شود. این عمل معادل افزودن پارامتر در انتهای تنظیمات سراسری پیش از تعریف اولین ماژول است. در صورت تمایل، نام‌های پارامترها را می‌توان بدون فاصله مشخص کرد. برای مثال: .RS 4 .IP .nf rsync --daemon -M pidfile=/path/rsync.pid .fi .RE .IP "\fB\-\-no\-detach\fP" هنگام اجرا به عنوان دیمن، این گزینه به rsync دستور می‌دهد که از ترمینال جدا نشده و به یک فرآیند پس‌زمینه تبدیل نشود. این گزینه هنگام اجرا به عنوان یک سرویس در Cygwin الزامی است، و همچنین ممکن است زمانی که rsync توسط برنامه‌ای مانند \fBdaemontools\fP یا \fBSystem\ Resource\ Controller\fP در AIX نظارت می‌شود مفید باشد. همچنین اجرای \fB\-\-no\-detach\fP زمانی که rsync تحت یک دیباگر اجرا می‌شود توصیه می‌شود. این گزینه در صورتی که rsync از inetd یا sshd اجرا شود هیچ تاثیری ندارد. .IP "\fB\-\-port=PORT\fP" این گزینه یک شماره پورت TCP جایگزین به جای پورت پیش‌فرض 873 برای گوش دادن دیمن تعیین می‌کند. .IP همچنین نسخه کلاینت گزینه \fB\-\-port\fP و تنظیم سراسری port در صفحه راهنمای rsyncd.conf را ببینید. .IP "\fB\-\-log\-file=FILE\fP" این گزینه به دیمن rsync اعلام می‌کند که به جای استفاده از تنظیم "\fBlog\ file\fP" در فایل پیکربندی، از نام فایل لاگ داده شده استفاده کند. .IP همچنین نسخه کلاینت گزینه \fB\-\-log\-file\fP را ببینید. .IP "\fB\-\-log\-file\-format=FORMAT\fP" این گزینه به دیمن rsync اعلام می‌کند که به جای استفاده از تنظیم "\fBlog\ format\fP" در فایل پیکربندی، از رشته FORMAT داده شده استفاده کند. همچنین این گزینه "\fBtransfer\ logging\fP" را فعال می‌کند مگر اینکه رشته خالی باشد، که در این صورت لاگ‌گیری انتقال خاموش می‌شود. .IP همچنین به نسخه کلاینت گزینه \fB\-\-log\-file\-format\fP مراجعه کنید. .IP "\fB\-\-sockopts\fP" این گزینه تنظیم \fBsocket\ options\fP را در فایل rsyncd.conf بازنویسی می‌کند و دارای ساختار نحوی مشابهی است. .IP همچنین به نسخه کلاینت گزینه \fB\-\-sockopts\fP مراجعه کنید. .IP "\fB\-\-verbose\fP, \fB\-v\fP" این گزینه مقدار اطلاعاتی را که دیمن در طول مرحله راه‌اندازی ثبت می‌کند افزایش می‌دهد. پس از اتصال کلاینت، سطح پرگویی (verbosity) دیمن توسط گزینه‌های مورد استفاده کلاینت و تنظیم "\fBmax\ verbosity\fP" در بخش پیکربندی ماژول کنترل خواهد شد. .IP همچنین به نسخه کلاینت گزینه \fB\-\-verbose\fP مراجعه کنید. .IP "\fB\-\-ipv4\fP, \fB\-4\fP or \fB\-\-ipv6\fP, \fB\-6\fP" به rsync اعلام می‌کند که هنگام ایجاد سوکت‌های ورودی که دیمن rsync برای شنود اتصالات استفاده می‌کند، IPv4/IPv6 را ترجیح دهد. یکی از این گزینه‌ها ممکن است در نسخه‌های قدیمی‌تر لینوکس برای دور زدن یک باگ IPv6 در هسته مورد نیاز باشد (اگر خطای "address already in use" را در شرایطی که هیچ چیز دیگری از پورت استفاده نمی‌کند مشاهده کردید، مشخص کردن \fB\-\-ipv6\fP یا \fB\-\-ipv4\fP را هنگام شروع دیمن امتحان کنید). .IP همچنین به نسخه کلاینت این گزینه‌ها مراجعه کنید. .IP اگر rsync بدون پشتیبانی از IPv6 کامپایل شده باشد، گزینه \fB\-\-ipv6\fP هیچ اثری نخواهد داشت. خروجی \fBrsync\ \-\-version\fP در این حالت شامل "\fBno\ IPv6\fP" خواهد بود. .IP "\fB\-\-help\fP, \fB\-h\fP" هنگامی که پس از \fB\-\-daemon\fP مشخص شود، صفحه راهنمای کوتاهی را چاپ می‌کند که گزینه‌های موجود برای راه‌اندازی دیمن rsync را توصیف می‌کند. .P .SH "قواعد فیلتر (FILTER RULES)" .P قواعد فیلتر امکان کنترل سفارشی جنبه‌های مختلف نحوه مدیریت فایل‌ها را فراهم می‌کنند: .P .IP o کنترل اینکه طرف ارسال‌کننده چه فایل‌هایی را در فهرست فایلی که سلسله‌مراتب انتقال را توصیف می‌کند، قرار دهد .IP o کنترل اینکه وقتی فایل در فهرست فایل‌های ارسال‌کننده نیست، طرف دریافت‌کننده از حذف چه فایل‌هایی محافظت کند .IP o کنترل اینکه هنگام کپی کردن xattrs، کدام نام‌های ویژگی‌های گسترش‌یافته نادیده گرفته شوند .P این قواعد یا مستقیماً از طریق آرگومان‌های گزینه‌ها مشخص می‌شوند یا می‌توان آن‌ها را از یک یا چند فایل خواند. فایل‌های قواعد فیلتر حتی می‌توانند بخشی از ساختار سلسله‌مراتبی فایل‌های در حال رونوشت باشند و بخش‌های مختلف درخت را به روش‌های متفاوتی تحت تأثیر قرار دهند. .P .SS "قواعد ساده INCLUDE/EXCLUDE (SIMPLE INCLUDE/EXCLUDE RULES)" .P ابتدا مبانی چگونگی تأثیر قواعد include و exclude بر فایل‌های منتقل‌شده را بدون در نظر گرفتن اثرات جانبی حذف پوشش خواهیم داد. قواعد فیلتر عمدتاً محتویات دایرکتوری‌هایی را که rsync به صورت بازگشتی وارد آن‌ها می‌شود تحت تأثیر قرار می‌دهند، اما می‌توانند بر روی آیتم‌های سطح بالا در انتقال که به عنوان آرگومان مشخص شده‌اند نیز تأثیر بگذارند. .P حالت پیش‌فرض برای هر فایل/دایرکتوری بدون تطابق این است که در انتقال گنجانده شود، که فایل/دایرکتوری را در فهرست فایل‌های ارسال‌کننده قرار می‌دهد. استفاده از قاعده exclude باعث می‌شود یک یا چند فایل/دایرکتوری منطبق از فهرست فایل‌های فرستنده کنار گذاشته شوند. از یک قاعده include می‌توان برای محدود کردن اثر یک قاعده exclude که با فایل‌های بسیار زیادی تطابق دارد استفاده کرد. .P ترتیب قواعد مهم است زیرا نخستین قاعده‌ای که مطابقت پیدا کند اعمال می‌شود. بنابراین، اگر قاعده‌ای پیشین یک فایل را مستثنی کند، هیچ قاعده include بعد از آن اثری نخواهد داشت. این بدان معناست که شما باید هر بازنویسی include را در نقطه‌ای پیش از قاعده exclude که قصد محدود کردن آن را دارد قرار دهید. .P وقتی یک پوشه مستثنی (exclude) می‌شود، تمام محتویات و زیرمجموعه‌های آن نیز مستثنی می‌شوند. ارسال‌کننده اصلاً درون آن را پیمایش نمی‌کند، که این امر هنگام نادیده گرفتن زیردرخت‌های بزرگ و غیرضروری می‌تواند زمان زیادی را ذخیره کند. .P همچنین مهم است درک کنید که قواعد گنجاندن/استثنا کردن (include/exclude) روی هر فایل و دایرکتوری که فرستنده به صورت بازگشتی وارد آن می‌شود، اعمال می‌شوند. بنابراین، اگر می‌خواهید یک فایل خاص در عمق مسیر گنجانده شود، باید مطمئن شوید هیچ‌یک از دایرکتوری‌هایی که در مسیر رسیدن به آن فایل باید پیمایش شوند استثنا نشده باشند، وگرنه فایل هرگز برای گنجانده شدن پیدا نخواهد شد. به عنوان مثال، اگر دایرکتوری "\fBa/path\fP" به عنوان آرگومان انتقال داده شده باشد و بخواهید مطمئن شوید که فایل "\fBa/path/down/deep/wanted.txt\fP" بخشی از انتقال است، فرستنده نباید در هنگام پیمایش درخت فایل، دایرکتوری‌های "\fBa/path\fP"، "\fBa/path/down\fP" یا "\fBa/path/down/deep\fP" را استثنا کند. .P هنگامی که روی قواعد کار می‌کنید، می‌تواند مفید باشد که از rsync بخواهید به شما بگوید چه چیزی و به چه دلیلی استثنا یا گنجانده می‌شود. مشخص کردن \fB\-\-debug=FILTER\fP یا (هنگام دریافت فایل‌ها) \fB\-M\-\-debug=FILTER\fP سطح ۱ از اطلاعات اشکال‌زدایی FILTER را فعال می‌کند که در صورت گنجانده شدن یا استثنا شدن هر فایل یا دایرکتوری، پیامی به همراه قاعده‌ای که با آن تطابق یافته چاپ می‌کند. از نسخه 3.2.4 به بعد، این گزینه همچنین در صورت وجود نویسه فاصله در انتهای یک قاعده فیلتر هشدار می‌دهد، چرا که استثنا کردن "foo\ " (با یک فاصله در انتها) فایلی با نام "foo" را استثنا نخواهد کرد. .P قواعد استثنا و گنجاندن می‌توانند از «قواعد تطبیق الگو» (PATTERN MATCHING RULES) با نویسه‌های عام (مشابه نویسه‌های عام شل) استفاده کنند که به شما اجازه می‌دهد مواردی مانند پسوند فایل یا بخشی از نام فایل را تطبیق دهید. .P یک قاعده می‌تواند تنها با قرار دادن یک اسلش در انتهای نام فایل، فقط بر یک دایرکتوری اثر بگذارد. .P .SS "مثال ساده گنجاندن/استثنا کردن (SIMPLE INCLUDE/EXCLUDE EXAMPLE)" .P با فرض وجود درخت فایل زیر در سمت فرستنده: .RS 4 .P .nf mkdir x/ touch x/file.txt mkdir x/y/ touch x/y/file.txt touch x/y/zzz.txt mkdir x/z/ touch x/z/file.txt .fi .RE .P سپس دستور rsync زیر فایل "\fBx/y/file.txt\fP" و دایرکتوری‌های مورد نیاز برای نگهداری آن را منتقل خواهد کرد که نتیجه آن ایجاد مسیر "\fB/tmp/x/y/file.txt\fP" روی میزبان راه‌دور است: .RS 4 .P .nf rsync -ai -f'+ x/' -f'+ x/y/' -f'+ x/y/file.txt' -f'- *' x host:/tmp/ .fi .RE .P نکته جانبی: این رونوشت می‌توانست با استفاده از گزینه \fB\-R\fP نیز انجام شود (اگرچه این ۲ دستور در صورت فعال بودن حذف، رفتار متفاوتی دارند): .RS 4 .P .nf rsync -aiR x/y/file.txt host:/tmp/ .fi .RE .P دستور زیر نیازی به گنجاندن دایرکتوری "x" ندارد زیرا بخشی از انتقال نیست (به اسلش پایانی دقت کنید). اجرای این دستور تنها "\fB/tmp/x/file.txt\fP" را کپی می‌کند زیرا دایرکتوری‌های "y" و "z" استثنا می‌شوند: .RS 4 .P .nf rsync -ai -f'+ file.txt' -f'- *' x/ host:/tmp/x/ .fi .RE .P این دستور پروندهٔ zzz.txt را هنگام رونوشت از «x» و هر آنچه درون آن است نادیده می‌گیرد: .RS 4 .P .nf rsync -ai -f'- zzz.txt' x host:/tmp/ .fi .RE .P .SS "قواعد فیلتر هنگام حذف (FILTER RULES WHEN DELETING)" .P به‌طور پیش‌فرض، قواعد فیلتر include و exclude هم بر فرستنده (هنگام ایجاد فهرست پرونده‌هایش) و هم بر گیرنده (هنگام ایجاد فهرست پرونده‌ها برای محاسبهٔ موارد حذفی) اثر می‌گذارند. اگر هیچ گزینهٔ حذفی فعال نباشد، گیرنده از ایجاد فهرست‌های پروندهٔ مربوط به حذف صرف‌نظر می‌کند. این پیش‌فرض دوطرفه می‌تواند به‌صورت دستی لغو شود تا تنها قواعد فرستنده یا قواعد گیرنده را تعیین کنید، همان‌طور که در بخش FILTER RULES IN DEPTH توضیح داده شده است. .P هنگام حذف، یک exclude پرونده را در سمت گیرنده از حذف‌شدن محافظت می‌کند، در حالی که یک include این محافظت را لغو می‌کند (و پرونده را در معرض خطر حذف قرار می‌دهد). حالت پیش‌فرض این است که پرونده در معرض خطر باشد\ \-\- امنیت آن به تطابق با پرونده‌ای متناظر از فرستنده بستگی دارد. .P نمونه‌ای از اثر دوطرفهٔ exclude را می‌توان با رونوشت یک دایرکتوری توسعهٔ C میان ۲ سیستم نشان داد. هنگام انجام یک رونوشت تکمیلی، ممکن است بخواهید از رونوشت پروندهٔ اجرایی ساخته‌شده و پرونده‌های \fB.o\fP صرف‌نظر کنید (پنهان‌سازی فرستنده) تا سمت گیرنده بتواند پرونده‌های خودش را بسازد و هیچ پروندهٔ شیء (object file) که از قبل درست است را از دست ندهد (محافظت گیرنده). برای نمونه: .RS 4 .P .nf rsync -ai --del -f'- *.o' -f'- cmd' src host:/dest/ .fi .RE .P توجه داشته باشید که استفاده از \fB\-f'\-p\ *.o'\fP حتی بهتر از \fB\-f'\-\ *.o'\fP است اگر این احتمال وجود داشته باشد که ساختار دایرکتوری تغییر کرده باشد. اصلاح‌کنندهٔ «p» در FILTER RULE MODIFIERS بررسی شده است. .P یک نکتهٔ پایانی، اگر پوستهٔ شما با نویسه‌های عام (wildcard) بازنشده مشکلی ندارد، می‌توانید نوشتن گزینه‌های فیلتر را با استفاده از زیرخط به‌جای فاصله و حذف نقل‌قول‌ها ساده‌تر کنید. برای نمونه، می‌توان از \fB\-f\ \-_*.o\ \-f\ \-_cmd\fP (و موارد مشابه) به‌جای گزینه‌های فیلتر بالا استفاده کرد. .P .SS "بررسی دقیق قواعد فیلتر (FILTER RULES IN DEPTH)" .P برنامهٔ rsync از قواعد سبک قدیمی include/exclude و قواعد سبک جدید فیلتر پشتیبانی می‌کند. قواعد قدیمی‌تر با استفاده از \fB\-\-include\fP و \fB\-\-exclude\fP و همچنین \fB\-\-include\-from\fP و \fB\-\-exclude\-from\fP مشخص می‌شوند. این‌ها در رفتار محدود هستند اما نیازی به پیشوند «\-» یا «+» ندارند. یک قاعدهٔ exclude سبک قدیمی به یک قاعدهٔ فیلتر «\fB\-\ name\fP» (بدون اصلاح‌کننده) تبدیل می‌شود و یک قاعدهٔ include سبک قدیمی به یک قاعدهٔ فیلتر «\fB+\ name\fP» (بدون اصلاح‌کننده) تبدیل می‌گردد. .P برنامهٔ rsync فهرستی مرتب‌شده از قواعد فیلتر را همان‌طور که در خط فرمان مشخص شده و/یا از پرونده‌ها خوانده شده است، ایجاد می‌کند. قواعد فیلتر سبک جدید نحو زیر را دارند: .RS 4 .P .nf RULE [PATTERN_OR_FILENAME] RULE,MODIFIERS [PATTERN_OR_FILENAME] .fi .RE .P شما می‌توانید نام‌های کوتاه یا بلند RULE را مطابق شرح زیر انتخاب کنید. اگر از قاعده با نام کوتاه استفاده کنید، نویسهٔ «,» که RULE را از MODIFIERS جدا می‌کند اختیاری است. عبارت PATTERN یا FILENAME پس از آن (در صورت وجود) باید پس از یک فاصله یا یک زیرخط (_) قرار گیرد. هرگونه فاصله و/یا زیرخط اضافی بخشی از نام الگو در نظر گرفته می‌شود. در اینجا پیشوندهای موجود برای قواعد آورده شده است: .P .IP "\fBexclude,\ '\-'\fP" الگوی استثنا (exclude) را مشخص می‌کند که (به‌طور پیش‌فرض) هم \fBhide\fP و هم \fBprotect\fP است. .IP "\fBinclude,\ '+'\fP" الگوی شمول (include) را مشخص می‌کند که (به‌طور پیش‌فرض) هم \fBshow\fP و هم \fBrisk\fP است. .IP "\fBmerge,\ '.'\fP" یک merge-file را در سمت کلاینت برای خواندن قواعد بیشتر مشخص می‌کند. .IP "\fBdir-merge,\ ':'\fP" یک merge-file به ازای هر دایرکتوری را مشخص می‌کند. استفاده از این نوع قاعده فیلتر مستلزم اعتماد به بررسی فیلتر در سمت فرستنده است، بنابراین اثر جانبی ذکر شده ذیل گزینه \fB\-\-trust\-sender\fP را به همراه دارد. .IP "\fBhide,\ 'H'\fP" الگویی را برای پنهان کردن فایل‌ها از انتقال مشخص می‌کند. معادل با یک استثنای فقط-فرستنده است، بنابراین \fB\-f'H\ foo'\fP می‌تواند به‌صورت \fB\-f'\-s\ foo'\fP نیز مشخص شود. .IP "\fBshow,\ 'S'\fP" فایل‌هایی که با الگو مطابقت دارند پنهان نمی‌شوند. معادل با یک شمول فقط-فرستنده است، بنابراین \fB\-f'S\ foo'\fP می‌تواند به‌صورت \fB\-f'+s\ foo'\fP نیز مشخص شود. .IP "\fBprotect,\ 'P'\fP" الگویی را برای محافظت فایل‌ها از حذف شدن مشخص می‌کند. معادل با یک استثنای فقط-گیرنده است، بنابراین \fB\-f'P\ foo'\fP می‌تواند به‌صورت \fB\-f'\-r\ foo'\fP نیز مشخص شود. .IP "\fBrisk,\ 'R'\fP" فایل‌هایی که با الگو مطابقت دارند محافظت نمی‌شوند. معادل با یک شمول فقط-گیرنده است، بنابراین \fB\-f'R\ foo'\fP می‌تواند به‌صورت \fB\-f'+r\ foo'\fP نیز مشخص شود. .IP "\fBclear,\ '!'\fP" فهرست شمول/استثنای (include/exclude) فعلی را پاک می‌کند (هیچ آرگومانی نمی‌گیرد) .P هنگامی که قواعد از یک فایل خوانده می‌شوند (با استفاده از merge یا dir-merge)، خطوط خالی و همچنین خطوط کامنت که با '\fB#\fP' شروع می‌شوند نادیده گرفته می‌شوند (قواعد نام فایلی که شامل نویسه هش هستند تحت تأثیر قرار نمی‌گیرند). .P همچنین توجه داشته باشید که گزینه‌های \fB\-\-filter\fP، \fB\-\-include\fP و \fB\-\-exclude\fP هر کدام یک قاعده/الگو می‌پذیرند. برای افزودن چندین مورد، می‌توانید گزینه‌ها را در خط فرمان تکرار کنید، از نحو merge-file در گزینه \fB\-\-filter\fP استفاده کنید، یا از گزینه‌های \fB\-\-include\-from\fP / \fB\-\-exclude\-from\fP بهره ببرید. .P .SS "قواعد تطبیق الگو (PATTERN MATCHING RULES)" .P بیشتر قواعد ذکر شده در بالا آرگومانی دریافت می‌کنند که مشخص می‌کند قاعده باید با چه چیزی تطبیق داده شود. اگر rsync در حال پیمایش بازگشتی در سلسله‌مراتب پوشه‌ها باشد، به یاد داشته باشید که هم‌زمان با یافتن نام فایل‌ها برای ارسال، هر الگو با نام تک‌تک پوشه‌ها در مسیر پیمایش تطبیق داده می‌شود. .P قواعد تطبیق برای آرگومان الگو به چند شکل است: .P .IP o اگر یک الگو شامل \fB/\fP (بدون در نظر گرفتن اسلش پایانی) یا "\fB**\fP" (که می‌تواند با اسلش تطبیق یابد) باشد، آنگاه الگو با کل مسیر فایل، شامل تمام پوشه‌های والد درون انتقال، تطبیق داده می‌شود. اگر الگو شامل \fB/\fP (غیر پایانی) یا "\fB**\fP" نباشد، تنها با بخش پایانی نام فایل یا مسیر تطبیق داده می‌شود. برای مثال، \fBfoo\fP بدین معناست که مؤلفه پایانی مسیر باید "foo" باشد در حالی که \fBfoo/bar\fP با ۲ عنصر پایانی مسیر تطبیق می‌یابد (تا زمانی که هر دو عنصر درون انتقال باشند). .IP o الگویی که به یک \fB/\fP ختم می‌شود تنها با یک دایرکتوری تطبیق می‌یابد، نه با یک فایل معمولی، پیوند نمادین (symlink) یا دستگاه (device). .IP o الگویی که با یک \fB/\fP شروع می‌شود، به جای انتهای مسیر انتقال، به ابتدای آن متصل (anchor) می‌شود. برای مثال، \fB/foo/**\fP یا \fB/foo/bar/**\fP فقط با مؤلفه‌های ابتدایی مسیر تطبیق می‌یابند. اگر قاعده از یک فایل فیلتر به ازای هر دایرکتوری خوانده شود، مسیر انتقال مورد تطبیق، به جای بالاترین سطح انتقال، از سطح همان فایل فیلتر شروع خواهد شد. برای توضیحات کامل در مورد نحوه مشخص کردن الگویی که با ریشه انتقال تطبیق یابد، بخش ANCHORING INCLUDE/EXCLUDE PATTERNS را ببینید. .P ابزار rsync بین تطبیق رشته‌ای ساده و تطبیق با نویسه‌های عام (wildcard) بر اساس وجود یکی از این سه نویسه عام در الگو تصمیم می‌گیرد: '\fB*\fP'، \&'\fB?\fP' و '\fB[\fP' : .P .IP o یک '\fB?\fP' با هر تک‌نویسه‌ای به‌جز اسلش (\fB/\fP) مطابقت دارد. .IP o یک '\fB*\fP' با صفر یا چند نویسه غیر از اسلش مطابقت دارد. .IP o یک '\fB**\fP' با صفر یا چند نویسه، شامل اسلش‌ها، مطابقت دارد. .IP o یک '\fB[\fP' رده‌ای از نویسه‌ها مانند \fB[a-z]\fP یا \fB[[:alpha:]]\fP را معرفی می‌کند که باید با یک نویسه مطابقت داشته باشد. .IP o یک \fB***\fP در انتهای الگو، روش کوتاهی است که به شما امکان می‌دهد با یک قاعده منفرد، یک پوشه و تمام محتویات آن را مطابقت دهید. برای مثال، مشخص کردن «\fBdir_name/***\fP» هم با پوشه «dir_name» (مانند حالتی که «\fBdir_name/\fP» مشخص شده باشد) و هم با همه موارد درون پوشه (مانند حالتی که «\fBdir_name/**\fP» مشخص شده باشد) مطابقت می‌یابد. .IP o می‌توان از بک‌اسلش برای گریز (escape) دادن یک نویسه عام استفاده کرد، اما بک‌اسلش تنها زمانی به عنوان نویسه گریز تفسیر می‌شود که حداقل یک نویسه عام در الگوی تطبیق وجود داشته باشد. برای نمونه، الگوی «\fBfoo\\bar\fP» با همان تک‌بک‌اسلش به‌صورت لفظی مطابقت می‌یابد، در حالی که الگوی «\fBfoo\\bar*\fP» باید به «\fBfoo\\\\bar*\fP» تغییر داده شود تا از تبدیل «\fB\\b\fP» به تنها «b» جلوگیری شود. .P در اینجا چند مثال از تطبیق شامل‌سازی/مستثنی‌سازی (exclude/include) آورده شده است: .P .IP o گزینه \fB\-f'\-\ *.o'\fP تمام نام‌های پرونده که به \fB.o\fP ختم می‌شوند را مستثنی می‌کند .IP o گزینه \fB\-f'\-\ /foo'\fP یک پرونده (یا پوشه) به نام foo را در پوشه ریشه انتقال مستثنی می‌کند .IP o گزینه \fB\-f'\-\ foo/'\fP هر پوشه‌ای به نام foo را مستثنی می‌کند .IP o گزینه \fB\-f'\-\ foo/*/bar'\fP هر پرونده/پوشه‌ای به نام bar را که در دو سطح پایین‌تر از پوشه‌ای به نام foo قرار دارد مستثنی می‌کند (در صورتی که foo در انتقال باشد) .IP o گزینه \fB\-f'\-\ /foo/**/bar'\fP هر پرونده/پوشه‌ای به نام bar را که در دو سطح یا بیشتر زیر یک پوشه سطح‌بالا به نام foo باشد مستثنی می‌کند (توجه داشته باشید که /foo/bar با این قاعده مستثنی \fBنمی‌شود\fP) .IP o گزینه‌های \fB\-f'+\ */'\ \-f'+\ *.c'\ \-f'\-\ *'\fP تمام پوشه‌ها و پرونده‌های منبع .c را شامل می‌شوند و نه هیچ چیز دیگری .IP o گزینه‌های \fB\-f'+\ foo/'\ \-f'+\ foo/bar.c'\ \-f'\-\ *'\fP تنها پوشه foo و foo/bar.c را شامل می‌شوند (پوشه foo باید به‌طور صریح شامل شود وگرنه توسط «\fB\-\ *\fP» مستثنی خواهد شد) .P .SS "اصلاح‌کننده‌های قواعد فیلتر (FILTER RULE MODIFIERS)" .P اصلاح‌کننده‌های زیر پس از یک قاعده شامل‌سازی (+) یا مستثنی‌سازی (\-) پذیرفته می‌شوند: .P .IP o یک \fB/\fP مشخص می‌کند که قاعده شامل‌سازی/مستثنی‌سازی باید در برابر مسیر مطلق آیتم جاری مطابقت داده شود. برای مثال، \fB\-f'\-/\ /etc/passwd'\fP پرونده passwd را در هر زمانی که انتقال در حال ارسال پرونده‌ها از پوشه "/etc" باشد مستثنی می‌کند، و "\-/ subdir/foo" همیشه "foo" را زمانی که درون پوشه‌ای به نام "subdir" باشد مستثنی خواهد کرد، حتی اگر "foo" در ریشه انتقال جاری باشد. .IP o یک \fB!\fP مشخص می‌کند که شامل‌سازی/مستثنی‌سازی باید در صورت عدم تطابق الگو اعمال شود. برای نمونه، \fB\-f'\-!\ */'\fP تمام موارد غیرپوشه را مستثنی می‌کند. .IP o یک \fBC\fP نشان می‌دهد که تمام قواعد سراسری CVS-exclude باید به جای «\-C» به عنوان موارد مستثنی‌شده درج شوند. هیچ آرگومانی نباید به دنبال آن بیاید. .IP o یک \fBs\fP برای نشان دادن این موضوع استفاده می‌شود که قاعده روی سمت ارسال‌کننده اعمال می‌شود. هنگامی که یک قاعده سمت ارسال‌کننده را تحت تأثیر قرار می‌دهد، بر این که چه پرونده‌هایی در فهرست پرونده‌های ارسال‌کننده قرار می‌گیرند اثر می‌گذارد. حالت پیش‌فرض این است که قاعده بر هر دو سمت اثر بگذارد مگر اینکه \fB\-\-delete\-excluded\fP مشخص شده باشد، که در این صورت قواعد پیش‌فرض تنها مختص سمت ارسال‌کننده می‌شوند. همچنین قواعد hide (H) و show (S) را ببینید که روشی جایگزین برای تعیین شامل‌سازی‌ها/مستثنی‌سازی‌های سمت ارسال‌کننده هستند. .IP o یک \fBr\fP برای نشان دادن اعمال قاعده بر سمت دریافت‌کننده استفاده می‌شود. وقتی قاعده‌ای بر سمت دریافت‌کننده اثر می‌گذارد، از حذف پرونده‌ها جلوگیری می‌کند. برای اطلاعات بیشتر تغییردهنده \fBs\fP را ببینید. همچنین قواعد protect (P) و risk (R) را ببینید که روشی جایگزین برای تعیین include/exclude در سمت دریافت‌کننده هستند. .IP o یک \fBp\fP نشان می‌دهد که قاعده فناپذیر (perishable) است، به این معنی که در دایرکتوری‌های در حال حذف نادیده گرفته می‌شود. به عنوان مثال، قواعد پیش‌فرض گزینه \fB\-\-cvs\-exclude\fP (\fB\-C\fP) که مواردی مانند \(dqCVS\(dq و \(dq\fB*.o\fP\(dq را مستثنی می‌کنند، به عنوان فناپذیر علامت‌گذاری شده‌اند و مانع از حذف دایرکتوری حذف‌شده در مبدأ، در مقصد نخواهند شد. .IP o یک \fBx\fP نشان می‌دهد که یک قاعده بر نام‌های xattr در عملیات کپی/حذف xattr اثر می‌گذارد (و بنابراین هنگام تطبیق نام‌های پرونده/دایرکتوری نادیده گرفته می‌شود). اگر هیچ قاعده تطبیق xattr مشخص نشده باشد، یک قاعده فیلتر پیش‌فرض xattr استفاده می‌شود (گزینه \fB\-\-xattrs\fP را ببینید). .P .SS "قواعد فیلتر پرونده ادغامی (MERGE-FILE FILTER RULES)" .P می‌توانید با مشخص کردن یک قاعده فیلتر merge (.) یا dir-merge (:) تمام پرونده‌ها را در قواعد فیلتر خود ادغام کنید (همان‌طور که در بخش قواعد فیلتر (FILTER RULES) در بالا معرفی شد). .P دو نوع پرونده ادغام‌شده وجود دارد\ \-\- تک‌نمونه ('.') و به‌ازای-دایرکتوری (':'). پرونده ادغام تک‌نمونه یک بار خوانده می‌شود و قواعد آن به‌جای قاعده \(dq.\(dq در فهرست فیلتر گنجانده می‌شوند. برای پرونده‌های ادغام به‌ازای-دایرکتوری، rsync هر دایرکتوری را که می‌پیماید برای پرونده نام‌برده بررسی کرده و در صورت وجود پرونده، محتویات آن را در فهرست فعلی قواعد به ارث رسیده ادغام می‌کند. این پرونده‌های قواعد به‌ازای-دایرکتوری باید در سمت فرستنده ایجاد شوند، زیرا سمت فرستنده است که برای پرونده‌های موجود جهت انتقال پیمایش می‌شود. اگر بخواهید این پرونده‌ها بر حذف نشدن فایل‌ها اثر بگذارند، ممکن است نیاز به انتقال آن‌ها به سمت دریافت‌کننده نیز باشد (بخش PER-DIRECTORY RULES AND DELETE را در ادامه ببینید). .P چند مثال: .RS 4 .P .nf merge /etc/rsync/default.rules \&. /etc/rsync/default.rules dir-merge .per-dir-filter dir-merge,n- .non-inherited-per-dir-excludes :n- .non-inherited-per-dir-excludes .fi .RE .P تغییردهنده‌های زیر پس از قاعده merge یا dir-merge پذیرفته می‌شوند: .P .IP o یک \fB\-\fP مشخص می‌کند که پرونده باید فقط شامل الگوهای exclude باشد، بدون تجزیه هیچ قاعده دیگری به جز کامنت‌های درون پرونده. .IP o یک \fB+\fP مشخص می‌کند که پرونده باید فقط شامل الگوهای include باشد، بدون تجزیه هیچ قاعده دیگری به جز کامنت‌های درون پرونده. .IP o یک \fBC\fP روشی برای تعیین خوانده شدن پرونده به شیوه سازگار با CVS است. این حالت 'n' ،'w' و '\-' را فعال می‌کند، اما امکان مشخص کردن توکن پاک‌سازی فهرست (!) را نیز فراهم می‌سازد. اگر نام پرونده‌ای ارائه نشود، \(dq.cvsignore\(dq فرض می‌شود. .IP o یک \fBe\fP نام پرونده ادغامی را از انتقال مستثنی می‌کند؛ مثلاً \(dqdir-merge,e .rules\(dq مانند \(dqdir-merge .rules\(dq و \(dq\- .rules\(dq عمل می‌کند. .IP o یک \fBn\fP مشخص می‌کند که قواعد توسط زیردایرکتوری‌ها به ارث برده نمی‌شوند. .IP o یک \fBw\fP مشخص می‌کند که قواعد به‌جای تفکیک سطری معمول، بر اساس فاصله خالی (whitespace) به کلمات تفکیک شوند. این حالت همچنین کامنت‌ها را غیرفعال می‌کند. نکته: با فاصله‌ای که پیشوند را از قاعده جدا می‌کند به‌طور ویژه رفتار می‌شود، بنابراین \(dq\- foo + bar\(dq به عنوان دو قاعده تجزیه می‌شود (با فرض اینکه تجزیه پیشوند نیز غیرفعال نشده باشد). .IP o همچنین می‌توانید هر یک از تغییردهنده‌های قواعد «+» یا «\-» (در بالا) را مشخص کنید تا قواعدی که از پرونده خوانده می‌شوند به‌طور پیش‌فرض آن تغییردهنده را داشته باشند (به جز تغییردهنده \fB!\fP که کاربردی ندارد). برای نمونه، \(dqmerge,\-/ .excl\(dq محتوای .excl را به عنوان استثناهای مسیر مطلق در نظر می‌گیرد، در حالی که \(dqdir-merge,s .filt\(dq و \(dq:sC\(dq هر کدام باعث می‌شوند تمام قواعد بر-پوشه (per-directory) آن‌ها تنها در سمت ارسال‌کننده اعمال شوند. اگر قاعده ادغام، سمت‌های تحت تأثیر را مشخص کند (از طریق تغییردهنده \fBs\fP یا \fBr\fP یا هر دو)، آنگاه قواعد درون پرونده نباید سمت‌ها را مشخص کنند (از طریق تغییردهنده یا پیشوند قاعده مانند \fBhide\fP). .P قواعد بر-پوشه در تمام زیرپوشه‌های پوشه‌ای که پرونده ادغام در آن پیدا شده به ارث می‌رسند، مگر اینکه از تغییردهنده \(aqn\(aq استفاده شده باشد. قواعد هر زیرپوشه به عنوان پیشوند به قواعد بر-پوشه به ارث رسیده از والدین اضافه می‌شوند، که به قواعد جدیدتر اولویت بالاتری نسبت به قواعد ارث‌بری‌شده می‌دهد. کل مجموعه قواعد dir-merge در همان نقطه‌ای که پرونده ادغام مشخص شده گروه‌بندی می‌شوند، بنابراین می‌توان قواعد dir-merge را با قاعده‌ای که پیش‌تر در فهرست قواعد سراسری مشخص شده لغو و بازنویسی کرد. هنگامی که قاعده پاک‌سازی فهرست (\(dq!\(dq) از یک پرونده بر-پوشه خوانده می‌شود، تنها قواعد ارث‌بری‌شده برای پرونده ادغام فعلی را پاک می‌کند. .P راه دیگر برای جلوگیری از به ارث رسیدن یک قاعده منفرد از پرونده dir-merge، مهار کردن (anchor) آن با یک اسلش ابتدایی است. قواعد مهارشده در یک پرونده ادغام بر-پوشه نسبت به پوشه همان پرونده ادغام سنجیده می‌شوند، بنابراین الگوی \(dq/foo\(dq تنها با پرونده \(dqfoo\(dq در همان پوشه‌ای که پرونده فیلتر dir-merge در آن یافت شده مطابقت می‌یابد. .P در اینجا نمونه‌ای از یک پرونده فیلتر آورده شده که می‌توانید از طریق \fB\-\-filter=".\ file"\fP مشخص کنید: .RS 4 .P .nf merge /home/user/.global-filter - *.gz dir-merge .rules + *.[ch] - *.o - foo* .fi .RE .P این ساختار محتوای پرونده /home/user/.global-filter را در ابتدای فهرست ادغام کرده و همچنین نام پرونده \(dq.rules\(dq را به یک پرونده فیلتر بر-پوشه تبدیل می‌کند. تمامی قواعدی که پیش از آغاز پویش پوشه خوانده شوند، از قواعد مهار سراسری پیروی می‌کنند (یعنی یک اسلش ابتدایی با ریشه انتقال مطابقت می‌یابد). .P اگر یک پرونده ادغام بر-پوشه با مسیری مشخص شود که پوشه والد اولین پوشه انتقال است، rsync تمام پوشه‌های والد را از آن نقطه آغازین تا پوشه انتقال برای یافتن پرونده بر-پوشه مشخص‌شده می‌پوید. برای نمونه، این یک فیلتر رایج است (به \fB\-F\fP مراجعه کنید): .RS 4 .P .nf --filter=': /.rsync-filter' .fi .RE .P این قاعده به rsync می‌گوید که پیش از شروع پویش عادی پوشه برای پرونده‌هایی در پوشه‌ها که به عنوان بخشی از فرایند انتقال فرستاده می‌شوند، به دنبال پرونده .rsync-filter در تمام پوشه‌ها از ریشه به سمت پایین تا پوشه والد انتقال بگردد. (نکته: برای یک دیمن rsync، ریشه همیشه همان \(dqpath\(dq ماژول است.) .P چند نمونه از این پیش‌پویش برای پرونده‌های بر-پوشه: .RS 4 .P .nf rsync -avF /src/path/ /dest/dir rsync -av --filter=': ../../.rsync-filter' /src/path/ /dest/dir rsync -av --filter=': .rsync-filter' /src/path/ /dest/dir .fi .RE .P دو دستور نخست در بالا، پیش از آغاز پویش عادی برای یافتن فایل در «/src/path» و زیرپوشه‌های آن، به‌دنبال «.rsync-filter» در «/» و «/src» می‌گردند. دستور آخر از پویش پوشه والد صرف‌نظر کرده و تنها به‌دنبال فایل‌های «.rsync-filter» در هر پوشه‌ای می‌گردد که بخشی از انتقال است. .P اگر می‌خواهید محتویات یک «.cvsignore» را در الگوهای خود بگنجانید، باید از قاعده «:C» استفاده کنید که یک ادغام پوشه‌ای (dir-merge) از فایل .cvsignore ایجاد می‌کند، اما به شیوه‌ای سازگار با CVS تجزیه می‌شود. با قرار دادن «:C» در هر کجای قواعد فیلتر خود، می‌توانید تعیین کنید که گنجاندن فایل per-directory \&.cvsignore توسط گزینه \fB\-\-cvs\-exclude\fP (\fB\-C\fP) در کجای قواعد شما قرار گیرد. بدون این کار، rsync قاعده ادغام پوشه‌ای برای فایل .cvsignore را در انتهای تمام قواعد دیگر شما اضافه می‌کند (که اولویتی کمتر از قواعد خط فرمان شما به آن می‌دهد). برای مثال: .RS 4 .P .nf cat < out.dat .fi .RE .P سپس فایل out.dat را بررسی کنید. اگر همه‌چیز به درستی کار کند، out.dat باید فایلی با طول صفر باشد. اگر خطای بالا را از rsync دریافت می‌کنید، احتمالاً خواهید دید که out.dat حاوی مقداری متن یا داده است. محتویات آن را بررسی کنید و مشخص کنید چه چیزی آن را تولید می‌کند. رایج‌ترین علت، اسکریپت‌های راه‌اندازی شل با پیکربندی نادرست (مانند .cshrc یا .profile) هستند که حاوی دستورات خروجی برای ورودهای غیرتعاملی می‌باشند. .P اگر در اشکال‌زدایی الگوهای فیلتر با مشکل مواجه شدید، از گزینه \fB\-vv\fP استفاده کنید. در این سطح از پرگویی، rsync دلیل گنجانده شدن یا حذف شدن هر فایل را به صورت جداگانه نمایش می‌دهد. .P .SH "کدهای خروج (EXIT VALUES)" .P .IP o \fB0\fP \- موفقیت‌آمیز .IP o \fB1\fP \- خطای نحوی یا خطای استفاده از دستور .IP o \fB2\fP \- ناسازگاری پروتکل .IP o \fB3\fP \- خطا در انتخاب فایل‌ها یا دایرکتوری‌های ورودی/خروجی .IP o .P .RS .IP o \fB4\fP \- اقدام درخواستی پشتیبانی نمی‌شود. یکی از دو حالت زیر: تلاش برای دستکاری فایل‌های ۶۴ بیتی روی بستری که از آن‌ها پشتیبانی نمی‌کند .IP o گزینه‌ای مشخص شده که توسط کلاینت پشتیبانی می‌شود اما توسط سرور پشتیبانی نمی‌شود .RE .IP o \fB5\fP \- خطا در شروع پروتکل کلاینت-سرور .IP o \fB10\fP \- خطا در ورودی/خروجی سوکت .IP o \fB11\fP \- خطا در ورودی/خروجی فایل .IP o \fB12\fP \- خطا در جریان داده پروتکل rsync .IP o \fB13\fP \- خطا در عیب‌یابی برنامه .IP o \fB14\fP \- خطا در کد IPC .IP o \fB15\fP \- پردازه هم‌نیا دچار فروپاشی شد (مانند core dumped). .IP o \fB16\fP \- پردازه هم‌نیا توسط یک سیگنال متوقف شد (کشته شد). .IP o \fB19\fP \- سیگنال SIGUSR1 دریافت شد. .IP o \fB20\fP \- سیگنال SIGINT، SIGTERM یا SIGHUP دریافت شد. .IP o \fB21\fP \- خطایی توسط \fBwaitpid()\fP بازگردانده شد .IP o \fB22\fP \- خطا در تخصیص بافرهای حافظه اصلی .IP o \fB23\fP \- انتقال ناقص به دلیل بروز خطا .IP o \fB24\fP \- انتقال ناقص به دلیل ناپدید شدن فایل‌های مبدأ .IP o \fB25\fP \- محدودیت \-\-max\-delete حذف‌ها را متوقف کرد .IP o \fB30\fP \- اتمام مهلت زمانی در ارسال/دریافت داده .IP o \fB35\fP \- اتمام مهلت زمانی در انتظار برای اتصال دیمن .P .SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" .P .IP "\fBCVSIGNORE\fP" متغیر محیطی CVSIGNORE هر الگوی نادیده‌گرفتن موجود در فایل‌های \&.cvsignore را تکمیل می‌کند. برای جزئیات بیشتر گزینه \fB\-\-cvs\-exclude\fP را ببینید. .IP "\fBRSYNC_ICONV\fP" یک تنظیم پیش‌فرض \fB\-\-iconv\fP را با استفاده از این متغیر محیطی مشخص کنید. .IP "\fBRSYNC_OLD_ARGS\fP" مقدار "1" را تعیین کنید اگر می‌خواهید گزینه \fB\-\-old\-args\fP به صورت پیش‌فرض فعال باشد، "2" (یا بیشتر) اگر می‌خواهید در حالت تکرار گزینه فعال باشد، یا "0" برای اطمینان از اینکه به صورت پیش‌فرض غیرفعال است. هنگامی که این متغیر محیطی روی یک مقدار غیر صفر تنظیم شود، جایگزین متغیر \fBRSYNC_PROTECT_ARGS\fP می‌شود. .IP اگر \fB\-\-old\-args\fP، \fB\-\-no\-old\-args\fP یا \fB\-\-secluded\-args\fP در خط فرمان مشخص شده باشند، این متغیر نادیده گرفته می‌شود. .IP اولین بار در 3.2.4 (آوریل 2022) پشتیبانی شد. .IP "\fBRSYNC_PROTECT_ARGS\fP" یک مقدار عددی غیر صفر مشخص کنید اگر می‌خواهید گزینه \fB\-\-secluded\-args\fP به طور پیش‌فرض فعال باشد، یا یک مقدار صفر برای اطمینان از اینکه به طور پیش‌فرض غیرفعال است. .IP اگر \fB\-\-secluded\-args\fP، \fB\-\-no\-secluded\-args\fP یا \fB\-\-old\-args\fP در خط فرمان مشخص شده باشند، این متغیر نادیده گرفته می‌شود. .IP از نسخه 3.2.4 (آوریل 2022)، اگر \fBRSYNC_OLD_ARGS\fP روی یک مقدار غیر صفر تنظیم شده باشد، این متغیر نادیده گرفته می‌شود. .IP "\fBRSYNC_RSH\fP" این متغیر محیطی به شما اجازه می‌دهد تا شل پیش‌فرض مورد استفاده به عنوان بستر انتقال rsync را بازنویسی کنید. گزینه‌های خط فرمان پس از نام دستور مجاز هستند، درست مانند گزینه \fB\-\-rsh\fP (\fB\-e\fP). .IP "\fBRSYNC_PROXY\fP" این متغیر محیطی به شما امکان می‌دهد هنگام اتصال به یک دیمن rsync، کلاینت rsync خود را به استفاده از یک وب‌پراکسی هدایت کنید. باید \fBRSYNC_PROXY\fP را روی یک مقدار hostname:port تنظیم کنید. .IP "\fBRSYNC_PASSWORD\fP" این متغیر محیطی به شما اجازه می‌دهد تا گذرواژه را برای اتصال به \fBdaemon\fP rsync تنظیم کنید، که از درخواست گذرواژه جلوگیری می‌کند. توجه داشته باشید که این متغیر گذرواژه‌ای برای انتقال از طریق شل راه‌دور مانند ssh ارائه \fBنمی‌دهد\fP (برای نحوه انجام آن به مستندات مربوطه مراجعه کنید). .IP "\fBUSER\fP or \fBLOGNAME\fP" متغیرهای محیطی USER یا LOGNAME برای تعیین نام کاربری پیش‌فرض ارسال‌شده به دیمن rsync استفاده می‌شوند. اگر هیچ‌کدام تنظیم نشده باشند، نام کاربری به طور پیش‌فرض "nobody" خواهد بود. اگر هر دو تنظیم شده باشند، \fBUSER\fP اولویت دارد. .IP "\fBRSYNC_PARTIAL_DIR\fP" این متغیر محیطی پوشه‌ای را که برای انتقال \fB\-\-partial\fP استفاده می‌شود مشخص می‌کند، بدون اینکه دلالت بر فعال بودن انتقال‌های ناقص داشته باشد. برای جزئیات کامل گزینه \fB\-\-partial\-dir\fP را ببینید. .IP "\fBRSYNC_COMPRESS_LIST\fP" این متغیر محیطی به شما اجازه می‌دهد با تعیین ترتیبی جایگزین یا فهرستی کاهش‌یافته از نام‌ها، مذاکره الگوریتم فشرده‌سازی را سفارشی‌سازی کنید. دستور \fBrsync\ \-\-version\fP را برای مشاهده نام‌های فشرده‌سازی موجود اجرا کنید. برای جزئیات کامل گزینه \fB\-\-compress\fP را ببینید. .IP "\fBRSYNC_CHECKSUM_LIST\fP" این متغیر محیطی به شما امکان می‌دهد با مشخص کردن ترتیبی جایگزین یا فهرستی کاهش‌یافته از نام‌ها، مذاکره الگوریتم چکسام (checksum) را سفارشی‌سازی کنید. دستور \fBrsync\ \-\-version\fP را برای مشاهده نام‌های چکسام موجود اجرا کنید. برای جزئیات کامل گزینه \fB\-\-checksum\-choice\fP را ببینید. .IP "\fBRSYNC_MAX_ALLOC\fP" این متغیر محیطی حداکثر تخصیص حافظه را تنظیم می‌کند، درست مانند زمانی که از گزینه \fB\-\-max\-alloc\fP استفاده کرده باشید. .IP "\fBRSYNC_PORT\fP" این متغیر محیطی توسط rsync خوانده نمی‌شود، بلکه هنگام اجرای شل راه‌دور در ترکیب با اتصال دیمن، در زیرمحیط آن مقداردهی می‌شود. این امر به اسکریپت‌هایی مانند \fBrsync-ssl\fP اجازه می‌دهد تا شماره پورت مشخص‌شده توسط کاربر در خط فرمان را بدانند. .IP "\fBHOME\fP" این متغیر محیطی برای یافتن فایل پیش‌فرض .cvsignore کاربر استفاده می‌شود. .IP "\fBRSYNC_CONNECT_PROG\fP" این متغیر محیطی عمدتاً در راه‌اندازی‌های عیب‌یابی برای تعیین برنامه‌ای که هنگام برقراری اتصال دیمن باید استفاده شود، به کار می‌رود. برای جزئیات کامل بخش CONNECTING TO AN RSYNC DAEMON را ببینید. .IP "\fBRSYNC_SHELL\fP" این متغیر محیطی عمدتاً در راه‌اندازی‌های عیب‌یابی برای تعیین برنامه‌ای که باید برای اجرای برنامه مشخص‌شده توسط \fBRSYNC_CONNECT_PROG\fP استفاده شود، به کار می‌رود. برای جزئیات کامل بخش CONNECTING TO AN RSYNC DAEMON را ببینید. .P .SH "فایل‌ها (FILES)" .P /etc/rsyncd.conf یا rsyncd.conf .P .SH "همچنین ببینید (SEE ALSO)" .P \fBrsync-ssl\fP(1), \fBrsyncd.conf\fP(5), \fBrrsync\fP(1) .P .SH "باگ‌ها (BUGS)" .P .IP o زمان‌ها به عنوان مقادیر time_t یونیکس منتقل می‌شوند. .IP o هنگام انتقال به فایل‌سیستم‌های FAT ممکن است rsync فایل‌های تغییرنیافته را مجدداً همگام‌سازی کند. توضیحات گزینه \fB\-\-modify\-window\fP را ببینید. .IP o مجوزهای فایل، دستگاه‌ها و غیره به صورت مقادیر عددی نیتیو منتقل می‌شوند. .IP o همچنین توضیحات مربوط به گزینه \fB\-\-delete\fP را ببینید. .P لطفاً باگ‌ها را گزارش دهید! به وبگاه زیر مراجعه کنید: .UR https://rsync.samba.org .UE . .P .SH "نسخه (VERSION)" .P این صفحه راهنما مربوط به نسخه 3.5.0 برنامه rsync است. .P .SH "گزینه‌های داخلی (INTERNAL OPTIONS)" .P گزینه‌های \fB\-\-server\fP و \fB\-\-sender\fP به صورت داخلی توسط rsync استفاده می‌شوند و در شرایط عادی هرگز نباید توسط کاربر وارد شوند. در برخی سناریوها، مانند زمان تنظیم لاگینی که فقط مجاز به اجرای دستور rsync است، ممکن است آگاهی از این گزینه‌ها لازم باشد. برای مثال، دایرکتوری support در توزیع rsync شامل یک اسکریپت نمونه به نام rrsync (برای rsync محدودشده) است که می‌تواند با لاگین محدودشده ssh استفاده شود. .P .SH "دست‌اندرکاران (CREDITS)" .P برنامه Rsync تحت مجوز GNU General Public License توزیع شده است. فایل COPYING را برای جزئیات ببینید. .P وبگاه rsync در آدرس زیر در دسترس است: .UR https://rsync.samba.org .UE . این سایت شامل یک FAQ-O-Matic است که ممکن است به سوالات پاسخ‌داده‌نشده در این صفحه راهنما پاسخ دهد. .P پروژه گیت‌هاب rsync: .UR https://github.com/RsyncProject/rsync .UE . .P اگر این برنامه برایتان مفید بوده است، خوشحال می‌شویم از شما بشنویم. لطفاً با فهرست پستی در .UR mailto:rsync@lists.samba.org rsync@lists.samba.org .UE مکاتبه کنید. .P این برنامه از کتابخانه فشرده‌سازی عالی zlib که توسط Jean-loup Gailly و Mark Adler نوشته شده، استفاده می‌کند. .P .SH "تشکرها (THANKS)" .P تشکر ویژه از: John Van Essen، Matt McCutchen، Wesley W. Terpstra، David Dykstra، Jos Backus، Sebastian Krahmer، Martin Pool و رفیق از دست رفته اما فراموش‌نشدنی ما، J.W. Schultz. .P همچنین با تشکر از Richard Brent، Brendan Mackay، Bill Waite، Stephen Rothwell و David Bell. احتمالاً نام برخی از قلم افتاده باشد که اگر چنین است پوزش می‌طلبم. .P .SH "نویسنده (AUTHOR)" .P برنامه rsync در ابتدا توسط Andrew Tridgell و Paul Mackerras نوشته شد. افراد بسیاری از سراسر جهان در نگهداری و بهبود آن مشارکت داشته‌اند. .P تشکر ویژه از Wayne Davison که از سال 2004 تا 2024 نگهداری rsync را بر عهده داشت. .P فهرست‌های پستی برای پشتیبانی و توسعه در .UR https://lists.samba.org .UE در دسترس هستند.