.\" Copyright 2011-2025 Tarsnap Backup Inc.
.\" All rights reserved.
.\"
.Dd March 20, 2025
.Dt TARSNAP-KEYREGEN 1
.Os
.Sh "نام (NAME)"
.Nm tarsnap-keyregen
.Nd تولید یک فایل کلید برای استفاده با
.Xr tarsnap-recrypt 1
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Fl -keyfile Ar key-file
.Fl -oldkey Ar old-key-file
.Fl -user Ar user-name
.Fl -machine Ar machine-name
.Op Fl -passphrased
.Op Fl -passphrase-mem Ar maxmem
.Op Fl -passphrase-time Ar maxtime
.Nm
.Fl -version
.Sh "توضیحات (DESCRIPTION)"
دستور
.Nm
مجموعه‌ای از کلیدهای رمزنگاری را تولید می‌کند که با یک مجموعه موجود از کلیدهای رمزنگاری سازگار هستند، با سرور tarsnap ثبت‌نام کرده و یک فایل کلید برای استفاده با
.Xr tarsnap-recrypt 1
و
.Xr tarsnap 1
می‌نویسد. اصطلاح "سازگار" در اینجا به این معناست که می‌توان آرشیوهای ذخیره‌شده با مجموعه اول کلیدها را مجدداً رمزنگاری کرد تا با مجموعه دوم کلیدها ذخیره شوند. این امر به این دلیل لازم است که Tarsnap دارای کلیدهایی است که هنگام رمزنگاری مجدد داده‌ها باید یکسان باقی بمانند؛ در غیر این صورت، آرشیوهای موجود غیرقابل‌خواندن خواهند شد و نمی‌توان از آن‌ها برای حذف داده‌های تکراری (deduplication) استفاده کرد.
.Pp
گزینه
.Fl -keyfile Ar key-file
نام فایلی را مشخص می‌کند که کلیدهای تازه تولیدشده در آن نوشته شوند.
گزینه
.Fl -oldkey Ar old-key-file
نام فایل حاوی کلیدهای قدیمی را مشخص می‌کند.
گزینه
.Fl -user Ar user-name
نام (یعنی آدرس ایمیل) حساب Tarsnap را مشخص می‌کند.
گزینه
.Fl -machine Ar machine-name
نامی را مشخص می‌کند که در گزارش‌های حسابداری نمایش داده خواهد شد تا بتوانید ببینید هر ماشین چه مقدار داده ذخیره می‌کند.
.Pp
اگر گزینه
.Fl -passphrased
مشخص شود، از کاربر خواسته می‌شود یک عبارت عبور (دو بار) وارد کند تا برای رمزنگاری فایل کلید استفاده شود.
.Pp
اگر گزینه
.Fl -passphrase-mem Ar maxmem
مشخص شود، حداکثر
.Ar maxmem
بایت حافظه RAM در تابع اشتقاق کلید scrypt برای رمزنگاری فایل کلید استفاده خواهد شد؛ در صورتی که یک فایل کلید روی سیستمی با حافظه RAM بسیار بیشتر از سیستمی که فایل کلید در آن استفاده خواهد شد تولید شود، ممکن است تنظیم این گزینه لازم باشد.
.Pp
اگر گزینه
.Fl -passphrase-time Ar maxtime
مشخص شود، حداکثر تقریباً
.Ar maxtime
ثانیه در تابع اشتقاق کلید scrypt برای رمزنگاری فایل کلید استفاده خواهد شد.
.Pp
گزینه
.Fl -version
شماره نسخه
.Nm
را چاپ کرده و سپس خارج می‌شود.