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

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

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]

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

-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

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

/etc/tgt/targets.conf

فایل پیکربندی برای tgt-admin.

/usr/share/doc/tgt/targets.conf.example

نمونه فایل پیکربندی برای tgt-admin.

targets.conf(5), tgtd(8), tgtadm(8), tgtimg(8), tgt-setup-lun(8). https://github.com/fujita/tgt

گزارش اشکالات به <stgt@vger.kernel.org>

07/09/2026 [FIXME: source]