Annotation of cci/usr/src/man/man8/ifconfig.8c, revision 1.1.1.1

1.1       root        1: .TH IFCONFIG 8C "28 August 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: ifconfig \- configure network interface parameters
                      5: .SH SYOPNSIS
                      6: .B /etc/ifconfig
                      7: interface
                      8: [
                      9: .I address
                     10: ] [
                     11: .I parameters
                     12: ]
                     13: .SH DESCRIPTION
                     14: .I Ifconfig
                     15: is used to assign an address
                     16: to a network interface and/or configure
                     17: network interface parameters.
                     18: .I Ifconfig
                     19: must be used at boot time to define the network address
                     20: of each interface present on a machine; it may also be used at
                     21: a later time to redefine an interface's address. 
                     22: For the Ethernet network, the network interface must be assigned with both
                     23: Internet and Ethernet station addresses using this command.
                     24: .PP 
                     25: The
                     26: .I interface
                     27: parameter is a string of the form 'name unit', e.g. 'en0'.
                     28: .PP
                     29: The 
                     30: .I address 
                     31: parameter could be one of the following types:
                     32: .IP -
                     33: a host name in the file
                     34: .I /etc/hosts, 
                     35: or 
                     36: .IP -
                     37: a network name in the file
                     38: .I /etc/networks, 
                     39: or
                     40: .IP -
                     41: a DARPA Internet address expressed in the Internet standard
                     42: "dot notation", or 
                     43: .IP - 
                     44: an Ethernet station address whose format is
                     45: Ex.x.x.x.x.x where x is a 
                     46: .I hexadecimal 
                     47: number.
                     48: .PP
                     49: .I Ifconfig
                     50: determines the address type by the sequence of the above list.
                     51: The address names can not be any of the parameters described below.
                     52: .PP
                     53: The following parameters may be set with 
                     54: .IR ifconfig :
                     55: .TP 15
                     56: .B up
                     57: Mark an interface ``up''. 
                     58: .TP 15
                     59: .B down
                     60: Mark an interface ``down''.  When an interface is
                     61: marked ``down'', the system will not attempt to
                     62: transmit messages through that interface. 
                     63: .TP 15
                     64: .B trailers
                     65: Enable the use of a ``trailer'' link level encapsulation when
                     66: sending (default).
                     67: If a network interface supports
                     68: .IR trailers ,
                     69: the system will, when possible, encapsulate outgoing
                     70: messages in a manner which minimizes the number of
                     71: memory to memory copy operations performed by the receiver.
                     72: .TP 15
                     73: .B \-trailers
                     74: Disable the use of a ``trailer'' link level encapsulation.
                     75: .TP 15
                     76: .B arp
                     77: Enable the use of the Address Resolution Protocol in mapping
                     78: between network level addresses and link level addresses (default). 
                     79: This is currently implemented for mapping between DARPA Internet
                     80: addreses and 10Mb/s Ethernet addresses.
                     81: .TP 15
                     82: .B \-arp
                     83: Disable the use of the Address Resolution Protocol.
                     84: .PP
                     85: .I Ifconfig
                     86: displays the current configuration for a network interface
                     87: when no optional parameters are supplied.
                     88: .PP
                     89: Only the super-user may modify the configuration of a network interface.
                     90: .SH DIAGNOSTICS
                     91: Messages indicating the specified interface does not exit; the
                     92: requested address is unknown; the Ethernet station address format is invalid; 
                     93: the user is not privileged and tried to alter an interface's configuration.
                     94: .SH "SEE ALSO"
                     95: rc(8), intro(4N), netstat(1), nstat(8)
                     96: .SH "BUGS"
                     97: .I
                     98: ifconfig
                     99: does not display the station address of an Ethernet interface. The user
                    100: must use 
                    101: .I nstat
                    102: to get the station address.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.