.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH BUPSTASH-NEW-SUB-KEY 1 "2026-09-01" "bupstash" "User Commands"
.SH "نام (NAME)"
bupstash-new-sub-key \- ایجاد زیرکلید با دسترسیهای محدود در bupstash
.SH "خلاصه دستور (SYNOPSIS)"
تولید یک زیرکلید bupstash با قابلیت‌های رمزگذاری و رمزگشایی محدودتر\.
.P
\fBbupstash new\-sub\-key \-k KEY \-o SUB_KEY\fR
.SH "توضیحات (DESCRIPTION)"
دستور
\fBbupstash new\-sub\-key\fR
یک کلید جدید bupstash ایجاد می‌کند که قادر به انجام زیرمجموعه‌ای از عملیات رمزگذاری و رمزگشایی کلید اصلی است\.
.P
قابلیت‌ها شامل هر یک از موارد 'put' ،'list' و 'list\-contents' هستند\. کلیدهای 'put' می‌توانند پشتیبان‌های جدید ایجاد کنند اما قادر به رمزگشایی داده‌ها نیستند، کلیدهای 'list' می‌توانند برچسب‌ها و سایر متاداده‌ها را رمزگشایی کنند، در حالی که کلیدهای 'list\-contents' قادر به رمزگشایی محتوای آیتم‌های ایجادشده توسط 'bupstash put' هستند\.
.P
یک کاربرد متداول برای کلید فقط-فهرست (list only)، اجازه دادن به یک جاب کرون (cron job) برای چرخاندن پشتیبان‌های قدیمی بر اساس برچسب‌های جستجوی آن‌ها، بدون فاش کردن کلید رمزگشایی داده‌ها است\.
.P
کلید تولیدشده دارای مجوزهایی خواهد بود که خواندن آن تنها برای کاربر ایجادکننده ممکن باشد\.
.P
در صورت مفقود شدن یک زیرکلید، کلید اصلی همچنان قادر خواهد بود هر داده‌ای را در مخزن که توسط آن زیرکلید رمزگذاری شده است رمزگشایی کند\.
.P
\fIنکته\fR: رمزگشایی با دسترسی متفاوت است \- یک مهاجم ممکن است همچنان بتواند صرفاً با حذف آیتم‌ها یا فایل‌هایی که به آن‌ها دسترسی دارد، داده‌ها را حذف کند\. برای محدود کردن عملیاتی که یک کاربر می‌تواند انجام دهد و جلوگیری از حذف غیرمجاز داده‌ها، از کنترل‌های دسترسی
.BR bupstash\-serve (1)
استفاده کنید\. این کار می‌تواند از طریق فایل authorized_keys مربوط به ssh یا سازوکارهایی مانند پیکربندی
\fBsudo\fR
یا
\fBdoas\fR
انجام شود\.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-k\fR, \fB\-\-key\fR \fIPATH\fR
کلیدی که زیرکلید جدید از آن مشتق می‌شود\.
.TP
\fB\-o\fR, \fB\-\-output\fR \fIPATH\fR
مسیر فایلی که زیرکلید در آن نوشته خواهد شد\.
.TP
\fB\-\-put\fR
کلید قادر خواهد بود داده‌ها را برای عملیات 'put' رمزگذاری کند\.
.TP
\fB\-\-list\fR
کلید قادر خواهد بود متاداده‌ها را رمزگشایی کرده و پرس‌وجوها را انجام دهد\.
.TP
\fB\-\-list\-contents\fR
کلید قادر خواهد بود محتوای آیتم‌ها را با 'list\-contents' فهرست کند (مستلزم \fB\-\-list\fR نیز هست)\.
.SH "مثال‌ها (EXAMPLES)"
.SS "ایجاد یک کلید جدید فقط برای درج داده (put only)"
.nf
$ bupstash new\-sub\-key \-\-put \-k backups\.key \-o \./put\.key
$ bupstash put \-k \./backups\-put\.key \./data
.fi
.SS "ایجاد یک کلید جدید برای فهرست‌کردن (listing key)"
.nf
$ bupstash new\-sub\-key \-k \./backups\.key \-o \./list\.key \-\-list
$ bupstash list \-k \./list\.key
.fi
.SS "ایجاد یک کلید جدید برای فهرست‌کردن محتوا (content listing key)"
.nf
$ bupstash new\-sub\-key \-k \./backups\.key \-o \./list\-contents\.key \-\-list\-contents
$ bupstash list\-contents \-k \./list\-contents\.key name=some\-backup\.tar
.fi
.SH "همچنین ببینید (SEE ALSO)"
\fBbupstash\fR(1), \fBbupstash\-keyfiles\fR(7)