'\" t
.\" Title: tgtadm
.\" 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: English
.\"
.TH "TGTADM" "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)"
tgtadm \- ابزار مدیریت SCSI Target در لینوکس
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBtgtadm\ [OPTIONS]\&.\&.\&.\fR\ 'u
\fBtgtadm [OPTIONS]\&.\&.\&.\fR [\-C\ \-\-control\-port\ ] [\-L\ \-\-lld\ ] [\-o\ \-\-op\ ] [\-m\ \-\-mode\ ] [\-t\ \-\-tid\ ] [\-T\ \-\-targetname\ ] [\-y\ \-\-blocksize\ ] [\-Y\ \-\-device\-type\ ] [\-l\ \-\-lun\ ] [\-b\ \-\-backing\-store\ ] [\-f\ \-\-bsoflags\ {direct|sync}] [\-S\ \-\-bsopts\ {backing\-store\ opt\ string}] [\-E\ \-\-bstype\ ] [\-I\ \-\-initiator\-address\ ] [\-Q\ \-\-initiator\-name\ ] [\-n\ \-\-name\ ] [\-v\ \-\-value\ ] [\-P\ \-\-params\ ] [\-F\ \-\-force] [\-h\ \-\-help]
.SH "شرح (DESCRIPTION)"
.PP
دستور tgtadm برای پایش و تغییر همهچیز پیرامون نرمافزار هدف SCSI در لینوکس (Linux SCSI target) شامل هدفها، دیسکها و حجمها به کار میرود.\&
.SH "گزینهها (OPTIONS)"
.PP
\fB\-C, \-\-control\-port \fR
.RS 4
امکان اجرای چندین نمونه همزمان از tgtd روی یک میزبان وجود دارد.\& این آرگومان برای تعیین نمونهای که دستور tgtadm باید روی آن عمل کند، استفاده میشود.\&
.RE
.PP
\fB\-y, \-\-blocksize \fR
.RS 4
دستگاههای بلوکی با اندازه بلوک پیشفرض ۵۱۲ بایت ایجاد میشوند.\& این آرگومان میتواند برای ایجاد دستگاههای بلوکی با اندازههای بلوک متفاوت استفاده شود.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
مثال:
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op new \e
\-\-tid \-\-lun \e
\-b \-\-blocksize=4096
.fi
.if n \{\
.RE
.\}
.PP
\fB\-Y, \-\-device\-type \fR
.RS 4
هنگام ایجاد یک LUN، این پارامتر نوع دستگاه ایجادشده را مشخص میکند.\& مقدار پیشفرض disk است.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
انواع ممکن برای device-type عبارتند از:
disk : شبیهسازی یک دستگاه دیسک
tape : شبیهسازی یک نوارخوان
ssc : مشابه tape
cd : شبیهسازی یک درایو DVD
changer : شبیهسازی یک دستگاه تعویضکننده رسانه (media changer)
pt : نوع عبوردهنده (passthrough) برای ارائهی یک دستگاه /dev/sg
.fi
.if n \{\
.RE
.\}
.PP
\fB\-E, \-\-bstype \fR
.RS 4
هنگام ایجاد یک LUN، این پارامتر نوع فضای ذخیرهسازی پشتیبان (backend storage) را برای استفاده مشخص میکند.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
انواع ممکن برای backend عبارتند از:
rdwr : استفاده از ورودی/خروجی عادی فایل. این گزینه پیشفرض برای دستگاههای دیسک است
aio : استفاده از ورودی/خروجی ناهمگام (Asynchronous I/O)
rbd : استفاده از RADOS Block Device در فضای ذخیرهسازی توزیعشده Ceph
sg : نوع بکاند ویژه برای دستگاههای عبوردهنده (passthrough)
ssc : نوع بکاند ویژه برای شبیهسازی نوار
.fi
.if n \{\
.RE
.\}
.PP
\fB\-\-lld \-\-op new \-\-mode target \-\-tid \-\-targetname \fR
.RS 4
افزودن یک هدف (target) جدید با شناسه و نام .\&
.RE
.PP
\fB\-\-lld \-\-op delete \-\-mode target \-\-tid \fR
.RS 4
حذف هدف مشخص با شناسه .\& هدف نباید هیچ I_T nexus فعالی داشته باشد.\&
.RE
.PP
\fB\-\-lld \-\-op delete \-\-force \-\-mode target \-\-tid \fR
.RS 4
حذف اجباری هدف مشخص با شناسه .\&
.RE
.PP
\fB\-\-lld \-\-op show \-\-mode target\fR
.RS 4
نمایش تمامی هدفها.\&
.RE
.PP
\fB\-\-lld \-\-op show \-\-mode target \-\-tid \fR
.RS 4
نمایش پارامترهای یک هدف مشخص با شناسه .\&
.RE
.PP
\fB\-\-lld \-\-op new \-\-mode logicalunit \-\-tid \-\-lun \-\-backing\-store \-\-bsopts=\fR
.RS 4
افزودن یک واحد منطقی (logical unit) جدید با شناسه به هدف مشخص با شناسه .\& واحد منطقی به آغازگرها (initiators) ارائه میشود.\& مقدار باید پروندههای دستگاه بلوکی (از جمله دستگاههای LVM و RAID) یا پروندههای عادی، و یا نام تصویر یا اسنپشات RBD برای \-\-bstype rbd باشد.\& شناسه lun0 برای دستگاه ویژهای که بهطور خودکار ایجاد میشود رزرو شده است.\&
.sp
.if n \{\
.RS 4
.\}
.nf
مثال:
اگر tgt به همراه پشتیبانی از منبع ذخیرهسازی bs_rbd برای تصاویر Ceph RBD
کامپایل شده باشد (دستور tgtadm \-\-mode system \-\-op show را برای بررسی مشاهده کنید)،
یک هدف با نگاشت تصویر rbd به نام "rbdimage" تنظیم کنید و گزینهها را به bs_rbd ارسال نمایید:
tgtadm \-\-lld iscsi \-\-op new \-\-mode logicalunit \-\-tid 1 \e
\-\-lun 1 \-\-bstype=rbd \-\-backing\-store=rbdimage \e
\-\-bsopts="conf=/etc/ceph/ceph\&.conf;id=tgt"
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-\-lld \-\-op delete \-\-mode logicalunit \-\-tid \-\-lun \fR
.RS 4
حذف واحد منطقی مشخص با شناسه از هدف با شناسه .\&
.RE
.PP
\fB\-\-lld \-\-op bind \-\-mode target \-\-tid \-\-initiator\-address \fR
.RS 4
افزودن نشانی به فهرست دسترسی هدف با شناسه .\& آغازگرهای دارای این نشانی میتوانند به هدف دسترسی پیدا کنند.\& مقدار \*(AqALL\*(Aq یک نشانی ویژه است که به تمام آغازگرها اجازه دسترسی به هدف را میدهد.\&
.RE
.PP
\fB\-\-lld \-\-op bind \-\-mode target \-\-tid \-\-initiator\-name \fR
.RS 4
افزودن نام آغازگر به فهرست دسترسی هدف با شناسه .\& آغازگرهای دارای این نام میتوانند به هدف دسترسی پیدا کنند.\&
.RE
.PP
\fB\-\-lld \-\-op unbind \-\-mode target \-\-tid \-\-initiator\-address \fR
.RS 4
حذف نشانی از فهرست دسترسی هدف با شناسه .\&
.RE
.PP
\fB\-\-lld \-\-op unbind \-\-mode target \-\-tid \-\-initiator\-name \fR
.RS 4
حذف نام آغازگر از فهرست دسترسی هدف با شناسه .\&
.RE
.PP
\fB\-\-lld \-\-op update \-\-mode target \-\-tid \-\-name= \-\-value=\fR
.RS 4
تغییر مقدار در هدف با شناسه به مقدار .\&
.RE
.PP
\fB\-\-lld \-\-op update \-\-mode target \-\-tid \-\-params parameter=value<,\&.\&.\&.>\fR
.RS 4
تنظیم یا تغییر مقدار یک یا چند پارامتر هدف.\&
.RE
.PP
\fB\-\-lld \-\-op update \-\-mode logicalunit \-\-tid \-\-lun \-\-params parameter=value<,\&.\&.\&.>\fR
.RS 4
تنظیم یا تغییر مقدار یک یا چند پارامتر واحد منطقی.\&
.RE
.PP
\fB\-\-lld \-\-op start \-\-mode lld\fR
.RS 4
راهاندازی درایور lld مشخصشده بدون راهاندازی مجدد فرآیند tgtd.\& در مواردی که ماژولهای مورد نیاز پس از اجرای tgtd بارگذاری شدهاند، برای مقداردهی اولیه درایور lld کاربرد دارد.\&
.RE
.PP
\fB\-\-help\fR
.RS 4
نمایش فهرست گزینههای موجود و خروج.\&
.RE
.SH "پارامترهای LUN (LUN PARAMETERS)"
.PP
این پارامترها تنها برای "\-\-mode logicalunit" کاربرد دارند.\&
.PP
\fBvendor_id=\fR
.RS 4
این پارامتر رشته شناسایی سازنده (Vendor Identification) را که LUN در دادههای INQUIRY گزارش میدهد، تنظیم میکند.\&
.RE
.PP
\fBproduct_id=\fR
.RS 4
این پارامتر رشته شناسایی محصول (Product Identification) را که LUN در دادههای INQUIRY گزارش میدهد، تنظیم میکند.\&
.RE
.PP
\fBproduct_rev=\fR
.RS 4
این پارامتر رشته نگارش محصول (Product Revision) را که LUN در دادههای INQUIRY گزارش میدهد، تنظیم میکند.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
مثال:
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \e
\-\-tid \-\-lun \e
\-\-params vendor_id=TGTD,product_id=VirtualHD,product_rev=0103
.fi
.if n \{\
.RE
.\}
.PP
\fBremovable=<0|1>\fR
.RS 4
برای بازنویسی/تغییر مقدار پیشفرض پرچم قابلحمل (removable) استفاده میشود.\& دستگاههای دیسک به صورت پیشفرض غیرقابلحمل و دستگاههای DVD و نوار به صورت پیشفرض قابلحمل هستند.\&
.RE
.PP
\fBsense_format=<0|1>\fR
.RS 4
این پرچم قالب دادههای حسگر (sense data) بازگرداندهشده توسط دستگاه را کنترل میکند.\& مقدار 0 = قالب کلاسیک sense و مقدار 1 = پشتیبانی از قالب توصیفگر (descriptor format).\&
.RE
.PP
\fBonline=<0|1>\fR
.RS 4
این گزینه برخط (online) بودن یا نبودن دستگاه را کنترل میکند.\&
.sp
دستگاهها هنگام ایجاد به طور پیشفرض برخط هستند اما میتوان آنها را با این پارامتر آفلاین کرد.\& رفتار دستگاههای آفلاین به نوع دستگاه بستگی دارد.\& یک دستگاه MMC/DVD که آفلاین است گزارش میدهد دیسکی در دستگاه وجود ندارد اما خود واحد MMC/DVD همچنان قابل ارتباط است.\& تمام انواع دستگاههای دیگر هرگونه عملیات I/O را با کد وضعیت Not Ready رد میکنند.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
مثال:
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \e
\-\-tid 1 \-\-lun 1 \e
\-\-params removable=1,sense_format=1,online=1
.fi
.if n \{\
.RE
.\}
.PP
\fBmode_page=\fR
.RS 4
این پارامتر برای تنظیم صفحههای حالت (mode pages) مشخص و محتوای آنها برای دستگاه به کار میرود.\& اغلب دستگاهها هنگام ایجاد LUN صفحههای حالت پیشفرض معقولی را به خود میگیرند، اما این پارامتر امکان تنظیمات خاص را فراهم میسازد.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
مثالها:
ایجاد صفحه حالت \*(Aq2\*(Aq، زیرصفحه 0 و ۱۴ بایت داده.
این صفحه حالت Disconnect-Reconnect است.
tgtadm \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 2 \e
\-\-params mode_page=2:0:14:0x80:0x80:0:0xa:0:0:0:0:0:0:0:0:0:0
ایجاد صفحه حالت \*(Aq10\*(Aq، زیرصفحه 0 و ۱۰ بایت داده.
این صفحه حالت Control Extension است.
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 2 \e
\-\-params mode_page=10:0:10:2:0:0:0:0:0:0:0:2:0
ایجاد صفحه حالت \*(Aq0x1c\*(Aq، زیرصفحه 0 و ۱۰ بایت داده.
این صفحه حالت Informational Exceptions Control است.
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 2 \e
\-\-params mode_page=0x1c:0:10:8:0:0:0:0:0:0:0:0:0
.fi
.if n \{\
.RE
.\}
.PP
\fBreadonly=<0|1>\fR
.RS 4
پرچم فقطخواندنی یک LUN را تنظیم میکند.\& یک LUN فقطخواندنی هر تلاشی برای نوشتن داده روی آن را رد خواهد کرد.\&
.sp
این پارامتر فقط برای دستگاههای DISK کاربرد دارد.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 1 \e
\-\-params readonly=1
.fi
.if n \{\
.RE
.\}
.PP
\fBthin_provisioning=<0|1>\fR
.RS 4
تخصیص پویای فضا (thin-provisioning) را برای LUN کنترل میکند.\& یک LUN با تخصیص پویا به صورت یک پرونده متناوب (sparse file) نمایش داده میشود.\& ابزار TGTD از تخصیص نوع ۲ برای فایلهای sparse پشتیبانی میکند.\& هنگامی که آغازگرها از دستور SCSI UNMAP استفاده کنند، TGTD نواحی آزادشده را با استفاده از FALLOC_FL_PUNCH_HOLE به سیستمفایل برمیگرداند.\&
.sp
این پارامتر فقط برای دستگاههای DISK اعمال میشود.\&
.sp
تخصیص پویا برای LUNهایی که روی سیستمفایلهای دارای پشتیبانی از FALLOC_FL_PUNCH_HOLE قرار دارند کار میکند.\&
.sp
هنگام استفاده از گزینه thin-provisioning همراه با یک دستگاه بلوکی مانند SSD یا ZVOL، دستور SCSI UNMAP ناحیه مورد نظر را از دستگاه بلوکی دور میاندازد (discard).\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 1 \e
\-\-params thin_provisioning=1
.fi
.if n \{\
.RE
.\}
.PP
\fBrotation_rate=\fR
.RS 4
سرعت چرخش گزارششده LUN بر حسب دور بر دقیقه (RPM) به آغازگر را تنظیم میکند.\& برخی سیستمعاملها هنگامی که این پارامتر صفر باشد دستگاه را از نوع دیسک SSD فرض میکنند.\&
.sp
این پارامتر فقط برای دستگاههای DISK اعمال میشود.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 1 \e
\-\-params rotation_rate=0
.fi
.if n \{\
.RE
.\}
.SH "پارامترهای اختصاصی LUNهای نوع SMC (SMC SPECIFIC LUN PARAMETERS)"
.PP
این پارامترها تنها برای LUNهایی با نوع "changer" (دستگاه تعویضکننده رسانه برای Jukebox مربوط به DVD یا کتابخانه نوار مجازی VTL) کاربرد دارند.\&
.PP
\fBelement_type=<1|2|3|4>\fR
.RS 4
نوع عنصر یک اسلات مشخص در jukebox/vtl را تعیین میکند.\&
.sp
.if n \{\
.RS 4
.\}
.nf
انواع اسلات:
1 \-> انتقالدهنده رسانه (بازوی رباتیک / picker arm)
2 \-> عنصر ذخیرهسازی (Storage Element)
3 \-> عنصر ورود/خروج (Import/Export Element)
4 \-> دستگاه انتقال داده (درایو CD، درایو نوار، درایو MO و...)
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fBaddress=<1\-65535>\fR
.RS 4
برای ایجاد یا کار بر روی یک اسلات منفرد به کار میرود.\& پارامتر Address اسلاتی را که عملیات باید روی آن انجام شود، مشخص میکند.\&
.RE
.PP
\fBstart_address=<1\-65535>,quantity=<1\-\-65535>\fR
.RS 4
برای ایجاد یا اعمال عملیات روی یک محدوده کامل از اسلاتها به صورت یکجا استفاده میشود.\& پارامتر start_address نشانی آغازین و quantity تعداد اسلاتهای متوالی را تعیین میکند.\&
.RE
.PP
\fBsides=<1|2>\fR
.RS 4
هنگام ایجاد عناصر ذخیرهسازی (یعنی "element_type=2")، این پارامتر مشخص میکند که رسانه دارای ۱ یا ۲ طرف برای نگهداری داده است.\&
.RE
.PP
\fBclear_slot=<1>\fR
.RS 4
این گزینه برای پاکسازی یک عنصر ذخیرهسازی و حذف رسانههای احتمالی موجود به کار میرود.\& پس از اتمام این دستور، عنصر ذخیرهسازی با وضعیت "Empty" نشان داده خواهد شد.\&
.RE
.PP
\fBbarcode=\fR
.RS 4
برای انتساب بارکد به یک عنصر به کار میرود.\& بارکدها در tgtd به ۱۰ نویسه محدود هستند.\&
.RE
.PP
\fBvolume_tag=\fR
.RS 4
برای انتساب برچسب حجم به عناصر ذخیرهسازی SMC استفاده میشود.\& اگر برچسب حجمی مشخص نشود، tgtd از بارکد به عنوان جایگزین استفاده خواهد کرد.\& برچسب حجم میتواند تا ۳۲ نویسه باشد.\&
.RE
.PP
\fBmedia_home=\fR
.RS 4
این پارامتر پوشهای را مشخص میکند که تمام رسانههای مجازی برای عناصر دستگاه dvd/tape در آن ذخیره میشوند.\&
.sp
برای انتساب یک پرونده تصویر رسانه به اسلات عنصر ذخیرهسازی، مقدار "barcode" را برابر نام پرونده تصویر در پوشه "media_home" قرار دهید.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
مثال: نحوه ایجاد یک DVD jukebox با هشت سینی دیسک و دو دیسک خالی DVD-R.
# ایجاد هدف
tgtadm \-\-lld iscsi \-\-mode target \-\-op new \-\-tid 1 \-\-targetname iqn\&.2007\-03:virtual\-dvd:`hostname`
# ایجاد یک درایو DVD و نامگذاری مناسب آن
# درایو dvd ابتدا بدون پرونده ذخیرهساز پشتیبان شروع میشود، یعنی دیسکی درون آن نیست
tgtadm \-\-op new \-\-mode logicalunit \-\-tid 1 \-\-lun 1 \-\-device\-type cd
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 1 \-\-params vendor_id=STGT_DVD,product_id=DVD101,product_rev=0010,scsi_sn=STGTDVD01,removable=1
# نیاز به یک پرونده پشتیبان برای تعویضکننده رسانه داریم
if [ ! \-f $HOME/smc ]; then
dd if=/dev/zero of=$HOME/smc bs=1k count=1
fi
# ایجاد دستگاه SMC و نامگذاری مناسب آن
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op new \-\-tid 1 \-\-lun 2 \-\-backing\-store $HOME/smc \-\-device\-type changer
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 2 \-\-params vendor_id=STK,product_id=L700,product_rev=0010,scsi_sn=XYZZY_0,removable=1
# افزودن دستگاههای انتقال داده (۱ درایو)
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 2 \-\-params element_type=4,start_address=1,quantity=1
# تعیین اینکه DVD فوق (LUN 1) همان دستگاه انتقال داده ایجادشده باشد
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 2 \-\-params element_type=4,address=1,tid=1,lun=1
# عناصر انتقال رسانه (بازوی رباتیک / picker)
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 2 \-\-params element_type=1,start_address=16,quantity=1
# تعریف مسیر به رسانههای مجازی
VTL=${HOME}/vtl
mkdir \-p ${VTL}
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 2 \-\-params media_home=${VTL}
# عناصر ذخیرهسازی \- ۸ عدد با شروع از آدرس ۱۰۲۴
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 2 \-\-params element_type=2,start_address=1024,quantity=8
# افزودن 'media' به اسلاتهای ۱ و ۲ و خالی گذاشتن ۶ اسلات دیگر
# اسلات ۱
# ایجاد رسانه مجازی خالی و قابل نوشتن DVD-R
tgtimg \-\-op new \-\-device\-type cd \-\-type dvd+r \-\-file ${VTL}/DISK_001
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 2 \-\-params element_type=2,address=1024,barcode=DISK_001,volume_tag="A blank disk",sides=1
# اسلات ۲
tgtimg \-\-op new \-\-device\-type cd \-\-type dvd+r \-\-file ${VTL}/DISK_002
tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \-\-tid 1 \-\-lun 2 \-\-params element_type=2,address=1025,barcode=DISK_002,volume_tag="My second blank disk",sides=1
# اجازه اتصال به تمام آغازگرها (ALL) به این هدف
tgtadm \-\-lld iscsi \-\-mode target \-\-op bind \-\-tid 1 \-\-initiator\-address ALL
# نمایش تمام کارهای انجامشده
tgtadm \-\-lld iscsi \-\-mode target \-\-op show
.fi
.if n \{\
.RE
.\}
.SH "دستگاههای عبوردهنده (PASSTHROUGH DEVICES)"
.PP
علاوه بر شبیهسازی دستگاهها، TGTD از بهرهگیری از دستگاههای SG موجود روی میزبان و صادر کردن آنها از طریق نوع دستگاه عبوردهنده (passthrough) ویژه پشتیبانی میکند.\&
.PP
\fB\-\-bstype=sg\fR
.RS 4
مشخص میکند که از دستگاههای SG استفاده میشود.\&
.RE
.PP
\fB\-\-device\-type=pt\fR
.RS 4
مشخص میکند که از نوع دستگاه عبوردهنده استفاده میشود.\&
.RE
.PP
\fB\-\-backing\-store=\fR
.RS 4
مشخص میکند کدام دستگاه از طریق TGTD صادر (export) شود.\&
.RE
.PP
\fB\-\-bsoflags={direct|sync}\fR
.RS 4
این آرگومان هنگام ایجاد یک LUN برای مشخص کردن پرچمهای اضافی هنگام باز کردن پرونده پشتیبان به کار میرود.\& پرچم O_DIRECT با "direct" و پرچم O_SYNC با "sync" تعیین میشود.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
مثال:
در دسترس قرار دادن /dev/sg4 برای آغازگرهای متصل به TGTD.
tgtadm \-\-lld iscsi \-\-op new \-\-mode logicalunit \-\-tid 1 \-\-lun 1 \-\-bstype=sg \-\-device\-type=pt \-\-backing\-store=/dev/sg4
مثال:
باز کردن پرونده پشتیبان با O_SYNC.
tgtadm \-\-lld iscsi \-\-op new \-\-mode logicalunit \-\-tid 1 \-\-lun 1 \-\-bsoflags="sync" \-\-backing\-store=/data/100m_image\&.raw
.fi
.if n \{\
.RE
.\}
.SH "خلاصه هدر و دادهها (HEADER DIGEST AND DATA DIGEST)"
.PP
خلاصه هدر و دادهها (digest) را میتوان برای هر هدف تنظیم کرد.\& نرمافزار TGTD از دو حالت پشتیبانی میکند: None و CRC32C.\& هنگامی که خلاصه روی None تنظیم شود، TGTD توافق میکند که از خلاصه استفاده نشود، و هنگامی که CRC32C تنظیم شود، TGTD اتصال را مجبور به استفاده از خلاصه خواهد کرد.\&
.SS "مشاهده تنظیمات کنونی"
.PP
این دستور برای مشاهده تنظیمات کنونی خلاصه هدر/داده استفاده میشود.\&
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-op show \-\-mode target \-\-tid 1
\&.\&.\&.
HeaderDigest=None
DataDigest=None
\&.\&.\&.
.fi
.if n \{\
.RE
.\}
.SS "تنظیم دایجست"
.sp
.if n \{\
.RS 4
.\}
.nf
تنظیم خلاصه هدر روی CRC32C:
tgtadm \-\-op update \-\-mode target \-\-tid 1 \-n HeaderDigest \-v CRC32C
تنظیم خلاصه داده روی None:
tgtadm \-\-op update \-\-mode target \-\-tid 1 \-n DataDigest \-v None
.fi
.if n \{\
.RE
.\}
.SH "احراز هویت با CHAP (CHAP AUTHENTICATION)"
.PP
احراز هویت CHAP برای الزام به احراز هویت پیش از ورود آغازگر و دسترسی به دستگاهها پشتیبانی میشود.\&
.PP
احراز هویت فاز اصلی CHAP در سطح هدف تنظیم میشود.\& برای تنظیم احراز هویت CHAP، ابتدا باید یک حساب کاربری و گذرواژه مربوطه را ایجاد کنیم و سپس حساب را به یک یا چند هدف متصل (bind) نماییم.\&
.SS "تنظیم CHAP روی یک هدف"
.PP
این دو دستور یک حساب کاربری ایجاد کرده و آن را به هدف ۱ متصل میکنند.\&
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-lld iscsi \-\-op new \-\-mode account \-\-user ronnie \-\-password password
tgtadm \-\-lld iscsi \-\-op bind \-\-mode account \-\-tid 1 \-\-user ronnie
.fi
.if n \{\
.RE
.\}
.SS "فهرست کردن تمام حسابها"
.PP
این دستور برای فهرست کردن تمام حسابهای ایجادشده به کار میرود.\&
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-lld iscsi \-\-op show \-\-mode account
Account list:
ronnie
.fi
.if n \{\
.RE
.\}
.SS "بررسی نیاز به احراز هویت در یک هدف"
.PP
هنگام فهرست کردن هدفها، هر هدفی که احراز هویت روی آن فعال باشد شامل فهرستی از تمام حسابهای متصل به آن هدف خواهد بود.\&
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-lld iscsi \-\-op show \-\-mode target
Target 1: iqn\&.ronnie\&.test
\&.\&.\&.
Account information:
ronnie
\&.\&.\&.
.fi
.if n \{\
.RE
.\}
.SH "کاوشگرهای NOP-OUT (NOP-OUT PROBES)"
.PP
نرمافزار TGTD میتواند کاوشگرهای NOP-OUT را برای آغازگرهای متصل ارسال کند تا زمان قطع شدن اتصال آغازگر را تشخیص داده و سپس بهطور خودکار اتصال TCP را پاکسازی و قطع کند.\& این مقدار را میتوان به عنوان یک پیشفرض سراسری از خط فرمان tgtd تنظیم کرد یا میتوان برای هدفهای جداگانه با استفاده از دستور tgtadm تنظیم نمود.\&
.SS "بررسی تنظیمات جاری NOP-OUT"
.PP
دستور tgtadm برای مشاهده وضعیت کنونی ارسال کاوشگرهای NOP-OUT به آغازگرهای متصل به کار میرود.\&
.PP
اگر هدف طوری پیکربندی شده باشد که کاوشگرهای NOP-OUT ارسال کند، این به صورت دو خط پارامتر در خروجی مشخصات هدف ظاهر خواهد شد.\& اگر هدف برای ارسال NOP-OUT پیکربندی نشده باشد، این خطوط اصلاً چاپ نخواهند شد.\&
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-lld iscsi \-\-op show \-\-mode target
Target 1: iqn\&.ronnie\&.test
System information:
Driver: iscsi
State: ready
Nop interval: 5
Nop count: 5
I_T nexus information:
.fi
.if n \{\
.RE
.\}
.SS "تنظیم NOP-OUT برای یک هدف"
.PP
دستور tgtadm برای تغییر تنظیمات NOP-OUT به کار میرود.\&
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-op update \-\-mode target \-\-tid 1 \-n nop_count \-v 5
tgtadm \-\-op update \-\-mode target \-\-tid 1 \-n nop_interval \-v 5
.fi
.if n \{\
.RE
.\}
.SH "درگاههای ISCSI (ISCSI PORTALS)"
.PP
پورتالهای iSCSI را میتوان در زمان اجرا مشاهده، اضافه یا حذف کرد.\&
.SS "فهرست کردن پورتالها"
.PP
این دستور برای فهرست کردن پورتالهای کنونی iSCSI تعریفشده روی هدف به کار میرود:
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-lld iscsi \-\-op show \-\-mode portal
Portal: 10\&.1\&.1\&.101:3260,1
Portal: 127\&.0\&.0\&.1:3260,1
.fi
.if n \{\
.RE
.\}
.SS "افزودن پورتال"
.PP
این دستور برای افزودن یک پورتال به هدف استفاده میشود:
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-lld iscsi \-\-op new \-\-mode portal \-\-param portal=10\&.1\&.1\&.101:3260
.fi
.if n \{\
.RE
.\}
.SS "حذف پورتال"
.PP
این دستور برای حذف یک پورتال از هدف استفاده میشود:
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-lld iscsi \-\-op delete \-\-mode portal \-\-param portal=10\&.1\&.1\&.101:3260
.fi
.if n \{\
.RE
.\}
.SH "اتصالات ISCSI (ISCSI CONNECTIONS)"
.PP
اتصالات iSCSI را میتوان در زمان اجرا مشاهده کرد و به صورت اجباری بست.\&
.SS "فهرست کردن تمام اتصالات فعال برای یک هدف"
.PP
این دستور برای فهرست کردن تمام اتصالات فعال iSCSI به هدف، همراه با شناسه اتصال، نام آغازگر و نشانی IP آغازگر به کار میرود:
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-lld iscsi \-\-op show \-\-mode conn \-\-tid 1
Session: 2
Connection: 0
Initiator: iqn\&.2008\-11\&.org\&.linux\-kvm:
IP Address: 127\&.0\&.0\&.1
.fi
.if n \{\
.RE
.\}
.SS "بستن یک اتصال موجود"
.PP
این دستور برای بستن یک اتصال iSCSI به کار میرود.\& توجه داشته باشید که بستن اجباری اتصالات iSCSI میتواند منجر به از دست رفتن دادهها شود.\&
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-lld iscsi \-\-op delete \-\-mode conn \-\-tid 1 \-\-sid 2 \-\-cid 0
.fi
.if n \{\
.RE
.\}
.SH "وضعیت برخط/آفلاین (ONLINE/OFFLINE STATUS)"
.PP
واحدهای منطقی (LUNs) در tgtd میتوانند در وضعیت برخط (online) یا آفلاین (offline) باشند.\& LUNهایی که آفلاین هستند بسته به نوع دستگاه رفتار کمی متفاوتی دارند.\& دستگاههای آفلاین طوری رفتار میکنند که گویی هیچ رسانهای در دسترس نیست و هر عملیاتی که به رسانه دسترسی پیدا کند با خطای check-condition شکست خواهد خورد.\&
.PP
دستگاهها زمانی که قفلهای "PREVENT ALLOW MEDIUM REMOVAL" روی آنها وجود دارد نمیتوانند روی حالت Offline تنظیم شوند.\& به همین ترتیب رسانه در دستگاههای Online هنگامی که چنین قفلهایی روی دستگاه وجود دارد نمیتواند با نرمافزار خارج شود (دستور \*(Aqeject\*(Aq ناموفق خواهد بود).\&
.SS "نمایش وضعیت Online/Offline"
.PP
مشاهده وضعیت برخط/آفلاین یک LUN از طریق دستور tgtd انجام میشود.\& اگر مقدار "Prevent removal" برابر با "Yes" باشد، نشاندهنده این است که یک برنامه کاربردی قفل "جلوگیری از خروج رسانه" را روی دستگاه نگه داشته است.\&
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-lld iscsi \-\-mode target \-\-op show
\&.\&.\&.
LUN: 2
Type: cd/dvd
SCSI ID: IET 00010002
SCSI SN: beaf12
Size: 3432 MB, Block size: 1
Online: Yes
Removable media: Yes
Prevent removal: Yes
\&.\&.\&.
.fi
.if n \{\
.RE
.\}
.SS "تغییر وضعیت LUN به آفلاین"
.PP
یک LUN با دستور tgtadm به وضعیت آفلاین تغییر داده میشود.\& هنگامی که دستگاهها روی Offline تنظیم شوند، طوری رفتار میکنند که گویی دیسکی در درایو بارگذاری نشده است.\&
.PP
تغییر وضعیت LUN به آفلاین (نبود دیسک در درایو):
.sp
.if n \{\
.RS 4
.\}
.nf
tgtadm \-\-tid 1 \-\-lun 2 \-\-op update \-\-mode logicalunit \-P Online=No
.fi
.if n \{\
.RE
.\}
.SH "پارامترهای ISNS (ISNS PARAMETERS)"
.PP
پیکربندی iSNS برای یک هدف با استفاده از دستور tgtadm صورت میپذیرد.\&
.PP
\fBiSNSServerIP\fR
.RS 4
نشانی IP سرور iSNS را مشخص میکند.\& نرمافزار TGTD تنها از یک سرور iSNS پشتیبانی میکند.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
مثال:
tgtadm \-\-op update \-\-mode sys \-\-name iSNSServerIP \-\-value 192\&.168\&.11\&.133
.fi
.if n \{\
.RE
.\}
.PP
\fBiSNS\fR
.RS 4
این تنظیم iSNS را فعال (On) یا غیرفعال (Off) میکند.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
مثال:
tgtadm \-\-op update \-\-mode sys \-\-name iSNS \-\-value On
.fi
.if n \{\
.RE
.\}
.PP
\fBiSNSServerPort\fR
.RS 4
این تنظیم درگاه (port) مورد استفاده برای iSNS را مشخص میکند.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
مثال:
tgtadm \-\-op update \-\-mode sys \-\-name iSNSServerPort \-\-value 3205
.fi
.if n \{\
.RE
.\}
.PP
\fBiSNSAccessControl\fR
.RS 4
فعال/غیرفعالسازی کنترل دسترسی برای iSNS.\&
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
مثال:
tgtadm \-\-op update \-\-mode sys \-\-name iSNSAccessControl \-\-value Off
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
tgtd(8), tgt\-admin(8), tgtimg(8), tgt\-setup\-lun(8)\&.
\m[blue]\fB\%https://github.com/fujita/tgt\fR\m[]
.SH "گزارش اشکالات (REPORTING BUGS)"
.PP
گزارش اشکالات به