TGTIMG(8) [FIXME: manual] TGTIMG(8)

tgtimg - ابزار فایل ایمیج چارچوب SCSI Target در لینوکس

tgtimg [-o --op <operation>] [-Y --device-type <device-type>] [-b --barcode <barcode>] [-s --size <size>] [-t --type <media-type>] [-f --file <path>] [-T --thin-provisioning]

tgtimg --help

دستور tgtimg ابزاری برای ایجاد و مدیریت فایل‌های ایمیج مورد استفاده در شبیه‌سازی دستگاه‌های TGTD است.

این دستور برای مقداردهی اولیه فایل‌های ایمیج دستگاه با فراداده‌های اضافی، مانند بارکد، فهرست بلوک‌ها، اندازه کل و غیره که شبیه‌سازی TGTD به آن‌ها نیاز دارد، استفاده می‌شود.

-h, --help

نمایش صفحه راهنما و خروج.

-o, --op {new|show}

نوع عملیات؛ برای ایجاد یک فایل ایمیج جدید مقدار new و برای نمایش محتوای یک فایل ایمیج موجود مقدار show را دریافت می‌کند.

-Y, --device-type <type>

این گزینه نوع فایل ایمیج را مشخص می‌کند.
انواع دستگاه‌های پشتیبانی‌شده عبارتند از:
    cd   : برای ایجاد رسانه جهت یک دستگاه dvd
    disk : برای ایجاد رسانه جهت یک دستگاه disk
    tape : برای ایجاد رسانه جهت یک دستگاه tape (نوار)

-t, --type <media-type>

هنگام ایجاد یک ایمیج جدید، نوع رسانه برای شبیه‌سازی را مشخص می‌کند. انواع رسانه‌های موجود به نوع دستگاه بستگی دارد.
انواع رسانه پشتیبانی‌شده برای دستگاه‌های cd عبارتند از:
    dvd+r : ایجاد یک دیسک خالی و قابل نوشتن DVD+R
انواع رسانه پشتیبانی‌شده برای دستگاه‌های disk عبارتند از:
    disk  : ایجاد یک دیسک خالی
انواع رسانه پشتیبانی‌شده برای دستگاه‌های tape عبارتند از:
    data  : ایجاد یک نوار داده معمولی
    clean : ایجاد یک نوار پاک‌کننده (cleaning)
    worm  : ایجاد یک رسانه worm (یک‌بار نوشتنی، چندبار خواندنی)

-b, --barcode <barcode>

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

-s, --size <size>

هنگام ایجاد یک ایمیج جدید، اندازه ایمیج نوار مجازی را بر حسب مگابایت مشخص می‌کند.

-f, --file <path>

نام یا مسیر فایل ایمیج.

-T, --thin-provisioning

این آرگومان تخصیص قالب ایمیج را به صورت تخصیص پویا (thin-provisioning) تنظیم می‌کند. این بدان معناست که فایل ایجادشده یک فایل پراکنده (sparse file) خواهد بود که بلوک‌ها را در صورت نیاز از سیستم‌فایل تخصیص می‌دهد.

هنگام استفاده از تخصیص پویا (thin-provisioning) احتیاط کنید. اگر فضای سیستم‌فایل پر شود، عملیات نوشتن iSCSI در یک LUN دارای تخصیص پویا ممکن است با شکست مواجه شود. آغازگرها (Initiators) معمولاً خطاهای «کمبود فضا» (out of space) را به خوبی مدیریت نمی‌کنند.

تخصیص پویا از FALLOC_FL_PUNCH_HOLE استفاده می‌کند که تنها در برخی از سیستم‌فایل‌های لینوکس در دسترس است. قابلیت تخصیص پویا تنها برای ایمیج‌های DISK قابل استفاده است.

برای ایجاد یک دیسک جدید ۱۰۰ مگابایتی:

tgtimg --op new --device-type disk --type disk --size 100 --file /data/hd001.raw

برای ایجاد یک ایمیج نوار جدید:

tgtimg --op new --device-type tape --barcode 12345 --size 100 --type data --file /data/tape001.img

برای مشاهده محتوای یک ایمیج موجود:

tgtimg --op show --device-type tape --file /data/tape001.img

برای ایجاد یک ایمیج جدید و خالی DVD+R:

tgtimg --op new --device-type cd --type dvd+r --file /data/dvd001.iso

tgtd(8), tgtadm(8), tgt-admin(8), tgt-setup-lun(8).

https://github.com/fujita/tgt

گزارش باگ‌ها را به <stgt@vger.kernel.org> ارسال کنید.

07/09/2026 [FIXME: source]