age

دستورهای age

دستورهای توکار برای بک‌اند age. این دستورها امکان تعامل محدود با هویت‌های age ویژهٔ gopass را فراهم می‌کنند. هویت‌های افزوده شده هنگام رمزنگاری به‌طور خودکار به‌عنوان دریافت‌کننده به رازهای شما افزوده می‌شوند، اما نه به دریافت‌کنندگان شما؛ اطمینان حاصل کنید که دریافت‌کنندگان و هویت‌های خود را مطابق نیازتان همگام نگه می‌دارید. تمامی هویت‌های age، از جمله موارد افزونه، باید پشتیبانی شوند. ما همچنین با وجود منسوخ شدن هویت‌های github توسط age، همچنان از آن‌ها پشتیبانی می‌کنیم؛ این کار با بازگشت به هویت‌های ssh برای این موارد و نگهداری یک حافظه پنهان محلی از کلیدهای ssh برای یک هویت github مشخص انجام می‌شود.

پرچم‌ها

--age-ssh-key-path,

مسیر سفارشی به کلید SSH اضافی یا پوشه‌ای از کلیدها برای بک‌اند age

--age-sshkeys,

بارگذاری کلیدهای SSH از پوشهٔ پیش‌فرض SSH

alias

چاپ نام‌های مستعار دامنه

چاپ نام‌های مستعار دامنهٔ تعریف‌شده.

audit

رمزگشایی همهٔ رازها و پویش برای گذرواژه‌های ضعیف یا افشاشده

این دستور همهٔ رازها را رمزگشایی کرده و آن‌ها را برای وجود نقص‌های رایج و (اختیاراً) در برابر فهرستی از گذرواژه‌های از پیش افشاشده بررسی می‌کند.

پرچم‌ها

--format,

قالب خروجی. text، csv، html یا json. پیش‌فرض: text

--full,

چاپ جزئیات کامل همهٔ یافته‌ها. پیش‌فرض: false

--output-file,

-o, نام فایل خروجی. برای csv و html استفاده می‌شود

--summary,

چاپ خلاصه‌ای از نتایج ممیزی. پیش‌فرض: true (چاپ خلاصه)

--template,

قالب HTML. در صورت تنظیم نشدن، از پیش‌فرض توکار استفاده می‌شود..SS cat رمزگشایی و چاپ محتوای یک راز دودویی در stdout، یا کدگذاری و درج از stdin

این دستور مشابه روش کارکرد cat در خط فرمان است. می‌تواند هم برای بازیابی محتوای رمزگشایی‌شدهٔ یک راز مشابه “cat file” به کار رود و هم برعکس، برای کدگذاری محتوا از STDIN در یک راز استفاده شود.

clone

شبیه‌سازی یک مخزن گذرواژه از یک مخزن git

این دستور یک مخزن گذرواژهٔ موجود را از یک ریموت git به یک مخزن گذرواژهٔ محلی شبیه‌سازی (clone) می‌کند. می‌تواند برای مقداردهی اولیهٔ یک مخزن ریشه (root store) جدید یا افزودن یک زیرمخزنِ سوارشدهٔ (mounted sub-store) جدید به کار رود. برای کلون کردن به دست‌کم یک آرگومان (نشانی URL مربوط به git) نیاز دارد. آرگومان دوم (مکان سوار کردن / mount location) را برای کلون و سوار کردن یک زیرمخزن می‌پذیرد، مانند “gopass clone git@example.com/store.git foo/bar”.

پرچم‌ها (Flags)

--check-keys,

بررسی وجود کلیدهای رمزگشایی معتبر. در صورت پیدا نشدن، کلیدهای جدیدی تولید می‌شوند.

--crypto,

انتخاب بک‌اند رمزنگاری [age gpgcli plain]

--path,

مسیر برای کلون کردن مخزن در آن

--storage,

انتخاب بک‌اند ذخیره‌سازی [cryptfs fossilfs gitfs jjfs]

config

نمایش و ویرایش فایل پیکربندی

این دستور امکان چاپ و ویرایش آسان پیکربندی را فراهم می‌کند. بدون آرگومان، کل پیکربندی چاپ می‌شود. با یک آرگومان، یک کلید منفرد چاپ می‌شود. با دو آرگومان، تنظیمی که توسط کلید مشخص شده می‌تواند به یک مقدار تنظیم شود.

