.\" Copyright 2011-2025 Tarsnap Backup Inc.
.\" All rights reserved.
.\"
.Dd March 20, 2025
.Dt TARSNAP-RECRYPT 1
.Os
.Sh "نام (NAME)"
.Nm tarsnap-recrypt
.Nd رمزنگاری مجدد داده‌های ذخیره‌شده با استفاده از
.Xr tarsnap 1
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Fl -oldkey Ar old-key-file
.Fl -oldcachedir Ar old-cache-dir
.Fl -newkey Ar new-key-file
.Fl -newcachedir Ar new-cache-dir
.Nm
.Fl -version
.Sh "توضیحات (DESCRIPTION)"
.Nm
داده‌ها را با استفاده از
.Ar old-key-file
بارگیری و رمزگشایی کرده و با استفاده از
.Ar new-key-file
مجدداً رمزنگاری و بارگذاری می‌کند.
پس از آن‌که تمام داده‌ها مجدداً بارگذاری شدند،
.Nm
داده‌ها را با استفاده از
.Ar old-key-file
حذف می‌کند تا تنها نسخه باقی‌مانده از داده‌ها، با
.Ar new-key-file
رمزنگاری شده باشد.
فایل کلید
.Ar new-key-file
باید توسط
.Xr tarsnap-keyregen 1
به همراه
.Ar old-key-file
تولید شده باشد.
.Pp
.Nm
وضعیت پیشرفت خود را پس از هر ۱ تا ۲ گیگابایت داده رونوشت‌شده ذخیره (checkpoint) می‌کند؛ در صورت بروز وقفه، می‌توان آن را دوباره اجرا کرد و تلاش خواهد کرد عملیات را ادامه دهد.
.Pp
توجه داشته باشید که پس از پایان کار
.Nm
همچنان امکان ذخیره آرشیوهای بیشتر با استفاده از کلید
.Ar old-key-file
و دایرکتوری کش
.Ar old-cache-dir
وجود خواهد داشت؛ بنابراین باید دقت شود که در زمان اجرای
.Nm ،
هرگونه فرآیند بایگانی خودکار (مانند
.Xr cron 8 )
غیرفعال گردد.
.Pp
گزینه
.Fl -version
شماره نسخه
.Nm
را چاپ کرده و سپس خارج می‌شود.
.Sh "مثال‌ها (EXAMPLES)"
دنباله دستورهای زیر کلیدهای جدید ایجاد کرده و داده‌ها را دوباره رمزنگاری می‌کند، با این فرض که کلیدهای مورد استفاده فعلی در
.Pa /root/tarsnap.key
و دایرکتوری کش فعلی در
.Pa /usr/local/tarsnap-cache
قرار دارند:
.Pp
.Dl Cm tarsnap-keyregen Fl -keyfile Pa /root/tarsnap.key.new Fl -oldkey Pa /root/tarsnap.key Fl -user Ar me@example.com Fl -machine Ar myserver
.Pp
.Dl Nm Fl -oldkey Pa /root/tarsnap.key Fl -oldcachedir Pa /usr/local/tarsnap-cache Fl -newkey Pa /root/tarsnap.key.new Fl -newcachedir Pa /usr/local/tarsnap-cache.new
.Pp
.Dl Cm rm Fl r Pa /usr/local/tarsnap-cache
.Pp
.Dl Cm mv Pa /usr/local/tarsnap-cache.new Pa /usr/local/tarsnap-cache
.Pp
.Dl Cm rm Pa /root/tarsnap.key
.Pp
.Dl Cm mv Pa /root/tarsnap.key.new Pa /root/tarsnap.key