TGT-ADMIN(8)                    [FIXME: manual]                   TGT-ADMIN(8)

نام (NAME)
       tgt-admin - ابزار پیکربندی اهداف (Target) در پروتکل SCSI لینوکس

خلاصه دستور (SYNOPSIS)
       tgt-admin [-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]

توضیحات (DESCRIPTION)
       ابزار tgt-admin برنامه‌ای کاربردی است که امکان پیکربندی ماندگار تارگت‌ها
       (targets) و LUNها را فراهم می‌سازد. این ابزار از دستورات tgtadm برای
       ایجاد، حذف و نمایش تارگت‌ها استفاده می‌کند.

گزینه‌ها (OPTIONS)
       -e, --execute
           خواندن فایل etc/tgt/targets.conf/ و اجرای دستورات tgtadm. اگر تارگت
           از قبل وجود داشته باشد، پردازش نخواهد شد. گزینه update-- را ببینید.

       -d, --delete <value>
           حذف همه یا تارگت‌های انتخاب‌شده. تارگت تنها در صورتی حذف خواهد شد که
           در حال استفاده نباشد (هیچ آغازگری به آن متصل نباشد).

           اگر می‌خواهید تارگت‌هایی را که در حال استفاده هستند حذف کنید، باید
           فلگ "force--" را اضافه کنید.

               نمونه استفاده:
                   --delete ALL            - حذف تمامی تارگت‌ها
                   --delete tid=4          - حذف تارگت شماره ۴
                                             (تارگت با شناسه ۴)
                   --delete iqn.2008-08.com.example:some.target
                                           - حذف این تارگت مشخص


       --offline
           قرار دادن همه یا تارگت‌های انتخاب‌شده در وضعیت برون‌خط (offline).

               نمونه استفاده:
                   --offline ALL           - برون‌خط کردن تمامی تارگت‌ها
                   --offline tid=4         - برون‌خط کردن تارگت شماره ۴
                                             (تارگت با شناسه ۴)
                   --offline iqn.2008-08.com.example:some.target
                                           - برون‌خط کردن این تارگت مشخص


       --ready
           قرار دادن همه یا تارگت‌های انتخاب‌شده در وضعیت آماده (ready).

               نمونه استفاده:
                   --ready ALL             - آماده‌سازی تمامی تارگت‌ها
                   --ready tid=4           - آماده‌سازی تارگت شماره ۴
                                             (تارگت با شناسه ۴)
                   --ready iqn.2008-08.com.example:some.target
                                           - آماده‌سازی این تارگت مشخص


       --update <value>
           به‌روزرسانی همه یا تارگت‌های انتخاب‌شده. تارگت تنها زمانی به‌روزرسانی
           می‌شود که در حال استفاده نباشد (هیچ آغازگری به آن متصل نباشد).

           چنانچه مایل به به‌روزرسانی تارگت‌های در حال استفاده هستید، باید فلگ
           "force--" را اضافه نمایید.

               نمونه استفاده:
                   --update ALL             - به‌روزرسانی تمامی تارگت‌ها
                   --update tid=4           - به‌روزرسانی تارگت شماره ۴
                                              (تارگت با شناسه ۴)
                   --update iqn.2008-08.com.example:some.target
                                            - به‌روزرسانی این تارگت مشخص


       -s, --show
           نمایش تمامی تارگت‌ها.

       -C, --control-port <NNNN>
           امکان اجرای چندین نمونه هم‌روند از tgtd روی یک میزبان وجود دارد. این
           آرگومان برای تعیین اینکه دستور tgt-admin روی کدام نمونه عملیات را
           انجام دهد به کار می‌رود.

       -c, --conf <configuration file>
           مشخص کردن فایل پیکربندی جایگزین به‌جای etc/tgt/targets.conf/ که فایل
           پیش‌فرض است.

       --ignore-errors
           ادامه دادن فرآیند حتی در صورتی که tgtadm با کدی غیر از صفر خارج
           شود.

       -f, --force
           اجبار به انجام برخی عملیات حتی در صورتی که تارگت در حال استفاده
           باشد.

       -p, --pretend
           تنها چاپ گزینه‌هایی از tgtadm که مورد استفاده قرار خواهند گرفت؛ هیچ
           اقدامی را اجرا نمی‌کند. گزینه v- را فعال فرض می‌کند.

       --dump
           تخلیه و نمایش پیکربندی فعلی tgtd. توجه: پارامترهای با جزئیات کامل،
           مانند کش نوشتن (write caching) را شامل نمی‌شود.

       -v, --verbose
           افزایش سطح جزئیات خروجی (نمایش دستورات استفاده‌شده tgtadm).

       -h, --help
           نمایش فهرستی از گزینه‌های موجود و سپس خروج.

فایل‌ها (FILES)
       /etc/tgt/targets.conf
           فایل پیکربندی برای tgt-admin.

       /usr/share/doc/tgt/targets.conf.example
           نمونه فایل پیکربندی برای tgt-admin.

همچنین ببینید (SEE ALSO)
       targets.conf(5), tgtd(8), tgtadm(8), tgtimg(8), tgt-setup-lun(8).
       https://github.com/fujita/tgt

گزارش باگ‌ها (REPORTING BUGS)
       گزارش اشکالات به <stgt@vger.kernel.org>

[FIXME: source]                   07/09/2026                      TGT-ADMIN(8)