'\" t
.\"     Title: tgt-admin
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 07/09/2026
.\"    Manual: [FIXME: manual]
.\"    Source: [FIXME: source]
.\"  Language: English
.\"
.TH "TGT\-ADMIN" "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)"
tgt\-admin \- ابزار پیکربندی اهداف (Target) در پروتکل SCSI لینوکس
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBtgt\-admin\fR\ 'u
\fBtgt\-admin\fR [\-e\ \-\-execute] [\-\-delete\ <value>] [\-\-offline\ <value>] [\-\-ready\ <value>] [\-s\ \-\-show] [\-C\ \-\-control\-port\ <NNNN>] [\-c\ \-\-conf\ <file>] [\-\-ignore\-errors] [\-f\ \-\-force] [\-p\ \-\-pretend] [\-\-dump] [\-v\ \-\-verbose] [\-h\ \-\-help]
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار tgt\-admin برنامه‌ای کاربردی است که امکان پیکربندی ماندگار تارگت‌ها (targets) و LUNها را فراهم می‌سازد. این ابزار از دستورات tgtadm برای ایجاد، حذف و نمایش تارگت‌ها استفاده می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-e, \-\-execute\fR
.RS 4
خواندن فایل etc/tgt/targets.conf/ و اجرای دستورات tgtadm. اگر تارگت از قبل وجود داشته باشد، پردازش نخواهد شد. گزینه update-- را ببینید.
.RE
.PP
\fB\-d, \-\-delete <value>\fR
.RS 4
حذف همه یا تارگت‌های انتخاب‌شده. تارگت تنها در صورتی حذف خواهد شد که در حال استفاده نباشد (هیچ آغازگری به آن متصل نباشد).
.sp
اگر می‌خواهید تارگت‌هایی را که در حال استفاده هستند حذف کنید، باید فلگ "force--" را اضافه کنید.
.sp
.if n \{\
.RS 4
.\}
.nf
نمونه استفاده:
    \-\-delete ALL            \- حذف تمامی تارگت‌ها
    \-\-delete tid=4          \- حذف تارگت شماره ۴
                              (تارگت با شناسه ۴)
    \-\-delete iqn\&.2008\-08\&.com\&.example:some\&.target
                            \- حذف این تارگت مشخص
.fi
.if n \{\
.RE
.\}
.sp
.RE
.PP
\fB\-\-offline\fR
.RS 4
قرار دادن همه یا تارگت‌های انتخاب‌شده در وضعیت برون‌خط (offline).
.sp
.if n \{\
.RS 4
.\}
.nf
نمونه استفاده:
    \-\-offline ALL           \- برون‌خط کردن تمامی تارگت‌ها
    \-\-offline tid=4         \- برون‌خط کردن تارگت شماره ۴
                              (تارگت با شناسه ۴)
    \-\-offline iqn\&.2008\-08\&.com\&.example:some\&.target
                            \- برون‌خط کردن این تارگت مشخص
.fi
.if n \{\
.RE
.\}
.sp
.RE
.PP
\fB\-\-ready\fR
.RS 4
قرار دادن همه یا تارگت‌های انتخاب‌شده در وضعیت آماده (ready).
.sp
.if n \{\
.RS 4
.\}
.nf
نمونه استفاده:
    \-\-ready ALL             \- آماده‌سازی تمامی تارگت‌ها
    \-\-ready tid=4           \- آماده‌سازی تارگت شماره ۴
                              (تارگت با شناسه ۴)
    \-\-ready iqn\&.2008\-08\&.com\&.example:some\&.target
                            \- آماده‌سازی این تارگت مشخص
.fi
.if n \{\
.RE
.\}
.sp
.RE
.PP
\fB\-\-update <value>\fR
.RS 4
به‌روزرسانی همه یا تارگت‌های انتخاب‌شده. تارگت تنها زمانی به‌روزرسانی می‌شود که در حال استفاده نباشد (هیچ آغازگری به آن متصل نباشد).
.sp
چنانچه مایل به به‌روزرسانی تارگت‌های در حال استفاده هستید، باید فلگ "force--" را اضافه نمایید.
.sp
.if n \{\
.RS 4
.\}
.nf
نمونه استفاده:
    \-\-update ALL             \- به‌روزرسانی تمامی تارگت‌ها
    \-\-update tid=4           \- به‌روزرسانی تارگت شماره ۴
                               (تارگت با شناسه ۴)
    \-\-update iqn\&.2008\-08\&.com\&.example:some\&.target
                             \- به‌روزرسانی این تارگت مشخص
.fi
.if n \{\
.RE
.\}
.sp
.RE
.PP
\fB\-s, \-\-show\fR
.RS 4
نمایش تمامی تارگت‌ها.
.RE
.PP
\fB\-C, \-\-control\-port <NNNN>\fR
.RS 4
امکان اجرای چندین نمونه هم‌روند از tgtd روی یک میزبان وجود دارد. این آرگومان برای تعیین اینکه دستور tgt\-admin روی کدام نمونه عملیات را انجام دهد به کار می‌رود.
.RE
.PP
\fB\-c, \-\-conf <configuration file>\fR
.RS 4
مشخص کردن فایل پیکربندی جایگزین به‌جای etc/tgt/targets.conf/ که فایل پیش‌فرض است.
.RE
.PP
\fB\-\-ignore\-errors\fR
.RS 4
ادامه دادن فرآیند حتی در صورتی که tgtadm با کدی غیر از صفر خارج شود.
.RE
.PP
\fB\-f, \-\-force\fR
.RS 4
اجبار به انجام برخی عملیات حتی در صورتی که تارگت در حال استفاده باشد.
.RE
.PP
\fB\-p, \-\-pretend\fR
.RS 4
تنها چاپ گزینه‌هایی از tgtadm که مورد استفاده قرار خواهند گرفت؛ هیچ اقدامی را اجرا نمی‌کند. گزینه v- را فعال فرض می‌کند.
.RE
.PP
\fB\-\-dump\fR
.RS 4
تخلیه و نمایش پیکربندی فعلی tgtd. توجه: پارامترهای با جزئیات کامل، مانند کش نوشتن (write caching) را شامل نمی‌شود.
.RE
.PP
\fB\-v, \-\-verbose\fR
.RS 4
افزایش سطح جزئیات خروجی (نمایش دستورات استفاده‌شده tgtadm).
.RE
.PP
\fB\-h, \-\-help\fR
.RS 4
نمایش فهرستی از گزینه‌های موجود و سپس خروج.
.RE
.SH "فایل‌ها (FILES)"
.PP
\fB/etc/tgt/targets\&.conf\fR
.RS 4
فایل پیکربندی برای tgt\-admin.
.RE
.PP
\fB/usr/share/doc/tgt/targets\&.conf\&.example\fR
.RS 4
نمونه فایل پیکربندی برای tgt\-admin.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
targets\&.conf(5), tgtd(8), tgtadm(8), tgtimg(8), tgt\-setup\-lun(8)\&.
\m[blue]\fB\%https://github.com/fujita/tgt\fR\m[]
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.PP
گزارش اشکالات به <stgt@vger\&.kernel\&.org>