.\" Copyright © Tavian Barnes <tavianator@tavianator.com>
.\" SPDX-License-Identifier: 0BSD
.TH BFS 1 2026-06-29 "bfs 4.1.4"
.SH "نام (NAME)"
bfs \- جستجوی سطح‌اول برای فایل‌های شما
.SH "خلاصه دستور (SYNOPSIS)"
.B bfs
.RB [ پرچم‌ها ...]
.RI [ مسیرها ...]
.RB [ عبارت ...]
.PP
پرچم‌ها
.RB ( \-H / \-L / \-P
و غیره)،
.IR مسیرها ،
و
.B عبارت‌ها
را می‌توان آزادانه به هر ترتیبی ترکیب کرد.
.SH "توضیحات (DESCRIPTION)"
.B bfs
یک نسخه جستجوی سطح‌اول (breadth-first) از دستور یونیکس
.BR find (1)
است.
.PP
.B bfs
تقریباً از همه ویژگی‌های پیاده‌سازی‌های اصلی
.BR find (1)
پشتیبانی می‌کند، بنابراین خطوط فرمان موجود شما باید همان‌طور که هستند کار کنند.
همچنین برخی ویژگی‌های خاص خود را می‌افزاید، مانند یک تجزیه‌گر خط فرمان بخشنده‌تر و برخی گزینه‌های اضافی.
.PP
هر
.I مسیر
مشخص‌شده در خط فرمان به عنوان یک مسیر شروع برای جستجو در نظر گرفته می‌شود.
اگر هیچ مسیری مشخص نشود، دایرکتوری فعلی
.RI ( . )
به‌طور پیش‌فرض جستجو می‌شود.
.PP
مانند
.BR find (1)،
.B bfs
آرگومان‌های خود را به عنوان یک عبارت بولی با اتصال کوتاه تفسیر می‌کند.
به عنوان مثال،
.PP
.nf
.RS
.B bfs \e( \-name '*.txt' \-or \-lname '*.txt' \e) \-and \-print
.RE
.fi
.PP
تمام مسیرهایی را چاپ می‌کند که یا فایل‌های .txt هستند یا پیوندهای نمادین به فایل‌های .txt می‌باشند.
.B \-and
بین دو عبارت متوالی ضمنی فرض می‌شود، بنابراین این دستور نیز معادل است:
.PP
.nf
.RS
.B bfs \e( \-name '*.txt' \-or \-lname '*.txt' \e) \-print
.RE
.fi
.PP
در نهایت، اگر هیچ کنشی مشخص نشود،
.B \-print
به‌طور ضمنی اعمال می‌شود، بنابراین این دستور نیز معادل است:
.PP
.nf
.RS
.B bfs \-name '*.txt' \-or \-lname '*.txt'
.RE
.fi
.PP
بیشتر گزینه‌هایی که یک آرگومان عددی
.I N
می‌گیرند،
.I \-N
یا
.IR +N
را نیز می‌پذیرند.
.I \-N
به معنی «کمتر از
.IR N »،
و
.I +N
به معنی «بیشتر از
.IR N »
است.
.SH "پرچم‌ها (FLAGS)"
.TP
.B \-H
دنبال کردن پیوندهای نمادین مشخص‌شده در خط فرمان، اما نه در حین جستجو.
.TP
.B \-L
دنبال کردن تمام پیوندهای نمادین.
.TP
.B \-P
هرگز پیوندهای نمادین را دنبال نکند (پیش‌فرض).
.TP
.B \-E
استفاده از عبارت‌های منظم گسترش‌یافته (مشابه
.B \-regextype
.IR posix-extended ).
.TP
.B \-X
فیلتر کردن فایل‌هایی با نام‌های ناامن برای
.RB xargs (1).
.TP
.B \-d
جستجو با ترتیب پس‌مرتبه (مشابه
.BR \-depth ).
.TP
.B \-s
پیمایش مدخل‌های دایرکتوری به ترتیب مرتب‌شده.
مرتب‌سازی درون هر دایرکتوری به‌طور جداگانه انجام می‌شود، که آن را با
.B bfs ... |
.BR sort
متفاوت می‌سازد، اما همچنان یک ترتیب قطعی را فراهم می‌کند.
.TP
.B \-x
به نقاط پیوند دیگر وارد نشود (مشابه
.BR \-xdev ).
.TP
.BI "\-f " PATH
در نظر گرفتن
.I PATH
به عنوان مسیری برای جستجو (مفید در صورتی که با خط تیره شروع شود).
.TP
.BI "\-D " FLAG
فعال کردن پرچم اشکال‌زدایی (به
.B \-D
.IR help
مراجعه کنید).
.PP
.BI \-O N
.RS
فعال‌سازی سطح بهینه‌سازی
.I N
(پیش‌فرض:
.IR 3 ).
.TP
.BI \-O 0
غیرفعال‌سازی تمام بهینه‌سازی‌ها.
.TP
.BI \-O 1
ساده‌سازی‌های منطقی پایه.
.TP
.BI \-O 2
تمام بهینه‌سازی‌های
.BI \-O 1 ،
به همراه حذف کدهای مرده و تحلیل جریان داده.
.TP
.BI \-O 3
تمام بهینه‌سازی‌های
.BI \-O 2 ،
به همراه بازآرایی عبارت‌ها برای کاهش هزینه مورد انتظار.
.TP
\fB\-O\fI4\fR/\fB\-O\fIfast\fR
تمام بهینه‌سازی‌ها، شامل بهینه‌سازی‌های تهاجمی که ممکن است رفتار مشاهده‌شده را در حالت‌های خاص تغییر دهد.
.RE
.PP
\fB\-S \fIbfs\fR|\fIdfs\fR|\fIids\fR|\fIeds\fR
.RS
انتخاب راهبرد جستجو.
.TP
.I bfs
جستجوی سطح‌اول (پیش‌فرض).
.TP
.I dfs
جستجوی عمق‌اول.
حافظه کمتری نسبت به جستجوی سطح‌اول مصرف می‌کند، اما معمولاً در بازگرداندن نتایج مرتبط کندتر است.
.TP
.I ids
جستجوی عمق‌یابی تکراری.
جستجوهای عمق‌اول مکرر را با محدودیت‌های عمق فزاینده انجام می‌دهد.
این حالت نتایج را با ترتیبی مشابه جستجوی سطح‌اول، اما با مصرف حافظه کاهش‌یافته جستجوی عمق‌اول بازمی‌گرداند.
در عمل تمایل به کندی زیاد دارد، بنابراین فقط در صورتی از آن استفاده کنید که حتماً به ترتیب سطح‌اول نیاز دارید اما
.B \-S
.I bfs
حافظه بسیار زیادی مصرف می‌کند.
.TP
.I eds
جستجوی عمق‌یابی نمایی.
مصالحه‌ای بین جستجوی سطح‌اول و عمق‌اول، که دامنه‌های عمق با افزایش نمایی را جستجو می‌کند (مانند 0-1، 1-2، 2-4، 4-8 و غیره).
بسیاری از مزایای جستجوی سطح‌اول را با مصرف حافظه کمتر جستجوی عمق‌اول فراهم می‌کند.
معمولاً بسیار سریع‌تر از
.B \-S
.IR ids
است.
.RE
.TP
.BI \-j N
جستجو با
.I N
نخ به‌صورت موازی (پیش‌فرض: تعداد پردازنده‌ها، تا سقف
.IR 8 ).
.SH "عملگرها (OPERATORS)"
.TP
.BI "( " expression " )"
پرانتزها برای گروه‌بندی عبارت‌ها با یکدیگر استفاده می‌شوند.
احتمالاً باید
.B \e(
.I expression
.B \e)
بنویسید تا از تفسیر پرانتزها توسط پوسته جلوگیری شود.
.PP
\fB! \fIexpression\fR
.br
.B \-not
.I expression
.RS
عملگر «not»: نقیض مقدار درستی
.IR expression
را برمی‌گرداند.
ممکن است لازم باشد \fB\e! \fIexpression\fR بنویسید تا از تفسیر
.B !
توسط پوسته جلوگیری شود.
.RE
.PP
.I expression expression
.br
.I expression
.B \-a
.I expression
.br
.I expression
.B \-and
.I expression
.RS
عملگر «and» با اتصال کوتاه: اگر
.I expression
سمت چپ
.BR true
باشد،
.I expression
سمت راست را برمی‌گرداند؛ در غیر این صورت،
.BR false
را برمی‌گرداند.
.RE
.PP
.I expression
.B \-o
.I expression
.br
.I expression
.B \-or
.I expression
.RS
عملگر «or» با اتصال کوتاه: اگر
.I expression
سمت چپ
.BR false
باشد،
.I expression
سمت راست را برمی‌گرداند؛ در غیر این صورت،
.BR true
را برمی‌گرداند.
.RE
.TP
.IB "expression " , " expression"
عملگر «کاما»:
.I expression
سمت چپ را ارزیابی می‌کند اما نتیجه آن را نادیده می‌گیرد و
.I expression
سمت راست را برمی‌گرداند.
.SH "عبارت‌های خاص (SPECIAL EXPRESSIONS)"
.TP
.BI "\-exclude " expression
مستثنی کردن تمام مسیرهای منطبق با
.I expression
از جستجو.
این قدرتمندتر از
.BR \-prune
است، زیرا حتی زمانی که عبارت به دلیل وجود
.B \-depth
یا
.B \-mindepth
ارزیابی نمی‌شود نیز اعمال می‌گردد.
استثناها همیشه پیش از سایر عبارت‌ها اعمال می‌شوند، بنابراین قرار دادن آن‌ها در ابتدای خط فرمان کمترین ابهام را دارد.
.PP
.B \-help
.br
.B \-\-help
.RS
چاپ اطلاعات نحوه استفاده و خروج فوری (بدون تجزیه بقیه خط فرمان یا پردازش هیچ فایلی).
.RE
.PP
.B \-version
.br
.B \-\-version
.RS
چاپ اطلاعات نسخه و خروج فوری.
.RE
.SH "گزینه‌ها (OPTIONS)"
.B \-color
.br
.B \-nocolor
.RS
فعال یا غیرفعال کردن رنگ‌ها (پیش‌فرض:
.B \-color
در صورت خروجی به ترمینال، وگرنه
.B \-nocolor
).
.RE
.TP
.B \-daystart
محاسبه زمان نسبت به شروع امروز.
.TP
.B \-depth
جستجو با ترتیب پس‌مرتبه (ابتدا فرزندان).
.TP
.B \-follow
دنبال کردن تمام پیوندهای نمادین (مشابه
.BR \-L ).
.TP
.BI "\-files0\-from " FILE
در نظر گرفتن مسیرهای جداشده با NUL ('\e0') در
.I FILE
به عنوان نقاط شروع جستجو.
برای خواندن مسیرها از ورودی استاندارد،
.B \-files0\-from
.I \-
را ارسال کنید.
.PP
.B \-ignore_readdir_race
.br
.B \-noignore_readdir_race
.RS
گزارش خطا در صورتی که
.B bfs
تشخیص دهد درخت فایل در طول جستجو تغییر یافته است یا خیر (پیش‌فرض:
.BR \-noignore_readdir_race ).
.RE
.PP
.B \-maxdepth
.I N
.br
.B \-mindepth
.I N
.RS
نادیده گرفتن فایل‌های عمیق‌تر/کم‌عمق‌تر از
.IR N .
.RE
.TP
.B \-mount
مستثنی کردن کامل نقاط پیوند از نتایج.
.TP
.B \-noerror
نادیده گرفتن هرگونه خطایی که در حین پیمایش رخ می‌دهد.
.TP
.B \-nohidden
مستثنی کردن فایل‌ها و دایرکتوری‌های پنهان.
.TP
.B \-noleaf
نادیده گرفته می‌شود؛ جهت سازگاری با GNU find.
.TP
.BI "\-regextype " TYPE
استفاده از عبارت‌های منظم با سبک
.IR TYPE .
انواع معتبر عبارتند از:
.RS
.TP
.I posix-basic
عبارت‌های منظم پایه‌ای POSIX (پیش‌فرض).
.TP
.I posix-extended
عبارت‌های منظم گسترش‌یافته POSIX.
.TP
.I ed
مشابه
.BR ed (1)
(مشابه
.IR posix-basic ).
.TP
.I emacs
مشابه
.BR emacs (1).
.TP
.I grep
مشابه
.BR grep (1).
.TP
.I sed
مشابه
.BR sed (1)
(مشابه
.IR posix-basic ).
.PP
برای شرح ساختار عبارت منظم، به
.BR regex (7)
مراجعه کنید.
.RE
.TP
.B \-status
نمایش نوار وضعیت در حین جستجو.
.TP
.B \-unique
رد کردن فایل‌هایی که قبلاً دیده شده‌اند.
به‌ویژه در کنار
.BR \-L
مفید است.
.PP
.B \-warn
.br
.B \-nowarn
.RS
فعال یا غیرفعال کردن هشدارهای مربوط به خط فرمان.
.RE
.TP
.B \-xdev
به سایر نقاط پیوند وارد نشود.
برخلاف
.BR \-mount ،
خود نقطه پیوند همچنان گنجانده می‌شود.
.SH "آزمون‌ها (TESTS)"
.TP
.B \-acl
یافتن فایل‌هایی با فهرست کنترل دسترسی
.RB ( acl (5))
غیرجزئی.
.PP
\fB\-amin\fR [\fI\-+\fR]\fIN\fR
.br
\fB\-Bmin\fR [\fI\-+\fR]\fIN\fR
.br
\fB\-cmin\fR [\fI\-+\fR]\fIN\fR
.br
\fB\-mmin\fR [\fI\-+\fR]\fIN\fR
.RS
یافتن فایل‌هایی که
.I N
دقیقه پیش
.BR a ccessed/ B irthed/ c hanged/ m odified
(دسترسی‌یافته/ایجادشده/وضعیت‌تغییریافته/محتوا‌تغییریافته) شده‌اند.
.RE
.PP
.B \-anewer
.I FILE
.br
.B \-Bnewer
.I FILE
.br
.B \-cnewer
.I FILE
.br
.B \-mnewer
.I FILE
.RS
یافتن فایل‌هایی که به تازگی‌تر از زمان تغییر
.I FILE ،
.BR a ccessed/ B irthed/ c hanged/ m odified
(دسترسی‌یافته/ایجادشده/وضعیت‌تغییریافته/محتوا‌تغییریافته) شده‌اند.
.RE
.PP
.B \-asince
.I TIME
.br
.B \-Bsince
.I TIME
.br
.B \-csince
.I TIME
.br
.B \-msince
.I TIME
.RS
یافتن فایل‌هایی که به تازگی‌تر از برچسب زمانی با سبک ISO 8601
.IR TIME ،
.BR a ccessed/ B irthed/ c hanged/ m odified
(دسترسی‌یافته/ایجادشده/وضعیت‌تغییریافته/محتوا‌تغییریافته) شده‌اند.
برای مثال‌هایی از قالب برچسب زمانی، به
.BI \-newer XY
مراجعه کنید.
.RE
.PP
\fB\-atime\fR [\fI\-+\fR]\fIN\fR
.br
\fB\-Btime\fR [\fI\-+\fR]\fIN\fR
.br
\fB\-ctime\fR [\fI\-+\fR]\fIN\fR
.br
\fB\-mtime\fR [\fI\-+\fR]\fIN\fR
.RS
یافتن فایل‌هایی که
.I N
روز پیش
.BR a ccessed/ B irthed/ c hanged/ m odified
(دسترسی‌یافته/ایجادشده/وضعیت‌تغییریافته/محتوا‌تغییریافته) شده‌اند.
.RE
.TP
.B \-capable
یافتن فایل‌هایی که قابلیت‌های
.BR capabilities (7)
POSIX.1e روی آن‌ها تنظیم شده است.
.TP
.BI "\-context " GLOB
یافتن فایل‌هایی که بافتار SELinux آن‌ها با
.I GLOB
تطابق دارد.
.TP
\fB\-depth\fR [\fI\-+\fR]\fIN\fR
یافتن فایل‌هایی با عمق
.IR N .
.TP
.B \-empty
یافتن فایل‌ها/دایرکتوری‌های خالی.
.PP
.B \-executable
.br
.B \-readable
.br
.B \-writable
.RS
یافتن فایل‌هایی که کاربر فعلی می‌تواند آن‌ها را اجرا کند/بخواند/بنویسد.
.RE
.PP
.B \-false
.br
.B \-true
.RS
همیشه نادرست/درست (false/true).
.RE
.TP
\fB\-flags\fR [\fI\-+\fR]\fIFLAGS\fR
یافتن فایل‌هایی با پرچم‌های inode منطبق بر
.BR FLAGS .
.TP
.BI "\-fstype " TYPE
یافتن فایل‌های روی سیستم‌های فایلی با نوع
.IR TYPE .
.PP
\fB\-gid\fR [\fI\-+\fR]\fIN\fR
.br
\fB\-uid\fR [\fI\-+\fR]\fIN\fR
.RS
یافتن فایل‌های متعلق به شناسه گروه/کاربر
.IR N .
.RE
.PP
.B \-group
.I NAME
.br
.B \-user
.I NAME
.RS
یافتن فایل‌های متعلق به گروه/کاربر
.IR NAME .
.RE
.TP
.B \-hidden
یافتن فایل‌های پنهان (آن‌هایی که با
.I .
شروع می‌شوند).
.PP
.B \-ilname
.I GLOB
.br
.B \-iname
.I GLOB
.br
.B \-ipath
.I GLOB
.br
.B \-iregex
.I REGEX
.br
.B \-iwholename
.I GLOB
.RS
نسخه‌های غیرحساس به حروف بزرگ و کوچک از
.BR \-lname / \-name / \-path / \-regex / \-wholename .
.RE
.TP
\fB\-inum\fR [\fI\-+\fR]\fIN\fR
یافتن فایل‌هایی با شماره inode برابر
.IR N .
.TP
\fB\-links\fR [\fI\-+\fR]\fIN\fR
یافتن فایل‌هایی با
.I N
پیوند سخت.
.TP
.BI "\-lname " GLOB
یافتن پیوندهای نمادینی که مقصد آن‌ها با
.I GLOB
تطابق دارد.
.TP
.BI "\-name " GLOB
یافتن فایل‌هایی که نام آن‌ها با
.I GLOB
تطابق دارد.
.TP
.BI "\-newer " FILE
یافتن فایل‌های تازه‌تر از
.IR FILE .
.TP
.BI \-newer "XY REFERENCE"
یافتن فایل‌هایی که زمان
.I X
آن‌ها تازه‌تر از زمان
.I Y
در
.I REFERENCE
است.
.I X
و
.I Y
می‌توانند هر یک از
.RI [ aBcm ]
.RI ( a ccess/ B irth/ c hange/ m odification)
باشند.
همچنین
.I Y
می‌تواند
.I t
باشد تا
.I REFERENCE
به عنوان یک برچسب زمانی به سبک ISO 8601 تجزیه شود. به عنوان مثال:
.PP
.RS
.nf
\(bu  \fI1991-12-14\fR
\(bu  \fI1991-12-14T03:00\fR
\(bu  \fI1991-12-14T03:00-07:00\fR
\(bu '\fI1991-12-14 10:00Z\fR'
.fi
.RE
.PP
.B \-nogroup
.br
.B \-nouser
.RS
یافتن فایل‌های متعلق به گروه‌ها/کاربران ناموجود.
.RE
.PP
.B \-path
.I GLOB
.br
.B \-wholename
.I GLOB
.RS
یافتن فایل‌هایی که کل مسیر آن‌ها با
.I GLOB
تطابق دارد.
.RE
.TP
\fB\-perm\fR [\fI\-+/\fR]\fIMODE\fR
یافتن فایل‌هایی با حالت مجوز منطبق.
.TP
.BI "\-regex " REGEX
یافتن فایل‌هایی که کل مسیر آن‌ها با عبارت منظم
.I REGEX
تطابق دارد.
.TP
.BI "\-samefile " FILE
یافتن پیوندهای سخت به
.IR FILE .
.TP
.BI "\-since " TIME
یافتن فایل‌های تغییریافته از زمان برچسب زمانی به سبک ISO 8601
.IR TIME .
برای مثال‌هایی از قالب برچسب زمانی، به
.BI \-newer XY
مراجعه کنید.
.TP
\fB\-size\fR [\fI\-+\fR]\fIN\fR[\fIcwbkMGTP\fR]
یافتن فایل‌هایی با اندازه مشخص‌شده.
واحد می‌تواند یکی از موارد زیر باشد:
.PP
.RS
.nf
\(bu \fIc\fRhars  (1 بایت)
\(bu \fIw\fRords  (2 بایت)
\(bu \fIb\fRlocks (512 بایت، پیش‌فرض)
\(bu \fIk\fRiB    (1024 بایت)
\(bu \fIM\fRiB    (1024 کیبی‌بایت)
\(bu \fIG\fRiB    (1024 میبی‌بایت)
\(bu \fIT\fRiB    (1024 گیبی‌بایت)
\(bu \fIP\fRiB    (1024 تبی‌بایت)
.fi
.RE
.TP
.B \-sparse
یافتن فایل‌هایی که بلوک‌های دیسک کمتری از حد انتظار اشغال کرده‌اند.
.TP
\fB\-type\fR [\fIbcdlpfswD\fR]
یافتن فایل‌های با نوع مشخص‌شده.
انواع ممکن عبارتند از:
.PP
.RS
\(bu
دستگاه بلوکی
.RI ( b lock)
.br
\(bu
دستگاه نویسه‌ای
.RI ( c haracter)
.br
\(bu
دایرکتوری
.RI ( d irectory)
.br
\(bu
پیوند نمادین
.RI ( l ink)
.br
\(bu
پایپ
.RI ( p ipe)
.br
\(bu
فایل عادی
.RI ( f ile)
.br
\(bu
سوکت
.RI ( s ocket)
.br
\(bu
وایت‌اوت
.RI ( w hiteout)
.br
\(bu
درگاه
.RI ( D oor)
.PP
چندین نوع را می‌توان همزمان و جداشده با کاما مشخص کرد.
برای مثال،
.B \-type
.I d,f
هم با دایرکتوری‌ها و هم با فایل‌های عادی تطابق می‌یابد.
.RE
.TP
\fB\-used\fR [\fI\-+\fR]\fIN\fR
یافتن فایل‌هایی که آخرین دسترسی به آن‌ها
.I N
روز پس از آخرین تغییر وضعیت آن‌ها بوده است.
.TP
.B \-xattr
یافتن فایل‌هایی با ویژگی‌های گسترش‌یافته
.RB ( xattr (7)).
.TP
.BI "\-xattrname " NAME
یافتن فایل‌هایی با ویژگی گسترش‌یافته
.IR NAME .
.TP
\fB\-xtype\fR [\fIbcdlpfswD\fR]
یافتن فایل‌هایی با نوع مشخص‌شده، با دنبال کردن پیوندها زمانی که
.B \-type
دنبال نمی‌کند، و بالعکس.
.SH "کنش‌ها (ACTIONS)"
.B \-delete
.br
.B \-rm
.RS
حذف فایل‌های یافت‌شده (مستلزم
.BR \-depth ).
.RE
.TP
.BI "\-exec " "command ... {} ;"
اجرای یک دستور.
.TP
.BI "\-exec " "command ... {} +"
اجرای یک دستور با چندین فایل به‌طور همزمان.
.TP
.BI "\-ok " "command ... {} ;"
پرسش از کاربر برای اجرای یک دستور.
.PP
.B \-execdir
.I command ... {} ;
.br
.B \-execdir
.I command ... {} +
.br
.B \-okdir
.I command ... {} ;
.RS
مانند
.BR \-exec / \-ok ،
اما اجرای دستور در همان دایرکتوری فایل(های) یافت‌شده انجام می‌شود.
.RE
.TP
\fB\-exit\fR [\fISTATUS\fR]
خروج فوری با وضعیت مشخص‌شده
.RI ( 0
در صورت عدم تعیین).
.PP
.B \-fls
.I FILE
.br
.B \-fprint
.I FILE
.br
.B \-fprint0
.I FILE
.br
.B \-fprintf
.I FILE FORMAT
.RS
مشابه
.BR \-ls / \-print / \-print0 / \-printf ،
اما نوشتن در
.I FILE
به جای خروجی استاندارد.
.RE
.TP
.BI "\-limit " N
خروج پس از آنکه این کنش
.I N
بار ارزیابی شد.
.TP
.B \-ls
فهرست کردن فایل‌ها مشابه
.B ls
.IR \-dils .
.TP
.B \-print
چاپ مسیر فایل یافت‌شده.
.TP
.B \-print0
مشابه
.BR \-print ،
اما استفاده از نویسه تهی ('\e0') به جای خطوط جدید به عنوان جداکننده.
در ترکیب با
.B xargs
.I \-0
مفید است.
.TP
.BI "\-printf " FORMAT
چاپ بر اساس یک رشته قالب‌بندی (به
.BR find (1)
مراجعه کنید).
این دستورالعمل‌های قالب‌بندی اضافی نیز پشتیبانی می‌شوند:
.RS
.TP
%w
زمان ایجاد فایل، با همان قالب %a/%c/%t.
.TP
.RI %W k
فیلد
.I k
از زمان ایجاد فایل، با همان قالب
.RI %A k /%C k /%T k .
.RE
.TP
.B \-printx
مشابه
.BR \-print ،
اما گریز دادن نویسه‌های فاصله‌خالی و نقل‌قول برای ایمن‌سازی خروجی برای
.BR xargs (1).
استفاده از
.B \-print0
و
.B xargs
.I \-0
به جای آن را در نظر بگیرید.
.TP
.B \-prune
به داخل این دایرکتوری وارد نشود.
اگر
.B \-depth
فعال باشد (چه صراحتاً یا به‌طور ضمنی توسط
.BR \-delete )
هیچ تاثیری ندارد.
در این حالت به جای آن از
.B \-exclude
استفاده کنید.
.TP
.B \-quit
خروج فوری.
.SH "محیط (ENVIRONMENT)"
متغیرهای محیطی خاصی بر رفتار
.B bfs
اثر می‌گذارند.
.PP
.B LANG
.br
.B LC_*
.RS
تعیین‌کننده
.BR locale (7)
مورد استفاده برای موارد گوناگون.
.B bfs
هنوز به هیچ زبانی به جز انگلیسی ترجمه نشده است، اما محلی‌سازی همچنان بر قالب مقادیر چاپ‌شده اثر خواهد گذاشت.
پیام‌های تایید بله/خیر (مانند خروجی از
.BR \-ok )
نیز بر اساس locale فعلی تفسیر خواهند شد.
.RE
.PP
.B LS_COLORS
.br
.B BFS_COLORS
.RS
کنترل‌کننده رنگ‌های مورد استفاده هنگام نمایش مسیرهای فایل در صورت فعال بودن
.BR \-color .
دستور
.B bfs
متغیر
.B LS_COLORS
را مشابه
.BR ls (1)
گنو تفسیر می‌کند (به
.BR dir_colors (5)
مراجعه کنید).
متغیر
.B BFS_COLORS
می‌تواند برای سفارشی‌سازی
.B bfs
بدون اثر گذاشتن بر سایر دستورات استفاده شود.
.RE
.TP
.B NO_COLOR
در صورت تنظیم بودن، باعث می‌شود
.B bfs
به‌طور پیش‌فرض از
.B \-nocolor
استفاده کند (به https://no-color.org/ مراجعه کنید).
.TP
.B PAGER
تعیین‌کننده صفحه‌بندی‌کننده (pager) مورد استفاده برای خروجی
.BR \-help .
پیش‌فرض آن
.BR less (1)
است، در صورتی که در
.B PATH
فعلی یافت شود، در غیر این صورت
.BR more (1).
.TP
.B PATH
برای یافتن برنامه‌های اجرایی جهت
.BR \-exec [ dir ]
و
.BR \-ok [ dir ]
استفاده می‌شود.
.TP
.B POSIXLY_CORRECT
باعث می‌شود
.B bfs
با استاندارد POSIX.1-2017 برای
.BR find (1)
سازگاری دقیق‌تری داشته باشد.
در حال حاضر این متغیر دو اثر دارد:
.RS
.IP \(bu
غیرفعال کردن هشدارها به‌طور پیش‌فرض، زیرا POSIX نوشتن در خطای استاندارد را ممنوع می‌کند (به جز اعلان‌های
.BR \-ok )،
مگر اینکه دستور با کد وضعیت غیرصفر پایان یابد.
.IP \(bu
باعث می‌شود
.B \-ls
و
.B \-fls
به جای بلوک‌های ۱۰۲۴ بایتی از بلوک‌های ۵۱۲ بایتی استفاده کنند.
(POSIX این کنش‌ها را مشخص نمی‌کند، اما پیاده‌سازی‌های
.BR find (1)
در BSD از بلوک‌های ۵۱۲ بایتی استفاده می‌کنند، در حالی که
.BR find (1)
گنو به‌طور پیش‌فرض از بلوک‌های ۱۰۲۴ بایتی استفاده می‌کند.)
.PP
این متغیر الحاقات گوناگون
.B bfs
به قابلیت‌های پایه POSIX را غیرفعال نمی‌کند.
.B POSIXLY_CORRECT
همین اثرات را روی
.BR find (1)
گنو نیز دارد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.TP
.B bfs
بدون آرگومان،
.B bfs
تمام فایل‌های زیر دایرکتوری فعلی را با ترتیب سطح‌اول چاپ می‌کند.
.TP
.B bfs \-name '*.txt'
تمام فایل‌های .txt زیر دایرکتوری فعلی را چاپ می‌کند.
عبارت
.B *.txt
در گیومه قرار داده شده تا تضمین شود glob توسط
.B bfs
پردازش می‌شود و نه توسط پوسته.
.TP
.BI "bfs \-name access_log \-L " /var
تمام فایل‌های با نام
.B access_log
را در زیر مسیر
.IR /var ،
با دنبال کردن پیوندهای نمادین پیدا می‌کند.
.B bfs
اجازه می‌دهد پرچم‌ها و مسیرها در هر کجای خط فرمان قرار گیرند.
.TP
.BI "bfs " ~ " \-not \-user $USER"
تمام فایل‌های موجود در دایرکتوری خانگی شما که متعلق به شما نیستند را چاپ می‌کند.
.TP
.B bfs \-xtype l
پیوندهای نمادین شکسته را پیدا می‌کند.
.TP
.B bfs \-name config \-exclude \-name .git
تمام فایل‌های به نام
.BR config
را پیدا کرده و از تمام دایرکتوری‌های
.B .git
صرف‌نظر می‌کند.
.TP
.B bfs \-type f \-executable \-exec strip {} +
دستور
.BR strip (1)
را روی تمام فایل‌های اجرایی یافته‌شده اجرا می‌کند و چندین فایل را همزمان به آن ارسال می‌نماید.
.SH "اشکالات (BUGS)"
https://github.com/tavianator/bfs/issues
.SH "نویسنده (AUTHOR)"
Tavian Barnes <tavianator@tavianator.com>
.PP
https://tavianator.com/projects/bfs.html
.SH "همچنین ببینید (SEE ALSO)"
.BR find (1),
.BR locate (1),
.BR xargs (1)