پرچم‌ها (Flags)

--store,

اعمال گزینه‌ها روی یک مخزن مشخص

convert

تبدیل یک مخزن به بک‌اندهای مختلف

تبدیل یک مخزن به مجموعه‌ای متفاوت از بک‌اندها

پرچم‌ها (Flags)

--crypto,

کدام بک‌اند رمزنگاری؟ [age gpgcli plain]

--move,

مخزن جایگزین شود؟

--storage,

کدام بک‌اند ذخیره‌سازی؟ [cryptfs fossilfs fs gitfs jjfs]

--store,

مشخص کردن مخزن مورد نظر برای تبدیل

copy

رونوشت از رازها از یک مکان به مکان دیگر

این دستور از یک راز موجود در مخزن در مکانی دیگر رونوشت برمی‌دارد. این کار در میان زیرمخزن‌های مختلف نیز عمل می‌کند. اگر مبدأ یک دایرکتوری باشد، به طور خودکار رونوشت را به صورت بازگشتی (recursive) تهیه می‌کند. در این حالت، اگر اسلش پایانی وجود نداشته باشد، دایرکتوری مبدأ در مقصد بازسازی می‌شود؛ در غیر این صورت محتویات تخت (flatten) می‌شوند (مشابه rsync).

پرچم‌ها (Flags)

--commit-message,

-m, تنظیم پیام کامیت (commit)

--force,

-f, اجبار به رونوشت از راز و رونویسی روی مورد موجود

--interactive-commit,

-i, باز کردن یک ویرایشگر برای نوشتن پیام کامیت

create

ساخت آسان رازهای جدید

این دستور یک راهنما (wizard) را برای کمک به ساخت رازهای جدید اجرا می‌کند.

پرچم‌ها (Flags)

--force,

-f, اجبار در انتخاب مسیر

--store,

-s, کدام مخزن استفاده شود.SS delete حذف یک یا چند راز از مخزن

این دستور رازها را حذف می‌کند. این فرمان می‌تواند به صورت بازگشتی روی پوشه‌ها عمل کند. پیمایش بازگشتی در بین مخازن عمداً پشتیبانی نمی‌شود.

پرچم‌ها

--commit-message,

-m, تنظیم پیام کامیت

--force,

-f, اجبار در حذف راز

--interactive-commit,

-i, باز کردن ویرایشگر برای نوشتن پیام کامیت

--recursive,

-r, حذف بازگشتی فایل‌ها و پوشه‌ها

doctor

بررسی نصب gopass برای مشکلات رایج

مجموعه‌ای از بررسی‌های تشخیصی را روی نصب gopass اجرا می‌کند: وابستگی‌های باینری، پیکربندی git، مجوزهای مخزن، اعتبار کلید دریافت‌کنندگان و اتصال ریموت git. در صورت بروز خطا در هر یک از بررسی‌ها با وضعیت غیر صفر خارج می‌شود.

پرچم‌ها

--recipients,

اجرای بررسی دقیق سازگاری دریافت‌کنندگان (شناسه‌های استاندارد، کلیدهای ناموجود، وضعیت .public-keys/)

--verbose,

-v, نمایش بررسی‌های موفق علاوه بر هشدارها و خطاها

edit

ویرایش رازهای جدید یا موجود

از این دستور برای درج یک راز جدید یا ویرایش یک راز موجود با استفاده از $EDITOR خود استفاده کنید. این فرمان تلاش می‌کند یک دایرکتوری موقت امن برای ذخیره راز در زمان دسترسی ویرایشگر ایجاد کند. لطفاً مطمئن شوید که ویرایشگر شما داده‌های حساس را حین ویرایش در مکان‌های دیگر نشت ندهد. نکته: اگر $EDITOR تنظیم نشده باشد، 'editor' امتحان می‌شود. اگر آن هم در دسترس نباشد، به 'vi' بازگردانده می‌شود. برای تغییر مقادیر پیش‌فرض، استفاده از “update-alternatives --config editor” را مد نظر قرار دهید.

پرچم‌ها

--commit-message,

-m, تنظیم پیام کامیت

--create,

-c, ایجاد یک راز جدید در صورت پیدا نشدن

--editor,

-e, استفاده از این باینری ویرایشگر

--force,

اجبار به بازنویسی و رمزگذاری حتی اگر هیچ‌یک از کلیدهای محلی شما در میان دریافت‌کنندگان نباشد

