[stgt] [PATCH 1/1] Document how to set up iSNS via tgtadm
FUJITA Tomonori
fujita.tomonori at lab.ntt.co.jp
Wed Mar 31 08:03:10 CEST 2010
On Wed, 31 Mar 2010 16:50:55 +1100
ronnie sahlberg <ronniesahlberg at gmail.com> 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 at gmail.com>
Subject: [PATCH] doc: document how to configure iSNS via tgtadm
Signed-off-by: Ronnie Sahlberg <ronniesahlberg at gmail.com>
Signed-off-by: FUJITA Tomonori <fujita.tomonori at lab.ntt.co.jp>
---
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 at vger.kernel.org>
</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 at vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
More information about the stgt
mailing list