.TH PASS-OTP 1 "2017 March 19" "Password store OTP extension"

.SH "نام (NAME)"
pass-otp \- افزونه‌ای برای \fBpass\fP(1) جهت مدیریت توکن‌های گذرواژه یک‌بارمصرف (OTP).

.SH "خلاصه دستور (SYNOPSIS)"
.B pass otp
[
.I COMMAND
] [
.I OPTIONS
]... [
.I ARGS
]...

.SH "توضیحات (DESCRIPTION)"

.B pass-otp
ابزار
.BR pass (1)
را با دستور
.B otp
جهت افزودن کلیدهای محرمانه OTP، تولید کدهای OTP، و نمایش نشانی‌های URI کلید محرمانه با استفاده از ساختار استاندارد \fIotpauth://\fP گسترش می‌دهد.

اگر هیچ COMMAND مشخص نشود، دستور پیش‌فرض \fBcode\fP خواهد بود.

.SH "دستورها (COMMANDS)"

.TP
\fBotp code\fP [ \fI--clip\fP, \fI-c\fP ] \fIpass-name\fP

یک کد OTP را از کلید محرمانه ذخیره‌شده در \fIpass-name\fP با استفاده از \fBoathtool\fP(1) تولید کرده و چاپ می‌کند. اگر \fI--clip\fP یا \fI-c\fP مشخص شده باشد، کد را چاپ نکرده بلکه با استفاده از \fBxclip\fP(1) در کلیپ‌بورد کپی می‌کند و پس از ۴۵ ثانیه (یا به میزان \fIPASSWORD_STORE_CLIP_TIME\fP) کلیپ‌بورد را بازیابی می‌کند. نام دیگر این دستور \fBshow\fP است.

.TP
\fBotp insert\fP [ \fI--force\fP, \fI-f\fP ] [ \fI--echo\fP, \fI-e\fP ] \
[ [ \fI--secret\fP, \fI-s\fP ] [ \fI--issuer\fP, \fI-i\fP \fIissuer\fP ] \
[ \fI--account\fP, \fI-a\fP \fIaccount\fP ] ] [ \fIpass-name\fP ]

درخواست ورود و درج یک کلید محرمانه جدید OTP در مخزن گذرواژه در مسیر \fIpass-name\fP.

اگر \fI--secret\fP مشخص شده باشد، مقدار \fIsecret\fP (کلید محرمانه) با فرض الگوریتم SHA1، دوره زمانی ۳۰ ثانیه‌ای و ۶ رقم OTP درخواست می‌شود. همچنین باید یکی از گزینه‌های \fIissuer\fP یا \fIaccount\fP (یا هر دو) مشخص شود.

اگر \fI--secret\fP مشخص نشده باشد، نشانی اینترنتی (URI) کلید درخواست می‌شود؛ برای مشخصات دقیق URI کلید، مستندات موجود در
.UR https://\:github.\:com/\:google/\:google-authenticator/\:wiki/\:Key-Uri-Format
.UE
را ببینید.

مقدار محرمانه از ورودی استاندارد (stdin) خوانده می‌شود؛ هنگام اجرای تعاملی این دستور، \fI--echo\fP یا \fI-e\fP را برای بازتاب ورودی تعیین کنید. اگر \fIpass-name\fP مشخص نشده باشد، برچسب URI به‌صورت \fIissuer:accountname\fP به مسیری به شکل \fIissuer/accountname\fP تبدیل می‌شود. پیش از بازنویسی روی کلید محرمانه موجود، تأییدیه خواسته می‌شود مگر آنکه \fI--force\fP یا \fI-f\fP مشخص شده باشد. نام دیگر این دستور \fBadd\fP است.

.TP
\fBotp append\fP [ \fI--force\fP, \fI-f\fP ] [ \fI--echo\fP, \fI-e\fP ] \
[ [ \fI--secret\fP, \fI-s\fP ] [ \fI--issuer\fP, \fI-i\fP \fIissuer\fP ] \
[ \fI--account\fP, \fI-a\fP \fIaccount\fP ] ] \fIpass-name\fP

