نام (NAME)

pkttyagent - ابزار کمکی احراز هویت متنی

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

pkttyagent [--version] [--help]

pkttyagent [--process { pid | pid,pid-start-time } | --system-bus-name busname] [--notify-fd fd] [--fallback]

توضیحات (DESCRIPTION)

دستور pkttyagent برای راه‌اندازی یک عامل احراز هویت متنی برای موضوع مشخص‌شده توسط --process یا --system-bus-name به کار می‌رود. اگر هیچ‌یک از این گزینه‌ها مشخص نشوند، از فرایند والد استفاده می‌شود.

برای مطلع‌شدن از زمان ثبت عامل احراز هویت، می‌توانید به سیگنال D-Bus با عنوان Changed گوش دهید یا از --notify-fd برای ارسال شماره توصیف‌کننده فایلی (file descriptor) که به برنامه داده شده است، استفاده کنید. پس از آنکه عامل احراز هویت با موفقیت ثبت شد، این توصیف‌کننده فایل بسته خواهد شد.

اگر از --fallback استفاده شود، عامل احراز هویت متنی جایگزین یک عامل احراز هویت موجود نخواهد شد.

وضعیت خروج (EXIT STATUS)

اگر عامل احراز هویت نتواند ثبت شود، pkttyagent با کد خروج 127 پایان می‌یابد. پیام‌های عیب‌یابی در خروجی استاندارد خطا چاپ می‌شوند.

اگر یک یا چند مورد از گزینه‌های ارسال‌شده نامعتبر باشند، pkttyagent با کد خروج 126 خارج می‌شود. اگر ورودی استاندارد (stdin) یک tty باشد، این صفحه راهنما نیز نمایش داده می‌شود.

اگر عامل احراز هویت با موفقیت ثبت شود، pkttyagent به اجرای خود ادامه داده و برحسب نیاز با کاربر تعامل خواهد داشت. زمانی که دیگر نیازی به خدمات آن نباشد، می‌توان فرایند را متوقف کرد (kill کرد).

نکات (NOTES)

از آنجا که شناسه‌های فرایند (PID) ممکن است بازیافت و دوباره مصرف شوند، فراخواننده باید همیشه هنگام استفاده از گزینه --process از قالب pid,pid-start-time استفاده کند. مقدار pid-start-time بسته به سیستم‌عامل می‌تواند از طریق مراجعه به مواردی چون سیستم فایل proc(5) تعیین شود. اگر فقط pid به گزینه --process داده شود، pkttyagent خودش زمان شروع را جستجو خواهد کرد، اما توجه داشته باشید که این کار ممکن است منجر به شرایط رقابتی (race condition) شود.

نویسندگان (AUTHORS)

نوشته‌شده توسط David Zeuthen <davidz@redhat.com> با کمک‌های بسیار از طرف افراد متعدد دیگر.

گزارش باگ‌ها (BUGS)

لطفاً گزارش باگ‌ها را به توزیع خود یا به لیست پستی polkit-devel ارسال کنید؛ ببینید: https://github.com/polkit-org/polkit#bugs-and-development.

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

polkit(8), polkitd(8), pkaction(1), pkcheck(1), pkexec(1)