ifconfig.1m (2011 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

ifconﬁg(1M) ifconﬁg(1M)

NAME

ifconﬁg - conﬁgure network interface parameters

SYNOPSIS

ifconfig [-m mod1[,mod2]...] interface [address_family][address [dest_address ]] [parameters ]

ifconfig interface [address_family]

DESCRIPTION

The ﬁrst form of the

ifconfig command assigns an address to a network interface and/or conﬁgures

network interface parameters. ifconfig must be used at boot time to deﬁne the network address of

each interface present on a machine. It can also be used at other times to redeﬁne an interface’s address

or other operating parameters. If the address_family is not speciﬁed, the address family defaults to IPv4.

The second form of the command, without address_family, displays the current conﬁguration for inter-

face .Ifaddress_family is not speciﬁed,

ifconfig reports the details on all supported address families.

An exception is when the user has not conﬁgured any interface with an IPv6 address,

ifconfig does

not display the IPv6 loopback interface.

Only a user with appropriate privileges can modify the conﬁguration of a network interface. All users

can run the second form of the command.

Arguments

ifconfig recognizes the following arguments:

-m mod1[,mod2]...

A list of modules that can be pushed on a stream associated with an interface. The

-m

option can be used to conﬁgure an interface manually with the speciﬁed module names.

There is no space between the module names and only a comma is used to separate the

module names. If the -m option is speciﬁed, ifconfig pushes all modules on the

stream associated with the interface in the speciﬁed order. For example, module mod2 is

pushed on top of module mod1. The modules are pushed between IP and network

drivers. If the

-m option is not speciﬁed, the modules (if any) speciﬁed in the

DEFAULT_INTERFACE_MODULES variable are used for conﬁguring the interface (see

netconf and netconf-ipv6 in /etc/rc.config.d/

address Either a host name present in the host name database (see hosts (4)), or a DARPA Inter-

net 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 transmis-

sions in differing protocols, each of which may require separate naming schemes. The

address_family, affects the interpretation of the remaining parameters 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 name unit, such as

lan0. (See the Interface Naming subsection

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 interface. Setting

this ﬂag 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 sys-

tem will not attempt to transmit messages through that interface. A pri-

mary interface (see the Interface Naming subsection given below) can be

marked down only if all the secondary interfaces on the same physical

device are already down.

HP-UX 11i Version 3: September 2011 − 1 − Hewlett-Packard Company 1

Summary of content (8 pages)

PAGE 1
ifconfig(1M) ifconfig(1M) NAME ifconfig - configure network interface parameters SYNOPSIS ifconfig [-m mod1[,mod2]...] 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.
PAGE 2
ifconfig(1M) ifconfig(1M) 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 encapsulation limit is the maximum number of additional encapsulations 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.
PAGE 3
ifconfig(1M) ifconfig(1M) tsrc addr Specify the source addr of the tunnel. This is the source address in the encapsulating (outer) header. It should be an unicast address configured on an interface in the tunnel entry-point node. For tunnel types ipinip6 and ip6inip6, the addr should be an IPv6 address. For tunnel types ip6inip and 6to4, the addr should be an IPv4 address.
PAGE 4
ifconfig(1M) ifconfig(1M) A primary interface is an interface whose IP index number is zero. A secondary interface is an interface whose IP index number is non-zero. Loopback Interface The loopback interface (lo0) is automatically configured when the system boots with the TCP/IP software. The IP address and netmask of the primary IPv4 loopback interface are 127.0.0.1 and 255.0.0.0, respectively. The IP address and prefix of the primary IPv6 loopback interface are ::1 and 128 respectively.
PAGE 5
ifconfig(1M) ifconfig(1M) manually configures secondary interfaces. To disable communication through a specific IP address on an autoconfigured secondary interface, that secondary interface should be marked down, not removed or overwritten with a different IP address. If that interface is removed or overwritten, the host will reconfigure another secondary interface with the same IP address when it receives the next router advertisement.
PAGE 6
ifconfig(1M) ifconfig(1M) # ifconfig iptu0 inet6 tunnel ip6inip fe80::1 fe80::2 \ tsrc 10.10.1.1 tdst 10.10.2.2 up Secondary addresses to the tunnel interfaces can be assigned as shown below: # ifconfig iptu0:1 inet6 2ffe::1 3ffe::1 up IP-in-IP6 tunnel interface configuration "IP-in-IP6" tunnel configuration allows transmission of IPv4 packets encapsulated in an IPv6 header.
PAGE 7
ifconfig(1M) ifconfig(1M) DIAGNOSTICS Messages indicate if the specified interface does not exist, the requested address is unknown, or the user is not privileged and tried to alter an interface’s configuration. WARNINGS The lanadmin, lanscan, and linkloop commands are deprecated. These commands will be removed in a future HP-UX release. HP recommends the use of replacement command nwmgr(1M) to perform all network interface-related tasks.
PAGE 8
(Notes) A (Notes) iA 8 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2011