الحاق یک کلید محرمانه OTP به گذرواژه ذخیره‌شده در \fIpass-name\fP، با حفظ خطوط موجود.

اگر \fI--secret\fP مشخص شده باشد، مقدار \fIsecret\fP (کلید محرمانه) با فرض الگوریتم SHA1، دوره زمانی ۳۰ ثانیه‌ای و ۶ رقم OTP درخواست می‌شود. همچنین باید یکی از گزینه‌های \fIissuer\fP یا \fIaccount\fP (یا هر دو) مشخص شود.

اگر \fI--secret\fP مشخص نشده باشد، نشانی اینترنتی (URI) کلید درخواست می‌شود؛ برای مشخصات دقیق URI کلید، مستندات موجود در
.UR https://\:github.\:com/\:google/\:google-authenticator/\:wiki/\:Key-Uri-Format
.UE
را ببینید.

نشانی URI از ورودی استاندارد (stdin) خوانده می‌شود؛ هنگام اجرای تعاملی این دستور، \fI--echo\fP یا \fI-e\fP را برای بازتاب ورودی تعیین کنید. پیش از بازنویسی روی کلید محرمانه موجود، تأییدیه خواسته می‌شود مگر آنکه \fI--force\fP یا \fI-f\fP مشخص شده باشد.

.TP
\fBotp uri\fP [ \fI--clip\fP, \fI-c\fP | \fI--qrcode\fP, \fI-q\fP ] \fIpass-name\fP

چاپ نشانی اینترنتی (URI) کلید ذخیره‌شده در \fIpass-name\fP در خروجی استاندارد (stdout). اگر \fI--clip\fP یا \fI-c\fP مشخص شده باشد، نشانی URI را چاپ نکرده بلکه با استفاده از
.BR xclip (1)
در کلیپ‌بورد کپی می‌کند و پس از ۴۵ ثانیه (یا به میزان \fIPASSWORD_STORE_CLIP_TIME\fP) کلیپ‌بورد را بازیابی می‌کند. اگر \fI--qrcode\fP یا \fI-q\fP مشخص شده باشد، نشانی URI چاپ نمی‌شود بلکه یک بارکد QR با استفاده از
.BR qrencode (1)
در ترمینال یا به‌صورت گرافیکی (در صورت پشتیبانی) نمایش داده می‌شود.

.TP
\fBotp validate\fP \fIuri\fP

بررسی اعتبار رشته URI مطابق با قالب Key Uri Format. برای اطلاعات بیشتر درباره این قالب، مستندات موجود در
.UR https://\:github.\:com/\:google/\:google-authenticator/\:wiki/\:Key-Uri-Format
.UE .

.SH "گزینه‌ها (OPTIONS)"

.TP
\fBhelp\fP, \fB\-h\fP, \fB\-\-help\fP
نمایش پیام راهنمای نحوه استفاده.

.SH "همچنین ببینید (SEE ALSO)"
.BR pass (1),
.BR qrencode (1),
.BR zbarimg (1)

.SH "نویسندگان (AUTHORS)"
.B pass-otp
توسط
.MT tadfisher@gmail.com
Tad Fisher
.ME
نوشته شده است.

.SH "کپی‌رایت و تکثیر (COPYING)"
این برنامه یک نرم‌افزار آزاد است: شما می‌توانید تحت شرایط «اجازه‌نامه عمومی همگانی گنو» (GNU General Public License) منتشر شده توسط بنیاد نرم‌افزارهای آزاد، چه نسخه ۳ اجازه‌نامه و چه (به انتخاب خودتان) هر نسخه بعدی دیگری، آن را بازتوزیع کرده یا تغییر دهید.

این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی «قابل فروش بودن» یا «مناسب بودن برای یک هدف خاص». برای جزئیات بیشتر «اجازه‌نامه عمومی همگانی گنو» را ببینید.

شما باید یک نسخه از «اجازه‌نامه عمومی همگانی گنو» را به همراه این برنامه دریافت کرده باشید. در غیر این صورت، پیوند <http://www.gnu.org/licenses> را مشاهده کنید.