''' $Id: uustat.1,v 1.14 2002/03/05 22:15:10 ian Rel $
.TH uustat 1 "Taylor UUCP 1.07"
.SH "نام (NAME)"
uustat \- استعلام وضعیت و کنترل UUCP
.SH "خلاصه دستور (SYNOPSIS)"
.B uustat \-a
.PP
.B uustat \-\-all
.PP
.B uustat
[
.B \-eKRiMNQ ] [
.B \-sS
system ] [
.B \-uU
user ] [
.B \-cC
command ] [
.B \-oy
hours ] [
.B \-B
lines ] [
.B \-\-executions
] [
.B \-\-kill-all
] [
.B \-\-rejuvenate-all
] [
.B \-\-prompt
] [
.B \-\-mail
] [
.B \-\-notify
] [
.B \-\-no-list
] [
.B \-\-system
system ] [
.B \-\-not-system
system ] [
.B \-\-user
user ] [
.B \-\-not-user
user ] [
.B \-\-command
command ] [
.B \-\-not-command
command ] [
.B \-\-older-than
hours ] [
.B \-\-younger-than
hours ] [
.B \-\-mail-lines
lines ]
.PP
.B uustat
[
.B \-kr
jobid ] [
.B \-\-kill
jobid ] [
.B \-\-rejuvenate
jobid ]
.PP
.B uustat \-q [
.B \-sS
system ] [
.B \-oy
hours ] [
.B \-\-system
system ] [
.B \-\-not-system
system ] [
.B \-\-older-than
hours ] [
.B \-\-younger-than
hours ]
.PP
.B uustat \-\-list [
.B \-sS
system ] [
.B \-oy
hours ] [
.B \-\-system
system ] [
.B \-\-not-system
system ] [
.B \-\-older-than
hours ] [
.B \-\-younger-than
hours ]
.PP
.B uustat \-m
.PP
.B uustat \-\-status
.PP
.B uustat \-p
.PP
.B uustat \-\-ps
.SH "توضیحات (DESCRIPTION)"
دستور
.I uustat
می‌تواند انواع مختلفی از اطلاعات وضعیت درباره سیستم UUCP را نمایش دهد. این دستور همچنین می‌تواند برای لغو یا تازه‌سازی درخواست‌های ثبت‌شده توسط
.I uucp
(1) یا
.I uux
(1) به کار رود.
.PP
به‌طور پیش‌فرض،
.I uustat
تمام کارهای صف‌بندی‌شده برای کاربر فراخواننده را نمایش می‌دهد؛ درست مانند این‌که گزینه
.B \-\-user
همراه با آرگومان مناسب مشخص شده باشد.
.PP
اگر هر یک از گزینه‌های
.B \-a,
.B \-\-all,
.B \-e,
.B \-\-executions,
.B \-s,
.B \-\-system,
.B \-S,
.B \-\-not-system,
.B \-u,
.B \-\-user,
.B \-U,
.B \-\-not-user,
.B \-c,
.B \-\-command,
.B \-C,
.B \-\-not-command,
.B \-o,
.B \-\-older-than,
.B \-y,
.B \-\-younger-than
مشخص شوند، تمام کارهایی که با مشخصات ترکیبی داده‌شده مطابقت داشته باشند نمایش داده خواهند شد.
.PP
گزینه
.B \-K
یا
.B \-\-kill-all
می‌تواند برای لغو و حذف گروه مشخصی از کارها استفاده شود؛ مانند تمام کارهایی که بیش از ۷ روز از ایجاد آن‌ها گذشته است.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر را می‌توان به
.I uustat
داد:
.TP 5
.B \-a, \-\-all
فهرست کردن تمام درخواست‌های انتقال فایل در صف.
.TP 5
.B \-e, \-\-executions
فهرست کردن درخواست‌های اجرای در صف، به جای درخواست‌های انتقال فایل در صف. درخواست‌های اجرای در صف به جای
.I uucico
(8) توسط
.I uuxqt
(8) پردازش می‌شوند. ممکن است درخواست‌های اجرای در صف در انتظار انتقال فایلی از یک سیستم راه دور باشند. این درخواست‌ها با فراخوانی
.I uux
(1) ایجاد می‌شوند.
.TP 5
.B \-s system, \-\-system system
فهرست کردن تمام کارهای صف‌بندی‌شده برای سیستم نام‌برده. این گزینه‌ها می‌توانند چندین بار مشخص شوند که در این حالت تمام کارهای مربوط به تمامی آن سیستم‌ها فهرست خواهند شد. در صورت استفاده همراه با
.B \-\-list
تنها سیستم‌های نام‌برده فهرست می‌شوند.
.TP 5
.B \-S system, \-\-not-system system
فهرست کردن تمام کارهای در صف برای سیستم‌هایی غیر از سیستم نام‌برده. این گزینه‌ها می‌توانند چندین بار مشخص شوند که در این حالت هیچ کاری از سیستم‌های مشخص‌شده فهرست نخواهد شد. در صورت استفاده همراه با
.B \-\-list
تنها سیستم‌هایی که نام برده نشده‌اند فهرست خواهند شد. این گزینه‌ها را نمی‌توان همراه با
.B \-s
یا
.B \-\-system
به کار برد.
.TP 5
.B \-u user, \-\-user user
فهرست کردن تمام کارهای صف‌بندی‌شده برای کاربر نام‌برده. این گزینه‌ها می‌توانند چندین بار مشخص شوند که در این حالت تمام کارهای تمامی آن کاربران فهرست خواهند شد.
.TP 5
.B \-U user, \-\-not-user user
فهرست کردن تمام کارهای در صف برای کاربرانی غیر از کاربر نام‌برده. این گزینه‌ها می‌توانند چندین بار مشخص شوند که در این حالت هیچ کاری از کاربران مشخص‌شده فهرست نخواهد شد. این گزینه‌ها را نمی‌توان همراه با
.B \-u
یا
.B \-\-user
به کار برد.
.TP 5
.B \-c command, \-\-command command
فهرست کردن تمام کارهایی که درخواست اجرای دستور نام‌برده را دارند. اگر
.B command
برابر با
.I ALL
باشد، تمام کارهایی که درخواست اجرای دستوری را دارند (در مقایسه با درخواست صرف برای انتقال فایل) فهرست می‌شوند. این گزینه‌ها می‌توانند چندین بار مشخص شوند که در این حالت تمام کارهای درخواست‌کننده هر یک از این دستورات فهرست خواهند شد.
.TP 5
.B \-C command, \-\-not-command command
فهرست کردن تمام کارهایی که درخواست اجرای دستوری غیر از دستور نام‌برده را دارند، یا اگر
.B command
برابر با
.I ALL
باشد، فهرست کردن تمام کارهایی که صرفاً درخواست انتقال فایل دارند (در مقایسه با درخواست اجرای یک دستور). این گزینه‌ها می‌توانند چندین بار مشخص شوند که در این حالت هیچ کاری با درخواست یکی از دستورات مشخص‌شده فهرست نخواهد شد. این گزینه‌ها را نمی‌توان همراه با
.B \-c
یا
.B \-\-command
استفاده کرد.
.TP 5
.B \-o hours, \-\-older-than hours
فهرست کردن تمام کارهای در صف که عمر آن‌ها بیشتر از تعداد ساعت داده‌شده است. در صورت استفاده همراه با
.B \-\-list
تنها سیستم‌هایی که قدیمی‌ترین کار آن‌ها بیش از تعداد ساعت مشخص‌شده عمر دارد فهرست خواهند شد.
.TP 5
.B \-y hours, \-\-younger-than hours
فهرست کردن تمام کارهای در صف که عمر آن‌ها کمتر از تعداد ساعت داده‌شده است. در صورت استفاده همراه با
.B \-\-list
تنها سیستم‌هایی که قدیمی‌ترین کار آن‌ها کمتر از تعداد ساعت مشخص‌شده عمر دارد فهرست خواهند شد.
.TP 5
.B \-k jobid, \-\-kill jobid
لغو و حذف کار مشخص‌شده. شناسه کار در قالب خروجی پیش‌فرض و همچنین با گزینه
.B \-j
یا
.B \-\-jobid
در
.I uucp
(1) یا
.I uux
(1) نمایش داده می‌شود. یک کار تنها توسط کاربری که آن را ایجاد کرده، یا مدیر UUCP یا مدیر سیستم (superuser) قابل لغو است. گزینه‌های
.B \-k
یا
.B \-\-kill
می‌توانند چندین بار در خط فرمان استفاده شوند تا چندین کار حذف شوند.
.TP 5
.B \-r jobid, \-\-rejuvenate jobid
تازه‌سازی کار مشخص‌شده. این عمل آن را به عنوان کاری که در زمان فعلی اجرا شده علامت‌گذاری می‌کند، که بر خروجی گزینه‌های
.B \-o,
.B \-\-older-than,
.B \-y,
یا
.B \-\-younger-than
تأثیر گذاشته و آن را از دیمن پاک‌سازی خودکار در امان نگه می‌دارد. شناسه کار در قالب خروجی پیش‌فرض و همچنین با گزینه‌های
.B \-j
یا
.B \-\-jobid
در
.I uucp
(1) یا
.I uux
(1) نمایش داده می‌شود. یک کار تنها توسط کاربری که آن را ایجاد کرده، یا مدیر UUCP یا مدیر سیستم (superuser) قابل تازه‌سازی است. گزینه‌های
.B \-r
یا
.B \-\-rejuvenate
می‌توانند چندین بار در خط فرمان برای تازه‌سازی چندین کار به کار روند.
.TP 5
.B \-q, \-\-list
نمایش وضعیت دستورات، اجراها و مکالمات برای تمامی سیستم‌های راه دور که دستورات یا اجراهایی برای آن‌ها در صف است. گزینه‌های
.B \-s,
.B \-\-system,
.B \-S,
.B \-\-not-system,
.B \-o,
.B \-\-older-than,
.B \-y,
و
.B \-\-younger-than
می‌توانند برای محدود کردن سیستم‌های فهرست‌شده استفاده شوند. سیستم‌هایی که هیچ دستور یا اجرایی برای آن‌ها در صف نیست هرگز فهرست نخواهند شد.
.TP 5
.B \-m, \-\-status
نمایش وضعیت مکالمات برای تمامی سیستم‌های راه دور.
.TP 5
.B \-p, \-\-ps
نمایش وضعیت تمامی فرایندهایی که قفل‌های UUCP را روی سیستم‌ها یا پورت‌ها نگه داشته‌اند.
.TP 5
.B \-i, \-\-prompt
برای هر کار فهرست‌شده، می‌پرسد که آیا کار لغو و حذف شود یا خیر. اگر اولین نویسه خط ورودی
.I y
یا
.I Y
باشد، کار لغو خواهد شد.
.TP 5
.B \-K, \-\-kill-all
لغو و حذف خودکار تک‌تک کارهای فهرست‌شده. این گزینه می‌تواند در ترکیب با گزینه‌های
.B \-\-mail
و
.B \-\-notify
برای اسکریپت‌های پاک‌سازی خودکار مفید باشد.
.TP 5
.B \-R, \-\-rejuvenate-all
تازه‌سازی خودکار تک‌تک کارهای فهرست‌شده. این گزینه را نمی‌توان همراه با
.B \-\-kill-all
استفاده کرد.
.TP 5
.B \-M, \-\-mail
برای هر کار فهرست‌شده، نامه‌ای به مدیر UUCP ارسال شود. اگر کار لغو شود (به دلیل
.B \-\-kill-all
یا
.B \-\-prompt
همراه با پاسخ مثبت)، نامه ارسالی این موضوع را مشخص خواهد کرد. توضیحی که با گزینه
.B \-\-comment
مشخص شده است می‌تواند در نامه گنجانده شود. اگر کار از نوع اجرا باشد، بخش آغازین ورودی استاندارد آن در پیام نامه گنجانده خواهد شد؛ تعداد خطوطی که باید گنجانده شوند را می‌توان با گزینه
.B \-\-mail-lines
تنظیم کرد (مقدار پیش‌فرض ۱۰۰ است). اگر ورودی استاندارد حاوی نویسه‌های تهی (null) باشد، به عنوان یک فایل باینری در نظر گرفته شده و گنجانده نمی‌شود.
.TP 5
.B \-N, \-\-notify
برای هر کار فهرست‌شده، نامه‌ای به کاربری که درخواست کار را داده ارسال شود. این نامه مشابه نامه‌ای است که توسط گزینه‌های
.B \-M
یا
.B \-\-mail
ارسال می‌شود.
.TP 5
.B \-W comment, \-\-comment comment
مشخص کردن توضیحی برای گنجانده شدن در نامه‌های ارسالی با گزینه‌های
.B \-M,
.B \-\-mail,
.B \-N,
یا
.B \-\-notify.
.TP 5
.B \-B lines, \-\-mail-lines lines
هنگامی که گزینه‌های
.B \-M,
.B \-\-mail,
.B \-N,
یا
.B \-\-notify
برای ارسال نامه درباره یک دستور اجرایی با ورودی استاندارد استفاده می‌شوند، این گزینه تعداد خطوط ورودی استاندارد را که باید در پیام گنجانده شوند کنترل می‌کند. مقدار پیش‌فرض ۱۰۰ است.
.TP 5
.B \-Q, \-\-no-list
کارها را به صورت واقعی فهرست نمی‌کند، بلکه تنها اقداماتی را که توسط گزینه‌های
.B \-i,
.B \-\-prompt,
.B \-K,
.B \-\-kill-all,
.B \-M,
.B \-\-mail,
.B \-N
یا
.B \-\-notify
مشخص شده‌اند به انجام می‌رساند.
.TP 5
.B \-x type, \-\-debug type
فعال کردن انواع خاصی از اشکال‌زدایی. انواع زیر شناخته شده‌اند:
abnormal, chat, handshake, uucp-proto, proto, port, config, spooldir, execute, incoming, outgoing.
تنها انواع abnormal، config، spooldir و execute برای
.I uustat
معنادار هستند.
.PP
می‌توان چندین نوع را با کاما جدا کرده و مشخص نمود، و گزینه
.B \-\-debug
می‌تواند چندین بار تکرار شود. همچنین می‌توان یک عدد مشخص کرد که به همان تعداد، انواع را از فهرست فوق فعال خواهد کرد؛ برای نمونه،
.B \-\-debug 2
معادل است با
.B \-\-debug abnormal,chat.
.TP 5
.B \-I file, \-\-config file
تنظیم فایل پیکربندی مورد استفاده. بسته به نحوه کامپایل
.I uustat
ممکن است این گزینه در دسترس نباشد.
.TP 5
.B \-v, \-\-version
گزارش اطلاعات نسخه و خروج.
.TP 5
.B \-\-help
نمایش پیام راهنما و خروج.
.SH "مثال‌ها (EXAMPLES)"
.br
.nf
uustat --all
.fi
نمایش وضعیت تمامی کارها. یک نمونه خط خروجی به صورت زیر است:
.br
.in +0.5i
.nf
bugsA027h bugs ian 04-01 13:50 Executing rmail ian@airs.com (sending 1283 bytes)
.fi
.in -0.5i
قالب به این صورت است:
.br
.in +0.5i
.nf
jobid system user queue-date command (size)
.fi
.in -0.5i
مقدار jobid را می‌توان به گزینه‌های
.B \-\-kill
یا
.B \-\-rejuvenate
داد.
مقدار size مشخص می‌کند چه مقدار داده باید به سیستم راه دور منتقل شود، و برای درخواست دریافت فایل وجود ندارد.
گزینه‌های
.B \-\-system,
.B \-\-not-system,
.B \-\-user,
.B \-\-not-user,
.B \-\-command,
.B \-\-not-command,
.B \-\-older-than,
و
.B \-\-younger-than
می‌توانند برای کنترل این‌که کدام کارها فهرست شوند استفاده شوند.
.PP
.br
.nf
uustat --executions
.fi
نمایش وضعیت درخواست‌های اجرای در صف قرار گرفته. یک نمونه خط خروجی به شرح زیر است:
.br
.in +0.5i
.nf
bugs bugs!ian 05-20 12:51 rmail ian
.fi
.in -0.5i
قالب به این صورت است:
.br
.in +0.5i
.nf
system requestor queue-date command
.fi
.in -0.5i
گزینه‌های
.B \-\-system,
.B \-\-not-system,
.B \-\-user,
.B \-\-not-user,
.B \-\-command,
.B \-\-not-command,
.B \-\-older-than,
و
.B \-\-younger-than
می‌توانند برای کنترل این‌که کدام درخواست‌ها فهرست شوند استفاده شوند.
.PP
.br
.nf
uustat --list
.fi
نمایش وضعیت برای تمامی سیستم‌هایی که دستورات در صف دارند. یک نمونه خط خروجی به صورت زیر است:
.br
.in +0.5i
.nf
bugs            4C (1 hour)   0X (0 secs) 04-01 14:45 Dial failed
.fi
.in -0.5i
این خروجی نام سیستم، تعداد دستورات در صف، عمر قدیمی‌ترین دستور در صف، تعداد اجراهای محلی در صف، عمر قدیمی‌ترین اجرای در صف، تاریخ آخرین مکالمه و وضعیت آن مکالمه را نشان می‌دهد.
.PP
.br
.nf
uustat --status
.fi
نمایش وضعیت مکالمه برای تمامی سیستم‌های راه دور. یک نمونه خط خروجی به صورت زیر است:
.br
.in +0.5i
.nf
bugs           04-01 15:51 Conversation complete
.fi
.in -0.5i
این خروجی نام سیستم، تاریخ آخرین مکالمه و وضعیت آن مکالمه را نشان می‌دهد. اگر آخرین مکالمه با شکست مواجه شده باشد،
.I uustat
مشخص می‌کند چه تعداد تلاش برای تماس با سیستم انجام شده است. اگر دوره تلاش مجدد (retry period) در حال حاضر از برقراری تماس با آن سیستم جلوگیری می‌کند،
.I uustat
همچنین زمانی را که تماس بعدی مجاز خواهد بود نمایش می‌دهد.
.PP
.br
.nf
uustat --ps
.fi
نمایش وضعیت تمام فرایندهایی که قفل‌های UUCP را در دست دارند. قالب خروجی وابسته به سیستم است، زیرا
.I uustat
صرفاً دستور
.I ps
(1) را برای هر فرایند نگه‌دارنده قفل فراخوانی می‌کند.
.PP
.br
.in +0.5i
.nf
uustat --command rmail --older-than 168 --kill-all --no-list --mail --notify --comment "Queued for over 1 week"
.fi
.in -0.5i
این دستور تمام دستورات
.I rmail
را که بیش از ۱ هفته (۱۶۸ ساعت) در صف در انتظار ارسال مانده‌اند لغو و حذف می‌کند. برای هر دستور از این دست، نامه‌ای هم به مدیر UUCP و هم به کاربری که درخواست اجرای rmail را داده ارسال خواهد شد. پیام نامه ارسالی شامل رشته متنی مشخص‌شده توسط گزینه
.B \-\-comment
خواهد بود. گزینه
.B \-\-no-list
از نمایش فهرست کارها در ترمینال جلوگیری می‌کند، بنابراین هرگونه خروجی برنامه تنها پیام‌های خطا خواهد بود.
.SH "همچنین ببینید (SEE ALSO)"
ps(1), rmail(1), uucp(1), uux(1), uucico(8), uuxqt(8)
.SH "نویسنده (AUTHOR)"
Ian Lance Taylor
(ian@airs.com)