نام (NAME)

uustat - استعلام وضعیت و کنترل UUCP

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

uustat -a

uustat --all

uustat [ -eKRiMNQ ] [ -sS system ] [ -uU user ] [ -cC command ] [ -oy hours ] [ -B lines ] [ --executions ] [ --kill-all ] [ --rejuvenate-all ] [ --prompt ] [ --mail ] [ --notify ] [ --no-list ] [ --system system ] [ --not-system system ] [ --user user ] [ --not-user user ] [ --command command ] [ --not-command command ] [ --older-than hours ] [ --younger-than hours ] [ --mail-lines lines ]

uustat [ -kr jobid ] [ --kill jobid ] [ --rejuvenate jobid ]

uustat -q [ -sS system ] [ -oy hours ] [ --system system ] [ --not-system system ] [ --older-than hours ] [ --younger-than hours ]

uustat --list [ -sS system ] [ -oy hours ] [ --system system ] [ --not-system system ] [ --older-than hours ] [ --younger-than hours ]

uustat -m

uustat --status

uustat -p

uustat --ps

توضیحات (DESCRIPTION)

دستور uustat می‌تواند انواع مختلفی از اطلاعات وضعیت درباره سیستم UUCP را نمایش دهد. این دستور همچنین می‌تواند برای لغو یا تازه‌سازی درخواست‌های ثبت‌شده توسط uucp (1) یا uux (1) به کار رود.

به‌طور پیش‌فرض، uustat تمام کارهای صف‌بندی‌شده برای کاربر فراخواننده را نمایش می‌دهد؛ درست مانند این‌که گزینه --user همراه با آرگومان مناسب مشخص شده باشد.

اگر هر یک از گزینه‌های -a, --all, -e, --executions, -s, --system, -S, --not-system, -u, --user, -U, --not-user, -c, --command, -C, --not-command, -o, --older-than, -y, --younger-than مشخص شوند، تمام کارهایی که با مشخصات ترکیبی داده‌شده مطابقت داشته باشند نمایش داده خواهند شد.

گزینه -K یا --kill-all می‌تواند برای لغو و حذف گروه مشخصی از کارها استفاده شود؛ مانند تمام کارهایی که بیش از ۷ روز از ایجاد آن‌ها گذشته است.

گزینه‌ها (OPTIONS)

گزینه‌های زیر را می‌توان به uustat داد:

