'\" t
.\"     Title: pkttyagent
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: May 2009
.\"    Manual: pkttyagent
.\"    Source: polkit
.\"  Language: Persian
.\"
.TH "PKTTYAGENT" "1" "May 2009" "polkit" "pkttyagent"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
pkttyagent \- ابزار کمکی احراز هویت متنی
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpkttyagent\fR\ 'u
\fBpkttyagent\fR [\fB\-\-version\fR] [\fB\-\-help\fR]
.HP \w'\fBpkttyagent\fR\ 'u
\fBpkttyagent\fR [\fB\-\-process\fR\ {\ \fIpid\fR\ |\ \fIpid,pid\-start\-time\fR\ } | \fB\-\-system\-bus\-name\fR\ \fIbusname\fR] [\fB\-\-notify\-fd\fR\ \fIfd\fR] [\fB\-\-fallback\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBpkttyagent\fR
برای راه‌اندازی یک عامل احراز هویت متنی برای موضوع مشخص‌شده توسط
\fB\-\-process\fR
یا
\fB\-\-system\-bus\-name\fR
به کار می‌رود\&. اگر هیچ‌یک از این گزینه‌ها مشخص نشوند، از فرایند والد استفاده می‌شود\&.
.PP
برای مطلع‌شدن از زمان ثبت عامل احراز هویت، می‌توانید به سیگنال D\-Bus با عنوان
Changed
گوش دهید یا از
\fB\-\-notify\-fd\fR
برای ارسال شماره توصیف‌کننده فایلی (file descriptor) که به برنامه داده شده است، استفاده کنید\&. پس از آنکه عامل احراز هویت با موفقیت ثبت شد، این توصیف‌کننده فایل بسته خواهد شد\&.
.PP
اگر از
\fB\-\-fallback\fR
استفاده شود، عامل احراز هویت متنی جایگزین یک عامل احراز هویت موجود نخواهد شد\&.
.SH "وضعیت خروج (EXIT STATUS)"
.PP
اگر عامل احراز هویت نتواند ثبت شود،
\fBpkttyagent\fR
با کد خروج 127 پایان می‌یابد\&. پیام‌های عیب‌یابی در خروجی استاندارد خطا چاپ می‌شوند\&.
.PP
اگر یک یا چند مورد از گزینه‌های ارسال‌شده نامعتبر باشند،
\fBpkttyagent\fR
با کد خروج 126 خارج می‌شود\&. اگر ورودی استاندارد (stdin) یک tty باشد، این صفحه راهنما نیز نمایش داده می‌شود\&.
.PP
اگر عامل احراز هویت با موفقیت ثبت شود،
\fBpkttyagent\fR
به اجرای خود ادامه داده و برحسب نیاز با کاربر تعامل خواهد داشت\&. زمانی که دیگر نیازی به خدمات آن نباشد، می‌توان فرایند را متوقف کرد (kill کرد)\&.
.SH "نکات (NOTES)"
.PP
از آنجا که شناسه‌های فرایند (PID) ممکن است بازیافت و دوباره مصرف شوند، فراخواننده باید همیشه هنگام استفاده از گزینه
\fB\-\-process\fR
از قالب
\fIpid,pid\-start\-time\fR
استفاده کند\&. مقدار
\fIpid\-start\-time\fR
بسته به سیستم‌عامل می‌تواند از طریق مراجعه به مواردی چون سیستم فایل
\fBproc\fR(5)
تعیین شود\&. اگر فقط
\fIpid\fR
به گزینه
\fB\-\-process\fR
داده شود،
\fBpkttyagent\fR
خودش زمان شروع را جستجو خواهد کرد، اما توجه داشته باشید که این کار ممکن است منجر به شرایط رقابتی (race condition) شود\&.
.SH "نویسندگان (AUTHORS)"
.PP
نوشته‌شده توسط David Zeuthen
<davidz@redhat\&.com>
با کمک‌های بسیار از طرف افراد متعدد دیگر\&.
.SH "گزارش باگ‌ها (BUGS)"
.PP
لطفاً گزارش باگ‌ها را به توزیع خود یا به لیست پستی polkit\-devel ارسال کنید؛ ببینید:
\m[blue]\fB\%https://github.com/polkit-org/polkit#bugs-and-development\fR\m[]\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpolkit\fR(8),
\fBpolkitd\fR(8),
\fBpkaction\fR(1),
\fBpkcheck\fR(1),
\fBpkexec\fR(1)