ifconfig(1M) ifconfig(1M)NAME ifconfig - manages network interfaces SYNOPSIS ifconfig interface [address[dest-address]] [option]... ifconfig interface [address-family] ARGUMENTS address Specifies the network address. dest-address Specifies a DARPA Internet address that is either a host name in the /etc/hosts file or a DARPA Internet address expressed in the Internet standard dot notation, byte-value.byte-value.byte-value.byte-value. address-family Specifies an address family. The following address families are recognized: inet, for AF_INET; ns, for AF_NS; and unix, for AF_UNIX. interface Specifies a string that consists of two values: name and unit. An example is ae0, where ae is the value of name and 0 is the value of unit. Another example is sl0, where sl is the value of name and 0 is the value of unit. option Specifies a change in the configuration of a network interface. Only a user who is logged in as root can modify the network interface configuration. These options are available: arp Enables the use of the Address Resolution Protocol (ARP) in mapping between network-level addresses and link-level addresses. This option is the default. This option currently is implemented for mapping between DARPA Internet addresses and 10 Mbits/second Ethernet addresses. -arp Disables the use of ARP. broadcast Specifies the address to use to represent broadcasts to the network. The default broadcast address is the one whose host part contains nothing but ones (Internet only). debug January 1992 1
ifconfig(1M) ifconfig(1M)Enables driver-dependent debugging; usually, this option turns on extra console error logging. -debug Disables driver-dependent debugging. down Marks an interface as ``down'' (disabled). When an interface is marked as down, the system does not attempt to transmit messages through that interface. If possible, the interface is reset to disable reception as well. This action does not automatically disable routes using the interface. dstaddr Specifies the address of the correspondent on the other end of a point-to-point link. metric number Sets the routing metric of the interface to number; the default is 0. The routing metric is used by routed. Higher metrics have the effect of making a route less favorable; metrics are counted as additional hops to the destination network or host. netmask mask Specifies 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 pseudonetwork name listed in the network table. See networks(4N) for details. The mask contains ones for the bit positions in the 32-bit address that are to be used for the network and subnet parts, and zeroes 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 (Internet only). trailers Enables the use of a ``trailer'' link-level encapsulation during transmission; this option is the default. If a network interface supports trailers, the system, when possible, encapsulates outgoing messages so that the number of memory- to-memory copy operations performed by the receiver is minimized. On networks that support the ARP (currently, only 10 Mbits/second Ethernet), specifying this option indicates that 2 January 1992
ifconfig(1M) ifconfig(1M)the system should request other systems to use trailers when sending to this host. Similarly, trailer encapsulations are sent to other hosts that have made such requests. This option is used currently by Internet protocols only. See arp(5) for details. -trailers Disables the use of a ``trailer'' link-level encapsulation. up Marks an interface as ``up'' (enabled). You can use this option to enable an interface after marking an interface as ``down.'' The ifconfig command automatically marks the interface as up when setting the first address on an interface. If the interface was reset when previously marked down, marking the interface as up reinitializes the hardware. DESCRIPTION ifconfig reports information about the available network interfaces, makes changes to the network interface configuration, and assigns addresses to a network interface. The ifconfig command is used at boot time to define the network address of each interface present on a system. It can also be used at a later time to redefine an interface's address or other operating parameters. To see the current configuration of a network interface, invoke ifconfig with the name of an interface. If you specify an optional address family, ifconfig reports only the details specific to that address family. EXAMPLES This command sets the netmask on the Compressed Serial Line/Internet Protocol (CSL/IP) interface identified by sl0: ifconfig sl0 netmask 0xffffff00 STATUS MESSAGES AND VALUES When unsuccessful, the ifconfig command prints any of these messages: ifconfig: error-string: no such interface You have specified an invalid interface. See intro(2) for an explanation of error.string. ifconfig: option: permission denied You do not have permission to modify the network interface configuration. January 1992 3
ifconfig(1M) ifconfig(1M)FILES /etc/ifconfig Executable file SEE ALSO brc(1M), routed(1M) netstat(1N) in A/UX Command Reference intro(2), hosts(4), networks(4N), arp(5), intro(5) in A/UX Programmer's Reference 4 January 1992