.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "bup\-damage" "1" "2026\-09\-01" "Bup 0.34+"
.SH "نام (NAME)"
bup\-damage \- تخریب تصادفی بلوکهای یک فایل برای آزمایش تابآوری پشتیبان
.SH "خلاصه دستور (SYNOPSIS)"
bup damage [\-n count] [\-s maxsize] [\-\-percent pct] [\-S seed]
[\-\-equal] <filenames\&...>
.SH "توضیحات (DESCRIPTION)"
از \f[CR]bup damage\f[R] برای تخریب عمدی بلوک‌ها در یک فایل
\f[CR].pack\f[R] یا \f[CR].idx\f[R] (از مسیر
\f[CR].bup/objects/pack\f[R]) جهت آزمایش ویژگی‌های بازیابی
\f[CR]bup\-fsck\f[R](1) یا سایر برنامه‌ها استفاده کنید.
.PP
\f[I]این برنامه به شدت خطرناک است و داده‌های شما را از بین خواهد برد\f[R]
.PP
دستور \f[CR]bup damage\f[R] در درجه اول برای آزمایش‌های خودکار یا دستی ابزارهای بازیابی داده مفید است، تا اطمینان حاصل کنید که این ابزارها در عمل واقعاً کار می‌کنند.
.PP
توجه داشته باشید که جزئیات رفتار فعلی ممکن است تغییر کند (به‌ویژه جزئیاتی که در اینجا مستند نشده‌اند).
به عنوان مثال در حال حاضر، تخریب کاملاً احتمالی است، بنابراین ممکن است در عمل هر بلوک مشخصی را تغییر دهد یا ندهد.
با اندازه بلوک ۱، احتمال ۱/۲۵۶ وجود دارد که بلوک در عمل تغییر نکند.
این رفتار ممکن است تغییر کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\-n, \-\-num=\f[I]numblocks\f[R]
تعداد بلوک‌های مجزا برای تخریب در هر فایل (پیش‌فرض ۱۰).
توجه داشته باشید که ممکن است بیش از یک بخش آسیب‌دیده در همان بلوک بازیابی
\f[CR]bup\-fsck\f[R](1) قرار گیرد، بنابراین ممکن است به تعداد بلوک‌های بازیابی که انتظار دارید آسیب نرسد.
اگر این مسئله مشکل‌ساز است، از \f[CR]\-\-equal\f[R] استفاده کنید.
.TP
\-s, \-\-size=\f[I]maxblocksize\f[R]
حداکثر اندازه هر بلوک آسیب‌دیده بر حسب بایت (پیش‌فرض ۱ مگر اینکه
\f[CR]\-\-percent\f[R] مشخص شده باشد).
توجه داشته باشید به دلیل نحوه عملکرد \f[CR]bup\-fsck\f[R](1)، یک بلوک چندبایتی ممکن است روی مرز میان دو بلوک بازیابی قرار گیرد و در نتیجه به دو بلوک بازیابی مجزا آسیب برساند.
در فایل‌های کوچک، این احتمال نیز وجود دارد که یک بلوک آسیب‌دیده بزرگتر از یک بلوک بازیابی باشد.
اگر این موارد ممکن است مشکل‌ساز شوند، باید از اندازه تخریب پیش‌فرض یعنی یک بایت استفاده کنید.
.TP
\-\-percent=\f[I]maxblockpercent\f[R]
حداکثر اندازه هر بلوک آسیب‌دیده، بر حسب درصدی از فایل اصلی.
اگر هر دو گزینه \f[CR]\-\-size\f[R] و \f[CR]\-\-percent\f[R] داده شوند، حداکثر اندازه بلوک، کمترین مقدار از بین این دو محدودیت خواهد بود.
می‌توانید از این گزینه استفاده کنید تا اطمینان حاصل شود که یک بلوک معین هرگز به بیش از یک یا دو بلوک بازیابی
\f[CR]git\-fsck\f[R](1) آسیب نمی‌رساند.
.TP
\-S, \-\-seed=\f[I]randomseed\f[R]
مقداردهی اولیه مولد اعداد تصادفی (seed) با مقدار ارائه‌شده.
اگر از این گزینه استفاده کنید، آزمایش‌های شما تکرارپذیر خواهند بود، زیرا آفست‌ها، اندازه‌ها و محتویات بلوک‌های آسیب‌دیده در هر بار اجرا یکسان خواهند بود.
به‌طور پیش‌فرض، اعداد تصادفی در هر بار اجرا متفاوت هستند (بنابراین می‌توانید آزمایش‌ها را در یک حلقه اجرا کرده و هر بار با آسیب‌های متفاوتی آزمایش کنید).
.TP
\-\-equal
به جای انتخاب آفست‌های تصادفی برای هر بلوک آسیب‌دیده، بلوک‌ها را با فاصله‌های مساوی در سراسر فایل، با شروع از آفست ۰ قرار می‌دهد.
اگر اندازه حداکثر بلوک را نیز به درستی انتخاب کنید، این می‌تواند تضمین کند که هر بلوک آسیب‌دیده معین هرگز به بیش از یک بلوک بازیابی
\f[CR]git\-fsck\f[R](1) آسیب نمی‌زند.
(این امر همچنین در صورت استفاده از \f[CR]\-s 1\f[R] تضمین می‌شود).
.SH "مثال‌ها (EXAMPLES)"
.IP
.EX
# تهیه یک نسخه پشتیبان در صورتی که همه چیز به شدت خراب شود
cp \-pPR \(ti/.bup/objects/pack \(ti/bup\-packs.bak

# تولید بلوک‌های بازیابی برای تمام بسته‌ها
bup fsck \-g

# تخریب عمدی بسته‌ها
bup damage \-n 10 \-s 1 \-S 0 \(ti/.bup/objects/pack/*.{pack,idx}

# بازیابی پس از آسیب
bup fsck \-r
.EE
.SH "همچنین ببینید (SEE ALSO)"
\f[CR]bup\-fsck\f[R](1), \f[CR]par2\f[R](1)
.SH "درباره BUP (BUP)"
بخشی از مجموعه \f[CR]bup\f[R](1).
.SH "نویسندگان (AUTHORS)"
Avery Pennarun \c
.MT apenwarr@gmail.com
.ME \c.