نام (NAME)

ddrescue - ابزار بازیابی داده

خلاصه دستور (SYNOPSIS)

ddrescue [options] infile outfile [mapfile]

توضیحات (DESCRIPTION)

نرم‌افزار GNU ddrescue یک ابزار بازیابی داده است. این برنامه داده‌ها را از یک فایل یا دستگاه بلوکی (دیسک سخت، cdrom و غیره) به دستگاه دیگری رونوشت می‌کند و در صورت بروز خطاهای خواندن، تلاش می‌کند ابتدا بخش‌های سالم را نجات دهد.

همیشه از یک mapfile استفاده کنید، مگر آنکه مطمئن باشید به آن نیازی ندارید. بدون mapfile، برنامه ddrescue نمی‌تواند عملیات بازیابی را از سر بگیرد و تنها می‌تواند آن را از ابتدا آغاز کند. دقت کنید که به اشتباه mapfile قدیمی مربوط به یک عملیات بازیابی نامرتبط دیگر را مشخص نکنید.

نکته: در نسخه‌های ddrescue پیش از 1.20، به mapfile نام 'logfile' داده شده بود. ساختار و قالب یکسان است؛ تنها نام آن تغییر کرده است.

اگر سیستم را راه‌اندازی مجدد کردید، پیش از شروع دوباره ddrescue، نام‌های دستگاه‌ها را بررسی کنید. بدون مطالعه دفترچه راهنما از گزینه‌های '-F' یا '-G' استفاده نکنید.

گزینه‌ها (OPTIONS)

-h, --help: نمایش این راهنما و خروج
-V, --version: نمایش اطلاعات نسخه و خروج
-a, --min-read-rate=<bytes>: حداقل نرخ خواندن نواحی سالم بر حسب بایت بر ثانیه
-A, --try-again: علامت‌گذاری بخش‌های هرس‌نشده (non-trimmed) و خراشیده‌نشده (non-scraped) به عنوان امتحان‌نشده (non-tried)
-b, --sector-size=<bytes>: اندازه سکتور دستگاه ورودی [پیش‌فرض 512]
-B, --binary-prefixes: نمایش پیشوندهای دودویی در اعداد [SI]
-c, --cluster-size=<sectors>: تعداد سکتورها برای رونوشت در هر نوبت [128]
-C, --complete-only: داده‌های جدید فراتر از محدوده‌های mapfile خوانده نشود
-d, --idirect: استفاده از دسترسی مستقیم به دیسک برای فایل ورودی
-D, --odirect: استفاده از دسترسی مستقیم به دیسک برای فایل خروجی
-e, --max-bad-areas=[+]<n>: حداکثر تعداد نواحی خراب [جدید] مجاز
-E, --max-error-rate=<bytes>: حداکثر نرخ مجاز خطاهای خواندن در هر ثانیه
-f, --force: بازنویسی اجباری روی دستگاه یا پارتیشن خروجی
-F, --fill-mode=<types>: پر کردن بلوک‌هایی از انواع مشخص‌شده با داده (?*/-+l)
-G, --generate-mode: تولید تقریبی mapfile از روی یک رونوشت جزئی
-H, --test-mode=<file>: تنظیم نقشه بلوک‌های سالم/خراب بر اساس mapfile ارائه‌شده
-i, --input-position=<bytes>: موقعیت شروع دامنه در فایل ورودی [0]
-I, --check-input-size: مقایسه اندازه فایل ورودی با اندازه ثبت‌شده در mapfile
-J, --check-on-error: خواندن مجدد آخرین سکتور سالم پس از هر خطا
-K, --skip-size=[<i>][,<max>]: اندازه اولیه و حداکثر برای پرش در هنگام بروز خطای خواندن
-L, --loose-domain: پذیرش mapfile دامنه نامرتب با فاصله‌ها و شکاف‌ها
-m, --domain-mapfile=<file>: محدود کردن دامنه به بلوک‌های تکمیل‌شده در <file>
-M, --retrim: علامت‌گذاری برخی بلوک‌های ناموفق به عنوان هرس‌نشده (non-trimmed)
-n, --no-scrape: صرف‌نظر کردن از فاز خراشیدن (scraping)
-N, --no-sweep: صرف‌نظر کردن از فاز جاروب کردن (sweeping)
--no-trim: صرف‌نظر کردن از فاز هرس کردن (trimming)
-o, --output-position=<bytes>: موقعیت شروع در فایل خروجی [ipos]
-O, --reopen-on-error: باز کردن مجدد فایل ورودی پس از هر خطای خواندن
-p, --preallocate: تخصیص فضای دیسک از پیش برای فایل خروجی
-P, --data-preview[=<lines>]: نمایش چند خط از آخرین داده‌های خوانده‌شده [3]
-q, --quiet: فرونشاندن تمام پیام‌ها (حالت بی‌صدا)
-r, --retry-passes=<n>: خروج پس از <n> نوبت تلاش مجدد (-1=infinity) [0]
-R, --reverse: معکوس کردن جهت تمام نوبت‌های خواندن
-s, --size=<bytes>: حداکثر اندازه داده ورودی برای رونوشت
-S, --sparse: استفاده از نوشتن تنک (sparse) برای فایل خروجی
-t, --truncate: کوتاه کردن حجم فایل خروجی به اندازه صفر
-T, --timeout=<interval>: حداکثر زمان سپری‌شده از آخرین خواندن موفق
-u, --unidirectional: اجرای تمام نوبت‌ها در یک جهت یکسان
-v, --verbose: حالت پرگو (استفاده از -v دوم جزئیات بیشتری می‌دهد)
-w, --ignore-write-errors: نادیده گرفتن خطاهای نوشتن در حالت پر کردن (fill mode)
-W, --compare-before-write: صرف‌نظر از نوشتن‌های زائد در حالت بازیابی
-x, --extend-outfile=<bytes>: افزایش اندازه فایل خروجی حداقل به این میزان
-X, --max-read-errors=<n>: حداکثر تعداد خطاهای خواندن مجاز
-y, --synchronous: استفاده از نوشتن همگام (synchronous) برای فایل خروجی
-Z, --max-read-rate=<bytes>: حداکثر نرخ خواندن بر حسب بایت بر ثانیه
--ask: درخواست تأیید پیش از شروع رونوشت
--bad-sector-data=<file>: در نظر گرفتن سکتورهای حاوی داده‌های <file> به عنوان خطای خواندن
--command-mode: اجرای دستورات از ورودی استاندارد
--continue-on-errno=<n>[,<n>]: در نظر گرفتن کد خطای <n> در errno به عنوان غیرمهلک
--cpass=<range>: انتخاب نوبت(های) رونوشت برای اجرا
--delay-slow=<interval>: تأخیر اولیه پیش از بررسی خواندن‌های کند [30]
--log-events=<file>: ثبت رویدادهای مهم در <file>
--log-rates=<file>: ثبت نرخ‌ها و اندازه‌های خطا در <file>
--log-reads=<file>: ثبت تمام عملیات‌های خواندن در <file>
--mapfile-interval=[i][,i]: ذخیره/همگام‌سازی mapfile در بازه مشخص‌شده [auto]
--max-slow-reads=<n>: حداکثر تعداد مجاز خواندن‌های کند
--pause-on-error=<interval>: مدت زمان مکث پس از هر خطای خواندن [0]
--pause-on-pass=<interval>: مدت زمان مکث بین نوبت‌ها [0]
--reset-slow: بازنشانی شمارش خواندن‌های کند در صورتی که نرخ به بالای حداقل برسد
--same-file: مجاز بودن یکسان بودن infile و outfile

