@@ -0,0 +1,134 @@
<?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">
<!--
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" > 1.2</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>