'\" t
.\"     Title: clevis-luks-edit
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/23/2026
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "CLEVIS\-LUKS\-EDIT" "1" "08/23/2026" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
clevis-luks-edit \- ویرایش پیکربندی پیوند Clevis در اسلات LUKS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBclevis luks edit\fR [\-f] \-d DEV \-s SLT [\-c CONFIG]
.SH "نمای کلی (OVERVIEW)"
.sp
دستور \fBclevis luks edit\fR پیوندهای Clevis را در یک دستگاه LUKS ویرایش می‌کند\&. برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
clevis luks edit \-d /dev/sda1 \-s 1
.fi
.if n \{\
.RE
.\}
.SH "گزینه‌ها (OPTIONS)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-d\fR
\fIDEV\fR
: دستگاه LUKS جهت ویرایش پین‌های متصل به Clevis
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-s\fR
\fISLT\fR
: اسلات مورد استفاده هنگام ویرایش پیوند Clevis
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-f\fR
: ادامه دادن عملیات ویرایش حتی اگر پیکربندی بدون تغییر مانده باشد
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-c\fR
\fICONFIG\fR
: پیکربندی به‌روزشده برای استفاده
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.if n \{\
.RS 4
.\}
.nf
clevis luks list \-d /dev/sda1
1: tang \*(Aq{"url":"addr"}\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
همان‌طور که در مثال بالا مشاهده می‌شود، \fB/dev/sda1\fR دارای یک اسلات متصل است که در این مورد به یک پین \fItang\fR پیوند خورده است\&.
.sp
می‌توانیم با اجرای دستور زیر این پیوند را ویرایش کنیم:
.sp
.if n \{\
.RS 4
.\}
.nf
clevis luks edit \-d /dev/sda1 \-s 1
.fi
.if n \{\
.RE
.\}
.sp
این دستور یک ویرایشگر متنی را همراه با پیکربندی فعلی این پیوند جهت ویرایش باز می‌کند \(em همان ویرایشگری که در متغیر محیطی $EDITOR مشخص شده است یا \fIvi\fR به عنوان گزینه جایگزین \(em\&. در این حالت، محتوای زیر را خواهیم داشت:
.sp
.if n \{\
.RS 4
.\}
.nf
{
    "url": "addr"
}
.fi
.if n \{\
.RE
.\}
.sp
پس از باز شدن ویرایشگر، می‌توانیم پیکربندی پین را ویرایش کنیم\&. برای مثال برای \fItang\fR، می‌توان مقدار \fIurl\fR را تغییر داد\&. پس از انجام تغییرات، فایل را ذخیره کرده و خارج شوید\&. پیکربندی به‌روزشده از نظر صحت ساختار JSON اعتبارسنجی خواهد شد و در صورت نبود خطا، پیکربندی به‌روزشده به شما نشان داده می‌شود و از شما خواسته می‌شود تایید کنید که آیا مایل به ادامه عملیات هستید یا خیر\&.
.sp
با تایید و ادامه عملیات، پیوند به‌روزرسانی خواهد شد\&. ممکن است ارائه یک عبارت عبور معتبر LUKS برای دستگاه ضروری باشد\&.
.sp
در مثال دوم، همان دستگاه و اسلات را به‌روزرسانی می‌کنیم، اما پیکربندی به‌روزشده را نیز به صورت مستقیم ارائه می‌دهیم:
.sp
.if n \{\
.RS 4
.\}
.nf
clevis luks edit \-d /dev/sda1 \-s 1 \-c \*(Aq{"url":"new\-addr\-here"}\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
در این حالت، به‌روزرسانی پیوند در حالت غیرتعاملی انجام خواهد شد\&. توجه داشته باشید که در اینجا نیز ممکن است نیاز به ارائه عبارت عبور LUKS برای دستگاه باشد\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBclevis\-luks\-list\fR(1), \fBclevis\-luks\-bind\fR(1)