.\" Created from Texinfo source by yat2m 1.61-unknown
.TH GPGV 1 2025-02-19 "GnuPG 2.4.9" "GNU Privacy Guard 2.4"
.SH "نام (NAME)"
gpgv \- اعتبارسنجی امضاهای OpenPGP
.SH "خلاصه دستور (SYNOPSIS)"
.B  gpgv
[\fIگزینه‌ها\fR]
\fIفایل‌های امضاشده\fR


.SH "توضیحات (DESCRIPTION)"
دستور
.B gpgv
یک ابزار اعتبارسنجی امضای OpenPGP است.

این برنامه در واقع یک نسخه خلاصه‌شده از
.B gpg
است که تنها قادر به بررسی امضاهاست. حجم آن تا حدودی کمتر از نسخه کامل
.B gpg
بوده و از روشی متفاوت (و ساده‌تر) برای بررسی معتبر بودن کلیدهای عمومی استفاده‌شده در ایجاد امضا بهره می‌برد. این ابزار هیچ فایل پیکربندی‌ای ندارد و تنها تعداد کمی از گزینه‌ها در آن پیاده‌سازی شده‌اند.

دستور
.B gpgv
فرض می‌کند که تمامی کلیدهای موجود در دسته‌کلید (keyring) قابل‌اعتماد هستند. این بدان معنا نیز هست که این ابزار منقضی شدن یا باطل شدن کلیدها را بررسی نمی‌کند.

