.\" Load the www device when using groff; provide a fallback for groff's MTO macro that formats email addresses.
.ie \n[.g] \
.  mso www.tmac
.el \{
.  de MTO
     \\$2 \(la\\$1 \(ra\\$3 \
.  .
.\}
.\" Create wrappers for .MTO and .URL that print only text on systems w/o groff or if not outputting to a HTML
.\" device. To that end we need to distinguish HTML output on groff from other configurations first.
.nr groffhtml 0
.if \n[.g] \
.  if "\*[.T]"html" \
.    nr groffhtml 1
.\" For code reuse it would be nice to have a single wrapper that gets its target macro as parameter.
.\" However, this did not work out with NetBSD's and OpenBSD's groff...
.de URLB
.  ie (\n[groffhtml]==1) \{\
.    URL \\$@
.  \}
.  el \{\
.    ie "\\$2"" \{\
.      BR "\\$1" "\\$3"
.    \}
.    el \{\
.      RB "\\$2 \(la" "\\$1" "\(ra\\$3"
.    \}
.  \}
..
.de MTOB
.  ie (\n[groffhtml]==1) \{\
.    MTO \\$@
.  \}
.  el \{\
.    ie "\\$2"" \{\
.      BR "\\$1" "\\$3"
.    \}
.    el \{\
.      RB "\\$2 \(la" "\\$1" "\(ra\\$3"
.    \}
.  \}
..
.TH FLASHPROG-WRITE-PROTECT 8 "2026-07-17" "flashprog-write-protect-v1.6-dirty" "2026-07-17"

.SH "نام (NAME)"
flashprog-write-protect \- کنترل تنظیمات حفاظت از نوشتن در تراشه‌های فلش

.SH "خلاصه دستور (SYNOPSIS)"
.I flashprog write-protect \fR[\fIstatus\fR] <options>
.br
.I flashprog write-protect \ list \ \ \ \fR<options>
.br
.I flashprog write-protect \ disable    \fR<options> [\fB\-\-temporary\fR]
.br
.I flashprog write-protect \ enable   \ \fR<options> [\fB\-\-temporary\fR]
.br
.I flashprog write-protect \ range  \ \ \fR<options> [\fB\-\-temporary\fR] <start>\fB,\fR<len>
.br
.I flashprog write-protect \ region   \ \fR<options> [\fB\-\-temporary\fR] <region-name>
.sp
که در آن <options> عمومی عبارتند از:
.RS 4
\fB\-p\fR <programmername>[:<parameters>] [\fB\-c\fR <chipname>]
.br
[\fB\-V\fR[\fBV\fR[\fBV\fR]]] [\fB-o\fR <logfile>] [\fB\-h\fR]
.RE
.sp
و <options> چیدمان (layout) عبارتند از:
.RS 4
[(\fB-l\fR|\fB--layout\fR) <layout-file>|\fB--fmap\fR <fmap-file>|\fB--fmap\fR|\fB--ifd\fR]
.RE

.SH "توضیحات (DESCRIPTION)"
.B flashprog-write-protect
ابزاری برای خواندن و نوشتن تنظیمات حفاظت از نوشتن (write-protection) تراشه‌های فلش است. در حال حاضر، این ابزار تنها از حفاظت بلوکی (block protection) تراشه‌های SPI NOR پشتیبانی می‌کند.

.SH "عملیات‌ها (OPERATIONS)"
می‌توانید در هر فراخوانی یک عملیات را مشخص کنید.
.B status
عملیات پیش‌فرض است.
.PP
.B status
.RS 4
وضعیت حفاظت از نوشتن، از جمله محدوده حفاظت برنامه‌ریزی‌شده فعلی را نمایش می‌دهد.
.RE
.PP
.B list
.RS 4
فهرستی از محدوده‌های حفاظت از نوشتن پشتیبانی‌شده برای تراشه فلش را چاپ می‌کند.
.RE
.PP
.B disable
.RS 4
قفل‌های حفاظت از نوشتن را غیرفعال می‌کند. محدوده پیکربندی‌شده معمولاً بدون تغییر باقی می‌ماند، اما امکان بازنویسی (override) آن فراهم خواهد شد.
.RE
.PP
.B enable
.RS 4
قفل‌های حفاظت از نوشتن را فعال می‌کند. محدوده حفاظت از نوشتن باید قبل از اجرای عملیات enable تنظیم شده باشد.
.RE
.PP
.BR range " <start>,<len>"
.RS 4
محدوده حفاظت‌شده را پیکربندی می‌کند.
.BR start " و " length
محدوده را با اعداد ده‌دهی (decimal)، هشت‌هشتی (octal با پیشوند \fB0\fR)، یا شانزده‌شانزدهی (hexadecimal با پیشوند \fB0x\fR) بر حسب بایت مشخص می‌کنند.
هر محدوده با طول صفر، کل حافظه فلش را از حالت حفاظت خارج می‌کند
(به عنوان مثال \fBrange 0,0\fR).
.RE
.PP
.BR region " <region-name>"
.RS 4
محدوده حفاظت‌شده را مطابق با ناحیه‌ای از چیدمان بارگذاری‌شده (از یک فایل یا فلش، برای منابع ممکن چیدمان به توضیحات گزینه‌های مربوطه در
.MR flashprog 8
مراجعه کنید) پیکربندی می‌کند.
.RE