--interactive-commit,

-i, باز کردن ویرایشگر برای نوشتن پیام کامیت

env

اجرای یک زیرپردازش با متغیرهای محیطی از پیش مقداردهی‌شده

این دستور یک زیرپردازش را با محیطی که از کلیدهای یک راز پر شده است، اجرا می‌کند.

پرچم‌ها

--exec,

جایگزین کردن پردازش فعلی با زیرپردازش از طریق exec(3) به جای ایجاد پردازش فرزند (در Windows پشتیبانی نمی‌شود)

--file,

نوشتن هر راز در یک فایل موقت ramdisk و برون‌ریزی (export) به‌صورت KEY_FILE=/path به جای KEY=value

--keep-case,

--kc, حفظ بزرگی و کوچکی حروف اصلی نام متغیر محیطی و عدم تبدیل آن به حروف بزرگ

--stdin,

هدایت (pipe) گذرواژه راز به stdin زیرپردازش به جای مقداردهی به متغیر محیطی.SS find جستجوی رازها

این دستور ابتدا یک تطبیق الگوی ساده روی نام راز را امتحان می‌کند. اگر تطابق دقیقی وجود داشته باشد، مستقیماً نمایش داده خواهد شد؛ اگر چندین تطابق وجود داشته باشد، انتخابی از آن‌ها نمایش داده می‌شود.

پرچم‌ها

--json,

-j, خروجی تطابق‌ها به صورت آرایه JSON

--regex,

-r, تفسیر الگو به عنوان عبارت باقاعده (regular expression)

--unsafe,

-u, در صورت تطابق دقیق، نمایش گذرواژه حتی اگر safecontent فعال باشد

fsck

بررسی یکپارچگی مخزن، پاک‌سازی مصنوعات زائد و در صورت امکان بازنویسی رازها

بررسی یکپارچگی زیرمخزنِ مشخص‌شده، یا تمام مخزن‌ها در صورتی که موردی تعیین نشده باشد. به‌طور خودکار تمام مشکلات یافت‌شده را برطرف می‌کند؛ یعنی دسترسی‌ها را تغییر می‌دهد، رازها را بازنویسی می‌کند و پیکربندی‌های قدیمی را حذف می‌کند.

پرچم‌ها

--decrypt,

رمزگشایی و رمزنگاری مجدد در حین fsck.

--store,

محدود کردن fsck به این نقطه اتصال (mount point)

fscopy

کپی کردن فایل‌ها از یا به مخزن گذرواژه

این دستور یا فایلی را از سیستم‌فایل خوانده و نسخه کدگذاری و رمزنگاری‌شده آن را در مخزن می‌نویسد، یا رازی را رمزگشایی و کدگشایی کرده و نتیجه را در یک فایل می‌نویسد. یکی از مبدأ یا مقصد باید فایل و دیگری باید یک راز باشد. اگر می‌خواهید مبدأ پس از کپی به‌صورت امن حذف شود، از 'gopass fsmove' استفاده کنید.

fsmove

انتقال فایل‌ها از یا به مخزن گذرواژه

این دستور یا فایلی را از سیستم‌فایل خوانده و نسخه کدگذاری و رمزنگاری‌شده آن را در مخزن می‌نویسد، یا رازی را رمزگشایی و کدگشایی کرده و نتیجه را در یک فایل می‌نویسد. یکی از مبدأ یا مقصد باید فایل و دیگری باید یک راز باشد. مبدأ پس از کپی موفقیت‌آمیز و اعتبارسنجی، از دیسک یا از مخزن پاکسازی قطعی (wipe) خواهد شد. اگر نمی‌خواهید مبدأ حذف شود، از 'gopass fscopy' استفاده کنید.

generate

تولید یک گذرواژه جدید

کادر محاوره‌ای برای تولید یک گذرواژه جدید و نوشتن آن در یک راز جدید یا موجود. به‌طور پیش‌فرض، گذرواژه جدید جایگزین خط اول یک راز موجود خواهد شد (یا یک راز جدید ایجاد می‌کند).

پرچم‌ها

--clip,

-c, کپی گذرواژه تولیدشده به کلیپ‌بورد

--commit-message,

-m, تنظیم پیام کامیت

--edit,

-e, باز کردن راز جهت ویرایش پس از تولید گذرواژه

--force,

