.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.2.
.TH DDRESCUELOG "1" "January 2026" "GNU ddrescuelog 1.30" "User Commands"
.SH "نام (NAME)"
ddrescuelog \- ابزاری برای مدیریت فایل‌های نگاشت (mapfile) در ddrescue
.SH "خلاصه دستور (SYNOPSIS)"
.B ddrescuelog
[\fI\,options\/\fR] \fI\,mapfile\/\fR
.SH "توضیحات (DESCRIPTION)"
برنامه GNU ddrescuelog ابزاری است که فایل‌های نگاشت (mapfile) برنامه ddrescue را دستکاری می‌کند، محتویات فایل نگاشت را نمایش می‌دهد، فایل‌های نگاشت را به/از قالب‌های دیگر تبدیل می‌کند، فایل‌های نگاشت را با یکدیگر مقایسه می‌کند، وضعیت بازیابی را می‌سنجد و می‌تواند در صورت اتمام فرایند بازیابی، فایل نگاشت را حذف کند. در صورت استفاده از گزینه‌های تنظیم دامنه (domain)، عملیات‌های ddrescuelog می‌تواند به یک یا چند بخش از فایل نگاشت محدود شود.
.PP
برای خواندن فایل نگاشت از ورودی استاندارد (همچنین در گزینه‌هایی که یک آرگومان mapfile می‌گیرند) یا برای نوشتن فایل نگاشت ایجادشده توسط '\-\-create\-mapfile' در خروجی استاندارد، از یک خط‌تیره '\-' به عنوان mapfile استفاده کنید.
.PP
نکته: در نسخه‌های ddrescue پیش از 1.20، به فایل نگاشت \&'logfile' گفته می‌شد. قالب فایل یکسان است و تنها نام آن تغییر کرده است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.TP
\fB\-a\fR, \fB\-\-change\-types=\fR<ot>,<nt>
تغییر انواع بلوک در mapfile
.TP
\fB\-A\fR, \fB\-\-annotate\-mapfile\fR
افزودن یادداشت‌هایی با موقعیت/اندازه‌های خوانا برای انسان
.TP
\fB\-b\fR, \fB\-\-block\-size=\fR<bytes>
اندازه بلوک (سکتور) بر حسب بایت [پیش‌فرض: 512]
.TP
\fB\-B\fR, \fB\-\-binary\-prefixes\fR
نمایش پیشوندهای باینری در اعداد [SI]
.TP
\fB\-c\fR, \fB\-\-create\-mapfile[=\fR<tt>]
ایجاد mapfile از فهرستی از بلوک‌ها [+\-]
.TP
\fB\-C\fR, \fB\-\-complete\-mapfile[=\fR<t>]
تکمیل mapfile با افزودن بلوک‌هایی از نوع t [?]
.TP
\fB\-d\fR, \fB\-\-delete\-if\-done\fR
حذف فایل نگاشت در صورت اتمام بازیابی
.TP
\fB\-D\fR, \fB\-\-done\-status\fR
بازگرداندن کد 0 در صورت اتمام بازیابی
.TP
\fB\-f\fR, \fB\-\-force\fR
بازنویسی فایل‌های خروجی موجود
.TP
\fB\-F\fR, \fB\-\-format=\fR<name>
قالب برای \fB\-c\fR و \fB\-l\fR (شامل list، bitmap\-[bl]e)
.TP
\fB\-H\fR, \fB\-\-make\-test=\fR<C:H:S:to:bh>
ایجاد mapfile برای حالت آزمایشی ddrescue
.TP
\fB\-i\fR, \fB\-\-input\-position=\fR<bytes>
موقعیت شروع دامنه بازیابی [0]
.TP
\fB\-l\fR, \fB\-\-list\-blocks=\fR<types>
چاپ شماره بلوک‌های انواع داده‌شده (?*/\-+)
.TP
\fB\-L\fR, \fB\-\-loose\-domain\fR
پذیرش فایل نگاشت دامنه نامرتب با شکاف‌ها
.TP
\fB\-m\fR, \fB\-\-domain\-mapfile=\fR<file>
محدود کردن دامنه به بلوک‌های پایان‌یافته در <file>
.TP
\fB\-n\fR, \fB\-\-invert\-mapfile\fR
معکوس کردن انواع بلوک‌ها (پایان‌یافته <\-\-> سایر موارد)
.TP
\fB\-o\fR, \fB\-\-output\-position=\fR<bytes>
موقعیت شروع در فایل خروجی [ipos]
.TP
\fB\-p\fR, \fB\-\-compare\-mapfile=\fR<file>
مقایسه انواع بلوک‌ها در دامنه هر دو فایل
.TP
\fB\-P\fR, \fB\-\-compare\-as\-domain=\fR<file>
مشابه \fB\-p\fR، اما فقط مقایسه بلوک‌های پایان‌یافته
.TP
\fB\-q\fR, \fB\-\-quiet\fR
فرونشاندن تمامی پیام‌ها
.TP
\fB\-s\fR, \fB\-\-size=\fR<bytes>
حداکثر اندازه دامنه بازیابی برای پردازش
.TP
\fB\-t\fR, \fB\-\-show\-status\fR
نمایش خلاصه‌ای از محتویات mapfile
.TP
\fB\-v\fR, \fB\-\-verbose\fR
حالت پرگو (تکرار \fB\-v\fR برای بار دوم اطلاعات بیشتری می‌دهد)
.TP
\fB\-x\fR, \fB\-\-xor\-mapfile=\fR<file>
اِعمال عملگر XOR میان بلوک‌های پایان‌یافته در فایل و mapfile
.TP
\fB\-y\fR, \fB\-\-and\-mapfile=\fR<file>
اِعمال عملگر AND میان بلوک‌های پایان‌یافته در فایل و mapfile
.TP
\fB\-z\fR, \fB\-\-or\-mapfile=\fR<file>
اِعمال عملگر OR میان بلوک‌های پایان‌یافته در فایل و mapfile
.TP
\fB\-\-shift\fR
انتقال تمام موقعیت‌های بلوک‌ها به میزان (opos \- ipos)
.PP
اعداد ممکن است در مبنای دهدهی، شانزده‌شانزدهی (هگزادسیمال) یا هشت‌هشتی (اکتال) باشند، می‌توانند شامل جداکننده‌های زیرخط بین گروه‌های ارقام باشند، و ممکن است پس از آنها یک ضریب باینری یا SI و همچنین حرف 's' برای «سکتورها» بیاید: 1_234_567kB، 4Kis، 0x1234_5678، 07_777.
نحو آرگومان گزینه '\-H' به این صورت است:
<cylinders:heads:sectors1[\-sectors2[,tracks_per_zone]]:track_order:bad_head>
.SH "وضعیت خروج (EXIT STATUS)"
0 برای خروج عادی، 1 برای مشکلات محیطی (پیدا نشدن فایل، گزینه‌های خط فرمان نامعتبر، خطاهای ورودی/خروجی و غیره)، 2 برای مشخص کردن فایل ورودی خراب یا نامعتبر، 3 برای خطای سازگاری داخلی (مانند باگ) که منجر به توقف بحرانی (panic) در ddrescuelog شده است.
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها به bug\-ddrescue@gnu.org
.br
تارنمای اصلی Ddrescue: http://www.gnu.org/software/ddrescue/ddrescue.html
.br
راهنمای عمومی استفاده از نرم‌افزارهای گنو: http://www.gnu.org/gethelp
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
Copyright \(co 2026 Antonio Diaz Diaz.
مجوز GPLv2+: گنو GPL نسخه 2 یا بالاتر <http://gnu.org/licenses/gpl.html>
.br
این یک نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید.
هیچ‌گونه ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل برای
.B ddrescuelog
به صورت یک کتابچه Texinfo نگهداری می‌شود. در صورتی که برنامه‌های
.B info
و
.B ddrescuelog
به‌درستی روی سیستم شما نصب شده باشند، دستور
.IP
.B info ddrescue
.PP
باید دسترسی شما را به راهنمای کامل فراهم سازد.