iscsi tools: fix iscsiadm return value on failed login
[open-iscsi.git] / doc / iscsi_discovery.8
bloba4affc68a342a2277fe86cb3b362a534e5e4630a
1 .de Vb \" Begin verbatim text
2 .ft CW
3 .nf
4 .ne \\$1
5 ..
7 .TH "iscsi_discovery" 8
8 .SH NAME
9 iscsi_discovery \- discover iSCSI targets
10 .SH SYNOPSIS
11 .B iscsi_discovery <IP> [-p <port>] [-d] [-t <tcp|iser> [-f]] [-m] [-l]
13 .SH DESCRIPTION
14 Perform send-targets discovery to the specified IP. If a discovery record
15 is generated, try to login to the portal using the preferred transport
16 (\-t flag specifies the requested transport type, TCP is the default).
17 If login using a certain transport succeeds, mark the portal for automatic
18 login (unless \-m flag is used), and disconnect (unless \-l flag is used).
20 For iSCSI discovery to work, open-iscsi services must be running. i.e. iscsid
21 should be up, and the iSCSI modules loaded. This is best accomplished by the
22 init.d startup script.
24 .\" .SH OPTIONS
25 .TP
26 .BI [-p=]\fIport\-number\fP
27 set the port number (defualt is 3260).
28 .TP
29 .BI [-d]
30 print debugging information.
31 .TP
32 .BI [-t=]\fItransport\-type\fP
33 set transport (default is tcp).
34 .TP
35 .BI [-f]
36 force specific transport -
37 disable the fallback to tcp (default is fallback enabled).
38 force the transport specified by the argument of the \-t flag.
40 .TP
41 .BI [-m]
42 manual startup - will set manual startup (default is automatic startup).
43 .TP
44 .BI [-l]
45 login - login to the new discovered nodes (defualt is false).
47 .SH AUTHOR
48 Written by Dan Bar Dov
49 .SH "REPORTING BUGS"
50 Report bugs to <erezzi.list@gmail.com>.
51 .SH COPYRIGHT
52 Copyright \(co Voltaire Ltd. 2006.