CONFIGNETIF(1M)                                                CONFIGNETIF(1M)



NAME
     configNetIf - configure the network interfaces

SYNOPSIS
     /usr/sysadm/privbin/configNetIf [-i <interface>] [-p] [-h <hostname>] [-a
     <IP address>] [-m <netmask>] [-r <metric>] [-d on|off] [-n] [up|down]

DESCRIPTION
     configNetIf configures the network interfaces on the system. This command
     not only updates the given network interface, but also updates relevant
     system files. This command is used by the Set Up and Start Networking and
     Turn Off Networking tasks.


OPTIONS
     -i <interface>
          The network interface ( ec0, ec1, ... ). This should be a valid
          interface name on the system. For a list of all the network
          interfaces on the system, use, netstat -i. configNetIf quits with a
          non-zero error number if the given <interface> name is invalid. lo0
          is not a valid interface.

     -p   Primary interface. configNetIf allows operations on the primary
          interface if the <interface> is not passed in. If the command is
          invoked with both the arguments, it sets the current <interface> to
          be the primary interface. By default, if no <interface> name or -p
          options are passed in, then, configNetIf assumes the primary
          interface.

     -h <hostname>
          The hostname. configNetIf configures the given network interface
          with the passed in <hostname>, after validating the name. If the
          interface is the primary interface, it updates the /etc/sys_id file
          along with updating the /etc/hosts database.

     -a <IP address>
          The IP address. configNetIf configures the given network interface
          with the passed in <IP address>, after validating the address. If
          the interface is the primary interface, it updates nvram netaddr,
          along with updating the /etc/hosts database.

     -m <netmask>
          The Sub netmask. configNetIf configures the given network interface
          with the passed in <netmask>, after validating the netmask. For more
          information on the netmask, see ifconfig(1M).

     -r <metric>
          The Routing Metric. Set the interface routing metric to <metric>.
          The default is 0.






                                                                        Page 1

CONFIGNETIF(1M)                                                CONFIGNETIF(1M)



     -d on|off
          Let the DHCP client configure this interface.  If not specified,
          default is off.

     -n   Restart the network after making the changes.  This has the effect
          of killing any applications with files open on a network file system
          or current working directories in network file system.  If this
          switch is not used, the system will not be fully configured until
          the network is restarted (such as with a reboot).

     up|down
          The network interface state. Currently, if no interface is
          specified, the command turns on or off the system networking state (
          chkconfig(1M) ).


FILES
     /etc/hosts                       The local hosts database.
     /etc/config/network              The network configuration file.
     /etc/sys_id                      The hostname.
     /var/yp/ypdomain                 The domain name.
     /etc/config/netif.options        The network interface definitions file.
     /etc/config/ifconfig-*.options   The network interface configurations
                                      file.
     /etc/init.d/network              The network script that is executed at
                                      the end of a successful run of the
                                      command.
     /etc/config/network              The network configuration file

SEE ALSO
     sysmgr(1M)                       The System Manager
     NetIfManager(1M)                 The Network Interface Manager

     runpriv(1M), ifconfig(1M), netstat(1), chkconfig(1M),
     network(1M), nvram(1M), hosts(4)




















                                                                        Page 2