This one has been bothering me for a little while, so I hope it'll be
helpful. Overall, I found the tgtadm help to be very inconsistent, with
options being provided with an equal sign but others without, long and
short options being mixed in the examples, short options not being
documented in the man page, square brackets being used for optional and
non optional, etc.
For first time users, I fear this lack of consistency doesn't provide a
very good impression of an otherwise excellent set of utilities, and
thus the attached patch attempts to remedy that.
Note that the man and html diff included in the patch come from files
that have been regenerated from the xml, so they can be ignored if you
run xsltproc.
I have also not taken care of the parameters, that are currently left
out of the man/html page (eg: --cid, --user, --bsoflags...) but appear
with tgtadm -h. I suppose you probably want to add some examples for
these options in the .xml as well.
Regards,
/Pete
From 3d42f5badd8398674eb8658c2d408288b365b986 Mon Sep 17 00:00:00 2001
From: Pete Batard <pbatard@xxxxxxxxx>
Date: Sat, 14 Aug 2010 00:56:05 +0100
Subject: [PATCH] tgtadm manpage and help: improvements & consistency
Only use square brackets for optional parameters.
Don't use equal signs where avoidable.
Display the short option for all parameters.
Consistently use long option in the examples.
---
doc/htmlpages/tgtadm.8.html | 72 ++++++++--------
doc/manpages/tgtadm.8 | 196 +++++++++++++++++++++++++++----------------
doc/tgtadm.8.xml | 80 +++++++++---------
usr/tgtadm.c | 58 +++++++-------
4 files changed, 227 insertions(+), 179 deletions(-)
diff --git a/doc/htmlpages/tgtadm.8.html b/doc/htmlpages/tgtadm.8.html
index 287942a..18f62f2 100644
--- a/doc/htmlpages/tgtadm.8.html
+++ b/doc/htmlpages/tgtadm.8.html
@@ -1,48 +1,48 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>tgtadm</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="tgtadm.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>tgtadm — Linux SCSI Target Administration Utility</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">tgtadm [OPTIONS]...</code> [-C --control-port <port>] [--lld <driver>] [--op <operation>] [--mode <mode>] [--tid <tid>] [-T --targetname <targetname>] [-Y --device-type <type>] [--lun <lun>] [--backing-store <path>] [--initiator-address <address>] [--name <parameter>] [--value <value>] [--params <param=value[,param=value...]>] [--help]</p></div></div><div class="refsect1" lang="en"><a name="id2476151"></a><h2>DESCRIPTION</h2><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>tgtadm</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="tgtadm"><a name="tgtadm.8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>tgtadm — Linux SCSI Target Administration Utility</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">tgtadm [OPTIONS]...</code> [-C --control-port <port>] [-L --lld <driver>] [-o --op <operation>] [-m --mode <mode>] [-t --tid <id>] [-T --targetname <targetname>] [-Y --device-type <type>] [-l --lun <lun>] [-b --backing-store <path>] [-I --initiator-address <address>] [-n --name <parameter>] [-v --value <value>] [-P --params <param=value[,param=value...]>] [-h --help]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id247594"></a><h2>DESCRIPTION</h2><p>
tgtadm is used to monitor and modify everything about Linux SCSI target
software: targets, volumes, etc.
- </p></div><div class="refsect1" lang="en"><a name="id2476163"></a><h2>OPTIONS</h2><div class="variablelist"><pre class="screen">
+ </p></div><div class="refsect1" title="OPTIONS"><a name="id247605"></a><h2>OPTIONS</h2><div class="variablelist"><pre class="screen">
Possible device-types are:
disk : emulate a disk device
tape : emulate a tape reader
ssc : same as tape
cd : emulate a DVD drive
changer : emulate a media changer device
- </pre><dl><dt><span class="term"><code class="option">-C, --control-port=<port></code></span></dt><dd><p>
+ </pre><dl><dt><span class="term"><code class="option">-C, --control-port <port></code></span></dt><dd><p>
It is possible to run multiple concurrent instances of tgtd
on a host. This argument is used to control which instance
the tgtadm command will operate on.
- </p></dd><dt><span class="term"><code class="option">-Y, --device-type=<type></code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="option">-Y, --device-type <type></code></span></dt><dd><p>
When creating a LUN, this parameter specifies the type of device
to create. Default is disk.
- </p></dd><dt><span class="term"><code class="option">--lld [driver] --op new --mode target --tid=[id] --targetname [name]</code></span></dt><dd><p>
- Add a new target with [id] and [name].
- </p></dd><dt><span class="term"><code class="option">--lld [driver] --op delete --mode target --tid=[id]</code></span></dt><dd><p>
- Delete specific target with [id]. The target must have no active I_T nexus.
- </p></dd><dt><span class="term"><code class="option">--lld [driver] --op show --mode target</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="option">--lld <driver> --op new --mode target --tid <id> --targetname <name></code></span></dt><dd><p>
+ Add a new target with <id> and <name>.
+ </p></dd><dt><span class="term"><code class="option">--lld <driver> --op delete --mode target --tid <id></code></span></dt><dd><p>
+ Delete specific target with <id>. The target must have no active I_T nexus.
+ </p></dd><dt><span class="term"><code class="option">--lld <driver> --op show --mode target</code></span></dt><dd><p>
Show all the targets.
- </p></dd><dt><span class="term"><code class="option">--lld [driver] --op show --mode target --tid=[id]</code></span></dt><dd><p>
- Show target parameters of a target with [id].
- </p></dd><dt><span class="term"><code class="option">--lld [driver] --op new --mode=logicalunit --tid=[id] --lun=[lun] --backing-store [path]</code></span></dt><dd><p>
- Add a new logical unit with [lun] to specific target with [id]. The
- logical unit is offered to the initiators. [path] must be block device
+ </p></dd><dt><span class="term"><code class="option">--lld <driver> --op show --mode target --tid <id></code></span></dt><dd><p>
+ Show target parameters of a target with <id>.
+ </p></dd><dt><span class="term"><code class="option">--lld <driver> --op new --mode logicalunit --tid <id> --lun <lun> --backing-store <path></code></span></dt><dd><p>
+ Add a new logical unit with <lun> to specific target with <id>. The
+ logical unit is offered to the initiators. <path> must be block device
files (including LVM and RAID devices) or regular files. lun0 is
reserved for a special device automatically created.
- </p></dd><dt><span class="term"><code class="option">--lld [driver] --op delete --mode=logicalunit --tid=[id] --lun=[lun]</code></span></dt><dd><p>
- Delete specific logical unit with [lun] that the target with [id] has.
- </p></dd><dt><span class="term"><code class="option">--lld [driver] --op bind --mode=target --tid=[id] --initiator-address=[address]</code></span></dt><dd><p>
- Add the address to the access lists of the target with [id]. Initiators
+ </p></dd><dt><span class="term"><code class="option">--lld <driver> --op delete --mode logicalunit --tid <id> --lun <lun></code></span></dt><dd><p>
+ Delete specific logical unit with <lun> that the target with <id> has.
+ </p></dd><dt><span class="term"><code class="option">--lld <driver> --op bind --mode target --tid <id> --initiator-address <address></code></span></dt><dd><p>
+ Add the address to the access lists of the target with <id>. Initiators
with the address can access to the target. 'ALL' is a special address
to allow all initiators to access to a target.
- </p></dd><dt><span class="term"><code class="option">--lld [driver] --op unbind --mode=target --tid=[id] --initiator-address=[address]</code></span></dt><dd><p>
- Delete the address from the access lists of the target with [id].
- </p></dd><dt><span class="term"><code class="option">--lld [driver] --op update --mode=target --tid=[id] --name=[parameter] --value=[value]</code></span></dt><dd><p>
- Change the value of [parameter] of the target with [id] to [value].
- </p></dd><dt><span class="term"><code class="option">--lld [driver] --op update --mode=target --tid=[id] --params parameter=value[,...]</code></span></dt><dd><p>
+ </p></dd><dt><span class="term"><code class="option">--lld <driver> --op unbind --mode target --tid <id> --initiator-address <address></code></span></dt><dd><p>
+ Delete the address from the access lists of the target with <id>.
+ </p></dd><dt><span class="term"><code class="option">--lld <driver> --op update --mode target --tid <id> --name=<parameter> --value=<value></code></span></dt><dd><p>
+ Change the value of <parameter> of the target with <id> to <value>.
+ </p></dd><dt><span class="term"><code class="option">--lld <driver> --op update --mode target --tid <id> --params parameter=value<,...></code></span></dt><dd><p>
Sets/changes the value of one or more parameters.
</p></dd><dt><span class="term"><code class="option">--help</code></span></dt><dd><p>
Display a list of available options and exits.
- </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2476392"></a><h2>LUN PARAMETERS</h2><p>
+ </p></dd></dl></div></div><div class="refsect1" title="LUN PARAMETERS"><a name="id247860"></a><h2>LUN PARAMETERS</h2><p>
These parameters are only applicable for "--mode logicalunit".
</p><div class="variablelist"><pre class="screen">
Example:
@@ -108,7 +108,7 @@ tgtadm --lld iscsi --mode logicalunit --op update --tid 1 --lun 2 \
and the mode page contents. Most devices default to reasonable
default mode pages automatically when the LUN is created, but this
allows special settings.
- </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2476572"></a><h2>SMC SPECIFIC LUN PARAMETERS</h2><p>
+ </p></dd></dl></div></div><div class="refsect1" title="SMC SPECIFIC LUN PARAMETERS"><a name="id248034"></a><h2>SMC SPECIFIC LUN PARAMETERS</h2><p>
These parameters are only applicable for luns that are of type "changer"
i.e. the media changer device for a DVD Jukebox or a Virtual Tape Library.
</p><div class="variablelist"><pre class="screen">
@@ -117,11 +117,11 @@ two empty DVD-R disks.
# Create a target
-tgtadm --lld iscsi --mode target --op new --tid 1 -T iqn.2007-03:virtual-dvd:`hostname`
+tgtadm --lld iscsi --mode target --op new --tid 1 --targetname iqn.2007-03:virtual-dvd:`hostname`
# Create a DVD drive and give it a nice name
# The dvd starts out without a backing store file, i.e. no disk loaded
-tgtadm --op new --mode logicalunit --tid 1 --lun 1 -Y cd
+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
# We need a backend store file for the media changer
@@ -130,7 +130,7 @@ if [ ! -f $HOME/smc ]; then
fi
# Create the SMC device and give it a nice name
-tgtadm --lld iscsi --mode logicalunit --op new --tid 1 --lun 2 -b $HOME/smc --device-type=changer
+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
# Add a Data Transfer devices (1 drive)
@@ -161,7 +161,7 @@ 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,sides=1
# Allow ALL initiators to connect to this target
-tgtadm --lld iscsi --mode target --op bind --tid 1 -I ALL
+tgtadm --lld iscsi --mode target --op bind --tid 1 --initiator-address ALL
# Show all our good work.
tgtadm --lld iscsi --mode target --op show
@@ -193,24 +193,24 @@ Slot types:
To assign a media image file to a storage element slot,
you assign "barcode" to be the name of the image file in
the "media_home" directory.
- </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2476744"></a><h2>iSNS PARAMETERS</h2><p>
+ </p></dd></dl></div></div><div class="refsect1" title="iSNS PARAMETERS"><a name="id248206"></a><h2>iSNS PARAMETERS</h2><p>
iSNS configuration for a target is by using the tgtadm command.
</p><div class="variablelist"><pre class="screen">
Example:
-tgtadm --op update --mode sys --name iSNSServerIP -v 192.168.11.133
+tgtadm --op update --mode sys --name iSNSServerIP --value 192.168.11.133
</pre><pre class="screen">
Example:
-tgtadm --op update --mode sys --name iSNS -v On
+tgtadm --op update --mode sys --name iSNS --value On
</pre><pre class="screen">
Example:
-tgtadm --op update --mode sys --name iSNSServerPort -v 3205
+tgtadm --op update --mode sys --name iSNSServerPort --value 3205
</pre><pre class="screen">
Example:
-tgtadm --op update --mode sys --name iSNSAccessControl -v Off
+tgtadm --op update --mode sys --name iSNSAccessControl --value Off
</pre><dl><dt><span class="term"><code class="option">iSNSServerIP</code></span></dt><dd><p>
This specifies the IP address of the iSNS server. TGTD only
supprots one iSNS server.
@@ -220,9 +220,9 @@ tgtadm --op update --mode sys --name iSNSAccessControl -v Off
This setting specifies the port to use for iSNS.
</p></dd><dt><span class="term"><code class="option">iSNSAccessControl</code></span></dt><dd><p>
Enable/disable access control for iSNS.
- </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2476843"></a><h2>SEE ALSO</h2><p>
+ </p></dd></dl></div></div><div class="refsect1" title="SEE ALSO"><a name="id248305"></a><h2>SEE ALSO</h2><p>
tgtd(8), tgt-admin(8), tgtimg(8), tgt-setup-lun(8).
<a class="ulink" href="http://stgt.sourceforge.net/"; target="_top">http://stgt.sourceforge.net/</a>
- </p></div><div class="refsect1" lang="en"><a name="id2476858"></a><h2>REPORTING BUGS</h2><p>
+ </p></div><div class="refsect1" title="REPORTING BUGS"><a name="id248320"></a><h2>REPORTING BUGS</h2><p>
Report bugs to <stgt@xxxxxxxxxxxxxxx>
</p></div></div></body></html>
diff --git a/doc/manpages/tgtadm.8 b/doc/manpages/tgtadm.8
index abce11a..05485ed 100644
--- a/doc/manpages/tgtadm.8
+++ b/doc/manpages/tgtadm.8
@@ -1,36 +1,46 @@
+'\" t
.\" Title: tgtadm
.\" Author:
-.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
-.\" Date: 04/04/2010
+.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
+.\" Date: 08/14/2010
.\" Manual:
.\" Source:
+.\" Language: English
.\"
-.TH "TGTADM" "8" "04/04/2010" "" ""
+.TH "TGTADM" "8" "08/14/2010" "" ""
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
.SH "NAME"
-tgtadm - Linux SCSI Target Administration Utility
+tgtadm \- Linux SCSI Target Administration Utility
.SH "SYNOPSIS"
-.HP 20
-\fBtgtadm [OPTIONS]\.\.\.\fR [\-C\ \-\-control\-port\ <port>] [\-\-lld\ <driver>] [\-\-op\ <operation>] [\-\-mode\ <mode>] [\-\-tid\ <tid>] [\-T\ \-\-targetname\ <targetname>] [\-Y\ \-\-device\-type\ <type>] [\-\-lun\ <lun>] [\-\-backing\-store\ <path>] [\-\-initiator\-address\ <address>] [\-\-name\ <parameter>] [\-\-value\ <value>] [\-\-params\ <param=value[,param=value\.\.\.]>] [\-\-help]
+.HP \w'\fBtgtadm\ [OPTIONS]\&.\&.\&.\fR\ 'u
+\fBtgtadm [OPTIONS]\&.\&.\&.\fR [\-C\ \-\-control\-port\ <port>] [\-L\ \-\-lld\ <driver>] [\-o\ \-\-op\ <operation>] [\-m\ \-\-mode\ <mode>] [\-t\ \-\-tid\ <id>] [\-T\ \-\-targetname\ <targetname>] [\-Y\ \-\-device\-type\ <type>] [\-l\ \-\-lun\ <lun>] [\-b\ \-\-backing\-store\ <path>] [\-I\ \-\-initiator\-address\ <address>] [\-n\ \-\-name\ <parameter>] [\-v\ \-\-value\ <value>] [\-P\ \-\-params\ <param=value[,param=value\&.\&.\&.]>] [\-h\ \-\-help]
.SH "DESCRIPTION"
.PP
-tgtadm is used to monitor and modify everything about Linux SCSI target software: targets, volumes, etc\.
+tgtadm is used to monitor and modify everything about Linux SCSI target software: targets, volumes, etc\&.
.SH "OPTIONS"
.PP
-\fB\-C, \-\-control\-port=<port>\fR
+\fB\-C, \-\-control\-port <port>\fR
.RS 4
-It is possible to run multiple concurrent instances of tgtd on a host\. This argument is used to control which instance the tgtadm command will operate on\.
+It is possible to run multiple concurrent instances of tgtd on a host\&. This argument is used to control which instance the tgtadm command will operate on\&.
.RE
.PP
-\fB\-Y, \-\-device\-type=<type>\fR
+\fB\-Y, \-\-device\-type <type>\fR
.RS 4
-When creating a LUN, this parameter specifies the type of device to create\. Default is disk\.
+When creating a LUN, this parameter specifies the type of device to create\&. Default is disk\&.
.RE
.sp
+.if n \{\
.RS 4
+.\}
.nf
Possible device\-types are:
disk : emulate a disk device
@@ -40,82 +50,86 @@ Possible device\-types are:
changer : emulate a media changer device
.fi
+.if n \{\
.RE
+.\}
.PP
-\fB\-\-lld [driver] \-\-op new \-\-mode target \-\-tid=[id] \-\-targetname [name]\fR
+\fB\-\-lld <driver> \-\-op new \-\-mode target \-\-tid <id> \-\-targetname <name>\fR
.RS 4
-Add a new target with [id] and [name]\.
+Add a new target with <id> and <name>\&.
.RE
.PP
-\fB\-\-lld [driver] \-\-op delete \-\-mode target \-\-tid=[id]\fR
+\fB\-\-lld <driver> \-\-op delete \-\-mode target \-\-tid <id>\fR
.RS 4
-Delete specific target with [id]\. The target must have no active I_T nexus\.
+Delete specific target with <id>\&. The target must have no active I_T nexus\&.
.RE
.PP
-\fB\-\-lld [driver] \-\-op show \-\-mode target\fR
+\fB\-\-lld <driver> \-\-op show \-\-mode target\fR
.RS 4
-Show all the targets\.
+Show all the targets\&.
.RE
.PP
-\fB\-\-lld [driver] \-\-op show \-\-mode target \-\-tid=[id]\fR
+\fB\-\-lld <driver> \-\-op show \-\-mode target \-\-tid <id>\fR
.RS 4
-Show target parameters of a target with [id]\.
+Show target parameters of a target with <id>\&.
.RE
.PP
-\fB\-\-lld [driver] \-\-op new \-\-mode=logicalunit \-\-tid=[id] \-\-lun=[lun] \-\-backing\-store [path]\fR
+\fB\-\-lld <driver> \-\-op new \-\-mode logicalunit \-\-tid <id> \-\-lun <lun> \-\-backing\-store <path>\fR
.RS 4
-Add a new logical unit with [lun] to specific target with [id]\. The logical unit is offered to the initiators\. [path] must be block device files (including LVM and RAID devices) or regular files\. lun0 is reserved for a special device automatically created\.
+Add a new logical unit with <lun> to specific target with <id>\&. The logical unit is offered to the initiators\&. <path> must be block device files (including LVM and RAID devices) or regular files\&. lun0 is reserved for a special device automatically created\&.
.RE
.PP
-\fB\-\-lld [driver] \-\-op delete \-\-mode=logicalunit \-\-tid=[id] \-\-lun=[lun]\fR
+\fB\-\-lld <driver> \-\-op delete \-\-mode logicalunit \-\-tid <id> \-\-lun <lun>\fR
.RS 4
-Delete specific logical unit with [lun] that the target with [id] has\.
+Delete specific logical unit with <lun> that the target with <id> has\&.
.RE
.PP
-\fB\-\-lld [driver] \-\-op bind \-\-mode=target \-\-tid=[id] \-\-initiator\-address=[address]\fR
+\fB\-\-lld <driver> \-\-op bind \-\-mode target \-\-tid <id> \-\-initiator\-address <address>\fR
.RS 4
-Add the address to the access lists of the target with [id]\. Initiators with the address can access to the target\. \'ALL\' is a special address to allow all initiators to access to a target\.
+Add the address to the access lists of the target with <id>\&. Initiators with the address can access to the target\&. \'ALL\' is a special address to allow all initiators to access to a target\&.
.RE
.PP
-\fB\-\-lld [driver] \-\-op unbind \-\-mode=target \-\-tid=[id] \-\-initiator\-address=[address]\fR
+\fB\-\-lld <driver> \-\-op unbind \-\-mode target \-\-tid <id> \-\-initiator\-address <address>\fR
.RS 4
-Delete the address from the access lists of the target with [id]\.
+Delete the address from the access lists of the target with <id>\&.
.RE
.PP
-\fB\-\-lld [driver] \-\-op update \-\-mode=target \-\-tid=[id] \-\-name=[parameter] \-\-value=[value]\fR
+\fB\-\-lld <driver> \-\-op update \-\-mode target \-\-tid <id> \-\-name=<parameter> \-\-value=<value>\fR
.RS 4
-Change the value of [parameter] of the target with [id] to [value]\.
+Change the value of <parameter> of the target with <id> to <value>\&.
.RE
.PP
-\fB\-\-lld [driver] \-\-op update \-\-mode=target \-\-tid=[id] \-\-params parameter=value[,\.\.\.]\fR
+\fB\-\-lld <driver> \-\-op update \-\-mode target \-\-tid <id> \-\-params parameter=value<,\&.\&.\&.>\fR
.RS 4
-Sets/changes the value of one or more parameters\.
+Sets/changes the value of one or more parameters\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
-Display a list of available options and exits\.
+Display a list of available options and exits\&.
.RE
.SH "LUN PARAMETERS"
.PP
-These parameters are only applicable for "\-\-mode logicalunit"\.
+These parameters are only applicable for "\-\-mode logicalunit"\&.
.PP
\fBvendor_id=<string>\fR
.RS 4
-This parameter sets the Vendor Identification string that a LUN will report in INQURY data\.
+This parameter sets the Vendor Identification string that a LUN will report in INQURY data\&.
.RE
.PP
\fBproduct_id=<string>\fR
.RS 4
-This parameter sets the Product Identification string that a LUN will report in INQURY data\.
+This parameter sets the Product Identification string that a LUN will report in INQURY data\&.
.RE
.PP
\fBproduct_rev=<string>\fR
.RS 4
-This parameter sets the Product Revision string that a LUN will report in INQURY data\.
+This parameter sets the Product Revision string that a LUN will report in INQURY data\&.
.RE
.sp
+.if n \{\
.RS 4
+.\}
.nf
Example:
@@ -124,26 +138,30 @@ tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \e
\-\-params vendor_id=TGTD,product_id=VirtualHD,product_rev=0103
.fi
+.if n \{\
.RE
+.\}
.PP
\fBremovable=<0|1>\fR
.RS 4
-This can be used to override/change the default setting for the removable flag\. Disk devices default to non\-removable while DVD and TAPE devices default to removable\.
+This can be used to override/change the default setting for the removable flag\&. Disk devices default to non\-removable while DVD and TAPE devices default to removable\&.
.RE
.PP
\fBsense_format=<0|1>\fR
.RS 4
-This flag controls the format of sense data that the device will return\. 0 = Clasic sense format, 1 = Support descriptor format\.
+This flag controls the format of sense data that the device will return\&. 0 = Clasic sense format, 1 = Support descriptor format\&.
.RE
.PP
\fBonline=<0|1>\fR
.RS 4
-This controls whether a device is online or not\.
+This controls whether a device is online or not\&.
.sp
-Devices default to be online when created but can be brought offline using this parameter\. Behaviour of offline devices depend on device type\. An MMC/DVD device that is offline will report that there is no disk in the unit but the actual MMC/DVD unit itself can still be communicated with\. All other device types will fail all I/O with a sense code of Not Ready\.
+Devices default to be online when created but can be brought offline using this parameter\&. Behaviour of offline devices depend on device type\&. An MMC/DVD device that is offline will report that there is no disk in the unit but the actual MMC/DVD unit itself can still be communicated with\&. All other device types will fail all I/O with a sense code of Not Ready\&.
.RE
.sp
+.if n \{\
.RS 4
+.\}
.nf
Example:
@@ -152,48 +170,56 @@ tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op update \e
\-\-params removable=1,sense_format=1,online=1
.fi
+.if n \{\
.RE
+.\}
.PP
\fBmode_page=<byte\-string>\fR
.RS 4
-This parameter is used to set specific mode pages for the device and the mode page contents\. Most devices default to reasonable default mode pages automatically when the LUN is created, but this allows special settings\.
+This parameter is used to set specific mode pages for the device and the mode page contents\&. Most devices default to reasonable default mode pages automatically when the LUN is created, but this allows special settings\&.
.RE
.sp
+.if n \{\
.RS 4
+.\}
.nf
Examples:
-Create mode page \'2\', subpage 0 and 14 bytes of data\.
-This is Disconnect\-Reconnect mode page\.
+Create mode page \'2\', subpage 0 and 14 bytes of data\&.
+This is Disconnect\-Reconnect mode page\&.
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
-Create mode page \'10\', subpage 0 and 10 bytes of data\.
-This is Control Extension mode page\.
+Create mode page \'10\', subpage 0 and 10 bytes of data\&.
+This is Control Extension mode page\&.
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
-Create mode page \'0x1c\', subpage 0 and 10 bytes of data\.
-This is Informational Exceptions Control mode page\.
+Create mode page \'0x1c\', subpage 0 and 10 bytes of data\&.
+This is Informational Exceptions Control mode page\&.
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
+.\}
.SH "SMC SPECIFIC LUN PARAMETERS"
.PP
-These parameters are only applicable for luns that are of type "changer" i\.e\. the media changer device for a DVD Jukebox or a Virtual Tape Library\.
+These parameters are only applicable for luns that are of type "changer" i\&.e\&. the media changer device for a DVD Jukebox or a Virtual Tape Library\&.
.PP
\fBelement_type=<1|2|3|4>\fR
.RS 4
-This controls which type of element a certain slot in the jukebox/vtl is\.
+This controls which type of element a certain slot in the jukebox/vtl is\&.
.sp
+.if n \{\
.RS 4
+.\}
.nf
Slot types:
1 \-> Medium Transport (picker arm)
@@ -202,48 +228,52 @@ Slot types:
4 \-> Data Transfer device (CD drive, tape drive, MO drive etc)
.fi
+.if n \{\
.RE
+.\}
.RE
.PP
\fBaddress=<1\-65535>\fR
.RS 4
-This is used to create/operate on a single slot\. Address specifies the slot on which to perform the operation\.
+This is used to create/operate on a single slot\&. Address specifies the slot on which to perform the operation\&.
.RE
.PP
\fBstart_address=<1\-65535>,quantity=<1\-\-65535>\fR
.RS 4
-This is used to create/operate on an entire range of slots at once\. Start_address specifies the first address to operate on and quantity specifies the number of consequtive slots\.
+This is used to create/operate on an entire range of slots at once\&. Start_address specifies the first address to operate on and quantity specifies the number of consequtive slots\&.
.RE
.PP
\fBsides=<1|2>\fR
.RS 4
-When creating storage elements, i\.e\. "element_type=2", this parameter specifies if the media has 1 or two sides to hold data\.
+When creating storage elements, i\&.e\&. "element_type=2", this parameter specifies if the media has 1 or two sides to hold data\&.
.RE
.PP
\fBbarcode=<string>\fR
.RS 4
-This is used to assign a barcode to an element\.
+This is used to assign a barcode to an element\&.
.RE
.PP
\fBmedia_home=<string>\fR
.RS 4
-This parameter specifies a directory where all virtual media for the dvd/tape device elements are stored\.
+This parameter specifies a directory where all virtual media for the dvd/tape device elements are stored\&.
.sp
-To assign a media image file to a storage element slot, you assign "barcode" to be the name of the image file in the "media_home" directory\.
+To assign a media image file to a storage element slot, you assign "barcode" to be the name of the image file in the "media_home" directory\&.
.RE
.sp
+.if n \{\
.RS 4
+.\}
.nf
Example: How to create a DVD jukebox with eight disk trays and
-two empty DVD\-R disks\.
+two empty DVD\-R disks\&.
# Create a target
-tgtadm \-\-lld iscsi \-\-mode target \-\-op new \-\-tid 1 \-T iqn\.2007\-03:virtual\-dvd:`hostname`
+tgtadm \-\-lld iscsi \-\-mode target \-\-op new \-\-tid 1 \-\-targetname iqn\&.2007\-03:virtual\-dvd:`hostname`
# Create a DVD drive and give it a nice name
-# The dvd starts out without a backing store file, i\.e\. no disk loaded
-tgtadm \-\-op new \-\-mode logicalunit \-\-tid 1 \-\-lun 1 \-Y cd
+# The dvd starts out without a backing store file, i\&.e\&. no disk loaded
+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
# We need a backend store file for the media changer
@@ -252,7 +282,7 @@ if [ ! \-f $HOME/smc ]; then
fi
# Create the SMC device and give it a nice name
-tgtadm \-\-lld iscsi \-\-mode logicalunit \-\-op new \-\-tid 1 \-\-lun 2 \-b $HOME/smc \-\-device\-type=changer
+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
# Add a Data Transfer devices (1 drive)
@@ -283,76 +313,94 @@ 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,sides=1
# Allow ALL initiators to connect to this target
-tgtadm \-\-lld iscsi \-\-mode target \-\-op bind \-\-tid 1 \-I ALL
+tgtadm \-\-lld iscsi \-\-mode target \-\-op bind \-\-tid 1 \-\-initiator\-address ALL
-# Show all our good work\.
+# Show all our good work\&.
tgtadm \-\-lld iscsi \-\-mode target \-\-op show
.fi
+.if n \{\
.RE
+.\}
.SH "ISNS PARAMETERS"
.PP
-iSNS configuration for a target is by using the tgtadm command\.
+iSNS configuration for a target is by using the tgtadm command\&.
.PP
\fBiSNSServerIP\fR
.RS 4
-This specifies the IP address of the iSNS server\. TGTD only supprots one iSNS server\.
+This specifies the IP address of the iSNS server\&. TGTD only supprots one iSNS server\&.
.RE
.sp
+.if n \{\
.RS 4
+.\}
.nf
Example:
-tgtadm \-\-op update \-\-mode sys \-\-name iSNSServerIP \-v 192\.168\.11\.133
+tgtadm \-\-op update \-\-mode sys \-\-name iSNSServerIP \-\-value 192\&.168\&.11\&.133
.fi
+.if n \{\
.RE
+.\}
.PP
\fBiSNS\fR
.RS 4
-This setting enables(on)/disables(off) iSNS\.
+This setting enables(on)/disables(off) iSNS\&.
.RE
.sp
+.if n \{\
.RS 4
+.\}
.nf
Example:
-tgtadm \-\-op update \-\-mode sys \-\-name iSNS \-v On
+tgtadm \-\-op update \-\-mode sys \-\-name iSNS \-\-value On
.fi
+.if n \{\
.RE
+.\}
.PP
\fBiSNSServerPort\fR
.RS 4
-This setting specifies the port to use for iSNS\.
+This setting specifies the port to use for iSNS\&.
.RE
.sp
+.if n \{\
.RS 4
+.\}
.nf
Example:
-tgtadm \-\-op update \-\-mode sys \-\-name iSNSServerPort \-v 3205
+tgtadm \-\-op update \-\-mode sys \-\-name iSNSServerPort \-\-value 3205
.fi
+.if n \{\
.RE
+.\}
.PP
\fBiSNSAccessControl\fR
.RS 4
-Enable/disable access control for iSNS\.
+Enable/disable access control for iSNS\&.
.RE
.sp
+.if n \{\
.RS 4
+.\}
.nf
Example:
-tgtadm \-\-op update \-\-mode sys \-\-name iSNSAccessControl \-v Off
+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)\.
-\fI\%http://stgt.sourceforge.net/\fR
+tgtd(8), tgt\-admin(8), tgtimg(8), tgt\-setup\-lun(8)\&.
+\m[blue]\fB\%http://stgt.sourceforge.net/\fR\m[]
.SH "REPORTING BUGS"
.PP
-Report bugs to <stgt@vger\.kernel\.org>
+Report bugs to <stgt@vger\&.kernel\&.org>
diff --git a/doc/tgtadm.8.xml b/doc/tgtadm.8.xml
index d596c6e..1191597 100644
--- a/doc/tgtadm.8.xml
+++ b/doc/tgtadm.8.xml
@@ -16,19 +16,19 @@
<cmdsynopsis>
<command>tgtadm [OPTIONS]...</command>
<arg choice="opt">-C --control-port <port></arg>
- <arg choice="opt">--lld <driver></arg>
- <arg choice="opt">--op <operation></arg>
- <arg choice="opt">--mode <mode></arg>
- <arg choice="opt">--tid <tid></arg>
+ <arg choice="opt">-L --lld <driver></arg>
+ <arg choice="opt">-o --op <operation></arg>
+ <arg choice="opt">-m --mode <mode></arg>
+ <arg choice="opt">-t --tid <id></arg>
<arg choice="opt">-T --targetname <targetname></arg>
<arg choice="opt">-Y --device-type <type></arg>
- <arg choice="opt">--lun <lun></arg>
- <arg choice="opt">--backing-store <path></arg>
- <arg choice="opt">--initiator-address <address></arg>
- <arg choice="opt">--name <parameter></arg>
- <arg choice="opt">--value <value></arg>
- <arg choice="opt">--params <param=value[,param=value...]></arg>
- <arg choice="opt">--help</arg>
+ <arg choice="opt">-l --lun <lun></arg>
+ <arg choice="opt">-b --backing-store <path></arg>
+ <arg choice="opt">-I --initiator-address <address></arg>
+ <arg choice="opt">-n --name <parameter></arg>
+ <arg choice="opt">-v --value <value></arg>
+ <arg choice="opt">-P --params <param=value[,param=value...]></arg>
+ <arg choice="opt">-h --help</arg>
</cmdsynopsis>
</refsynopsisdiv>
@@ -45,7 +45,7 @@
<title>OPTIONS</title>
<variablelist>
- <varlistentry><term><option>-C, --control-port=<port></option></term>
+ <varlistentry><term><option>-C, --control-port <port></option></term>
<listitem>
<para>
It is possible to run multiple concurrent instances of tgtd
@@ -55,7 +55,7 @@
</listitem>
</varlistentry>
- <varlistentry><term><option>-Y, --device-type=<type></option></term>
+ <varlistentry><term><option>-Y, --device-type <type></option></term>
<listitem>
<para>
When creating a LUN, this parameter specifies the type of device
@@ -72,23 +72,23 @@ Possible device-types are:
changer : emulate a media changer device
</screen>
- <varlistentry><term><option>--lld [driver] --op new --mode target --tid=[id] --targetname [name]</option></term>
+ <varlistentry><term><option>--lld <driver> --op new --mode target --tid <id> --targetname <name></option></term>
<listitem>
<para>
- Add a new target with [id] and [name].
+ Add a new target with <id> and <name>.
</para>
</listitem>
</varlistentry>
- <varlistentry><term><option>--lld [driver] --op delete --mode target --tid=[id]</option></term>
+ <varlistentry><term><option>--lld <driver> --op delete --mode target --tid <id></option></term>
<listitem>
<para>
- Delete specific target with [id]. The target must have no active I_T nexus.
+ Delete specific target with <id>. The target must have no active I_T nexus.
</para>
</listitem>
</varlistentry>
- <varlistentry><term><option>--lld [driver] --op show --mode target</option></term>
+ <varlistentry><term><option>--lld <driver> --op show --mode target</option></term>
<listitem>
<para>
Show all the targets.
@@ -96,60 +96,60 @@ Possible device-types are:
</listitem>
</varlistentry>
- <varlistentry><term><option>--lld [driver] --op show --mode target --tid=[id]</option></term>
+ <varlistentry><term><option>--lld <driver> --op show --mode target --tid <id></option></term>
<listitem>
<para>
- Show target parameters of a target with [id].
+ Show target parameters of a target with <id>.
</para>
</listitem>
</varlistentry>
- <varlistentry><term><option>--lld [driver] --op new --mode=logicalunit --tid=[id] --lun=[lun] --backing-store [path]</option></term>
+ <varlistentry><term><option>--lld <driver> --op new --mode logicalunit --tid <id> --lun <lun> --backing-store <path></option></term>
<listitem>
<para>
- Add a new logical unit with [lun] to specific target with [id]. The
- logical unit is offered to the initiators. [path] must be block device
+ Add a new logical unit with <lun> to specific target with <id>. The
+ logical unit is offered to the initiators. <path> must be block device
files (including LVM and RAID devices) or regular files. lun0 is
reserved for a special device automatically created.
</para>
</listitem>
</varlistentry>
- <varlistentry><term><option>--lld [driver] --op delete --mode=logicalunit --tid=[id] --lun=[lun]</option></term>
+ <varlistentry><term><option>--lld <driver> --op delete --mode logicalunit --tid <id> --lun <lun></option></term>
<listitem>
<para>
- Delete specific logical unit with [lun] that the target with [id] has.
+ Delete specific logical unit with <lun> that the target with <id> has.
</para>
</listitem>
</varlistentry>
- <varlistentry><term><option>--lld [driver] --op bind --mode=target --tid=[id] --initiator-address=[address]</option></term>
+ <varlistentry><term><option>--lld <driver> --op bind --mode target --tid <id> --initiator-address <address></option></term>
<listitem>
<para>
- Add the address to the access lists of the target with [id]. Initiators
+ Add the address to the access lists of the target with <id>. Initiators
with the address can access to the target. 'ALL' is a special address
to allow all initiators to access to a target.
</para>
</listitem>
</varlistentry>
- <varlistentry><term><option>--lld [driver] --op unbind --mode=target --tid=[id] --initiator-address=[address]</option></term>
+ <varlistentry><term><option>--lld <driver> --op unbind --mode target --tid <id> --initiator-address <address></option></term>
<listitem>
<para>
- Delete the address from the access lists of the target with [id].
+ Delete the address from the access lists of the target with <id>.
</para>
</listitem>
</varlistentry>
- <varlistentry><term><option>--lld [driver] --op update --mode=target --tid=[id] --name=[parameter] --value=[value]</option></term>
+ <varlistentry><term><option>--lld <driver> --op update --mode target --tid <id> --name=<parameter> --value=<value></option></term>
<listitem>
<para>
- Change the value of [parameter] of the target with [id] to [value].
+ Change the value of <parameter> of the target with <id> to <value>.
</para>
</listitem>
</varlistentry>
- <varlistentry><term><option>--lld [driver] --op update --mode=target --tid=[id] --params parameter=value[,...]</option></term>
+ <varlistentry><term><option>--lld <driver> --op update --mode target --tid <id> --params parameter=value<,...></option></term>
<listitem>
<para>
Sets/changes the value of one or more parameters.
@@ -372,11 +372,11 @@ two empty DVD-R disks.
# Create a target
-tgtadm --lld iscsi --mode target --op new --tid 1 -T iqn.2007-03:virtual-dvd:`hostname`
+tgtadm --lld iscsi --mode target --op new --tid 1 --targetname iqn.2007-03:virtual-dvd:`hostname`
# Create a DVD drive and give it a nice name
# The dvd starts out without a backing store file, i.e. no disk loaded
-tgtadm --op new --mode logicalunit --tid 1 --lun 1 -Y cd
+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
# We need a backend store file for the media changer
@@ -385,7 +385,7 @@ if [ ! -f $HOME/smc ]; then
fi
# Create the SMC device and give it a nice name
-tgtadm --lld iscsi --mode logicalunit --op new --tid 1 --lun 2 -b $HOME/smc --device-type=changer
+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
# Add a Data Transfer devices (1 drive)
@@ -416,7 +416,7 @@ 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,sides=1
# Allow ALL initiators to connect to this target
-tgtadm --lld iscsi --mode target --op bind --tid 1 -I ALL
+tgtadm --lld iscsi --mode target --op bind --tid 1 --initiator-address ALL
# Show all our good work.
tgtadm --lld iscsi --mode target --op show
@@ -443,7 +443,7 @@ tgtadm --lld iscsi --mode target --op show
<screen format="linespecific">
Example:
-tgtadm --op update --mode sys --name iSNSServerIP -v 192.168.11.133
+tgtadm --op update --mode sys --name iSNSServerIP --value 192.168.11.133
</screen>
<varlistentry><term><option>iSNS</option></term>
@@ -456,7 +456,7 @@ tgtadm --op update --mode sys --name iSNSServerIP -v 192.168.11.133
<screen format="linespecific">
Example:
-tgtadm --op update --mode sys --name iSNS -v On
+tgtadm --op update --mode sys --name iSNS --value On
</screen>
<varlistentry><term><option>iSNSServerPort</option></term>
@@ -469,7 +469,7 @@ tgtadm --op update --mode sys --name iSNS -v On
<screen format="linespecific">
Example:
-tgtadm --op update --mode sys --name iSNSServerPort -v 3205
+tgtadm --op update --mode sys --name iSNSServerPort --value 3205
</screen>
<varlistentry><term><option>iSNSAccessControl</option></term>
@@ -482,7 +482,7 @@ tgtadm --op update --mode sys --name iSNSServerPort -v 3205
<screen format="linespecific">
Example:
-tgtadm --op update --mode sys --name iSNSAccessControl -v Off
+tgtadm --op update --mode sys --name iSNSAccessControl --value Off
</screen>
</variablelist>
diff --git a/usr/tgtadm.c b/usr/tgtadm.c
index d032aaf..b3f3765 100644
--- a/usr/tgtadm.c
+++ b/usr/tgtadm.c
@@ -138,48 +138,48 @@ static void usage(int status)
printf("\
Linux SCSI Target Framework Administration Utility, version %s\n\
\n\
- --lld [driver] --mode target --op new --tid=[id] --targetname [name]\n\
- add a new target with [id] and [name]. [id] must not be zero.\n\
- --lld [driver] --mode target --op delete --tid=[id]\n\
- delete the specific target with [id]. The target must\n\
+ --lld <driver> --mode target --op new --tid <id> --targetname <name>\n\
+ add a new target with <id> and <name>. <id> must not be zero.\n\
+ --lld <driver> --mode target --op delete --tid <id>\n\
+ delete the specific target with <id>. The target must\n\
have no activity.\n\
- --lld [driver] --mode target --op show\n\
+ --lld <driver> --mode target --op show\n\
show all the targets.\n\
- --lld [driver] --mode target --op show --tid=[id]\n\
+ --lld <driver> --mode target --op show --tid <id>\n\
show the specific target's parameters.\n\
- --lld [driver] --mode target --op update --tid=[id] --name=[param] --value=[value]\n\
+ --lld <driver> --mode target --op update --tid <id> --name <param> --value <value>\n\
change the target parameters of the specific\n\
- target with [id].\n\
- --lld [driver] --mode target --op bind --tid=[id] --initiator-address=[src]\n\
+ target with <id>.\n\
+ --lld <driver> --mode target --op bind --tid <id> --initiator-address <src>\n\
enable the target to accept the specific initiators.\n\
- --lld [driver] --mode target --op unbind --tid=[id] --initiator-address=[src]\n\
+ --lld <driver> --mode target --op unbind --tid <id> --initiator-address <src>\n\
disable the specific permitted initiators.\n\
- --lld [driver] --mode logicalunit --op new --tid=[id] --lun=[lun] \\\n\
- --backing-store=[path] --bstype=[type] --bsoflags=[options]\n\
- add a new logical unit with [lun] to the specific\n\
- target with [id]. The logical unit is offered\n\
- to the initiators. [path] must be block device files\n\
+ --lld <driver> --mode logicalunit --op new --tid <id> --lun <lun> \\\n\
+ --backing-store <path> --bstype <type> --bsoflags <options>\n\
+ add a new logical unit with <lun> to the specific\n\
+ target with <id>. The logical unit is offered\n\
+ to the initiators. <path> must be block device files\n\
(including LVM and RAID devices) or regular files.\n\
bstype option is optional.\n\
bsoflags supported options are sync and direct\n\
(sync:direct for both).\n\
- --lld [driver] --mode logicalunit --op delete --tid=[id] --lun=[lun]\n\
- delete the specific logical unit with [lun] that\n\
- the target with [id] has.\n\
- --lld [driver] --mode account --op new --user=[name] --password=[pass]\n\
- add a new account with [name] and [pass].\n\
- --lld [driver] --mode account --op delete --user=[name]\n\
- delete the specific account having [name].\n\
- --lld [driver] --mode account --op bind --tid=[id] --user=[name] [--outgoing]\n\
- add the specific account having [name] to\n\
- the specific target with [id].\n\
- [user] could be [IncomingUser] or [OutgoingUser].\n\
+ --lld <driver> --mode logicalunit --op delete --tid <id> --lun <lun>\n\
+ delete the specific logical unit with <lun> that\n\
+ the target with <id> has.\n\
+ --lld <driver> --mode account --op new --user <name> --password <pass>\n\
+ add a new account with <name> and <pass>.\n\
+ --lld <driver> --mode account --op delete --user <name>\n\
+ delete the specific account having <name>.\n\
+ --lld <driver> --mode account --op bind --tid <id> --user <name> [--outgoing]\n\
+ add the specific account having <name> to\n\
+ the specific target with <id>.\n\
+ <user> could be <IncomingUser> or <OutgoingUser>.\n\
If you use --outgoing option, the account will\n\
be added as an outgoing account.\n\
- --lld [driver] --mode account --op unbind --tid=[id] --user=[name]\n\
- delete the specific account having [name] from specific\n\
+ --lld <driver> --mode account --op unbind --tid <id> --user <name>\n\
+ delete the specific account having <name> from specific\n\
target.\n\
- --control-port NNNN use control port NNNN\n\
+ --control-port <port> use control port <port>\n\
--help display this help and exit\n\
\n\
Report bugs to <stgt@xxxxxxxxxxxxxxx>.\n", TGT_VERSION);
--
1.7.1.msysgit.0
