about summary refs log tree commit diff
path: root/man/nmcli.xml
diff options
context:
space:
mode:
authorMichael Biebl <biebl@debian.org>2017-05-11 14:55:55 +0200
committerMichael Biebl <biebl@debian.org>2017-05-11 14:55:55 +0200
commitc333f062ddcba9b35330647bf6cbd0a07f2d786e (patch)
tree257c3a0c74c09f4ad2328eab5b932806405f0c1c /man/nmcli.xml
parenta222e56e103f949b148a6942e385ccca2c26d9f3 (diff)
New upstream version 1.8.0 upstream/1.8.0
Diffstat (limited to 'man/nmcli.xml')
-rw-r--r--man/nmcli.xml29
1 files changed, 25 insertions, 4 deletions
diff --git a/man/nmcli.xml b/man/nmcli.xml
index d7610c8c..8ee7914b 100644
--- a/man/nmcli.xml
+++ b/man/nmcli.xml
@@ -205,10 +205,30 @@
           command. <literal>common</literal> is used to print common field values of
           the command.</para>
 
-          <para>If omitted, default is <literal>common</literal>. The option is
-          mandatory when <option>--terse</option> is used. In this case, generic values
-          <literal>all</literal> and <literal>common</literal> cannot be used. This
-          is to maintain compatibility when new fields are added in the future.</para>
+          <para>If omitted, default is <literal>common</literal>.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><group choice='plain'>
+          <arg choice='plain'><option>-g</option></arg>
+          <arg choice='plain'><option>--get-values</option></arg>
+          <group choice='req'>
+            <arg choice='plain' rep='repeat'><replaceable>field1</replaceable>,<replaceable>field2</replaceable></arg>
+            <arg choice='plain'>all</arg>
+            <arg choice='plain'>common</arg>
+          </group>
+        </group></term>
+
+        <listitem>
+          <para>This option is used to print values from specific fields. It is basically
+          a shortcut for <literal>--mode tabular --terse --fields</literal> and is a convenient
+          way to retrieve values for particular fields. The values are printed one per line
+          without headers.</para>
+
+          <para>If a section is specified instead of a field, the section name will be printed
+          followed by colon separated values of the fields belonging to that section, all on
+          the same line.</para>
         </listitem>
       </varlistentry>
 
@@ -925,6 +945,7 @@
             <listitem><para><literal>ip-tunnel</literal></para></listitem>
             <listitem><para><literal>macvlan</literal></para></listitem>
             <listitem><para><literal>vxlan</literal></para></listitem>
+            <listitem><para><literal>dummy</literal></para></listitem>
           </itemizedlist>
 
           <para>The most typical uses are described in the <link linkend='examples' endterm='examples.title' /> section.</para>