-a, --all: فهرست کردن تمام درخواست‌های انتقال فایل در صف.
-e, --executions: فهرست کردن درخواست‌های اجرای در صف، به جای درخواست‌های انتقال فایل در صف. درخواست‌های اجرای در صف به جای uucico (8) توسط uuxqt (8) پردازش می‌شوند. ممکن است درخواست‌های اجرای در صف در انتظار انتقال فایلی از یک سیستم راه دور باشند. این درخواست‌ها با فراخوانی uux (1) ایجاد می‌شوند.
-s system, --system system: فهرست کردن تمام کارهای صف‌بندی‌شده برای سیستم نام‌برده. این گزینه‌ها می‌توانند چندین بار مشخص شوند که در این حالت تمام کارهای مربوط به تمامی آن سیستم‌ها فهرست خواهند شد. در صورت استفاده همراه با --list تنها سیستم‌های نام‌برده فهرست می‌شوند.
-S system, --not-system system: فهرست کردن تمام کارهای در صف برای سیستم‌هایی غیر از سیستم نام‌برده. این گزینه‌ها می‌توانند چندین بار مشخص شوند که در این حالت هیچ کاری از سیستم‌های مشخص‌شده فهرست نخواهد شد. در صورت استفاده همراه با --list تنها سیستم‌هایی که نام برده نشده‌اند فهرست خواهند شد. این گزینه‌ها را نمی‌توان همراه با -s یا --system به کار برد.
-u user, --user user: فهرست کردن تمام کارهای صف‌بندی‌شده برای کاربر نام‌برده. این گزینه‌ها می‌توانند چندین بار مشخص شوند که در این حالت تمام کارهای تمامی آن کاربران فهرست خواهند شد.
-U user, --not-user user: فهرست کردن تمام کارهای در صف برای کاربرانی غیر از کاربر نام‌برده. این گزینه‌ها می‌توانند چندین بار مشخص شوند که در این حالت هیچ کاری از کاربران مشخص‌شده فهرست نخواهد شد. این گزینه‌ها را نمی‌توان همراه با -u یا --user به کار برد.
-c command, --command command: فهرست کردن تمام کارهایی که درخواست اجرای دستور نام‌برده را دارند. اگر command برابر با ALL باشد، تمام کارهایی که درخواست اجرای دستوری را دارند (در مقایسه با درخواست صرف برای انتقال فایل) فهرست می‌شوند. این گزینه‌ها می‌توانند چندین بار مشخص شوند که در این حالت تمام کارهای درخواست‌کننده هر یک از این دستورات فهرست خواهند شد.
-C command, --not-command command: فهرست کردن تمام کارهایی که درخواست اجرای دستوری غیر از دستور نام‌برده را دارند، یا اگر command برابر با ALL باشد، فهرست کردن تمام کارهایی که صرفاً درخواست انتقال فایل دارند (در مقایسه با درخواست اجرای یک دستور). این گزینه‌ها می‌توانند چندین بار مشخص شوند که در این حالت هیچ کاری با درخواست یکی از دستورات مشخص‌شده فهرست نخواهد شد. این گزینه‌ها را نمی‌توان همراه با -c یا --command استفاده کرد.
-o hours, --older-than hours: فهرست کردن تمام کارهای در صف که عمر آن‌ها بیشتر از تعداد ساعت داده‌شده است. در صورت استفاده همراه با --list تنها سیستم‌هایی که قدیمی‌ترین کار آن‌ها بیش از تعداد ساعت مشخص‌شده عمر دارد فهرست خواهند شد.
-y hours, --younger-than hours: فهرست کردن تمام کارهای در صف که عمر آن‌ها کمتر از تعداد ساعت داده‌شده است. در صورت استفاده همراه با --list تنها سیستم‌هایی که قدیمی‌ترین کار آن‌ها کمتر از تعداد ساعت مشخص‌شده عمر دارد فهرست خواهند شد.
-k jobid, --kill jobid: لغو و حذف کار مشخص‌شده. شناسه کار در قالب خروجی پیش‌فرض و همچنین با گزینه -j یا --jobid در uucp (1) یا uux (1) نمایش داده می‌شود. یک کار تنها توسط کاربری که آن را ایجاد کرده، یا مدیر UUCP یا مدیر سیستم (superuser) قابل لغو است. گزینه‌های -k یا --kill می‌توانند چندین بار در خط فرمان استفاده شوند تا چندین کار حذف شوند.
-r jobid, --rejuvenate jobid: تازه‌سازی کار مشخص‌شده. این عمل آن را به عنوان کاری که در زمان فعلی اجرا شده علامت‌گذاری می‌کند، که بر خروجی گزینه‌های -o, --older-than, -y, یا --younger-than تأثیر گذاشته و آن را از دیمن پاک‌سازی خودکار در امان نگه می‌دارد. شناسه کار در قالب خروجی پیش‌فرض و همچنین با گزینه‌های -j یا --jobid در uucp (1) یا uux (1) نمایش داده می‌شود. یک کار تنها توسط کاربری که آن را ایجاد کرده، یا مدیر UUCP یا مدیر سیستم (superuser) قابل تازه‌سازی است. گزینه‌های -r یا --rejuvenate می‌توانند چندین بار در خط فرمان برای تازه‌سازی چندین کار به کار روند.
-q, --list: نمایش وضعیت دستورات، اجراها و مکالمات برای تمامی سیستم‌های راه دور که دستورات یا اجراهایی برای آن‌ها در صف است. گزینه‌های -s, --system, -S, --not-system, -o, --older-than, -y, و --younger-than می‌توانند برای محدود کردن سیستم‌های فهرست‌شده استفاده شوند. سیستم‌هایی که هیچ دستور یا اجرایی برای آن‌ها در صف نیست هرگز فهرست نخواهند شد.
-m, --status: نمایش وضعیت مکالمات برای تمامی سیستم‌های راه دور.
-p, --ps: نمایش وضعیت تمامی فرایندهایی که قفل‌های UUCP را روی سیستم‌ها یا پورت‌ها نگه داشته‌اند.
-i, --prompt: برای هر کار فهرست‌شده، می‌پرسد که آیا کار لغو و حذف شود یا خیر. اگر اولین نویسه خط ورودی y یا Y باشد، کار لغو خواهد شد.
-K, --kill-all: لغو و حذف خودکار تک‌تک کارهای فهرست‌شده. این گزینه می‌تواند در ترکیب با گزینه‌های --mail و --notify برای اسکریپت‌های پاک‌سازی خودکار مفید باشد.
-R, --rejuvenate-all: تازه‌سازی خودکار تک‌تک کارهای فهرست‌شده. این گزینه را نمی‌توان همراه با --kill-all استفاده کرد.
-M, --mail: برای هر کار فهرست‌شده، نامه‌ای به مدیر UUCP ارسال شود. اگر کار لغو شود (به دلیل --kill-all یا --prompt همراه با پاسخ مثبت)، نامه ارسالی این موضوع را مشخص خواهد کرد. توضیحی که با گزینه --comment مشخص شده است می‌تواند در نامه گنجانده شود. اگر کار از نوع اجرا باشد، بخش آغازین ورودی استاندارد آن در پیام نامه گنجانده خواهد شد؛ تعداد خطوطی که باید گنجانده شوند را می‌توان با گزینه --mail-lines تنظیم کرد (مقدار پیش‌فرض ۱۰۰ است). اگر ورودی استاندارد حاوی نویسه‌های تهی (null) باشد، به عنوان یک فایل باینری در نظر گرفته شده و گنجانده نمی‌شود.
-N, --notify: برای هر کار فهرست‌شده، نامه‌ای به کاربری که درخواست کار را داده ارسال شود. این نامه مشابه نامه‌ای است که توسط گزینه‌های -M یا --mail ارسال می‌شود.
-W comment, --comment comment: مشخص کردن توضیحی برای گنجانده شدن در نامه‌های ارسالی با گزینه‌های -M, --mail, -N, یا --notify.
-B lines, --mail-lines lines: هنگامی که گزینه‌های -M, --mail, -N, یا --notify برای ارسال نامه درباره یک دستور اجرایی با ورودی استاندارد استفاده می‌شوند، این گزینه تعداد خطوط ورودی استاندارد را که باید در پیام گنجانده شوند کنترل می‌کند. مقدار پیش‌فرض ۱۰۰ است.
-Q, --no-list: کارها را به صورت واقعی فهرست نمی‌کند، بلکه تنها اقداماتی را که توسط گزینه‌های -i, --prompt, -K, --kill-all, -M, --mail, -N یا --notify مشخص شده‌اند به انجام می‌رساند.
-x type, --debug type: فعال کردن انواع خاصی از اشکال‌زدایی. انواع زیر شناخته شده‌اند: abnormal, chat, handshake, uucp-proto, proto, port, config, spooldir, execute, incoming, outgoing. تنها انواع abnormal، config، spooldir و execute برای uustat معنادار هستند.

