نام (NAME)

run-parts - اجرای اسکریپت‌ها یا برنامه‌ها در یک دایرکتوری

خلاصه دستور (SYNOPSIS)

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 ...]

run-parts -V

توضیحات (DESCRIPTION)

دستور run-parts تمام فایل‌های اجرایی که نام آن‌ها با محدودیت‌های ذکرشده در زیر مطابقت داشته باشد را در دایرکتوری directory اجرا می‌کند. سایر فایل‌ها و دایرکتوری‌ها بی‌صدا نادیده گرفته می‌شوند.

اگر هیچ‌یک از گزینه‌های --lsbsysinit یا --regex داده نشوند، نام‌ها باید فقط شامل حروف بزرگ و کوچک اسکی (ASCII)، ارقام اسکی، زیرخط اسکی (underscore) و خط تیره اسکی (minus-hyphen) باشند.

اگر گزینه --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_-]+$).

اگر گزینه --regex داده شود، نام‌ها باید با عبارت باقاعده گسترش‌یافته سفارشی که به عنوان آرگومان آن گزینه مشخص شده مطابقت داشته باشند.

فایل‌ها به ترتیب الفبایی لکسیکال (بر اساس قواعد مرتب‌سازی نویسه محلی C/POSIX) نام‌هایشان اجرا می‌شوند، مگر اینکه گزینه --reverse داده شود، که در این صورت با ترتیب معکوس اجرا می‌شوند.

اگر بیش از یک DIRECTORY مشخص شود، فایل‌های با نام یکسان در دایرکتوری‌های نخست نسبت به فایل‌های موجود در دایرکتوری‌هایی که در آرگومان‌های بعدی آمده‌اند اولویت خواهند داشت. این ویژگی به run-parts امکان می‌دهد دایرکتوری‌هایی حاوی اسکریپت را هم در /usr و هم در /etc دریافت کند اما اجازه دهد در صورت هم‌نام بودن، فایل‌های موجود در /etc جایگزین اسکریپت‌های موجود در /usr شوند. برای رخ دادن این حالت، باید مسیر دایرکتوری زیر /etc پیش از مسیر زیر /usr مشخص گردد.

گزینه‌ها (OPTIONS)

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

مثال‌ها (EXAMPLES)

چاپ نام تمام فایل‌های موجود در /etc که با `p` شروع شده و به `d` ختم می‌شوند:

run-parts --list --regex '^p.*d$' /etc

حق نشر (COPYRIGHT)

دستور run-parts یک نرم‌افزار آزاد است؛ برای شرایط کپی‌برداری به مجوز عمومی همگانی گنو (GNU GPL) نسخه ۲ یا بالاتر مراجعه کنید. هیچ ضمانتی وجود ندارد.