.\" Copyright 2008-2025 Tarsnap Backup Inc.
.\" All rights reserved.
.\"
.Dd March 20, 2025
.Dt TARSNAP-KEYMGMT 1
.Os
.Sh "نام (NAME)"
.Nm tarsnap-keymgmt
.Nd تولید زیرمجموعه‌هایی از فایل‌های کلید
.Xr tarsnap 1
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Fl -outkeyfile Ar new-key-file
.Op Fl r
.Op Fl w
.Op Fl d
.Op Fl -nuke
.Op Fl -passphrased
.Op Fl -passphrase-mem Ar maxmem
.Op Fl -passphrase-time Ar maxtime
.Ar key-file ...
.Nm
.Fl -print-key-id Ar key-file
.Nm
.Fl -print-key-permissions Ar key-file
.Nm
.Fl -version
.Sh "توضیحات (DESCRIPTION)"
.Nm
فایل‌های کلید ارائه‌شده را خوانده و یک فایل کلید جدید
(مشخص‌شده توسط
.Fl -outkeyfile Ar new-key-file )
می‌نویسد که تنها شامل کلیدهای مورد نیاز برای عملیات تعیین‌شده از طریق پرچم‌های
.Fl r
(فهرست کردن و استخراج آرشیوها)،
.Fl w
(نوشتن آرشیوها)،
.Fl d
(حذف آرشیوها)، و
.Fl -nuke
است.
توجه داشته باشید که
.Fl d
مستلزم
.Fl r
نیز هست، زیرا حذف یک آرشیو مجزا بدون امکان خواندن آن غیرممکن است؛ در حالی که فایل کلید تولیدشده با
.Fl -nuke
می‌تواند برای حذف تمام آرشیوهای ذخیره‌شده به کار رود، اما نه برای آرشیوهای مجزا.
.Pp
فهرست زیر نشان می‌دهد که برای حالت‌های مختلف دستور
.Xr tarsnap 1
.Em (command modes)
چه مجوزهایی مورد نیاز است.
.Bl -tag -width 4n -offset 4n
.It Em --recover
نیازمند کلیدهای یکی از موارد (۱)
.Fl d
(حذف آرشیو)، (۲)
.Fl w
(ایجاد آرشیو)، یا (۳)
.Fl -nuke
است.
.It Em --fsck
نیازمند کلیدهای یکی از موارد (۱) هر دوی
.Fl w
(نوشتن آرشیو) و
.Fl r
(خواندن آرشیو)، یا (۲)
.Fl d
(حذف آرشیو) است.
.It Em --fsck-prune
نیازمند کلیدهای
.Fl d
(حذف آرشیو) است، زیرا باید بتواند آرشیوهای آسیب‌دیده را حذف کند.
.El
.Pp
اگر گزینهٔ
.Fl -passphrased
مشخص شود، از کاربر خواسته می‌شود یک عبارت عبور (passphrase) را (دو بار) وارد کند تا برای رمزگذاری فایل کلید به کار رود.
.Pp
اگر گزینهٔ
.Fl -passphrase-mem Ar maxmem
مشخص شود، حداکثر
.Ar maxmem
بایت از حافظهٔ رم در تابع مشتق‌سازی کلید scrypt برای رمزگذاری فایل کلید استفاده خواهد شد؛ در صورتی که فایل کلید روی سیستمی با حافظهٔ رم بسیار بیشتر نسبت به سیستمی که قرار است فایل در آن استفاده شود ساخته می‌شود، ممکن است تنظیم این گزینه ضروری باشد.
.Pp
اگر گزینهٔ
.Fl -passphrase-time Ar maxtime
مشخص شود، حداکثر تقریباً
.Ar maxtime
ثانیه در تابع مشتق‌سازی کلید scrypt برای رمزگذاری فایل کلید صرف خواهد شد.
.Pp
توجه داشته باشید اگر هیچ‌یک از گزینه‌های
.Fl w ,
.Fl r ,
.Fl d ,
یا
.Fl -nuke
مشخص نشوند، یک فایل کلید ایجاد خواهد شد که شامل هیچ کلیدی نیست.
این مورد احتمالاً چندان کاربردی نخواهد بود.
.Pp
گزینهٔ
.Fl -print-key-id Ar key-file
عدد صحیح ۶۴-بیتی مربوط به شمارهٔ ماشین کلید را نمایش می‌دهد.
این گزینه ممکن است برای اسکریپت‌ها یا واسط‌های گرافیکی (GUI) که حساب Tarsnap کاربر را مدیریت می‌کنند مفید باشد، اما احتمالاً برای استفاده در خط فرمان کمکی نخواهد کرد.
.Pp
گزینهٔ
.Fl -print-key-permissions Ar key-file
مجوزهایی را که کلید داراست نمایش می‌دهد.
.Pp
گزینهٔ
.Fl -version
شماره نسخهٔ
.Nm
را چاپ کرده و سپس خارج می‌شود.