-f, اجبار به بازنویسی گذرواژه موجود

--force-regen,

اجبار به تولید مجدد کامل، شامل ارزیابی قالب‌ها (templates). کل راز بازنویسی خواهد شد!

--generator,

-g, انتخاب یک مولد گذرواژه، از یکی از این موارد استفاده کنید: cryptic، memorable، xkcd یا external. پیش‌فرض: cryptic

--interactive-commit,

-i, باز کردن یک ویرایشگر برای پیام کامیت

--print,

-p, چاپ گذرواژه تولیدشده در ترمینال

--strict,

الزامی کردن قوانین سخت‌گیرانه برای رده‌های نویسه (character classes)

--symbols,

-s, استفاده از نمادها در گذرواژه

--xkcd-capitalize,

--xkcdcapitalize, بزرگ نوشتن حرف اول هر کلمه در گذرواژه تولیدشده به روش XKCD

--xkcd-lang,

--lang, --xkcdlang, زبانی که گذرواژه XKCD از آن تولید می‌شود؛ در حال حاضر فقط en (انگلیسی، پیش‌فرض) یا de پشتیبانی می‌شوند

--xkcd-numbers,

--xkcdnumbers, افزودن یک عدد تصادفی به انتهای گذرواژه تولیدشده به روش XKCD

--xkcd-sep,

--sep, --xkcdsep, جداکننده کلمات برای گذرواژه‌های تولیدشده به روش XKCD. اگر جداکننده‌ای تعیین نشود، کلمات بدون فاصله/جداکننده ترکیب می‌شوند و نویسه اول کلمات بزرگ نوشته می‌شود..SS git اجرای یک دستور git در مخزن گذرواژه: gopass git [--store=<store>] <git-command>

اگر مخزن گذرواژه یک مخزن git باشد، یک دستور git مشخص‌شده با git-command-args را اجرا می‌کند.

پرچم‌ها

--store,

مخزنی که عملیات روی آن انجام می‌شود

grep

جستجو برای فایل‌های راز حاوی search-string پس از رمزگشایی.

این دستور تمام رازها را رمزگشایی کرده و تطبیق الگو را روی محتوا انجام می‌دهد.

پرچم‌ها

--regexp,

-r, تفسیر الگو به عنوان عبارت باقاعده RE2

history

نمایش تاریخچه گذرواژه

نمایش تاریخچه تغییرات برای یک راز

پرچم‌ها

--password,

-p, گنجاندن گذرواژه‌ها در خروجی

init

راه‌اندازی اولیه مخزن گذرواژه جدید.

راه‌اندازی اولیه فضای ذخیره‌سازی گذرواژه جدید و استفاده از gpg-id برای رمزنگاری.

پرچم‌ها

--crypto,

انتخاب موتور رمزنگاری [age gpgcli plain]

--path,

-p, تنظیم مسیر زیرمخزنی که عملیات روی آن انجام می‌شود

--storage,

انتخاب موتور ذخیره‌سازی [cryptfs fossilfs fs gitfs jjfs]

--store,

-s, تنظیم نام زیرمخزن

insert

درج یک راز جدید

درج یک راز جدید. به صورت اختیاری، بازتاب دادن راز در کنسول هنگام وارد کردن. یا به صورت اختیاری، ورودی می‌تواند چندخطی باشد. پیش از رونویسی راز موجود درخواست تأیید می‌شود، مگر اینکه اجبار شده باشد.

پرچم‌ها

--append,

-a, الحاق داده‌های خوانده‌شده از STDIN به داده‌های موجود

--commit-message,

تنظیم پیام commit

--echo,

-e, نمایش راز هنگام تایپ کردن

--force,

-f, رونویسی هرگونه راز موجود و عدم درخواست تأیید گیرندگان

--interactive-commit,

-i, باز کردن یک ویرایشگر برای پیام commit

--multiline,

-m, درج با استفاده از $EDITOR

link

ایجاد یک symlink

این دستور یک symlink از یک مدخل در مخزن متصل‌شده به مدخلی دیگر ایجاد می‌کند. مهم: از نقاط mount عبور نمی‌کند!.SS list فهرست کردن رازهای موجود

این دستور تمام رازهای موجود را فهرست می‌کند. برای فهرست کردن تنها زیرپوشه‌های مشخصی از مخزن، یک پیشوند پوشه ارائه دهید.

پرچم‌ها