اعداد می‌توانند در مبنای ده، شانزده یا هشت باشند، می‌توانند شامل جداکننده‌های خط زیر (_) بین گروه‌های ارقام باشند، و ممکن است پس از آن‌ها یک ضریب SI یا دودویی و 's' برای «سکتورها» بیاید: 1_234_567kB، 4Kis، 0x1234_5678، 07_777. در حالت بازیابی، '--size=output' از اندازه فایل یا دستگاه خروجی استفاده می‌کند. بازه‌های زمانی در قالب 1[.5][smhd] یا 1/2[smhd] مشخص می‌شوند.

وضعیت خروج (EXIT STATUS)

0 برای خروج عادی، 1 برای مشکلات محیطی (پیدا نشدن فایل، گزینه‌های نامعتبر خط فرمان، خطاهای ورودی/خروجی و غیره)، 2 برای نشان دادن فایل ورودی خراب یا نامعتبر، 3 برای خطای ناسازگاری داخلی (مانند وجود باگ) که موجب توقف اضطراری (panic) برنامه ddrescue شده باشد.

گزارش باگ‌ها (BUGS)

گزارش باگ‌ها به bug-ddrescue@gnu.org
صفحه خانگی Ddrescue: http://www.gnu.org/software/ddrescue/ddrescue.html
راهنمای عمومی استفاده از نرم‌افزارهای گنو: http://www.gnu.org/gethelp

کپی‌رایت و تکثیر (COPYRIGHT)

حق نشر © 2026 Antonio Diaz Diaz. مجوز GPLv2+: گنو GPL نسخه 2 یا بالاتر http://gnu.org/licenses/gpl.html
این یک نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید. هیچ‌گونه ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.

همچنین ببینید (SEE ALSO)

مستندات کامل ddrescue به صورت یک کتابچه Texinfo نگهداری می‌شود. در صورتی که برنامه‌های info و ddrescue به‌درستی بر روی سیستم شما نصب شده باشند، دستور

: info ddrescue

باید دسترسی شما به مستندات کامل را فراهم کند.