.SH "گزینه‌ها (OPTIONS)"
تمام عملیات‌ها نیازمند استفاده از گزینه
.B -p/--programmer
هستند (لطفاً برای اطلاعات بیشتر پیرامون پشتیبانی از پروگرامر و پارامترها به
.MR flashprog 8
مراجعه کنید).
.PP
.BR \-p ", " \-\-programmer " <name>[" : "<parameter>[" , "<parameter>]...]"
.RS 4
دستگاه پروگرامر را مشخص می‌کند. این گزینه برای تمامی عملیات‌ها الزامی است. لطفاً برای فهرستی از پروگرامرهای پشتیبانی‌شده فعلی و پارامترهای آن‌ها به صفحه راهنمای
.MR flashprog 8
مراجعه کنید.
.RE
.PP
.BR \-c ", " \-\-chip " <chipname>"
.RS 4
فقط تراشه رام فلش مشخص‌شده را بررسی می‌کند. این گزینه نام تراشه را همان‌گونه که توسط
.B "flashprog \-L"
چاپ می‌شود بدون نام سازنده به‌عنوان پارامتر می‌پذیرد. لطفاً توجه داشته باشید که نام تراشه به حروف بزرگ و کوچک حساس است.
.RE
.PP
.BR \-V ", " \-\-verbose
.RS 4
خروجی با جزئیات بیشتر. این گزینه می‌تواند چندین بار (حداکثر ۳ بار، یعنی
.BR \-VVV )
برای دریافت گزارش‌های اشکال‌زدایی بیشتر ارائه شود.
.RE
.PP
.BR \-o ", " \-\-output " <logfile>"
.RS 4
ذخیره گزارش کامل اشکال‌زدایی در
.BR <logfile> .
اگر فایل از قبل موجود باشد، بازنویسی خواهد شد. این شیوه توصیه‌شده برای جمع‌آوری گزارش‌ها از flashprog است، زیرا حتی اگر پیام‌های روی صفحه پرجزئیات نباشند، گزارش فایل پرجزئیات خواهد بود و نیازی به تغییر مسیر خروجی ندارد.
.RE
.PP
.BR \-h ", " \-\-help
.RS 4
نمایش متن راهنما و خروج.
.RE
.PP
.RB ( -l | --layout ") <layout-file>, " --fmap-file " <fmap-file>, " --fmap ", " --ifd
.RS 4
لطفاً برای اطلاعات درباره فایل‌های چیدمان و سایر منابع چیدمان به صفحه راهنمای
.MR flashrom 8
مراجعه کنید.
.RE
.PP
.B \-\-temporary
.RS 4
هنگامی که گزینه
.B \-\-temporary
برای هر عملیاتی که پیکربندی تراشه فلش را تغییر می‌دهد ارائه شود، flashprog تلاش خواهد کرد مقداری موقت بنویسد که در حافظه فلش ذخیره نمی‌شود. این قابلیت نیازمند پشتیبانی ویژه تراشه فلش از دستور نوشتن ناپایدار در ثبات وضعیت (volatile write status register) است. مقدار جدید پس از بازنشانی (reset) تراشه فلش از دست خواهد رفت. بنابراین، استفاده از این گزینه همراه با پروگرامرهای خارجی که برق تراشه فلش را قطع و وصل می‌کنند (مانند Dediprog) بی‌فایده است.
.RE

.SH "مثال‌ها (EXAMPLES)"
برای فقط چاپ وضعیت فعلی حفاظت از نوشتن حافظه فلش داخلی بایوس (BIOS):
.sp
.RS 2
.B flashprog write-protect -p internal
.sp
.RE
یا
.sp
.RS 2
.B flashprog write-protect status -p internal
.sp
.RE
برای فعال‌سازی موقت محدوده پیکربندی‌شده فعلی:
.sp
.RS 2
.B flashprog write-protect enable -p internal --temporary
.RE

.SH "وضعیت خروج (EXIT STATUS)"
دستور flashprog با کد ۰ در صورت موفقیت خارج می‌شود، در بیشتر شکست‌ها با ۱ و در صورت ناموفق بودن فراخوانی mmap() با ۳ خارج می‌شود.

.SH "نیازمندی‌ها (REQUIREMENTS)"
برنامه flashprog برای پروگرامرهای مختلف به دسترسی‌های متفاوتی نیاز دارد. برای جزئیات به این بخش در صفحه راهنمای
.MR flashprog 8
مراجعه کنید.

.SH "گزارش اشکالات (BUGS)"
می‌توانید اشکالات را گزارش دهید، سؤالات خود را بپرسید یا گزارش‌های موفقیت را از طریق کانال‌های ارتباطی ما ارسال کنید:
.URLB "https://www.flashprog.org/Contact" "" .
.sp

.SH "مجوز (LICENSE)"
برنامه
.B flashprog
تحت مجوز عمومی همگانی گنو (GPL)، نسخه ۲ پوشش داده شده است. برخی از فایل‌ها علاوه بر این تحت هر نسخه بعدی GPL در دسترس هستند.

.SH "حق نشر (COPYRIGHT)"
.br
لطفاً فایل‌های مجزا را ببینید.
.PP
این صفحه راهنما توسط Nico Huber نوشته شده و از صفحه راهنمای
.MR flashprog 8
مشتق شده است. این اثر تحت شرایط مجوز GNU GPL (نسخه ۲ یا بالاتر) منتشر شده است.

.SH "همچنین ببینید (SEE ALSO)"
.MR flashprog 8