HP-UX Reference (11i v2 04/09) - 1M System Administration Commands A-M (vol 3)

i
ifconfig(1M) ifconfig(1M)
NAME
ifconfig - configure network interface parameters
SYNOPSIS
ifconfig interface [address_family][address [dest_address ]] [parameters ]
ifconfig interface [address_family]
DESCRIPTION
The first form of the
ifconfig command assigns an address to a network interface and/or configures
network interface parameters. ifconfig must be used at boot time to define the network address of
each interface present on a machine. It can also be used at other times to redefine an interface’s address
or other operating parameters. If the address_family is not specified, the address family defaults to IPv4.
The second form of the command, without address_family, displays the current configuration for inter-
face.Ifaddress_family is not specified,
ifconfig reports the details on all supported address families.
An exception is when the user has not configured any interface with an IPv6 address,
ifconfig does
not display the IPv6 loopback interface.
Only a user with appropriate privileges can modify the configuration of a network interface. All users
can run the second form of the command.
Arguments
ifconfig recognizes the following arguments:
address Either a host name present in the host name database (see hosts(4)), or a DARPA
Internet address expressed in Internet standard dot notation (see inet(3N)) for an
IPv4 address and in colon notation (see inet6(3N)) for an IPv6 address.
address_family Name of protocol on which naming scheme is based. An interface can receive
transmissions in differing protocols, each of which may require separate naming
schemes. The address_family, affects the interpretation of the remaining parame-
ters on the command line. The only address families currently supported are
inet (DARPA-Internet family) for IPv4 addresses, and
inet6 for IPv6 addresses.
dest_address Address of destination system. Consists of either a host name present in the host
name database (see hosts(4)), or a DARPA Internet address expressed in Internet
standard dot notation (see inet(3N)) for an IPv4 address, and in colon notation (see
inet6(3N)) for an IPv6 address.
interface A string of the form nameunit, such as
lan0. (See the Interface Naming subsec-
tion given below.)
parameters One or more of the following operating parameters:
up Mark an interface "up". Enables interface after an ifconfig
down. Occurs automatically when setting the address on an inter-
face. Setting this flag has no effect if the hardware is "down". A
secondary interface (see the Interface Naming subsection given
below) can be marked up only if the primary interface is already
up.
down Mark an interface "down". When an interface is marked "down",
the system will not attempt to transmit messages through that
interface. A primary interface (see the Interface Naming subsec-
tion given below) can be marked down only if all the secondary
interfaces on the same physical device are already down.
broadcast (inet only) Specify the address that represents broadcasts to the
network. The default broadcast address is the address with a host
part of all 1’s.
encaplimit n
Specify the tunnel encapsulation limit value n. The tunnel encap-
sulation limit is the maximum number of additional encapsula-
tions permitted for the packets. The tunnel encapsulation limit
option is defined in RFC 2473. This option is valid only for tunnel
types ipinip6 and ip6inip6. The default is 4.
HP-UX 11i Version 2: September 2004 − 1 − Hewlett-Packard Company Section 1M−−299