SMTCONFIG(1M)                                                    SMTCONFIG(1M)


NAME
     smtconfig - configure or display FDDI interface parameters

SYNOPSIS
     /usr/etc/smtconfig interface [address_family] [address] [parameters]
     /usr/etc/smtconfig interface

DESCRIPTION
     smtconfig is used to configure FDDI network interfaces.  smtconfig is
     invoked at boot time from /etc/init.d/network to define the network
     address of each FDDI interface present on a machine. You may also use it
     once the system is up to redefine an interface's address or other
     operating parameters.

     The interface parameter is a string of the form ``name unit'', for
     example, ``ipg0''.  Use smtstat(1) or netstat(1) to display the names of
     FDDI interfaces on the machine.

     Since an interface may receive transmissions in differing protocols, each
     of which may require separate naming schemes, it is necessary to specify
     the address_family, which may change the interpretation of the remaining
     parameters.  Currently, just the ``inet'' address family is supported.

     For the Internet family, the address is either an Internet address
     expressed in the Internet standard ``dot notation'' (see inet(3N)), or a
     host name present in the hosts(4) file, /etc/hosts.  (Other hosts
     databases, such as named and NIS, are ignored.)

     Only the superuser may modify the configuration of a network interface.

     The following parameters may be set with smtconfig:

     up             Mark an interface ``up''. This parameter may be used to
                    enable an interface after an ``smtconfig down.''  It
                    happens automatically when setting the first address on an
                    interface.  If the interface was reset when previously
                    marked down, the hardware will be re-initialized.

     down           Mark an interface ``down''.  When an interface is marked
                    ``down'', the system will not attempt to transmit messages
                    through that interface. If possible, the interface will be
                    reset to disable reception as well.  This action does not
                    automatically disable routes using the interface.

     arp            Enable the use of the Address Resolution Protocol in
                    mapping between network level addresses and link level
                    addresses (default). This is currently implemented for
                    mapping between Internet addresses and FDDI MAC addresses.

     -arp           Disable the use of the Address Resolution Protocol.


     metric n       Set the routing metric of the interface to n, default 0.
                    The routing metric is used by the routing protocol
                    (routed(1m)).  Higher metrics have the effect of making a
                    route less favorable; metrics are counted as addition hops
                    to the destination network or host.

     netmask mask   Specify how much of the address to reserve for subdividing
                    networks into subnetworks.  The mask includes the network
                    part of the local address and the subnet part, which is
                    taken from the host field of the address.  The mask can be
                    specified as a single hexadecimal number with a leading
                    0x, with a dot-notation Internet address, or with a
                    pseudo-network name listed in the network table
                    networks(4).  The mask contains 1s for the bit positions
                    in the 32-bit address which are to be used for the network
                    and subnet parts, and 0s for the host part.  The mask
                    should contain at least the standard network portion, and
                    the subnet field should be contiguous with the network
                    portion.

     broadcast      Specify the address to use to represent broadcasts to the
                    network.  The default broadcast address is the address
                    with a host part of all 1s.

     debug          Enable driver-dependent debugging code; usually, this
                    turns on extra console error logging.

     -debug         Disable driver-dependent debugging code.

     primary        Select an interface as the primary network interface for
                    this host.

     smtconfig displays the current configuration for a network interface when
     no optional parameters are supplied.  If a protocol family is specified,
     smtconfig will report only the details specific to that protocol family.

DIAGNOSTICS
     Messages that indicate the specified interface does not exist, the
     requested address is unknown, or the user is not privileged if trying to
     alter an interface's configuration.

FILES
     /etc/hosts     host-address database

SEE ALSO
     smtstat(1), fddi(7m), network(1M), inet(3N)


                                                                        Page 2