| SECRET-TOOL(1) | User Commands | SECRET-TOOL(1) |
نام (NAME)
secret-tool - ذخیره و بازیابی گذرواژهها
خلاصه دستور (SYNOPSIS)
secret-tool store --label='Label' {attribute} {value} ...
secret-tool lookup {attribute} {value} ...
secret-tool clear {attribute} {value} ...
secret-tool search [--all]{attribute} {value} ...
توضیحات (DESCRIPTION)
secret-tool ابزاری در خط فرمان است که میتوان از آن برای ذخیره و بازیابی گذرواژهها استفاده کرد.
هر گذرواژه درون یک آیتم ذخیره میشود. آیتمها بهطور یکتا با مجموعهای از کلیدها و مقادیر مشخصهها شناسایی میشوند. هنگام ذخیرهٔ یک گذرواژه باید جفتهای یکتایی از نام و مقدار مشخصهها را مشخص کنید، و هنگام جستجوی یک گذرواژه، همان جفتهای نام و مقدار مشخصه را ارائه دهید.
STORE
برای ذخیرهٔ یک گذرواژه، secret-tool را با آرگومان store اجرا کنید. همچنین باید با آرگومان --label یک برچسب برای گذرواژه تعیین کنید. این برچسب در مدیر گذرواژه نمایش داده خواهد شد.
هنگام ذخیره کردن یک گذرواژه، اطمینان حاصل کنید که مجموعهای یکتا از نامها و مقادیر مشخصهها را ارسال میکنید. اگر این مشخصهها با موردی که از قبل موجود است مطابقت داشته باشند، بهجای ایجاد یک مورد جدید، آن مورد بهروزرسانی خواهد شد.
اگر از یک ترمینال یا tty فراخوانی شود، گذرواژه برای ذخیرهسازی درخواست خواهد شد و تنها یک خط پذیرفته میشود.
همچنین میتوان گذرواژهای را که قرار است ذخیره شود از طریق stdin هدایت (pipe) کرد. گذرواژه، محتویات stdin تا رسیدن به EOF خواهد بود. اگر از طریق stdin یک خط جدید وارد کنید، به عنوان بخشی از گذرواژه ذخیره خواهد شد.
LOOKUP
برای جستجوی یک گذرواژه، secret-tool را با آرگومان lookup اجرا کنید. همان جفتهای نام و مقدار مشخصهای را که هنگام ذخیره گذرواژه ارسال کرده بودید، مشخص کنید.
اگر چندین مورد با مشخصه ارائه شده مطابقت داشته باشند، اولین گذرواژهای که از قبل قفلگشایی شده است بازگردانده میشود. در صورت لزوم، یک مورد قفلگشایی خواهد شد.
هنگام چاپ گذرواژه در یک ترمینال یا tty، یک خط جدید اضافی پس از گذرواژه افزوده خواهد شد.
CLEAR
برای حذف یک گذرواژه، secret-tool را با آرگومان clear اجرا کنید. همان جفتهای نام و مقدار مشخصهای را که هنگام ذخیره گذرواژه ارسال کرده بودید، مشخص کنید.
تمام موارد قفلگشاییشدهای که با مشخصهها مطابقت دارند حذف خواهند شد.
SEARCH
این دستور، موارد منطبق را در secret service جستجو کرده و جزئیات آنها را چاپ میکند. همان جفتهای مشخصه و مقداری را که هنگام ذخیره گذرواژه ارسال کرده بودید، مشخص کنید. میتوانید از گزینههای زیر استفاده کنید:
--all
--unlock
کدهای خروج (EXIT CODES)
در صورت موفقیت 0 بازگردانده میشود، در غیر این صورت یک کد خطای غیر صفر بازگردانده خواهد شد.
مثالها (EXAMPLES)
مثال 1. ذخیرهسازی، بازیابی و پاک کردن یک گذرواژه
$ secret-tool store --label='My password' key1 value1 key2 value2 Password: hunter2
$ secret-tool lookup key1 value1 key2 value2 hunter2
$ secret-tool clear key1 value1 key2 value2
باگها (BUGS)
سامانه پیگیری باگها با مراجعه به وبسایت https://gitlab.gnome.org/GNOME/libsecret/issues در دسترس است. پیش از ارسال گزارش باگ، لطفاً مطمئن شوید که آخرین نسخهٔ secret-tool را دارید. بسیاری از باگها (بزرگ و کوچک) در هر انتشار برطرف میشوند و اگر نسخهٔ شما قدیمی باشد، ممکن است مشکل پیشتر حل شده باشد.
| XDG |