'\" t
.\"     Title: nvme-sanitize
.\"    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\-SANITIZE" "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-sanitize \- ارسال دستور پاکسازی امن به دستگاه NVMe
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme sanitize\fR <device> [\-\-no\-dealloc | \-d] [\-\-oipbp | \-i]
                        [\-\-owpass=<overwrite\-pass\-count> | \-n <overwrite\-pass\-count>]
                        [\-\-ause | \-u] [\-\-sanact=<action> | \-a <action>]
                        [\-\-ovrpat=<overwrite\-pattern> | \-p <overwrite\-pattern>]
                        [\-\-emvs | \-e] [\-\-force]
                        [\-\-output\-format=<fmt> | \-o <fmt>] [\-\-verbose | \-v]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
دستور Sanitize (پاک‌سازی امن) را برای دستگاه NVMe داده‌شده ارسال کرده و نتیجه را ارائه می‌دهد\&.
.sp
پارامتر <device> یک دستگاه کاراکتری اجباری NVMe است (مانند: /dev/nvme0)\&.
.sp
در صورت موفقیت مقدار 0 و در غیر این صورت کد خطا بازگردانده می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-d, \-\-no\-dealloc
.RS 4
عدم آزادسازی پس از پاک‌سازی امن (No Deallocate After Sanitize): در صورت تنظیم بودن، کنترلر در نتیجهٔ تکمیل موفقیت‌آمیز عملیات پاک‌سازی امن هیچ بلوک منطقی را آزاد نخواهد کرد\&. اگر غیرفعال باشد، کنترلر باید در نتیجهٔ اتمام موفقیت‌آمیز عملیات پاک‌سازی امن، بلوک‌های منطقی را آزاد کند\&. این بیت در صورتی که فیلد Sanitize Action بر روی 001b (یعنی Exit Failure Mode) تنظیم شده باشد نادیده گرفته خواهد شد\&.
.RE
.PP
\-i, \-\-oipbp
.RS 4
وارونه‌سازی الگوی رونویسی میان دورها (Overwrite Invert Pattern Between Passes): در صورت تنظیم بودن، الگوی رونویسی بین دورها وارونه خواهد شد\&. اگر غیرفعال باشد، الگوی رونویسی بین دورها وارونه نمی‌شود\&. این بیت نادیده گرفته می‌شود مگر اینکه فیلد Sanitize Action بر روی 011b (یعنی Overwrite) تنظیم شده باشد\&.
.RE
.PP
\-n <overwrite\-pass\-count>, \-\-owpass=<overwrite\-pass\-count>
.RS 4
تعداد دورهای رونویسی (Overwrite Pass Count): این فیلد تعداد دورهای رونویسی (یعنی چند بار داده‌های رسانه رونویسی شوند) با استفاده از داده‌های فیلد Overwrite Pattern این دستور را مشخص می‌کند\&. مقدار 0 بیانگر ۱۶ دور رونویسی است\&. این فیلد نادیده گرفته خواهد شد مگر اینکه فیلد Sanitize Action بر روی 011b (یعنی Overwrite) تنظیم شده باشد\&.
.RE
.PP
\-u, \-\-ause
.RS 4
اجازه خروج نامحدود از پاک‌سازی امن (Allow Unrestricted Sanitize Exit): در صورت تنظیم بودن، عملیات پاک‌سازی امن در حالت تکمیل نامحدود انجام می‌شود\&. اگر غیرفعال باشد، عملیات پاک‌سازی امن در حالت تکمیل محدود انجام خواهد شد\&. اگر فیلد Sanitize Action بر روی 001b (یعنی Exit Failure Mode) تنظیم شده باشد این بیت نادیده گرفته می‌شود\&.
.RE
.PP
\-a <action>, \-\-sanact=<action>
.RS 4
اقدام پاک‌سازی امن (Sanitize Action):
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
مقدار
T}:T{
تعریف
T}
T{
0x00
T}:T{
رزروشده
T}
T{
0x01 |
\fIexit\-failure\fR
T}:T{
خروج از حالت خرابی (Exit Failure Mode)
T}
T{
0x02 |
\fIstart\-block\-erase\fR
T}:T{
شروع یک عملیات پاک‌سازی امن حذف بلوک (Block Erase)
T}
T{
0x03 |
\fIstart\-overwrite\fR
T}:T{
شروع یک عملیات پاک‌سازی امن رونویسی (Overwrite)
T}
T{
0x04 |
\fIstart\-crypto\-erase\fR
T}:T{
شروع یک عملیات پاک‌سازی امن رمزنگارانه (Crypto Erase)
T}
T{
0x05 |
\fIexit\-media\-verification\fR
T}:T{
خروج از وضعیت اعتبارسنجی رسانه (Media Verification State)
T}
.TE
.sp 1
.RE
.PP
\-p <overwrite\-pattern>, \-\-ovrpat=<overwrite\-pattern>
.RS 4
الگوی رونویسی (Overwrite Pattern): این فیلد نادیده گرفته می‌شود مگر اینکه فیلد Sanitize Action در Command Dword 10 بر روی 011b (یعنی Overwrite) تنظیم شده باشد\&. این فیلد یک الگوی ۳۲ بیتی را مشخص می‌کند که برای عملیات پاک‌سازی امن رونویسی استفاده می‌شود\&.
.RE
.PP
\-e, \-\-emvs
.RS 4
ورود به وضعیت اعتبارسنجی رسانه (Enter Media Verification State): در صورت تنظیم بودن، چنانچه پردازش پاک‌سازی امن با موفقیت پایان یابد، دستگاه وارد وضعیت اعتبارسنجی رسانه (Media Verification) خواهد شد\&. اگر غیرفعال باشد، این بیت هیچ تاثیری نخواهد داشت\&. اگر فیلد SANACT شروع یک عملیات پاک‌سازی را مشخص نکند (یعنی روی مقداری غیر از 010b یا 011b یا 100b تنظیم شده باشد)، این بیت توسط کنترلر نادیده گرفته خواهد شد\&.
.RE
.PP
\-\-force
.RS 4
مشغول بودن فضای نام در زمان جاری را نادیده گرفته و در هر صورت عملیات را انجام می‌دهد\&.
.RE
.PP
\-o <fmt>, \-\-output\-format=<fmt>
.RS 4
قالب گزارش‌دهی را روی یکی از مقادیر
\fInormal\fR،
\fIjson\fR
یا
\fIbinary\fR
تنظیم می‌کند\&. در هر بار تنها یک قالب خروجی قابل استفاده است\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
میزان جزئیات اطلاعات را در خروجی افزایش می‌دهد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ارسال دستور Sanitize توسط برنامه:
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme sanitize /dev/nvme0 \-a 0x02
# nvme sanitize /dev/nvme0 \-\-sanact=0x01
# nvme sanitize /dev/nvme0 \-\-sanact=start\-overwrite
.fi
.if n \{\
.RE
.\}
.RE
.SH "NVME"
.sp
بخشی از مجموعهٔ nvme\-user\&.