نام (NAME)

gpg-preset-passphrase - قرار دادن پیشفرض عبارت عبور در حافظه موقت gpg-agent

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

gpg-preset-passphrase [ گزینهها ] شناسه_کلید

توضیحات (DESCRIPTION)

دستور gpg-preset-passphrase برای تزریق و ذخیره مستقیم عبارت عبور (passphrase) یک کلید خاص در کش داخلی gpg-agent استفاده میشود. این ابزار به ویژه برای ماشین‌ها و سامانه‌های بدون ناظر (unattended) کاربرد دارد، در شرایطی که امکان استفاده از ابزار استاندارد pinentry وجود ندارد و عبارات عبور کلیدهای مورد استفاده در زمان راه‌اندازی سامانه ارائه می‌شوند.

این برنامه با GnuPG نسخه ۲ و نسخه‌های پس از آن کار می‌کند. از GnuPG 1.x پشتیبانی نمی‌شود.

عبارات عبور تنظیم‌شده با این ابزار منقضی نمی‌شوند، مگر اینکه از گزینه --forget برای پاک کردن صریح آن‌ها از حافظه موقت استفاده شود — یا اینکه gpg-agent مجدداً راه‌اندازی (restart) یا بارگذاری مجدد (reload با ارسال سیگنال SIGHUP به آن) شود. توجه داشته باشید که حداکثر زمان نگهداری در حافظه موقت که با --max-cache-ttl تنظیم می‌شود، همچنان لحاظ خواهد شد. لازم است با اجرای gpg-agent همراه با گزینه --allow-preset-passphrase، امکان تنظیم پیش‌فرض عبارت عبور مجاز شده باشد.

دستور gpg-preset-passphrase به این روش فراخوانی می‌شود:

gpg-preset-passphrase [گزینه‌ها] [دستور] cacheid

مقدار cacheid (شناسه حافظه موقت) یک کی‌گریپ (keygrip) ۴۰ کاراکتری از نویسه‌های هگزادسیمال است که کلید مورد نظر جهت تنظیم یا پاک کردن عبارت عبور را مشخص می‌کند. این کی‌گریپ با اجرای دستور زیر در کنار کلید فهرست می‌شود:

gpgsm --with-keygrip --list-secret-keys

همچنین می‌توان از یک رشته دلخواه برای شناسایی عبارت عبور استفاده کرد؛ پیشنهاد می‌شود که پیشوند چنین رشته‌ای نام برنامه کاربردی باشد (مانند foo:12346). اسکریپت‌ها همیشه باید از گزینه --with-colons استفاده کنند که کی‌گریپ را در یک سطر "grp" فراهم می‌آورد (نگاه کنید به ‘doc/DETAILS’).

گزینه‌ها (OPTIONS)

باید یکی از گزینه‌های دستوری زیر مشخص شود:

--preset

تنظیم پیش‌فرض عبارت عبور. این گزینه‌ای است که معمولاً استفاده خواهید کرد. سپس gpg-preset-passphrase عبارت عبور را از ورودی استاندارد (stdin) می‌خواند.

--forget

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

گزینه‌های تکمیلی زیر نیز می‌توانند استفاده شوند:

-v

--verbose

نمایش اطلاعات بیشتر در حین اجرا.

-P string

--passphrase string

استفاده از رشته string ارائه‌شده به عنوان عبارت عبور به جای خواندن آن از ورودی استاندارد (stdin). توجه داشته باشید که این کار باعث می‌شود عبارت عبور برای سایر کاربران قابل مشاهده باشد.

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

gpg(1), gpgsm(1), gpg-agent(1), scdaemon(1)

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

info gnupg