نام (NAME)

tarsnap-keymgmt — تولید زیرمجموعه‌هایی از فایل‌های کلید tarsnap(1)

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

tarsnap-keymgmt --outkeyfile new-key-file [-r] [-w] [-d] [--nuke] [--passphrased] [--passphrase-mem maxmem] [--passphrase-time maxtime] key-file ... tarsnap-keymgmt --print-key-id key-file tarsnap-keymgmt --print-key-permissions key-file tarsnap-keymgmt --version

توضیحات (DESCRIPTION)

tarsnap-keymgmt فایل‌های کلید ارائه‌شده را خوانده و یک فایل کلید جدید (مشخص‌شده توسط --outkeyfile new-key-file) می‌نویسد که تنها شامل کلیدهای مورد نیاز برای عملیات تعیین‌شده از طریق پرچم‌های -r (فهرست کردن و استخراج آرشیوها)، -w (نوشتن آرشیوها)، -d (حذف آرشیوها)، و --nuke است. توجه داشته باشید که -d مستلزم -r نیز هست، زیرا حذف یک آرشیو مجزا بدون امکان خواندن آن غیرممکن است؛ در حالی که فایل کلید تولیدشده با --nuke می‌تواند برای حذف تمام آرشیوهای ذخیره‌شده به کار رود، اما نه برای آرشیوهای مجزا.

فهرست زیر نشان می‌دهد که برای حالت‌های مختلف دستور tarsnap(1) (command modes) چه مجوزهایی مورد نیاز است.

--recover: نیازمند کلیدهای یکی از موارد (۱) -d (حذف آرشیو)، (۲) -w (ایجاد آرشیو)، یا (۳) --nuke است.
--fsck: نیازمند کلیدهای یکی از موارد (۱) هر دوی -w (نوشتن آرشیو) و -r (خواندن آرشیو)، یا (۲) -d (حذف آرشیو) است.
--fsck-prune: نیازمند کلیدهای -d (حذف آرشیو) است، زیرا باید بتواند آرشیوهای آسیب‌دیده را حذف کند.

اگر گزینهٔ --passphrased مشخص شود، از کاربر خواسته می‌شود یک عبارت عبور (passphrase) را (دو بار) وارد کند تا برای رمزگذاری فایل کلید به کار رود.

اگر گزینهٔ --passphrase-mem maxmem مشخص شود، حداکثر maxmem بایت از حافظهٔ رم در تابع مشتق‌سازی کلید scrypt برای رمزگذاری فایل کلید استفاده خواهد شد؛ در صورتی که فایل کلید روی سیستمی با حافظهٔ رم بسیار بیشتر نسبت به سیستمی که قرار است فایل در آن استفاده شود ساخته می‌شود، ممکن است تنظیم این گزینه ضروری باشد.

اگر گزینهٔ --passphrase-time maxtime مشخص شود، حداکثر تقریباً maxtime ثانیه در تابع مشتق‌سازی کلید scrypt برای رمزگذاری فایل کلید صرف خواهد شد.

توجه داشته باشید اگر هیچ‌یک از گزینه‌های -w, -r, -d, یا --nuke مشخص نشوند، یک فایل کلید ایجاد خواهد شد که شامل هیچ کلیدی نیست. این مورد احتمالاً چندان کاربردی نخواهد بود.

گزینهٔ --print-key-id key-file عدد صحیح ۶۴-بیتی مربوط به شمارهٔ ماشین کلید را نمایش می‌دهد. این گزینه ممکن است برای اسکریپت‌ها یا واسط‌های گرافیکی (GUI) که حساب Tarsnap کاربر را مدیریت می‌کنند مفید باشد، اما احتمالاً برای استفاده در خط فرمان کمکی نخواهد کرد.

گزینهٔ --print-key-permissions key-file مجوزهایی را که کلید داراست نمایش می‌دهد.

گزینهٔ --version شماره نسخهٔ tarsnap-keymgmt را چاپ کرده و سپس خارج می‌شود.