Module Name: othersrc
Committed By: wiz
Date: Mon Aug 8 19:54:51 UTC 2011
Modified Files:
othersrc/external/bsd/iscsi/sbin/iscsictl: iscsictl.8
Log Message:
Try to fix a sentence. New sentence, new line.
Add a comment where the example is unclear. Use more markup.
To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 othersrc/external/bsd/iscsi/sbin/iscsictl/iscsictl.8
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: othersrc/external/bsd/iscsi/sbin/iscsictl/iscsictl.8
diff -u othersrc/external/bsd/iscsi/sbin/iscsictl/iscsictl.8:1.2 othersrc/external/bsd/iscsi/sbin/iscsictl/iscsictl.8:1.3
--- othersrc/external/bsd/iscsi/sbin/iscsictl/iscsictl.8:1.2 Mon Aug 8 07:22:12 2011
+++ othersrc/external/bsd/iscsi/sbin/iscsictl/iscsictl.8 Mon Aug 8 19:54:51 2011
@@ -1,4 +1,4 @@
-.\" $NetBSD: iscsictl.8,v 1.2 2011/08/08 07:22:12 dholland Exp $
+.\" $NetBSD: iscsictl.8,v 1.3 2011/08/08 19:54:51 wiz Exp $
.\"
.\" Copyright (c) 2011 Alistair Crooks <[email protected]>
.\" All rights reserved.
@@ -33,8 +33,8 @@
.Nm
.Op Fl v
.Op Fl d Ar directory
-command
-.Op Ar arguments...
+.Ar command
+.Op Ar arguments ...
.Sh DESCRIPTION
The
.Nm
@@ -57,9 +57,7 @@
The initiator can then issue commands to
and read responses from the target.
.Pp
-.\" XXX what does this mean?
-Firstly, a TCP connection
-the iSCSI initiator on the local machine must be made
+Firstly, the iSCSI initiator on the local machine must be made
aware of the network location of the target.
The
.Dv add_send_target
@@ -72,8 +70,7 @@
To login from the initiator to the target, the
.Dv login
command is used; this creates a session between the initiator and target.
-The sessions can be listed by using
-the
+The sessions can be listed by using the
.Dv list_sessions
command.
.Pp
@@ -96,17 +93,18 @@
.Dq OK
value is printed.
For more context on the exact usage of this
-command, please ee the worked example below.
+command, please see the example below.
.It list_targets
.It add_send_target
this command allows the iSCSI initiator to connect to an iSCSI
-target. The subsequent
+target.
+The subsequent
.Fl a
target provides the address of the target.
This can be provided as a numerical IP address,
or as a textual FQDN.
For more context on the exact usage of this
-command, please see the worked example below.
+command, please see the example below.
.It remove_send_target
.It list_send_targets
.It add_isns_server
@@ -116,16 +114,17 @@
.It refresh_isns
.It login
To be able to communicate with the iSCSI target, the initiator
-must login. This command allows this login to take place.
+must login.
+This command allows this login to take place.
The subsequent
-.Fl P session
+.Fl P Ar session
argument provides the session which should be used to
perform the login.
On successful completion of this command, the
session which has been created will be displayed, along with the connection
number.
For more context on the exact usage of this
-command, please see the worked example below.
+command, please see the example below.
.It logout
.It add_connection
.It remove_connection
@@ -141,7 +140,7 @@
To list the session information, this command is used.
The session number and target information for each of the targets are displayed.
For more context on the exact usage of this
-command, please see the worked example below.
+command, please see the example below.
.It set_node_name
.El
.Sh EXAMPLES
@@ -168,6 +167,7 @@
Created Session 2, Connection 1
burner# iscsictl list_sessions
Session 2: Target iqn.1994-04.org.netbsd.iscsi-target:target0
+.\" how do we know that it was assigned sd0?
burner# newfs /dev/rsd0a
/dev/rsd0a: 100.0MB (204800 sectors) block size 8192, fragment size 1024
using 4 cylinder groups of 25.00MB, 3200 blks, 6144 inodes.
