.\" Hey, Emacs!  This is an -*- nroff -*- source file.
.\" Build-from-directory and this manpage are Copyright 1994 by Ian Jackson.
.\" Changes to this manpage are Copyright 1996 by Jeff Noxon.
.\" More
.\"
.\" This is free software; see the GNU General Public Licence version 2
.\" or later for copying conditions.  There is NO warranty.
.TH RUN\-PARTS 8 "27 Jun 2012" "Debian"
.SH "نام (NAME)"
run\-parts \- اجرای اسکریپت‌ها یا برنامه‌ها در یک دایرکتوری
.SH "خلاصه دستور (SYNOPSIS)"
.B run\-parts
[\-\-test] [\-\-verbose] [\-\-debug] [\-\-report] [\-\-lsbsysinit] [\-\-regex=RE]
[\-\-umask=umask] [\-\-arg=argument] [\-\-after=PROG] [\-\-before=PROG]
[\-\-exit\-on\-error] [\-\-help]
[\-\-version] [\-\-list] [\-\-reverse] [\-\-] DIRECTORY [DIRECTORY ...]
.PP
.B run\-parts
\-V
.SH "توضیحات (DESCRIPTION)"
دستور
.B run\-parts
تمام فایل‌های اجرایی که نام آن‌ها با محدودیت‌های ذکرشده در زیر مطابقت داشته باشد را در دایرکتوری
.IR directory
اجرا می‌کند. سایر فایل‌ها و دایرکتوری‌ها بی‌صدا نادیده گرفته می‌شوند.
.PP
اگر هیچ‌یک از گزینه‌های
.B \-\-lsbsysinit
یا
.B \-\-regex
داده نشوند، نام‌ها باید فقط شامل حروف بزرگ و کوچک اسکی (ASCII)، ارقام اسکی، زیرخط اسکی (underscore) و خط تیره اسکی (minus-hyphen) باشند.
.PP
اگر گزینه
.B \-\-lsbsysinit
داده شود، نباید نام‌ها به
\&.dpkg\-old
یا
\&.dpkg\-dist
یا
\&.dpkg\-new
یا
\&.dpkg\-tmp
ختم شوند، و باید متعلق به یک یا چند مورد از فضاهای نام زیر باشند: فضای نام تخصیص‌یافته توسط
LANANA
(^[a\-z0\-9]+$)؛ فضاهای نام سلسله‌مراتبی و رزروشده LSB
(^_?([a\-z0\-9_.]+\-)+[a\-z0\-9]+$)؛
و فضای نام اسکریپت کرون (cron) دبیان
(^[a\-zA-Z0\-9_\-]+$).
.PP
اگر گزینه
.B \-\-regex
داده شود، نام‌ها باید با عبارت باقاعده گسترش‌یافته سفارشی که به عنوان آرگومان آن گزینه مشخص شده مطابقت داشته باشند.
.PP
فایل‌ها به ترتیب الفبایی لکسیکال (بر اساس قواعد مرتب‌سازی نویسه محلی C/POSIX) نام‌هایشان اجرا می‌شوند، مگر اینکه گزینه
.B \-\-reverse
داده شود، که در این صورت با ترتیب معکوس اجرا می‌شوند.
.PP
اگر بیش از یک
DIRECTORY
مشخص شود، فایل‌های با نام یکسان در دایرکتوری‌های نخست نسبت به فایل‌های موجود در دایرکتوری‌هایی که در آرگومان‌های بعدی آمده‌اند اولویت خواهند داشت. این ویژگی به
run-parts
امکان می‌دهد دایرکتوری‌هایی حاوی اسکریپت را هم در
/usr
و هم در
/etc
دریافت کند اما اجازه دهد در صورت هم‌نام بودن، فایل‌های موجود در
/etc
جایگزین اسکریپت‌های موجود در
/usr
شوند. برای رخ دادن این حالت، باید مسیر دایرکتوری زیر
/etc
پیش از مسیر زیر
/usr
مشخص گردد.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-\-test
چاپ نام اسکریپت‌هایی که اجرا خواهند شد، بدون اینکه واقعاً اجرا شوند.
.TP
.B \-\-list
چاپ نام تمام فایل‌های منطبق (بدون محدود شدن به فایل‌های اجرایی)، بدون اینکه واقعاً اجرا شوند. این گزینه با
.B \-\-test
قابل استفاده نیست.
.TP
.B \-v, \-\-verbose
چاپ نام هر اسکریپت در stderr پیش از اجرا.
.TP
.B \-\-report
مشابه
.BR \-\-verbose ،
اما فقط نام اسکریپت‌هایی را چاپ می‌کند که خروجی تولید می‌کنند. نام اسکریپت در هر یک از stdout یا stderr که زودتر خروجی روی آن تولید شود، چاپ می‌گردد.
.TP
.B \-d, \-\-debug
چاپ اینکه کدام اسکریپت‌ها برای اجرا انتخاب می‌شوند و کدام نمی‌شوند در stderr.
.TP
.B \-\-reverse
معکوس کردن ترتیب اجرای اسکریپت‌ها.
.TP
.B \-\-exit\-on\-error
خروج به محض اینکه اسکریپتی کد خروجی غیر صفر بازگرداند.
.TP
.B \-\-stdin
تسهیم ورودی استاندارد (stdin) برای اسکریپت‌های در حال اجرا، با استفاده از یک فایل موقت.
.TP
.B \-\-lsbsysinit
استفاده از فضاهای نام LSB به‌جای رفتار کلاسیک.
.TP
.B \-\-new\-session
اجرای هر اسکریپت در یک نشست پردازشی (process session) مجزا. در صورت استفاده از این گزینه، کشتن
run-parts
اسکریپت در حال اجرا را متوقف نخواهد کرد و تا پایان ادامه خواهد یافت.
.TP
.BI \-\-regex= RE
اعتبارسنجی نام فایل‌ها بر اساس عبارت باقاعده گسترش‌یافته سفارشی
.IR RE .
برای مشاهده مثال به بخش مثال‌ها (EXAMPLES) مراجعه کنید.
.TP
.BI "\-u, \-\-umask=" umask
تنظیم umask روی
.I umask
پیش از اجرای اسکریپت‌ها.
.I umask
باید در مبنای هشت (اکتال) مشخص شود. به‌طور پیش‌فرض umask روی 022 تنظیم است.
.TP
.BI "\-a, \-\-arg=" argument
ارسال
.I argument
به اسکریپت‌ها. برای هر آرگومانی که مایلید ارسال شود یک بار از
.B \-\-arg
استفاده کنید.
.TP
.BI "\-A, \-\-after=" program
اجرای
.I program
پس از اجرای هر اسکریپت. برنامه با سه آرگومان فراخوانی خواهد شد: نام اسکریپت، وضعیت خروجی، و مقدار کل نوشته‌شده در جریان‌های خروجی و خطا. آخرین آرگومان همواره 0 خواهد بود مگر اینکه گزینه
.B \-\-report
نیز مشخص شده باشد. اگر از این گزینه چندین بار استفاده شود، فقط آخرین مورد اثر خواهد کرد. اگر برنامه فراخوانی‌شده با کد خطا خارج شود، مجدداً فراخوانی نخواهد شد.
.TP
.BI "\-B, \-\-before=" program
اجرای
.I program
پیش از اجرای هر اسکریپت. برنامه با یک آرگومان فراخوانی خواهد شد: نام اسکریپت. اگر از این گزینه چندین بار استفاده شود، فقط آخرین مورد اثر خواهد کرد. اگر برنامه فراخوانی‌شده با کد خطا خارج شود، مجدداً فراخوانی نخواهد شد.
.TP
.B "\-\-"
مشخص می‌کند که گزینه‌ها به پایان رسیده‌اند. هر نام فایلی پس از
.B "\-\-"
حتی اگر با خط تیره شروع شود، به عنوان گزینه تفسیر نخواهد شد.
.TP
.B \-h, \-\-help
نمایش اطلاعات نحوه استفاده و خروج.
.TP
.B \-V, \-\-version
نمایش نسخه و حق نشر و خروج.

.SH "مثال‌ها (EXAMPLES)"
چاپ نام تمام فایل‌های موجود در /etc که با `p` شروع شده و به `d` ختم می‌شوند:
.P
run-parts \-\-list \-\-regex \[aq]^p.*d$\[aq] /etc

.SH "حق نشر (COPYRIGHT)"
Copyright (C) 1994 Ian Jackson.
.P
Copyright (C) 1996 Jeff Noxon.
.P
Copyright (C) 1996, 1997, 1998 Guy Maor
.P
Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Clint Adams
.PP
دستور
.B run\-parts
یک نرم‌افزار آزاد است؛ برای شرایط کپی‌برداری به مجوز عمومی همگانی گنو (GNU GPL) نسخه ۲ یا بالاتر مراجعه کنید.
.I هیچ
ضمانتی وجود ندارد.