On Wed, 31 Mar 2010 16:50:55 +1100 ronnie sahlberg <ronniesahlberg@xxxxxxxxx> wrote: > Oh, sorry. no. Please ignore the whitespace changes to tgt-admin manpage. No problem. I've merged the following patch about iSNS part. Please send a patch against the git head if tgt-admin needs more updates. Thanks! = From: Ronnie Sahlberg <ronniesahlberg@xxxxxxxxx> Subject: [PATCH] doc: document how to configure iSNS via tgtadm Signed-off-by: Ronnie Sahlberg <ronniesahlberg@xxxxxxxxx> Signed-off-by: FUJITA Tomonori <fujita.tomonori@xxxxxxxxxxxxx> --- doc/htmlpages/tgtadm.8.html | 19 ++++++++++--- doc/manpages/tgtadm.8 | 61 ++++++++++++++++++++++++++++++++++++++++- doc/tgtadm.8.xml | 63 +++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 137 insertions(+), 6 deletions(-) diff --git a/doc/htmlpages/tgtadm.8.html b/doc/htmlpages/tgtadm.8.html index 9b9c73c..673c8d8 100644 --- a/doc/htmlpages/tgtadm.8.html +++ b/doc/htmlpages/tgtadm.8.html @@ -1,7 +1,7 @@ -<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 [--control-port NNNN] --lld [driver] --op [operation] --mode [mode] [OPTION]...</code> </p></div></div><div class="refsect1" lang="en"><a name="id2475961"></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.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 [--control-port NNNN] --lld [driver] --op [operation] --mode [mode] [OPTION]...</code> </p></div></div><div class="refsect1" lang="en"><a name="id2476012"></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="id2475972"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term"><code class="option">--control-port NNNN</code></span></dt><dd><p> + </p></div><div class="refsect1" lang="en"><a name="id2476023"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term"><code class="option">--control-port NNNN</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. @@ -32,9 +32,20 @@ display version and exit. </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="id2476171"></a><h2>SEE ALSO</h2><p> + </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2476223"></a><h2>iSNS</h2><p> + iSNS configuration for a target is by using the tgtadm command. + </p><div class="variablelist"><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. + </p></dd><dt><span class="term"><code class="option">iSNS</code></span></dt><dd><p> + This setting enables(on)/disables(off) iSNS. + </p></dd><dt><span class="term"><code class="option">iSNSServerPort</code></span></dt><dd><p> + 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="id2476322"></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="id2476186"></a><h2>REPORTING BUGS</h2><p> + </p></div><div class="refsect1" lang="en"><a name="id2476336"></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 92fef89..7b9a708 100644 --- a/doc/manpages/tgtadm.8 +++ b/doc/manpages/tgtadm.8 @@ -1,11 +1,11 @@ .\" Title: tgtadm .\" Author: .\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/> -.\" Date: 03/04/2010 +.\" Date: 03/31/2010 .\" Manual: .\" Source: .\" -.TH "TGTADM" "8" "03/04/2010" "" "" +.TH "TGTADM" "8" "03/31/2010" "" "" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -79,6 +79,63 @@ display version and exit\. .RS 4 display a list of available options and exits\. .RE +.SH "ISNS" +.PP +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\. +.sp +.RS 4 +.nf +Example: + +tgtadm \-\-op update \-\-mode sys \-\-name iSNSServerIP \-v 192\.168\.11\.133 + +.fi +.RE +.RE +.PP +\fBiSNS\fR +.RS 4 +This setting enables(on)/disables(off) iSNS\. +.sp +.RS 4 +.nf +Example activating iSNS once configured: + +tgtadm \-\-op update \-\-mode sys \-\-name iSNS \-v On + +.fi +.RE +.RE +.PP +\fBiSNSServerPort\fR +.RS 4 +This setting specifies the port to use for iSNS\. +.sp +.RS 4 +.nf +Example: + +tgtadm \-\-op update \-\-mode sys \-\-name iSNSServerPort \-v 3205 + +.fi +.RE +.RE +.PP +\fBiSNSAccessControl\fR +.RS 4 +Enable/disable access control for iSNS\. +.sp +.RS 4 +.nf +tgtadm \-\-op update \-\-mode sys \-\-name iSNSAccessControl \-v Off + +.fi +.RE +.RE .SH "SEE ALSO" .PP tgtd(8), tgt\-admin(8), tgtimg(8), tgt\-setup\-lun(8)\. diff --git a/doc/tgtadm.8.xml b/doc/tgtadm.8.xml index 22d96f1..7a53e4f 100644 --- a/doc/tgtadm.8.xml +++ b/doc/tgtadm.8.xml @@ -137,6 +137,69 @@ </variablelist> </refsect1> + <refsect1><title>iSNS</title> + <para> + iSNS configuration for a target is by using the tgtadm command. + </para> + <variablelist> + + <varlistentry><term><option>iSNSServerIP</option></term> + <listitem> + <para> + This specifies the IP address of the iSNS server. TGTD only + supprots one iSNS server. + </para> + </listitem> + <screen format="linespecific"> +Example: + +tgtadm --op update --mode sys --name iSNSServerIP -v 192.168.11.133 + </screen> + </varlistentry> + + <varlistentry><term><option>iSNS</option></term> + <listitem> + <para> + This setting enables(on)/disables(off) iSNS. + </para> + </listitem> + <screen format="linespecific"> +Example activating iSNS once configured: + +tgtadm --op update --mode sys --name iSNS -v On + </screen> + </varlistentry> + + <varlistentry><term><option>iSNSServerPort</option></term> + <listitem> + <para> + This setting specifies the port to use for iSNS. + </para> + </listitem> + <screen format="linespecific"> +Example: + +tgtadm --op update --mode sys --name iSNSServerPort -v 3205 + </screen> + </varlistentry> + + <varlistentry><term><option>iSNSAccessControl</option></term> + <listitem> + <para> + Enable/disable access control for iSNS. + </para> + </listitem> + <screen format="linespecific"> +tgtadm --op update --mode sys --name iSNSAccessControl -v Off + </screen> + </varlistentry> + + </variablelist> + + + </refsect1> + + <refsect1><title>SEE ALSO</title> <para> tgtd(8), tgt-admin(8), tgtimg(8), tgt-setup-lun(8). -- 1.7.0 -- To unsubscribe from this list: send the line "unsubscribe stgt" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html