10139N/A<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
10139N/A<!--ArborText, Inc., 1988-1999, v.4002-->
16011N/A<!--ARC : LSARC 2006/350 GNOME System Tools-->
10139N/A<!ENTITY cmd "network-admin">
10139N/A<!ENTITY % commonents SYSTEM "smancommon.ent">
10139N/A%commonents;
10139N/A<!ENTITY % booktitles SYSTEM "booktitles.ent">
10139N/A%booktitles;
10139N/A<!ENTITY suncopy "Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved.">
10139N/A]>
10139N/A<?Pub UDT _bookmark _target>
10139N/A<?Pub Inc>
10139N/A<refentry id="network-admin-1">
10139N/A<!-- %Z%%M% %I% %E% SMI; -->
10139N/A<refmeta><refentrytitle>network-admin</refentrytitle><manvolnum>1</manvolnum>
10139N/A<refmiscinfo class="date">6 Nov 2006</refmiscinfo>
10139N/A<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
10139N/A<refmiscinfo class="software">&release;</refmiscinfo>
10139N/A<refmiscinfo class="arch">generic</refmiscinfo>
10139N/A<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
10139N/A</refmeta>
10139N/A<indexterm><primary>network-admin</primary></indexterm>
10139N/A<indexterm><primary>Basic administration of network interfaces.</primary></indexterm>
10139N/A
10139N/A<refnamediv id="network-admin-1-name">
10139N/A <refname>network-admin</refname>
10139N/A <refpurpose>Basic administration of network interfaces.</refpurpose>
10139N/A</refnamediv>
10139N/A
10139N/A<refsynopsisdiv id="network-admin-1-synp">
10139N/A <title>&synp-tt;</title>
10139N/A <cmdsynopsis>
10139N/A <command>&cmd;</command>
10139N/A <arg choice="opt"><option>-configure=<replaceable>INTERFACE</replaceable></option></arg>
10139N/A <arg choice="opt"><option>-configure-type=<replaceable>TYPE</replaceable></option></arg>
10139N/A <arg><option role="nodash"><replaceable>gnome-std-options</replaceable></option></arg>
10139N/A </cmdsynopsis>
10139N/A</refsynopsisdiv>
10139N/A
10139N/A<refsect1 id="network-admin-1-desc">
10139N/A <title>&desc-tt;</title>
10139N/A <para><command>&cmd;</command> enumerates the interfaces available to the user and provides a mechanism for configuring these interfaces as static-IP or DHCP. It's also possible to select which interfaces should be enabled on boot.</para>
10139N/A <para><command>&cmd;</command> also allows you configure the systems hostname, DNS options and hosts using the user interface.</para>
10139N/A</refsect1>
10139N/A
10139N/A<refsect1 id="network-admin-1-opts">
10139N/A <title>&opts-tt;</title>
10139N/A <para>The following options are supported:</para>
10139N/A <variablelist termlength="wide">
10139N/A <varlistentry>
11925N/A <term><option>c, --configure=<replaceable>INTERFACE</replaceable></option></term>
10139N/A <listitem>
10139N/A <para>Configure a specific network interface (e.g. ath0 or bge0).</para>
10139N/A </listitem>
10139N/A </varlistentry>
10139N/A <varlistentry>
11925N/A <term><option>t, --configure-type=<replaceable>TYPE</replaceable></option></term>
10139N/A <listitem>
10139N/A <para>Configure the first network interface of a specific type (e.g. ethernet or wireless).</para>
10139N/A </listitem>
10139N/A </varlistentry>
10139N/A <varlistentry>
10139N/A <term><option role="nodash"><replaceable>gnome-std-options</replaceable></option></term>
10139N/A <listitem>
10139N/A <para>Standard options available for use with most GNOME applications. See <citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry> for more information.</para>
10139N/A </listitem>
10139N/A </varlistentry>
10139N/A </variablelist>
10139N/A</refsect1>
10139N/A<refsect1 id="network-admin-1-exam">
10139N/A <title>&exam-tt;</title>
10139N/A <example role="example">
10139N/A <title>Running the main application.</title>
10139N/A <para><screen>example% <userinput>&cmd;</userinput></screen></para>
10139N/A </example>
10139N/A <example role="example">
10139N/A <title>Configuring the ath0 network interface.</title>
10139N/A <para><screen>example% <userinput>&cmd; --configure=ath0</userinput></screen></para>
10139N/A </example>
10139N/A <example role="example">
10139N/A <title>Configuring the first ethernet interface.</title>
10139N/A <para><screen>example% <userinput>&cmd; --configure-type=ethernet</userinput></screen></para>
10139N/A </example>
10139N/A</refsect1>
10139N/A
10139N/A<refsect1 id="network-admin-1-exit"><title>&exit-tt;</title>
10139N/A<para>The following exit values are returned:</para>
10139N/A<variablelist termlength="xtranarrow">
10139N/A <varlistentry>
10139N/A <term><returnvalue>0</returnvalue></term>
10139N/A <listitem><para>Application exited successfully</para></listitem>
10139N/A </varlistentry>
10139N/A <varlistentry>
10139N/A <term><returnvalue>&gt;0</returnvalue></term>
10139N/A <listitem><para>Application exited with failure</para></listitem>
10139N/A </varlistentry>
10139N/A</variablelist></refsect1>
10139N/A
10139N/A<refsect1 id="network-admin-1-file">
10139N/A <title>&file-tt;</title>
10139N/A <para>The following files are used by this application:</para>
10139N/A <variablelist termlength="wide">
10139N/A <varlistentry>
10139N/A <term><filename>/usr/bin/&cmd;</filename></term>
10139N/A <listitem>
10139N/A <para>Executable for network interface configuration.</para>
10139N/A </listitem>
10139N/A </varlistentry>
10139N/A <varlistentry>
10139N/A <term><filename>/etc/inet/gnome-system-tools</filename></term>
10139N/A <listitem>
10139N/A <para>Storage location for network configuration files when not active on boot.</para>
10139N/A </listitem>
10139N/A </varlistentry>
10139N/A <varlistentry>
10139N/A <term><filename>/var/spool/setup-tool-backends/backup/network</filename></term>
10139N/A <listitem>
10139N/A <para></para>
10139N/A <para>Backup directory for files that are modified.</para>
10139N/A </listitem>
10139N/A </varlistentry>
10139N/A <varlistentry>
10139N/A <term><filename>/var/spool/setup-tool-backends/data/network</filename></term>
10139N/A <listitem>
10139N/A <para></para>
10139N/A <para>Where "Location" profiles are stored.</para>
10139N/A </listitem>
10139N/A </varlistentry>
10139N/A <varlistentry>
10139N/A <term><filename>/var/run/setup-tool-backends/debug/network</filename></term>
10139N/A <listitem>
10139N/A <para></para>
10139N/A <para>Debug logs can be found under here.</para>
10139N/A </listitem>
10139N/A </varlistentry>
10139N/A </variablelist>
10139N/A</refsect1>
10139N/A
10139N/A<refsect1 id="network-admin-1-attr">
10139N/A <title>&attr-tt;</title>
10139N/A <para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink> for descriptions of the following attributes:</para>
10139N/A <informaltable frame="all">
10139N/A <tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
10139N/A <colspec colname="COLSPEC1" colwidth="1*">
10139N/A <thead>
10139N/A <row>
10139N/A <entry align="center" valign="middle">ATTRIBUTE TYPE</entry>
10139N/A <entry align="center" valign="middle">ATTRIBUTE VALUE</entry>
10139N/A </row>
10139N/A </thead>
10139N/A <tbody>
10139N/A <row>
10139N/A <entry><para>Availability</para></entry>
18745N/A <entry><para>desktop/administration/gnome-system-tools</para></entry>
10139N/A </row>
10139N/A <row>
10139N/A <entry colname="COLSPEC0"><para>Interface stability</para></entry>
10139N/A <entry colname="COLSPEC1"><para>Uncommitted</para></entry>
10139N/A </row>
10139N/A </tbody>
10139N/A </tgroup>
10139N/A </informaltable>
10139N/A</refsect1>
10139N/A
10139N/A<refsect1 id="network-admin-1-also">
10139N/A <title>&also-tt;</title>
10139N/A <!--Reference to another man page-->
10139N/A <!--Reference to a Help manual-->
10139N/A <!--Reference to a book.-->
10139N/A
10139N/A <para>Latest version of the <citetitle>GNOME Desktop User Guide</citetitle> for your platform.</para>
10139N/A
10139N/A<para>
10139N/A<citerefentry><refentrytitle>users-admin</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>shares-admin</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>services-admin</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>time-admin</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>ifconfig</refentrytitle><manvolnum>1M</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>hosts</refentrytitle><manvolnum>4</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>nsswitch.conf</refentrytitle><manvolnum>4</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>resolv.conf</refentrytitle><manvolnum>4</manvolnum></citerefentry>,
10139N/A<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>
10139N/A</refsect1>
10139N/A
10139N/A<refsect1 id="network-admin-1-note"><title>&note-tt;</title>
10139N/A <para>This tool can only be used to manage physical network devices as returned by the "dladm show-dev" command, it does not support configuration of more complex configurations.</para>
10139N/A <para>There is currently no support for enterprise name services such as YP/NIS, NIS+ or LDAP. There is also no support for anything but the global zone.</para>
10139N/A <para></para>
11933N/A <para>Written by Darren Kenny, Sun Microsystems Inc., 2006.</para>
10139N/A</refsect1>
10139N/A
10139N/A</refentry>
10139N/A
10139N/A