.\" Copyright 2007-2025 Tarsnap Backup Inc.
.\" All rights reserved.
.\"
.Dd March 20, 2025
.Dt TARSNAP-KEYGEN 1
.Os
.Sh "نام (NAME)"
.Nm tarsnap-keygen
.Nd تولید فایل کلید برای استفاده با
.Xr tarsnap 1
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Fl -keyfile Ar 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 1
می‌نویسد.
.Pp
گزینهٔ
.Fl -keyfile Ar 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
را چاپ کرده و سپس خارج می‌شود.