summaryrefslogtreecommitdiffstats
path: root/doc/standard-options.xml
blob: 8ae3f8bd3b2cdb4d005034fd5b7c02b8709d7997 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!--
    SPDX-License-Identifier: Apache-2.0
    Copyright (c) 2021, Dell Inc. or its subsidiaries.  All rights reserved.
-->

<variablelist>
  <varlistentry id='help'>
    <term><option>-h</option></term>
    <term><option>--help</option></term>

    <listitem id='help-text'>
      <para>Print the help text and exit.
    </para></listitem>
  </varlistentry>

  <varlistentry id='version'>
    <term><option>--version</option></term>

    <listitem id='version-text'>
      <para>Print the version string and exit.</para>
    </listitem>
  </varlistentry>

  <varlistentry id='tron'>
      <term><command>tron</command></term>
      <listitem>
          <para>Trace ON. Enable code tracing, which is to say that lots of
                debug information will be printed to the syslog
                (e.g. systemd-journal).</para>
      </listitem>
  </varlistentry>

  <varlistentry id='troff'>
      <term><command>troff</command></term>
      <listitem>
          <para>Trace OFF. Disable code tracing.</para>
      </listitem>
  </varlistentry>

  <varlistentry id='status'>
      <term><command>status</command></term>
      <listitem>
          <para>Show runtime status information.</para>
      </listitem>
  </varlistentry>

  <varlistentry id='detailed'>
      <term><option>-d</option></term>
      <term><option>--detailed</option></term>
      <listitem>
          <para>Print additional details.</para>
      </listitem>
  </varlistentry>

  <varlistentry id='transport'>
      <term><option>-tTRTYPE</option></term>
      <term><option>--transport=TRTYPE</option></term>

      <listitem>
          <para>NVMe-over-Fabrics fabric type (default: "tcp").</para>
      </listitem>
  </varlistentry>

  <varlistentry id='traddr'>
      <term><option>-aTRADDR</option></term>
      <term><option>--traddr=TRADDR</option></term>
      <listitem>
          <para>Discovery controller's network address.</para>
      </listitem>
  </varlistentry>

  <varlistentry id='trsvcid'>
      <term><option>-sTRSVCID</option></term>
      <term><option>--trsvcid=TRSVCID</option></term>
      <listitem>
          <para>
              Transport service id (for IP addressing, e.g. tcp, rdma,
              this field is the port number).
          </para>
      </listitem>
  </varlistentry>

  <varlistentry id='host-traddr'>
      <term><option>-wTRADDR</option></term>
      <term><option>--host-traddr=TRADDR</option></term>
      <listitem>
          <para>
              Network source address used on the host to connect to
              the controller.
          </para>
      </listitem>
  </varlistentry>

  <varlistentry id='host-iface'>
      <term><option>-fIFACE</option></term>
      <term><option>--host-iface=IFACE</option></term>
      <listitem>
          <para>
              This field specifies the network interface used on the
              host to connect to the controller.
          </para>
      </listitem>
  </varlistentry>

  <varlistentry id='nqn'>
      <term><option>-nNQN</option></term>
      <term><option>--nqn=NQN</option></term>
      <listitem>
          <para>
              This field specifies the Controller's NVMe Qualified Name.
          </para>
          <para>
              This field is mandatory for I/O Controllers, but is optional for
              Discovery Controllers (DC). For the latter, the NQN will default
              to the well-known DC NQN: <literal>nqn.2014-08.org.nvmexpress.discovery</literal>
              if left undefined.
          </para>
      </listitem>
  </varlistentry>

  <varlistentry id='TRTYPE-value'>
      <term><replaceable>TRTYPE</replaceable></term>
      <listitem>
          <para>rdma, fc, tcp, loop.</para>
      </listitem>
  </varlistentry>

  <varlistentry id='TRADDR-value'>
      <term><replaceable>TRADDR</replaceable></term>
      <listitem>
          <para>IP or Fibre Channel address. E.g. 10.10.0.100.</para>
      </listitem>
  </varlistentry>

  <varlistentry id='TRSVCID-value'>
      <term><replaceable>TRSVCID</replaceable></term>
      <listitem>
          <para>E.g., 8009.</para>
      </listitem>
  </varlistentry>

  <varlistentry id='IFACE-value'>
      <term><replaceable>IFACE</replaceable></term>
      <listitem>
          <para>
              Network interface name. E.g., eth1, enp0s8, wlp0s20f3.
          </para>
      </listitem>
  </varlistentry>

  <varlistentry id='NQN-value'>
      <term><replaceable>NQN</replaceable></term>
      <listitem>
          <para>
              NVMe Qualified Name.
          </para>
      </listitem>
  </varlistentry>

</variablelist>