می‌توان چندین نوع را با کاما جدا کرده و مشخص نمود، و گزینه --debug می‌تواند چندین بار تکرار شود. همچنین می‌توان یک عدد مشخص کرد که به همان تعداد، انواع را از فهرست فوق فعال خواهد کرد؛ برای نمونه، --debug 2 معادل است با --debug abnormal,chat.

-I file, --config file: تنظیم فایل پیکربندی مورد استفاده. بسته به نحوه کامپایل uustat ممکن است این گزینه در دسترس نباشد.
-v, --version: گزارش اطلاعات نسخه و خروج.
--help: نمایش پیام راهنما و خروج.

مثال‌ها (EXAMPLES)

uustat --all

نمایش وضعیت تمامی کارها. یک نمونه خط خروجی به صورت زیر است:

bugsA027h bugs ian 04-01 13:50 Executing rmail ian@airs.com (sending 1283 bytes)

قالب به این صورت است:

jobid system user queue-date command (size)

مقدار jobid را می‌توان به گزینه‌های --kill یا --rejuvenate داد. مقدار size مشخص می‌کند چه مقدار داده باید به سیستم راه دور منتقل شود، و برای درخواست دریافت فایل وجود ندارد. گزینه‌های --system, --not-system, --user, --not-user, --command, --not-command, --older-than, و --younger-than می‌توانند برای کنترل این‌که کدام کارها فهرست شوند استفاده شوند.

