.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "CASYNC" "1" "Aug 12, 2026" "1" "casync" .SH "نام (NAME)" casync \- ابزار سیستم همگام‌سازی و توزیع مبتنی بر محتوا .SH "خلاصه دستور (SYNOPSIS)" .nf \fBcasync\fP [\fIOPTIONS\fP\&...] make [\fIARCHIVE\fP | \fIARCHIVE_INDEX\fP | \fIBLOB_INDEX\fP] [\fIPATH\fP] \fBcasync\fP [\fIOPTIONS\fP\&...] extract [\fIARCHIVE\fP | \fIARCHIVE_INDEX\fP | \fIBLOB_INDEX\fP] [\fIPATH\fP] \fBcasync\fP [\fIOPTIONS\fP\&...] list [\fIARCHIVE\fP | \fIARCHIVE_INDEX\fP | \fIDIRECTORY\fP] [\fIPATH\fP] \fBcasync\fP [\fIOPTIONS\fP\&...] mtree [\fIARCHIVE\fP | \fIARCHIVE_INDEX\fP | \fIDIRECTORY\fP] [\fIPATH\fP] \fBcasync\fP [\fIOPTIONS\fP\&...] stat [\fIARCHIVE\fP | \fIARCHIVE_INDEX\fP | \fIDIRECTORY\fP] [\fIPATH\fP] \fBcasync\fP [\fIOPTIONS\fP\&...] digest [\fIARCHIVE\fP | \fIBLOB\fP | \fIARCHIVE_INDEX\fP | \fIBLOB_INDEX\fP | \fIDIRECTORY\fP] [PATH] \fBcasync\fP [\fIOPTIONS\fP\&...] mount [\fIARCHIVE\fP | \fIARCHIVE_INDEX\fP] \fIPATH\fP \fBcasync\fP [\fIOPTIONS\fP\&...] mkdev [\fIBLOB\fP | \fIBLOB_INDEX\fP] [\fINODE\fP] \fBcasync\fP [\fIOPTIONS\fP\&...] gc \fIBLOB_INDEX\fP | \fIARCHIVE_INDEX\fP ... .fi .sp .SH "توضیحات (DESCRIPTION)" .sp ابزار همگام‌سازی و توزیع داده‌ها با آدرس‌دهی مبتنی بر محتوا (Content\-Addressable Data Synchronization Tool). .SH "دستورها (COMMANDS)" .nf \fBcasync\fP \fBmake\fP [\fIARCHIVE\fP | \fIARCHIVE_INDEX\fP] [\fIDIRECTORY\fP] \fBcasync\fP \fBmake\fP [\fIBLOB_INDEX\fP] \fIFILE\fP | \fIDEVICE\fP .fi .sp .sp این دستور یک بایگانی با پسوند .catar یا یک نمایه (index) با پسوند .caidx برای \fIDIRECTORY\fP داده‌شده، یا یک نمایه با پسوند .caibx برای \fIFILE\fP یا \fIDEVICE\fP بلوکی داده‌شده ایجاد می‌کند. نوع خروجی به صورت خودکار بر اساس پسوند فایل انتخاب می‌شود (این رفتار می‌تواند با \fB\-\-what=\fP نادیده گرفته شود). تعیین \fIDIRECTORY\fP اختیاری است و در صورت عدم تعیین، دایرکتوری جاری استفاده خواهد شد. .sp هنگامی که یک فایل .caidx یا .caibx ایجاد می‌شود، یک دایرکتوری ذخیره‌سازی با پسوند .castr نیز ایجاد خواهد شد که به طور پیش‌فرض در همان دایرکتوری قرار دارد و نام آن \fBdefault.castr\fP خواهد بود مگر اینکه به صورت دیگری پیکربندی شود (گزینه \fB\-\-store=\fP را ببینید). .sp متاداده‌های گنجانده‌شده در بایگانی توسط گزینه‌های \fB\-\-with\-*\fP و \fB\-\-without\-*\fP کنترل می‌شوند. .nf \fBcasync\fP \fBextract\fP [\fIARCHIVE\fP | \fIARCHIVE_INDEX\fP] [\fIDIRECTORY\fP] \fBcasync\fP \fBextract\fP \fIBLOB_INDEX\fP \fIFILE\fP | \fIDEVICE\fP .fi .sp .sp این دستور محتوای یک بایگانی .catar یا نمایه .caidx را درون \fIDIRECTORY\fP مشخص‌شده، یا محتوای مشخص‌شده توسط \fIBLOB_INDEX\fP را درون \fIFILE\fP یا \fIDEVICE\fP بلوکی تعیین‌شده استخراج می‌کند. تعیین \fIDIRECTORY\fP اختیاری است و به طور پیش‌فرض دایرکتوری جاری استفاده خواهد شد. .sp متاداده‌های بازسازی‌شده از بایگانی توسط گزینه‌های \fB\-\-with\-*\fP و \fB\-\-without\-*\fP کنترل می‌شوند. .nf \fBcasync\fP \fBlist\fP [\fIARCHIVE\fP | \fIARCHIVE_INDEX\fP | \fIDIRECTORY\fP] [\fIPATH\fP] .fi .sp .sp این دستور تمام فایل‌ها و دایرکتوری‌های موجود در \fIPATH\fP را همان‌گونه که در \fIARCHIVE\fP یا \fIARCHIVE_INDEX\fP یا زیر \fIDIRECTORY\fP یافت می‌شوند، فهرست می‌کند. هر دو آرگومان اختیاری هستند؛ آرگومان اول به طور پیش‌فرض دایرکتوری جاری و آرگومان دوم به طور پیش‌فرض مسیر سطح بالا (ریشه) بایگانی (\fB/\fP) در نظر گرفته می‌شود. .sp خروجی شامل ماسک دسترسی و نام فایل‌ها است: .INDENT 0.0 .INDENT 3.5 .sp .EX $ casync list /usr/share/doc/casync drwxr\-xr\-x \-rw\-r\-\-r\-\- README.md \-rw\-r\-\-r\-\- TODO .EE .UNINDENT .UNINDENT .nf \fBcasync\fP \fBmtree\fP [\fIARCHIVE\fP | \fIARCHIVE_INDEX\fP | \fIDIRECTORY\fP] [\fIPATH\fP] .fi .sp .sp این دستور مشابه \fBlist\fP است، اما اطلاعات مربوط به هر مدخل را در قالب کلید=مقدار (key=value) تعریف‌شده توسط BSD mtree(5) شامل می‌شود: .INDENT 0.0 .INDENT 3.5 .sp .EX $ casync mtree /usr/share/doc/casync \&. type=dir mode=0755 uid=0 gid=0 time=1500343585.721189650 README.md type=file mode=0644 size=7286 uid=0 gid=0 time=1498175562.000000000 sha256digest=af75eacac1f00abf6adaa7510a2c7fe00a4636daf9ea910d69d96f0a4ae85df4 TODO type=file mode=0644 size=2395 uid=0 gid=0 time=1498175562.000000000 sha256digest=316f11a03c08ec39f0328ab1f7446bd048507d3fbeafffe7c32fad4942244b7d .EE .UNINDENT .UNINDENT .nf \fBcasync\fP \fBstat\fP [\fIARCHIVE\fP | \fIARCHIVE_INDEX\fP | \fIDIRECTORY\fP] [\fIPATH\fP] .fi .sp .sp این دستور اطلاعات دقیق درباره فایل یا دایرکتوری \fIPATH\fP را همان‌گونه که در \fIARCHIVE\fP یا \fIARCHIVE_INDEX\fP یا زیر \fIDIRECTORY\fP یافت می‌شود، نمایش می‌دهد. هر دو آرگومان اختیاری هستند؛ آرگومان اول به طور پیش‌فرض دایرکتوری جاری و آرگومان دوم مسیر سطح بالا (\fB/\fP) است. .sp نمونه خروجی: .INDENT 0.0 .INDENT 3.5 .sp .EX $ casync stat . File: . Mode: drwxrwxr\-x FileAttr: \-\-\-\-\-\-\-\-\-\- FATAttr: \-\-\- Offset: 0 Time: 2017\-07\-17 22:53:30.723304050 User: zbyszek (1000) Group: zbyszek (1000) .EE .UNINDENT .UNINDENT .nf \fBcasync\fP \fBdigest\fP [\fIBLOB\fP | \fIBLOB_INDEX\fP | \fIDIRECTORY\fP] \fBcasync\fP \fBdigest\fP \fIARCHIVE\fP | \fIARCHIVE_INDEX\fP [PATH] .fi .sp .sp این دستور چکسام (checksum) فایل یا دایرکتوری، یا \fIPATH\fP داده‌شده را به صورتی که در \fIARCHIVE\fP یا \fIARCHIVE_INDEX\fP یافت می‌شود، محاسبه کرده و چاپ می‌کند. هر دو آرگومان اختیاری هستند؛ آرگومان اول به طور پیش‌فرض دایرکتوری جاری و آرگومان دوم به طور پیش‌فرض مسیر سطح بالای بایگانی (\fB/\fP) است. .sp مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX $ casync digest d1698b0c4c27163284abea5d1e369b92e89dd07cb74378638849800e0406baf7 $ casync digest . d1698b0c4c27163284abea5d1e369b92e89dd07cb74378638849800e0406baf7 .EE .UNINDENT .UNINDENT .nf \fBcasync\fP \fBmount\fP [\fIARCHIVE\fP | \fIARCHIVE_INDEX\fP] \fIPATH\fP .fi .sp .sp این دستور بایگانی .catar یا نمایه .caidx مشخص‌شده را در \fIPATH\fP تعیین‌شده با استفاده از پروتکل FUSE سوار (mount) می‌کند. .nf \fBcasync\fP \fBmkdev\fP [\fIBLOB\fP | \fIBLOB_INDEX\fP] [\fINODE\fP] .fi .sp .sp این دستور یک گره دستگاه بلوکی \fINODE\fP را با محتویات مشخص‌شده توسط \fIBLOB_INDEX\fP با پسوند .caibx یا صرفاً فایل یا دستگاه بلوکی \fIBLOB\fP با استفاده از پروتکل NBD ایجاد می‌کند. .sp مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX $ sudo casync \-v mkdev README.md Attached: /dev/nbd0 (in another terminal) $ sudo head \-n1 /dev/nbd0 # casync — Content Addressable Data Synchronizer .EE .UNINDENT .UNINDENT .sp هنگامی که فرایند \fBcasync mkdev\fP متوقف شود (kill شود)، دستگاه از بین می‌رود. .nf \fBcasync\fP \fBgc\fP \fIARCHIVE_INDEX\fP | \fIBLOB_INDEX\fP ... .fi .sp .sp این دستور تمامی قطعه‌ها (chunks) را که توسط هیچ‌یک از نمایه‌های مشخص‌شده استفاده نشده‌اند حذف می‌کند (می‌توان یک یا چند نمایه blob و archive را مشخص کرد). اگر گزینه \fB\-\-store\fP تعیین نشده باشد، مخزن ذخیره‌سازی پیش‌فرض اولین نمایه استفاده خواهد شد. .sp این دستور را می‌توان برای پاک‌سازی و هرس کردن قطعات بلااستفاده از یک مخزن اشتراکی قطعات به کار برد. .SH "گزینه‌ها (OPTIONS)" .sp گزینه‌های عمومی: .INDENT 0.0 .TP .B \-\-help\fP,\fB \-h نمایش راهنمای مختصر .TP .B \-\-version نمایش اطلاعات خلاصه نسخه .TP .BI \-\-log\-level\fB= \fR,\fB \ \-l تنظیم سطح ثبت وقایع (debug، info، err) .TP .B \-\-verbose\fP,\fB \-v نمایش وضعیت مختصر در حین اجرا .TP .B \-\-dry\-run\fP,\fB \-n صرفاً چاپ مواردی که با \fBgc\fP حذف خواهند شد (بدون اعمال تغییرات) .TP .BI \-\-store\fB= PATH مخزن اصلی قطعات (chunk store) برای استفاده .TP .BI \-\-extra\-store\fB= مخزن قطعات اضافی برای جستجوی قطعات در آن .TP .BI \-\-chunk\-size\fB= <[MIN:]AVG[:MAX]> حداقل/میانگین/حداکثر تعداد بایت‌ها در هر قطعه .TP .BI \-\-digest\fB= انتخاب الگوریتم خلاصه/هش (sha512\-256 یا sha256) .TP .BI \-\-compression\fB= انتخاب الگوریتم فشرده‌سازی (zstd، xz یا gzip) .TP .BI \-\-seed\fB= فایل یا دایرکتوری اضافی برای استفاده به عنوان بذر (seed) .TP .BI \-\-cache\fB= دایرکتوری مورد استفاده به عنوان کش (حافظه نهان) رمزگذار .TP .B \-\-cache\-auto\fP,\fB \-c انتخاب خودکار دایرکتوری کش رمزگذار .TP .BI \-\-rate\-limit\-bps\fB= حداکثر پهنای باند بر حسب بایت در ثانیه برای ارتباطات شبکه از راه دور .TP .BI \-\-exclude\-nodump\fB= no هنگام ایجاد بایگانی، فایل‌های دارای نشان \fBnodump\fP با پرچم +d دستور chattr(1) مستثنی نشوند .TP .BI \-\-exclude\-submounts\fB= yes هنگام ایجاد بایگانی، سوارشدن‌های فرعی (submounts) مستثنی شوند .TP .BI \-\-exclude\-file\fB= no به فایل‌های .caexclude در درخت فایل‌ها اعتنا نشود .TP .BI \-\-reflink\fB= no هنگام استخراج، از بذرها پیوند بازتابی (reflink) ایجاد نشود .TP .BI \-\-hardlink\fB= yes هنگام استخراج، از بذرها پیوند سخت (hardlink) ایجاد شود .TP .BI \-\-punch\-holes\fB= no هنگام استخراج، فایل‌های کم‌پشت (sparse) ایجاد نشوند .TP .BI \-\-delete\fB= no پس از استخراج، فایل‌های موجود که در بایگانی فهرست نشده‌اند حذف نشوند .TP .BI \-\-undo\-immutable\fB= yes هنگام حذف فایل‌های موجود، پرچم +i (تغییرناپذیر یا immutable) دستور chattr(1) در زمان استخراج برداشته شود .TP .BI \-\-seed\-output\fB= no هنگام استخراج، خروجی‌های از پیش موجود به طور ضمنی به عنوان بذر افزوده نشوند .TP .BI \-\-recursive\fB= no فهرست‌گیری به صورت غیربازگشتی انجام شود .TP .BI \-\-mkdir\fB= no در صورت عدم وجود دایرکتوری محل سوار کردن (mount)، به طور خودکار ایجاد نشود .TP .BI \-\-uid\-shift\fB= تغییر مکان شناسه‌های کاربری/گروهی (UID/GID) .TP .BI \-\-uid\-range\fB= محدود کردن UID/GID به یک دامنه مشخص .UNINDENT .sp انتخاب‌گر ورودی/خروجی: .INDENT 0.0 .TP .BI \-\-what\fB= archive عملیات روی فایل بایگانی .TP .BI \-\-what\fB= archive\-index عملیات روی فایل نمایه بایگانی .TP .BI \-\-what\fB= blob عملیات روی فایل داده خام (blob) .TP .BI \-\-what\fB= blob\-index عملیات روی فایل نمایه داده خام (blob index) .TP .BI \-\-what\fB= directory عملیات روی دایرکتوری .TP .BI \-\-what\fB= help چاپ فهرستی از مقادیر مجاز (و خروج از برنامه) .UNINDENT .sp فعال‌سازی مجموعه‌های ویژگی‌های بایگانی: .INDENT 0.0 .TP .BI \-\-with\fB= best ذخیره دقیق‌ترین و کامل‌ترین اطلاعات .TP .BI \-\-with\fB= unix ذخیره اطلاعات پایه یونیکس .TP .BI \-\-with\fB= fat ذخیره اطلاعات سیستم‌فایل FAT .TP .BI \-\-with\fB= chattr ذخیره ویژگی‌های فایل chattr(1) .TP .BI \-\-with\fB= fat\-attrs ذخیره ویژگی‌های فایل FAT .TP .BI \-\-with\fB= privileged ذخیره داده‌های فایلی که بازیابی آن‌ها نیازمند دسترسی‌های ویژه است .TP .BI \-\-with\fB= fuse ذخیره داده‌های فایلی که می‌توانند مجدداً از طریق \(aqcasync mount\(aq عرضه شوند .UNINDENT .sp برای غیرفعال کردن (\fIoff\fP) ویژگی‌های بایگانی، می‌توان از \fB\-\-without=…\fP استفاده کرد، مانند \fB\-\-without=fat\-attrs\fP، \fB\-\-without=privileged\fP و غیره. برای غیرفعال کردن تمامی ویژگی‌های اختیاری، می‌توان از \fB\-\-without=all\fP استفاده کرد. (حالت مثبت \fB\-\-with=all\fP منطقی نیست، زیرا برخی ویژگی‌ها با یکدیگر تداخل دارند. برای فعال‌سازی حداکثر مجموعه اطلاعات، از \fB\-\-with=best\fP استفاده فرمایید.) .sp ویژگی‌های مجزای بایگانی: .INDENT 0.0 .TP .BI \-\-with\fB= <16bit\-uids> ذخیره اطلاعات تقلیل‌یافته ۱۶ بیتی UID/GID .TP .BI \-\-with\fB= <32bit\-uids> ذخیره اطلاعات کامل ۳۲ بیتی UID/GID .TP .BI \-\-with\fB= ذخیره نام‌های کاربری/گروهی .TP .BI \-\-with\fB= ذخیره برچسب‌های زمانی با دقت ۱ ثانیه .TP .BI \-\-with\fB= ذخیره برچسب‌های زمانی با دقت ۱ میکروثانیه (µs) .TP .BI \-\-with\fB= ذخیره برچسب‌های زمانی با دقت ۱ نانوثانیه (ns) .TP .BI \-\-with\fB= <2sec\-time> ذخیره برچسب‌های زمانی با دقت ۲ ثانیه .TP .BI \-\-with\fB= ذخیره پرچم فقط‌خواندنی به ازای هر فایل .TP .BI \-\-with\fB= ذخیره کامل مجوزهای دسترسی فایل یونیکس .TP .BI \-\-with\fB= ذخیره پیوندهای نمادین .TP .BI \-\-with\fB= ذخیره گره‌های دستگاه بلوکی و کاراکتری .TP .BI \-\-with\fB= ذخیره گره‌های لوله نام‌گذاری‌شده (FIFO) .TP .BI \-\-with\fB= ذخیره گره‌های سوکت سیستم‌فایل AF_UNIX .TP .BI \-\-with\fB= ذخیره پرچم فایل پنهان \(dqhidden\(dq در FAT .TP .BI \-\-with\fB= ذخیره پرچم فایل سیستمی \(dqsystem\(dq در FAT .TP .BI \-\-with\fB= ذخیره پرچم فایل بایگانی \(dqarchive\(dq در FAT .TP .BI \-\-with\fB= ذخیره پرچم فایل فقط‌الحاقی \(dqappend\-only\(dq .TP .BI \-\-with\fB= ذخیره پرچم فایل غیرفعال‌سازی زمان دسترسی \(dqdisable access time\(dq .TP .BI \-\-with\fB= ذخیره پرچم فایل فعال‌سازی فشرده‌سازی \(dqenable compression\(dq .TP .BI \-\-with\fB= ذخیره پرچم فایل غیرفعال‌سازی کپی هنگام نوشتن \(dqdisable copy\-on\-write\(dq .TP .BI \-\-with\fB= ذخیره پرچم فایل غیرفعال‌سازی تخلیه \(dqdisable dumping\(dq .TP .BI \-\-with\fB= ذخیره پرچم دایرکتوری همگام \(dqsynchronous\(dq .TP .BI \-\-with\fB= ذخیره پرچم فایل تغییرناپذیر \(dqimmutable\(dq .TP .BI \-\-with\fB= ذخیره پرچم فایل همگام \(dqsynchronous\(dq .TP .BI \-\-with\fB= ذخیره پرچم فایل غیرفعال‌سازی فشرده‌سازی \(dqdisable compression\(dq .TP .BI \-\-with\fB= ذخیره پرچم وراثت سهمیه پروژه \(dqproject quota inheritance\(dq .TP .BI \-\-with\fB= ذخیره اطلاعات زیرحجم (subvolume) سامانه فایل btrfs .TP .BI \-\-with\fB= ذخیره ویژگی فقط‌خواندنی زیرحجم btrfs .TP .BI \-\-with\fB= ذخیره ویژگی‌های گسترش‌یافته فایل (xattrs) .TP .BI \-\-with\fB= ذخیره فهرست‌های کنترل دسترسی فایل (ACL) .TP .BI \-\-with\fB= ذخیره برچسب‌های فایل SElinux .TP .BI \-\-with\fB= ذخیره قابلیت‌های فایل (file capabilities) .TP .BI \-\-with\fB= ذخیره شناسه پروژه سهمیه‌بندی ext4/XFS .UNINDENT .sp (و موارد مشابه: \fB\-\-without=16bit\-uids\fP، \fB\-\-without=32bit\-uids\fP، ...) .SH "ویژگی‌های بایگانی (ARCHIVE FEATURES)" .sp پارامترهای گوناگون \fB\-\-with=\fP و \fB\-\-without=\fP مجموعه دقیق متاداده‌های ذخیره‌شده در بایگانی یا بازیابی‌شده در هنگام استخراج را کنترل می‌کنند. این پرچم‌ها تنها در صورتی اعمال می‌شوند که \fBcasync\fP در سطح سیستم فایل کار کند. .SH "مستثنی کردن فایل‌ها و دایرکتوری‌ها از بایگانی‌سازی (EXCLUDING FILES AND DIRECTORIES FROM ARCHIVING)" .sp هنگام ایجاد یک بایگانی یا نمایه از درخت دایرکتوری سیستم‌فایل، برخی فایل‌ها و دایرکتوری‌ها به طور پیش‌فرض مستثنی می‌شوند و برخی دیگر را می‌توان به صورت اختیاری مستثنی کرد: .INDENT 0.0 .IP 1. 3 فایل‌ها و دایرکتوری‌های سیستم‌فایل‌های API مجازی ارائه شده توسط هسته (یعنی procfs، sysfs، cgroupfs، devpts و... — به جز tmpfs/devtmpfs) بدون قید و شرط مستثنی می‌شوند. .IP 2. 3 بسته به اینکه پیوندهای نمادین، گره‌های دستگاه، لوله‌های FIFO و سوکت‌ها با استفاده از \fB\-\-with=\fP و \fB\-\-without=\fP برای بایگانی‌سازی فعال شده باشند یا خیر، گره‌های فایل از این نوع مستثنی می‌شوند. .IP 3. 3 به طور پیش‌فرض، فایل‌ها و دایرکتوری‌هایی با پرچم \fB+d\fP دستور chattr(1) مستثنی می‌شوند؛ با این حال این رفتار را می‌توان با \fB\-\-exclude\-nodump=no\fP غیرفعال کرد. .IP 4. 3 به صورت اختیاری، در صورتی که \fB\-\-exclude\-submounts=yes\fP مشخص شده باشد، فایل‌ها و دایرکتوری‌های موجود در نقاط سوارشدن فرعی (submounts) درخت سیستم‌فایل مشخص‌شده مستثنی خواهند شد. .IP 5. 3 به طور پیش‌فرض، هر فایل و دایرکتوری فهرست‌شده در فایل‌های \fB\&.caexclude\fP در سلسله‌مراتب فایل‌ها مستثنی می‌شود؛ با این حال بررسی و پردازش این فایل‌ها را می‌توان با \fB\-\-exclude\-file=no\fP غیرفعال کرد. این فایل‌ها عملکردی مشابه با مفهوم \fB\&.gitignore\fP در ابزار \fBgit\fP دارند: آن‌ها به عنوان فایل متنی خوانده می‌شوند که هر خط آن یا خالی است / با \fB#\fP شروع می‌شود (که در این صورت تاثیری نداشته و می‌تواند برای نوشتن توضیحات به کار رود)، یا یک الگوی مسیر تطبیق نام (globbing) از فایل‌ها/دایرکتوری‌های نادیده‌گرفتنی را فهرست می‌کند. اگر خطی حاوی نویسه \fB/\fP نباشد، آن خط برای دایرکتوری محل قرارگیری فایل \fB\&.caexclude\fP و همچنین تمامی دایرکتوری‌های فرزند آن اعمال می‌شود. اگر شامل حداقل یک نویسه \fB/\fP باشد، کاملاً نسبت به دایرکتوری محل قرارگیری فایل \fB\&.caexclude\fP نسبی در نظر گرفته می‌شود. فایل‌های \fB\&.caexclude\fP ممکن است در هر دایرکتوری از درخت سیستم‌فایلی که بایگانی می‌شود قرار گیرند؛ با این وجود قرار دادن آن‌ها در دایرکتوری‌هایی که قبلاً توسط فایل‌های \fB\&.caexclude\fP بالاتر در درخت دایرکتوری برای مستثنی شدن علامت‌گذاری شده‌اند، بی‌اثر خواهد بود. هنگامی که یک خط با نویسه \fB/\fP پایان می‌یابد، صرفاً برای دایرکتوری‌ها اعمال می‌شود و شامل فایل‌های عادی یا سایر انواع گره‌های فایل نخواهد شد. اگر خطی با نویسه \fB!\fP شروع شود، فایل‌های منطبق از شمول مستثنی‌سازی خارج می‌شوند؛ به این معنی که اثر سایر خطوط منطبق که با این علامت شروع نشده‌اند برای این فایل‌ها لغو می‌شود. خطوط دارای علامت \fB!\fP بدون قید و شرط بر خطوط فاقد این علامت تقدم دارند. علاوه بر این، خطوطی که با \fB!\fP شروع می‌شوند اثر الگوهای موجود در فایل‌های \fB\&.caexclude\fP در دایرکتوری‌های بالاتر درخت را نیز لغو می‌کنند. .UNINDENT .\" End of generated man page.