'\" t .\" Title: tgtimg .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 07/09/2026 .\" Manual: [FIXME: manual] .\" Source: [FIXME: source] .\" Language: Persian .\" .TH "TGTIMG" "8" "07/09/2026" "[FIXME: source]" "[FIXME: 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)" tgtimg \- ابزار فایل ایمیج چارچوب SCSI Target در لینوکس .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBtgtimg\fR\ 'u \fBtgtimg\fR [\-o\ \-\-op\ ] [\-Y\ \-\-device\-type\ ] [\-b\ \-\-barcode\ ] [\-s\ \-\-size\ ] [\-t\ \-\-type\ ] [\-f\ \-\-file\ ] [\-T\ \-\-thin\-provisioning] .HP \w'\fBtgtimg\ \-\-help\fR\ 'u \fBtgtimg \-\-help\fR .SH "توضیحات (DESCRIPTION)" .PP دستور .B tgtimg ابزاری برای ایجاد و مدیریت فایل‌های ایمیج مورد استفاده در شبیه‌سازی دستگاه‌های TGTD است\&. .PP این دستور برای مقداردهی اولیه فایل‌های ایمیج دستگاه با فراداده‌های اضافی، مانند بارکد، فهرست بلوک‌ها، اندازه کل و غیره که شبیه‌سازی TGTD به آن‌ها نیاز دارد، استفاده می‌شود\&. .SH "گزینه‌ها (OPTIONS)" .PP \fB\-h, \-\-help\fR .RS 4 نمایش صفحه راهنما و خروج\&. .RE .PP \fB\-o, \-\-op {new|show}\fR .RS 4 نوع عملیات؛ برای ایجاد یک فایل ایمیج جدید مقدار .B new و برای نمایش محتوای یک فایل ایمیج موجود مقدار .B show را دریافت می‌کند\&. .RE .PP \fB\-Y, \-\-device\-type \fR .RS 4 این گزینه نوع فایل ایمیج را مشخص می‌کند\&. .RE .sp .if n \{\ .RS 4 .\} .nf انواع دستگاه‌های پشتیبانی‌شده عبارتند از: cd : برای ایجاد رسانه جهت یک دستگاه dvd disk : برای ایجاد رسانه جهت یک دستگاه disk tape : برای ایجاد رسانه جهت یک دستگاه tape (نوار) .fi .if n \{\ .RE .\} .PP \fB\-t, \-\-type \fR .RS 4 هنگام ایجاد یک ایمیج جدید، نوع رسانه برای شبیه‌سازی را مشخص می‌کند\&. انواع رسانه‌های موجود به نوع دستگاه بستگی دارد\&. .RE .sp .if n \{\ .RS 4 .\} .nf انواع رسانه پشتیبانی‌شده برای دستگاه‌های cd عبارتند از: dvd+r : ایجاد یک دیسک خالی و قابل نوشتن DVD+R انواع رسانه پشتیبانی‌شده برای دستگاه‌های disk عبارتند از: disk : ایجاد یک دیسک خالی انواع رسانه پشتیبانی‌شده برای دستگاه‌های tape عبارتند از: data : ایجاد یک نوار داده معمولی clean : ایجاد یک نوار پاک‌کننده (cleaning) worm : ایجاد یک رسانه worm (یک‌بار نوشتنی، چندبار خواندنی) .fi .if n \{\ .RE .\} .PP \fB\-b, \-\-barcode \fR .RS 4 هنگام ایجاد یک ایمیج جدید، بارکد مورد استفاده با این فایل ایمیج را مشخص می‌کند\&. نرم‌افزارهای پشتیبان‌گیری اغلب از بارکدها برای شناسایی نوارهای مشخص استفاده می‌کنند\&. هنگام شبیه‌سازی یک VTL (کتابخانه نوار مجازی)، اطمینان حاصل کنید که تمام ایمیج‌های نوار از بارکدهای یکتا استفاده می‌کنند\&. .RE .PP \fB\-s, \-\-size \fR .RS 4 هنگام ایجاد یک ایمیج جدید، اندازه ایمیج نوار مجازی را بر حسب مگابایت مشخص می‌کند\&. .RE .PP \fB\-f, \-\-file \fR .RS 4 نام یا مسیر فایل ایمیج\&. .RE .PP \fB\-T, \-\-thin\-provisioning\fR .RS 4 این آرگومان تخصیص قالب ایمیج را به صورت تخصیص پویا (thin\-provisioning) تنظیم می‌کند\&. این بدان معناست که فایل ایجادشده یک فایل پراکنده (sparse file) خواهد بود که بلوک‌ها را در صورت نیاز از سیستم‌فایل تخصیص می‌دهد\&. .sp هنگام استفاده از تخصیص پویا (thin\-provisioning) احتیاط کنید\&. اگر فضای سیستم‌فایل پر شود، عملیات نوشتن iSCSI در یک LUN دارای تخصیص پویا ممکن است با شکست مواجه شود\&. آغازگرها (Initiators) معمولاً خطاهای «کمبود فضا» (out of space) را به خوبی مدیریت نمی‌کنند\&. .sp تخصیص پویا از .B FALLOC_FL_PUNCH_HOLE استفاده می‌کند که تنها در برخی از سیستم‌فایل‌های لینوکس در دسترس است\&. قابلیت تخصیص پویا تنها برای ایمیج‌های .B DISK قابل استفاده است\&. .RE .SH "مثال‌ها (EXAMPLES)" .PP برای ایجاد یک دیسک جدید ۱۰۰ مگابایتی: .sp .if n \{\ .RS 4 .\} .nf tgtimg \-\-op new \-\-device\-type disk \-\-type disk \-\-size 100 \-\-file /data/hd001\&.raw .fi .if n \{\ .RE .\} .PP برای ایجاد یک ایمیج نوار جدید: .sp .if n \{\ .RS 4 .\} .nf tgtimg \-\-op new \-\-device\-type tape \-\-barcode 12345 \-\-size 100 \-\-type data \-\-file /data/tape001\&.img .fi .if n \{\ .RE .\} .PP برای مشاهده محتوای یک ایمیج موجود: .sp .if n \{\ .RS 4 .\} .nf tgtimg \-\-op show \-\-device\-type tape \-\-file /data/tape001\&.img .fi .if n \{\ .RE .\} .PP برای ایجاد یک ایمیج جدید و خالی DVD+R: .sp .if n \{\ .RS 4 .\} .nf tgtimg \-\-op new \-\-device\-type cd \-\-type dvd+r \-\-file /data/dvd001\&.iso .fi .if n \{\ .RE .\} .SH "همچنین ببینید (SEE ALSO)" .PP tgtd(8), tgtadm(8), tgt\-admin(8), tgt\-setup\-lun(8)\&. .PP \m[blue]\fB\%https://github.com/fujita/tgt\fR\m[] .SH "گزارش باگ‌ها (REPORTING BUGS)" .PP گزارش باگ‌ها را به ارسال کنید\&.