uustat --executions

نمایش وضعیت درخواست‌های اجرای در صف قرار گرفته. یک نمونه خط خروجی به شرح زیر است:

bugs bugs!ian 05-20 12:51 rmail ian

قالب به این صورت است:

system requestor queue-date command

گزینه‌های --system, --not-system, --user, --not-user, --command, --not-command, --older-than, و --younger-than می‌توانند برای کنترل این‌که کدام درخواست‌ها فهرست شوند استفاده شوند.

uustat --list

نمایش وضعیت برای تمامی سیستم‌هایی که دستورات در صف دارند. یک نمونه خط خروجی به صورت زیر است:

bugs            4C (1 hour)   0X (0 secs) 04-01 14:45 Dial failed

این خروجی نام سیستم، تعداد دستورات در صف، عمر قدیمی‌ترین دستور در صف، تعداد اجراهای محلی در صف، عمر قدیمی‌ترین اجرای در صف، تاریخ آخرین مکالمه و وضعیت آن مکالمه را نشان می‌دهد.

uustat --status

نمایش وضعیت مکالمه برای تمامی سیستم‌های راه دور. یک نمونه خط خروجی به صورت زیر است:

bugs           04-01 15:51 Conversation complete

این خروجی نام سیستم، تاریخ آخرین مکالمه و وضعیت آن مکالمه را نشان می‌دهد. اگر آخرین مکالمه با شکست مواجه شده باشد، uustat مشخص می‌کند چه تعداد تلاش برای تماس با سیستم انجام شده است. اگر دوره تلاش مجدد (retry period) در حال حاضر از برقراری تماس با آن سیستم جلوگیری می‌کند، uustat همچنین زمانی را که تماس بعدی مجاز خواهد بود نمایش می‌دهد.

uustat --ps

نمایش وضعیت تمام فرایندهایی که قفل‌های UUCP را در دست دارند. قالب خروجی وابسته به سیستم است، زیرا uustat صرفاً دستور ps (1) را برای هر فرایند نگه‌دارنده قفل فراخوانی می‌کند.

uustat --command rmail --older-than 168 --kill-all --no-list --mail --notify --comment "Queued for over 1 week"

این دستور تمام دستورات rmail را که بیش از ۱ هفته (۱۶۸ ساعت) در صف در انتظار ارسال مانده‌اند لغو و حذف می‌کند. برای هر دستور از این دست، نامه‌ای هم به مدیر UUCP و هم به کاربری که درخواست اجرای rmail را داده ارسال خواهد شد. پیام نامه ارسالی شامل رشته متنی مشخص‌شده توسط گزینه --comment خواهد بود. گزینه --no-list از نمایش فهرست کارها در ترمینال جلوگیری می‌کند، بنابراین هرگونه خروجی برنامه تنها پیام‌های خطا خواهد بود.

همچنین ببینید (SEE ALSO)

ps(1), rmail(1), uucp(1), uux(1), uucico(8), uuxqt(8)

نویسنده (AUTHOR)

Ian Lance Taylor (ian@airs.com)