.TH "GPG-PRESET-PASSPHRASE" "1" "مه ۲۰۲۵" "gnupg" "دستورهای کاربری"
.SH "نام (NAME)"
gpg-preset-passphrase \- قرار دادن پیشفرض عبارت عبور در حافظه موقت gpg-agent
.SH "خلاصه دستور (SYNOPSIS)"
\fBgpg-preset-passphrase\fP [ \fIگزینهها\fP ] \fIشناسه_کلید\fP
.SH "توضیحات (DESCRIPTION)"
دستور \fBgpg-preset-passphrase\fR برای تزریق و ذخیره مستقیم عبارت عبور (passphrase) یک کلید خاص در کش داخلی gpg-agent استفاده میشود.
این ابزار به ویژه برای ماشین‌ها و سامانه‌های بدون ناظر (unattended) کاربرد دارد، در شرایطی که امکان استفاده از ابزار استاندارد \fBpinentry\fP وجود ندارد و عبارات عبور کلیدهای مورد استفاده در زمان راه‌اندازی سامانه ارائه می‌شوند.
.PP
این برنامه با GnuPG نسخه ۲ و نسخه‌های پس از آن کار می‌کند. از GnuPG 1.x پشتیبانی نمی‌شود.
.PP
عبارات عبور تنظیم‌شده با این ابزار منقضی نمی‌شوند، مگر اینکه از گزینه
.B \-\-forget
برای پاک کردن صریح آن‌ها از حافظه موقت استفاده شود \[em] یا اینکه
.B gpg\-agent
مجدداً راه‌اندازی (restart) یا بارگذاری مجدد (reload با ارسال سیگنال SIGHUP به آن) شود. توجه داشته باشید که حداکثر زمان نگهداری در حافظه موقت که با
.B \-\-max\-cache\-ttl
تنظیم می‌شود، همچنان لحاظ خواهد شد. لازم است با اجرای
.B gpg\-agent
همراه با گزینه
.BR \-\-allow\-preset\-passphrase ،
امکان تنظیم پیش‌فرض عبارت عبور مجاز شده باشد.
.PP
دستور \fBgpg\-preset\-passphrase\fP به این روش فراخوانی می‌شود:
.RS 2
.nf
gpg\-preset\-passphrase [گزینه‌ها] [دستور] \fIcacheid\fP
.fi
.RE
.PP
مقدار \fIcacheid\fP (شناسه حافظه موقت) یک کی‌گریپ (keygrip) ۴۰ کاراکتری از نویسه‌های هگزادسیمال است که کلید مورد نظر جهت تنظیم یا پاک کردن عبارت عبور را مشخص می‌کند. این کی‌گریپ با اجرای دستور زیر در کنار کلید فهرست می‌شود:
.PP
.RS 2
.nf
gpgsm \-\-with\-keygrip \-\-list\-secret\-keys
.fi
.RE
.PP
همچنین می‌توان از یک رشته دلخواه برای شناسایی عبارت عبور استفاده کرد؛ پیشنهاد می‌شود که پیشوند چنین رشته‌ای نام برنامه کاربردی باشد (مانند
.BR foo:12346 ).
اسکریپت‌ها همیشه باید از گزینه
.B \-\-with\-colons
استفاده کنند که کی‌گریپ را در یک سطر "grp" فراهم می‌آورد (نگاه کنید به \(oq\fIdoc/DETAILS\fP\(cq).
.SH "گزینه‌ها (OPTIONS)"
باید یکی از گزینه‌های دستوری زیر مشخص شود:
.TP
.B \-\-preset
تنظیم پیش‌فرض عبارت عبور. این گزینه‌ای است که معمولاً استفاده خواهید کرد. سپس
.B gpg\-preset\-passphrase
عبارت عبور را از ورودی استاندارد (\fBstdin\fP) می‌خواند.
.TP
.B \-\-forget
پاک کردن عبارت عبور مربوط به شناسه حافظه موقت مشخص‌شده از حافظه موقت.
.PP
گزینه‌های تکمیلی زیر نیز می‌توانند استفاده شوند:
.TP
.B \-v
.TQ
.B \-\-verbose
نمایش اطلاعات بیشتر در حین اجرا.
.TP
.BI \-P " string"
.TQ
.BI \-\-passphrase " string"
استفاده از رشته \fIstring\fP ارائه‌شده به عنوان عبارت عبور به جای خواندن آن از ورودی استاندارد (\fBstdin\fP). توجه داشته باشید که این کار باعث می‌شود عبارت عبور برای سایر کاربران قابل مشاهده باشد.
.SH "همچنین ببینید (SEE ALSO)"
.BR gpg (1),
.BR gpgsm (1),
.BR gpg\-agent (1),
.BR scdaemon (1)
.PP
مستندات کامل این ابزار در قالب یک راهنمای Texinfo نگهداری می‌شود. اگر GnuPG و برنامه info به درستی روی سامانه شما نصب شده باشند، دستور
.RS 2
.nf
info gnupg
.fi
.RE
دسترسی شما به راهنمای کامل، شامل ساختار منو و نمایه را فراهم خواهد کرد.