summary refs log tree commit diff
path: root/man/nmtui.xml
blob: d92f525bcabc73756abfa2a7a592aadd4857def0 (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
<?xml version='1.0'?>
<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY % entities SYSTEM "common.ent" >
%entities;
]>

<!--
  nmtui(1) manual page

  This is free documentation; you can redistribute it and/or
  modify it under the terms of the GNU General Public License as
  published by the Free Software Foundation; either version 2 of
  the License, or (at your option) any later version.

  The GNU General Public License's references to "object code"
  and "executables" are to be interpreted as the output of any
  document formatting or typesetting system, including
  intermediate and printed output.

  This manual is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public Licence along
  with this manual; if not, write to the Free Software Foundation, Inc.,
  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

  Copyright 2010 - 2016 Red Hat, Inc.
-->

<refentry id='nmtui'>

  <refentryinfo>
    <title>nmtui</title>
    <author>NetworkManager developers</author>
  </refentryinfo>

  <refmeta>
    <refentrytitle>nmtui</refentrytitle>
    <manvolnum>1</manvolnum>
    <refmiscinfo class="source">NetworkManager</refmiscinfo>
    <refmiscinfo class="manual">General Commands Manual</refmiscinfo>
    <refmiscinfo class="version">&NM_VERSION;</refmiscinfo>
  </refmeta>

  <refnamediv>
    <refname>nmtui</refname>
    <refpurpose>Text User Interface for controlling NetworkManager</refpurpose>
  </refnamediv>

  <refsynopsisdiv id='synopsis'>
    <cmdsynopsis>
      <command><group choice='plain'>
        <arg choice='plain'>nmtui-edit</arg>
        <arg choice='plain'>nmtui edit</arg>
      </group></command>
      <arg choice='plain'>
        <group choice='req'>
          <arg choice='plain'><replaceable>name</replaceable></arg>
          <arg choice='plain'><replaceable>id</replaceable></arg>
        </group>
      </arg>
    </cmdsynopsis>
    <cmdsynopsis>
      <command><group choice='plain'>
        <arg choice='plain'>nmtui-connect</arg>
        <arg choice='plain'>nmtui connect</arg>
      </group></command>
      <arg choice='plain'>
        <group choice='req'>
          <arg choice='plain'><replaceable>name</replaceable></arg>
          <arg choice='plain'><replaceable>uuid</replaceable></arg>
          <arg choice='plain'><replaceable>device</replaceable></arg>
          <arg choice='plain'><replaceable>SSID</replaceable></arg>
        </group>
      </arg>
    </cmdsynopsis>
    <cmdsynopsis>
      <command><group choice='plain'>
        <arg choice='plain'>nmtui-hostname</arg>
        <arg choice='plain'>nmtui hostname</arg>
      </group></command>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1 id='description'><title>Description</title>
    <para><command>nmtui</command> is a curses‐based TUI application for
    interacting with NetworkManager. When starting <command>nmtui</command>, the
    user is prompted to choose the activity to perform unless it was specified as
    the first argument.</para>

    <para>The supported activities are:</para>

    <variablelist>
      <varlistentry>
        <term><option>edit</option></term>
        <listitem>
          <para>Show a connection editor that supports adding, modifying, viewing and
          deleting connections. It provides similar functionality as
          <command>nm-connection-editor</command>.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>connect</option></term>
        <listitem>
          <para>Show a list of available connections, with the option to activate or
          deactivate them. It provides similar functionality as
          <command>nm-applet</command>.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>hostname</option></term>
        <listitem>
          <para>Set the system hostname.</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para>Corresponding to above activities, <command>nmtui</command> also comes
    with binaries named <command>nmtui-edit</command>,
    <command>nmtui-connect</command>, and <command>nmtui-hostname</command> to skip
    the selection of the activities.</para>
  </refsect1>

  <refsect1 id='see_also'><title>See Also</title>
    <para><citerefentry><refentrytitle>nmcli</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
    <citerefentry><refentrytitle>nm-applet</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
    <citerefentry><refentrytitle>nm-connection-editor</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
    <citerefentry><refentrytitle>NetworkManager</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
  </refsect1>

</refentry>