--flat,

-f, چاپ یک فهرست مسطح

--folders,

-d, چاپ یک فهرست مسطح از پوشه‌ها

--json,

-j, خروجی به‌صورت آرایه JSON

--limit,

-l, نمایش درخت حداکثر تا این تعداد سطح

--strip-prefix,

-s, حذف این پیشوند از مدخل‌های پالایش‌شده

merge

ادغام چندین راز در یکی

این دستور یک گردش کار ادغام را برای کمک به یکپارچه‌سازی و حذف موارد تکراری رازها پیاده‌سازی می‌کند. به دقیقاً یک مقصد (که می‌تواند از قبل وجود داشته باشد) و دست‌کم یک مبدأ (که باید وجود داشته باشد و می‌تواند چندگانه باشد) نیاز دارد. سپس gopass تمام مدخل‌ها را در یک مورد ادغام کرده، یک ویرایشگر باز می‌کند، نتیجه را ذخیره می‌نماید و تمام مدخل‌های ادغام‌شده را حذف می‌کند.

پرچم‌ها

--delete,

-d, حذف مدخل‌های ادغام‌شده

--force,

-f, نادیده گرفتن ویرایشگر و ادغام خودکار مدخل‌ها

mounts

ویرایش مخازن متصل‌شده

این دستور تمام مخازن گذرواژهٔ متصل‌شده (mount) را نمایش می‌دهد. همچنین چندین زیرفرمان برای ایجاد یا حذف اتصال‌ها فراهم می‌کند.

move

انتقال رازها از مکانی به مکان دیگر

این دستور یک راز را از یک مسیر به مسیری دیگر منتقل می‌کند. این ویژگی در بین زیرمخازن مختلف نیز کار می‌کند. اگر مبدأ یک دایرکتوری باشد، در صورتی که اسلش انتهایی وجود نداشته باشد دایرکتوری مبدأ مجدداً در مقصد ایجاد می‌شود؛ در غیر این صورت محتویات مسطح خواهند شد (مشابه rsync).

پرچم‌ها

--commit-message,

-m, تنظیم پیام کامیت (commit)

--force,

-f, اجبار به انتقال راز و بازنویسی موارد موجود

--interactive-commit,

-i, باز کردن ویرایشگر برای پیام کامیت

otp

تولید توکن‌های مبتنی بر زمان یا hmac