اگر گزینه
.B \-\-keyring
مشخص نشده باشد،
.B gpgv
به دنبال دسته‌کلید «پیش‌فرض» با نام
\(oq\fItrustedkeys.kbx\fP\(cq
(ترجیح داده‌شده) یا
\(oq\fItrustedkeys.gpg\fP\(cq
در دایرکتوری خانگی GnuPG می‌گردد؛ چه دایرکتوری خانگی پیش‌فرض باشد و چه دایرکتوری‌ای که توسط گزینه
.B \-\-homedir
یا متغیر محیطی
.B GNUPGHOME
تنظیم شده باشد. اگر هرگونه گزینه
.B \-\-keyring
استفاده شود،
.B gpgv
به دنبال دسته‌کلید پیش‌فرض نخواهد گشت. گزینه
.B \-\-keyring
می‌تواند چندین بار استفاده شود و تمام دسته‌کلیدهای مشخص‌شده با هم به کار گرفته خواهند شد.


.SH "مقدار بازگشتی (RETURN VALUE)"

این برنامه در صورتی که همه چیز درست باشد مقدار 0، اگر حداقل یک امضا نامعتبر باشد مقدار 1، و برای خطاهای مهلک سایر کدهای خطا را برمی‌گرداند.

.SH "گزینه‌ها (OPTIONS)"
دستور
.B gpgv
این گزینه‌ها را می‌شناسد:


.TP
.B  \-\-verbose
.TQ
.B  \-v
اطلاعات بیشتری در طول پردازش ارائه می‌دهد. اگر دو بار استفاده شود، داده‌های ورودی با جزئیات فهرست می‌شوند.

.TP
.B  \-\-quiet
.TQ
.B  \-q
تلاش می‌کند تا حد امکان بی‌صدا باشد (پیام‌های کمتری نمایش دهد).

.TP
.B  \-\-keyring \fIfile\fP
افزودن \fIfile\fP به فهرست دسته‌کلیدها.
اگر \fIfile\fP با یک مدک (تیلدا) و اسلش آغاز شود، با دایرکتوری HOME جایگزین می‌شوند. اگر نام فایل شامل اسلش نباشد، فرض می‌شود که در دایرکتوری خانگی قرار دارد (در صورت عدم استفاده از
.BR \-\-homedir ،
مسیر «~/.gnupg»).

.TP
.B  \-\-output \fIfile\fP
.TQ
.B  \-o \fIfile\fP
نوشتن خروجی در \fIfile\fP؛ برای نوشتن در خروجی استاندارد (stdout) از
.B \-
استفاده کنید. این گزینه می‌تواند برای به دست آوردن متن امضاشده از یک امضای متنی ساده (cleartext) یا باینری استفاده شود؛ این گزینه برای امضاهای مجزا (detached) نیز کار می‌کند، اما در آن حالت معمولاً چندان کاربردی نیست. توجه داشته باشید که فایلی با همین نام بازنویسی خواهد شد.


.TP
.B  \-\-status\-fd \fIn\fP
نوشتن رشته‌های وضعیت ویژه در توصیف‌کننده فایل
.IR n .
برای مشاهده فهرستی از آن‌ها به فایل DETAILS در مستندات مراجعه کنید.

.TP
.B  \-\-logger\-fd \fBn\fP
نوشتن خروجی لاگ در توصیف‌کننده فایل
.B n
به جای stderr.

.TP
.B  \-\-log\-file \fBfile\fP
مشابه
.BR \-\-logger\-fd ،
با این تفاوت که داده‌های گزارش‌گیری در فایل
.B file
نوشته می‌شوند. برای ثبت گزارش در سوکت از
\(oq\fIsocket://\fP\(cq
استفاده کنید.

.TP
.B  \-\-ignore\-time\-conflict
برنامه GnuPG به طور معمول بررسی می‌کند که برچسب‌های زمانی مربوط به کلیدها و امضاها دارای مقادیر معقولی باشند. با این حال، گاهی اوقات ممکن است به دلیل مشکلات ساعت سیستم، یک امضا قدیمی‌تر از کلید به نظر برسد. این گزینه این بررسی‌ها را به هشدار تبدیل می‌کند.

.TP
.B  \-\-homedir \fIdir\fP
تنظیم نام دایرکتوری خانگی به \fIdir\fP. اگر از این گزینه استفاده نشود، دایرکتوری خانگی به طور پیش‌فرض برابر با
\(oq\fI~/.gnupg\fP\(cq
خواهد بود. این گزینه تنها زمانی شناسایی می‌شود که در خط فرمان مشخص شده باشد. همچنین این گزینه بر هر دایرکتوری خانگی تعیین‌شده از طریق متغیر محیطی
\(oq\fIGNUPGHOME\fP\(cq
یا (در سیستم‌های ویندوز) از طریق مدخل رجیستری
\fIHKCU\[rs]Software\[rs]GNU\[rs]GnuPG:HomeDir\fP
اولویت دارد.

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

.TP
.B  \-\-weak\-digest \fBname\fP
در نظر گرفتن الگوریتم خلاصه پیام (digest) مشخص‌شده به عنوان ضعیف. امضاهای ایجادشده با الگوریتم‌های خلاصه ضعیف معمولاً رد می‌شوند. این گزینه می‌تواند چندین بار مشخص شود در صورتی که نیاز باشد چندین الگوریتم ضعیف در نظر گرفته شوند. الگوریتم MD5 همیشه ضعیف در نظر گرفته می‌شود و نیازی نیست به صراحت ذکر گردد.

.TP
.B  \-\-enable\-special\-filenames
این گزینه حالتی را فعال می‌کند که در آن نام‌های فایل به فرم
\(oq\fI\-&n\fP\(cq
(که در آن n یک عدد ده‌دهی غیرمنفی است) به توصیف‌کننده فایل n اشاره دارند و نه به فایلی با آن نام.

.TP
.B  \-\-assert\-pubkey\-algo \fIalgolist\fP
این گزینه دقیقاً به همان شکلی که برای
.B gpg
توضیح داده شده است کار می‌کند.

.P

.SH "مثال‌ها (EXAMPLES)"


.TP
.B  gpgv \fBpgpfile\fP
.TQ
.B  gpgv \fBsigfile\fP [\fBdatafile\fP]
اعتبارسنجی امضای فایل. قالب دوم برای امضاهای مجزا (detached) استفاده می‌شود، که در آن
\fBsigfile\fP
امضای مجزا (چه در قالب متنی زره‌پوش ASCII و چه باینری) است و
\fBdatafile\fP
شامل داده‌های امضاشده است؛ اگر
\fBdatafile\fP
برابر با «-» باشد، انتظار می‌رود داده‌های امضاشده در
\fBstdin\fP
دریافت شوند؛ اگر
\fBdatafile\fP
مشخص نشده باشد، نام فایل حاوی داده‌های امضاشده با حذف پسوند («.asc»، «.sig» یا «.sign») از
\fBsigfile\fP
ساخته می‌شود.

.P

.SH "فایل‌ها (FILES)"


.TP
.B  ~/.gnupg/trustedkeys.gpg
دسته‌کلید پیش‌فرض حاوی کلیدهای مجاز.

.P

.SH "محیط (ENVIRONMENT)"


.TP
.B  HOME
برای تعیین موقعیت دایرکتوری خانگی پیش‌فرض استفاده می‌شود.

.TP
.B  GNUPGHOME
در صورت تنظیم، این دایرکتوری به جای «~/.gnupg» استفاده می‌شود.

.P

.SH "همچنین ببینید (SEE ALSO)"
\fBgpg\fP(1)

مستندات کامل این ابزار در قالب یک راهنمای Texinfo نگهداری می‌شود. اگر GnuPG و برنامه info به درستی روی سیستم شما نصب شده باشند، اجرای دستور

.RS 2
.nf
info gnupg
.fi
.RE

دسترسی به راهنمای کامل شامل ساختار منو و نمایه را برای شما فراهم می‌کند.