'\" t
.\"     Title: pkcheck
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: May 2009
.\"    Manual: pkcheck
.\"    Source: polkit
.\"  Language: Persian
.\"
.TH "PKCHECK" "1" "May 2009" "polkit" "pkcheck"
.\" -----------------------------------------------------------------
.\" * 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)"
pkcheck \- بررسی اینکه آیا یک فرایند مجاز است یا خیر
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpkcheck\fR\ 'u
\fBpkcheck\fR [\fB\-\-version\fR] [\fB\-\-help|\-h\fR]
.HP \w'\fBpkcheck\fR\ 'u
\fBpkcheck\fR [\fB\-\-list\-temp\fR]
.HP \w'\fBpkcheck\fR\ 'u
\fBpkcheck\fR [\fB\-\-revoke\-temp\fR]
.HP \w'\fBpkcheck\fR\ 'u
\fBpkcheck\fR \fB\-\-action\-id|\-a\fR\ \fIaction\fR {\fB\-\-process|\-p\fR\ {\ \fIpid\fR\ |\ \fIpid,pid\-start\-time\fR\ |\ \fIpid,pid\-start\-time,uid\fR\ } | \fB\-\-system\-bus\-name|\-s\fR\ \fIbusname\fR} [\fB\-\-allow\-user\-interaction|\-u\fR] [\fB\-\-enable\-internal\-agent\fR] [\fB\-\-detail|\-d\fR\ \fIkey\fR\ \fIvalue\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBpkcheck\fR
برای بررسی اینکه آیا یک فرایند مشخص‌شده با
\fB\-\-process\fR
(پایین را ببینید) یا
\fB\-\-system\-bus\-name\fR،
برای اقدامِ
\fIaction\fR
مجاز است یا خیر به کار می‌رود\&. گزینهٔ
\fB\-\-detail\fR
می‌تواند صفر یا چند بار برای انتقال جزئیات دربارهٔ
\fIaction\fR
استفاده شود\&. اگر
\fB\-\-allow\-user\-interaction\fR
ارسال شود،
\fBpkcheck\fR
در حین انتظار برای احراز هویت متوقف (block) می‌شود\&.
.PP
اجرای
\fBpkcheck \-\-list\-temp\fR
تمام مجوزهای موقت برای نشست فعلی را فهرست می‌کند و
\fBpkcheck \-\-revoke\-temp\fR
تمام مجوزهای موقت برای نشست فعلی را باطل خواهد کرد\&.
.PP
این دستور یک پوستهٔ واسط ساده بر روی رابط D\-Bus برنامهٔ polkit است؛ برای جزئیات به مستندات رابط D\-Bus مراجعه کنید\&.
.SH "وضعیت خروج (EXIT STATUS)"
.PP
اگر فرایند مشخص‌شده مجاز باشد،
\fBpkcheck\fR
با مقدار بازگشتی 0 خارج می‌شود\&. اگر نتیجهٔ مجوز شامل هرگونه جزئیاتی باشد، این اطلاعات در خروجی استاندارد به‌صورت جفت‌های کلید/مقدار با استفاده از سبک گزارش متغیرهای محیطی چاپ می‌شوند؛ برای مثال ابتدا کلید و به دنبال آن علامت مساوی، سپس مقدار و در پایان یک خط جدید چاپ می‌شود\&.
.sp
.if n \{\
.RS 4
.\}
.nf
KEY1=VALUE1
KEY2=VALUE2
KEY3=VALUE3
\&.\&.\&.
.fi
.if n \{\
.RE
.\}
.sp
بایت‌هایی که در محدودهٔ [a\-zA\-Z0\-9_] نیستند، با استفاده از کدهای هشت‌هشتی (octal) با پیشوند
\fI\e\fR
گریزدهی (escape) می‌شوند\&. برای نمونه، رشتهٔ UTF\-8 با متن
\fIføl,你好\fR
به‌صورت
\fIf\e303\e270l\e54\e344\e275\e240\e345\e245\e275\fR
چاپ خواهد شد\&.
.PP
اگر فرایند مشخص‌شده مجاز نباشد،
\fBpkcheck\fR
با مقدار بازگشتی 1 خارج می‌شود و یک پیام تشخیصی در خطای استاندارد چاپ خواهد شد\&. جزئیات در خروجی استاندارد چاپ می‌شوند\&.
.PP
اگر فرایند مشخص‌شده به این دلیل مجاز نباشد که عامل احراز هویت مناسبی در دسترس نیست یا اگر گزینهٔ
\fB\-\-allow\-user\-interaction\fR
ارسال نشده باشد،
\fBpkcheck\fR
با مقدار بازگشتی 2 خارج می‌شود و یک پیام تشخیصی در خطای استاندارد چاپ می‌گردد\&. جزئیات در خروجی استاندارد چاپ می‌شوند\&.
.PP
اگر فرایند مشخص‌شده به دلیل رد یا لغو شدن کادر محاوره‌ای / درخواست احراز هویت توسط کاربر مجاز نباشد،
\fBpkcheck\fR
با مقدار بازگشتی 3 خارج می‌شود و یک پیام تشخیصی در خطای استاندارد به نمایش درمی‌آید\&. جزئیات در خروجی استاندارد چاپ می‌شوند\&.
.PP
اگر هنگام بررسی مجوز خطایی رخ دهد،
\fBpkcheck\fR
با مقدار بازگشتی 127 به همراه پیامی تشخیصی در خطای استاندارد خارج می‌شود\&.
.PP
اگر یک یا چند مورد از گزینه‌های ارسال‌شده ناصحیح باشند،
\fBpkcheck\fR
با مقدار بازگشتی 126 خارج خواهد شد\&. اگر stdin یک tty باشد، این صفحهٔ راهنما نیز نمایش داده می‌شود\&.
.SH "نکات (NOTES)"
.PP
برای
\fB\-\-process\fR
از قالب‌های نحویِ خالیِ
\fIpid\fR
یا
\fIpid,start\-time\fR
استفاده نکنید\&. در هر دو حالت شرایط رقابتی (race conditions) وجود دارد\&. کدهای جدید همواره باید از
\fIpid,pid\-start\-time,uid\fR
استفاده کنند\&. مقدار
\fIstart\-time\fR
بسته به سیستم‌عامل می‌تواند با بررسی مواردی از قبیل سامانه پروندهٔ
\fBproc\fR(5)
تعیین شود\&. اگر کمتر از ۳ آرگومان ارسال شود،
\fBpkcheck\fR
تلاش می‌کند تا آن‌ها را به‌صورت داخلی جستجو کند، اما توجه داشته باشید که این کار ممکن است با شرایط رقابتی مواجه شود\&.
.PP
اگر برنامهٔ شما یک دیمن با مثلاً یک سوکت دامنه یونیکس (Unix domain socket) سفارشی است، باید پارامتر
\fIuid\fR
را از طریق سازوکارهای سیستم‌عامل نظیر
PEERCRED
تعیین کنید\&.
.SH "عامل احراز هویت (AUTHENTICATION AGENT)"
.PP
\fBpkcheck\fR
مانند هر برنامهٔ دیگر polkit، از عامل احراز هویت ثبت‌شده برای فرایند مورد نظر استفاده خواهد کرد\&. با این حال، اگر هیچ عامل احراز هویتی موجود نباشد، چنانچه گزینهٔ
\fB\-\-enable\-internal\-agent\fR
ارسال شده باشد،
\fBpkcheck\fR
می‌تواند عامل احراز هویت متنی خود را ثبت کند\&.
.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),
\fBpkexec\fR(1),
\fBpkttyagent\fR(1)