'\" t
.\"     Title: nvme-capacity-mgmt
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 02/16/2026
.\"    Manual: NVMe Manual
.\"    Source: NVMe
.\"  Language: Persian
.\"
.TH "NVME\-CAPACITY\-MGMT" "1" "02/16/2026" "NVMe" "NVMe Manual"
.\" -----------------------------------------------------------------
.\" * 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)"
nvme\-capacity\-mgmt \- مدیریت ظرفیت حافظه در دستگاه‌های NVMe
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme capacity\-mgmt\fR <device> [\-\-operation=<operation> | \-O <operation>]
                        [\-\-element\-id=<element\-id> | \-i <element\-id>]
                        [\-\-cap\-lower=<cap\-lower> | \-l <cap\-lower>]
                        [\-\-cap\-upper=<cap\-upper> | \-u <cap\-upper>]
                        [\-\-output\-format=<fmt> | \-o <fmt>] [\-\-verbose | \-v]
                        [\-\-timeout=<timeout> | \-t <timeout>]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
برای دستگاه NVMe داده‌شده، یک دستور مدیریت ظرفیت (capacity management) را جهت پیکربندی، ایجاد یا حذف گروه‌های استقامت (Endurance Groups) یا مجموعه‌های NVM (NVM Sets) بر اساس عملیات و شناسهٔ عنصر (element_id) درخواستی ارسال می‌کند\&. در صورت موفقیت، چنانچه عملیاتْ ایجاد گروه استقامت یا مجموعهٔ NVM باشد، فیلد CQE CDW0 شامل شناسهٔ عنصر ایجادشده خواهد بود، در غیر این صورت فیلد CQE CDW0 رزرو شده است\&.
.sp
پارامتر <device> اجباری است و می‌تواند یک دستگاه نویسه‌ای NVMe (مانند: /dev/nvme0) یا یک دستگاه بلوکی فضای‌نام (مانند: /dev/nvme0n1) باشد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-O <operation>, \-\-operation=<operation>
.RS 4
عملیاتی که باید توسط کنترل‌کننده انجام شود\&.
.RE
.PP
\-i <element\-id>, \-\-element\-id=<element\-id>
.RS 4
مقداری که بر اساس مقدار فیلد Operation تعیین می‌شود\&.
.RE
.PP
\-l <cap\-lower>, \-\-cap\-lower=<cap\-lower>
.RS 4
۳۲ بیت کم‌ارزش‌تر ظرفیت بر حسب بایت برای گروه استقامت یا مجموعهٔ NVM که قرار است ایجاد شود\&.
.RE
.PP
\-u <cap\-upper>, \-\-cap\-upper=<cap\-upper>
.RS 4
۳۲ بیت پرارزش‌تر ظرفیت بر حسب بایت برای گروه استقامت یا مجموعهٔ NVM که قرار است ایجاد شود\&.
.RE
.PP
\-o <fmt>, \-\-output\-format=<fmt>
.RS 4
تنظیم قالب گزارش‌دهی روی
\fInormal\fR،
\fIjson\fR
یا
\fIbinary\fR\&. در هر زمان تنها یک قالب خروجی می‌تواند استفاده شود\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
افزایش سطح جزئیات اطلاعات در خروجی\&.
.RE
.PP
\-t <timeout>, \-\-timeout=<timeout>
.RS 4
بازنویسی مقدار مهلت زمانی پیش‌فرض\&. بر حسب میلی‌ثانیه\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
هنوز مثالی ارائه نشده است\&.
.SH "NVME"
.sp
بخشی از مجموعهٔ nvme\-user