تلاش می‌کند تا یک نشانی اینترنتی OTP (⟨otpauth://⟩) را تجزیه کند. این نشانی می‌تواند TOTP یا HOTP باشد. نشانی می‌تواند در خطی مستقل یا در قالب یک خط کلید-مقدار با کلیدی به نام 'totp' ارائه شود.

پرچم‌ها

--alsoclip,

-C, کپی کردن توکن مبتنی بر زمان و نمایش آن

--chained,

-p, زنجیر کردن توکن به گذرواژه

--clip,

-c, کپی کردن توکن مبتنی بر زمان در کلیپ‌بورد

--password,

-o, فقط نمایش توکن

--qr,

-q, نوشتن کد QR در FILE

--snip,

-s, اسکن محتوای صفحه برای درج یک کد QR مربوط به OTP در مدخل ارائه‌شده.SS process پردازش یک فایل الگو

این دستور یک فایل الگو را پردازش می‌کند. فایل الگو خوانده شده و تمام متغیرها با مقادیرشان جایگزین می‌شوند.

پرچم‌ها (Flags)

pull

دریافت (Pull) یک مخزن از ریموت آن

دریافت مخزن انتخاب‌شده از ریموت پیکربندی‌شده آن. اگر هیچ ریموت یا شاخه‌ای مشخص نشده باشد، از پیش‌فرض‌های سامانه پشتیبان ذخیره‌سازی استفاده می‌شود.

پرچم‌ها (Flags)

--store,

-s, انتخاب مخزن برای دریافت (pull)

push

ارسال (Push) یک مخزن به ریموت آن

ارسال مخزن انتخاب‌شده به ریموت پیکربندی‌شده آن. اگر هیچ ریموت یا شاخه‌ای مشخص نشده باشد، از پیش‌فرض‌های سامانه پشتیبان ذخیره‌سازی استفاده می‌شود.

پرچم‌ها (Flags)

--store,

-s, انتخاب مخزن برای ارسال (push)

pwgen

تولید گذرواژه‌ها

چاپ هر تعداد گذرواژه در کنسول. پارامتر اختیاری length (طول)، طول هر گذرواژه را مشخص می‌کند.

پرچم‌ها (Flags)

--ambiguous,

-B, شامل نکردن نویسه‌هایی که ممکن است به راحتی با یکدیگر اشتباه شوند، مانند '1' و 'l' یا '0' و 'O'

--memorable,

-m, استفاده از تولیدکننده گذرواژه به‌یادسپردنی (مبتنی بر کلمه). طول درخواست‌شده حداقل است (خروجی ممکن است طولانی‌تر باشد). ناسازگار با --no-numerals (حالت به‌یادسپردنی همیشه شامل ارقام است).

--memorable-capitalize,

--memorablecapitalize, --mc, بزرگ‌نویسی (برخی از) کلمات در گذرواژه به‌یادسپردنیِ تولیدشده. این پرچم مستلزم --memorable است.

--no-capitalize,

-A, شامل نکردن حروف بزرگ در گذرواژه‌های تولیدشده.

--no-numerals,

-0, شامل نکردن ارقام در گذرواژه‌های تولیدشده.

--one-per-line,

-1, چاپ یک گذرواژه در هر خط

--symbols,

-y, گنجاندن حداقل یک نماد در گذرواژه.

--xkcd,

-x, استفاده از چندین کلمه انگلیسی تصادفی ترکیب‌شده در یک گذرواژه. به‌طور پیش‌فرض، فاصله به عنوان جداکننده استفاده می‌شود و همه کلمات با حروف کوچک هستند.

--xkcd-capitalize,

--xkcdcapitalize, --xc, بزرگ‌نویسی حرف اول هر کلمه در گذرواژه تولیدشده به سبک xkcd. این پرچم مستلزم -xkcd است.

--xkcd-lang,

--lang, --xkcdlang, --xl, زبانی که گذرواژه از آن تولید می‌شود؛ در حال حاضر فقط en (انگلیسی، پیش‌فرض) یا de پشتیبانی می‌شوند.

--xkcd-numbers,

--xkcdnumbers, --xn, افزودن یک عدد تصادفی به انتهای گذرواژه تولیدشده به سبک xkcd. این پرچم مستلزم -xkcd است.

--xkcd-sep,

--sep, --xkcdsep, --xs, جداکننده کلمات برای گذرواژه تولیدشده به سبک xkcd. اگر جداکننده‌ای مشخص نشود، کلمات بدون فاصله/جداکننده ترکیب می‌شوند و حرف اول کلمات بزرگ نوشته می‌شود. این پرچم مستلزم -xkcd است..SS rcs اجرای یک دستور RCS درون یک مخزن گذرواژه

اگر مخزن گذرواژه یک مخزن git باشد، دستور git مشخص‌شده توسط git-command-args را اجرا می‌کند.

recipients

ویرایش مجوزهای دریافت‌کنندگان (recipients)

این دستور تمام دریافت‌کنندگان موجود را برای تمامی مخازن متصل‌شده (mounted) نمایش می‌دهد. زیردستورها امکان افزودن یا حذف دریافت‌کنندگان را فراهم می‌کنند.

پرچم‌ها (Flags)

--json,

-j, خروجی دریافت‌کنندگان به‌صورت آرایه JSON

--pretty,

نمایش دریافت‌کنندگان با قالب‌بندی خوانا (Pretty print)

reorg

سازمان‌دهی مجدد یک مخزن گذرواژه با ویرایش یک فایل متنی

این دستور تمام رازها را به‌صورت خط‌به‌خط در یک فایل متنی فهرست کرده و سپس آن را در یک ویرایشگر باز می‌کند. پس از این‌که کاربر تغییرات را ذخیره کرد و از ویرایشگر خارج شد، gopass فایل موقت را خوانده، جابه‌جایی‌های لازم را محاسبه می‌کند و یک diff و اعلان تأیید نشان می‌دهد. پس از تأیید کاربر، رازها سازمان‌دهی مجدد شده و یک پیام کامیت معنادار ایجاد می‌شود.

setup

مقداردهی اولیه یک مخزن گذرواژه جدید

اگر gopass بدون هیچ مخزن گذرواژهٔ موجودی اجرا شود، این دستور به‌طور خودکار فراخوانی می‌شود. این دستور وجود دارد تا بتوان دستورالعمل‌های سادهٔ راه‌اندازی تک‌فرمانی را به کاربران ارائه داد.

پرچم‌ها (Flags)

--create-team,

--create, ایجاد یک تیم جدید به‌جای پیوستن به تیمی موجود (پیش‌فرض: false، یعنی پیوستن به یک تیم موجود)

--crypto,

انتخاب بک‌اند رمزنگاری [age gpgcli plain]

--email,

ایمیل برای تولید کلید GPG به‌صورت خودکار (unattended)

--name,

نام و نام خانوادگی برای تولید کلید GPG به‌صورت خودکار

--remote,

آدرس URL برای یک git remote؛ تلاش خواهد کرد به این تیم بپیوندد

--storage,

انتخاب بک‌اند ذخیره‌سازی [cryptfs fossilfs fs gitfs jjfs]

--team,

--alias, نام تیمی که باید ایجاد شود یا به آن ملحق شوید (می‌تواند شامل اسلش باشد). همچنین به‌عنوان نقطه اتصال (mount point) محلی استفاده می‌شود.

show

نمایش محتوای یک راز

یک راز موجود را نمایش داده و در صورت تمایل، خط نخست آن را در کلیپ‌بورد قرار می‌دهد. در صورت قرار گرفتن در کلیپ‌بورد، پس از 45 ثانیه پاک خواهد شد.

پرچم‌ها (Flags)

--alsoclip,

-C, کپی کردن گذرواژه و نمایش تمام محتوا

--chars,

چاپ نویسه‌های خاصی از راز

--nofuzzysearch,

عدم شروع جستجوی فازی هنگامی که یک مدخل پیدا نمی‌شود

--noparsing,

-n, عدم تجزیه (parse) خروجی.

--nosync,

غیرفعال‌سازی همگام‌سازی خودکار (auto-sync)

--password,

-o, تنها نمایش گذرواژه. بر تمام پرچم‌های دیگر اولویت دارد.

--qr,

چاپ گذرواژه به‌صورت کد QR

--qrbody,

چاپ بدنه (body) به‌صورت کد QR

--revision,

-r, نمایش یک نسخه (revision) پیشین. از میان‌برهای خاص RCS پشتیبانی نمی‌کند. از نسخه دقیق یا -<N> برای انتخاب Nامین نسخه قدیمی‌تر این مدخل استفاده کنید.

--safe,

-s, عدم نمایش محتوای ناامن (مانند گذرواژه) حتی اگر safecontent غیرفعال باشد

--unsafe,

-u, -f, نمایش محتوای ناامن (مانند گذرواژه) حتی اگر safecontent فعال باشد

--yes,

-y, پاسخ مثبت همیشگی به پرسش‌های yes/no.SS sum محاسبه‌ی چک‌سام SHA256

این دستور یک راز کُدگذاری‌شده با Base64 را رمزگشایی کرده و چک‌سام SHA256 را روی داده‌های رمزگشایی‌شده محاسبه می‌کند. این کار برای تأیید یکپارچگی رازِ واردشده مفید است.

sync

همگام‌سازی تمام مخازن محلی با ریموت‌های آن‌ها

تمام مخازن محلی را با ریموت‌های git آن‌ها (در صورت وجود) همگام‌سازی کرده و کلیدهای gpg که احتمالاً تحت تأثیر قرار گرفته‌اند را بررسی می‌کند.

پرچم‌ها

--store,

-s, انتخاب مخزن جهت همگام‌سازی

templates

ویرایش الگوها

فهرست کردن الگوهای موجود در مخزن گذرواژه و فراهم کردن امکان ویرایش و ایجاد آن‌ها.

unclip

دستور داخلی برای پاک کردن کلیپ‌بورد

پاک کردن کلیپ‌بورد در صورتی که محتوای آن با چک‌سام مطابقت داشته باشد.

پرچم‌ها

--force,

پاک کردن کلیپ‌بورد حتی در صورت عدم تطابق چک‌سام

--timeout,

مدت زمان انتظار

update

بررسی برای به‌روزرسانی‌ها

این دستور به‌روزرسانی‌های gopass را در GitHub بررسی کرده و هر به‌روزرسانی موجود را به صورت خودکار بارگیری و نصب می‌کند.

version

نمایش نسخه

این دستور اطلاعات نسخه و زمان ساخت را نمایش می‌دهد.