i
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 net-
work 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 interface.
If address_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:
-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 configure an interface manually with the specified 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 specified,
ifconfig
pushes all
modules on the stream associated with the interface in the specified order. For exam-
ple, module mod2 is pushed on top of module mod1. The modules are pushed between
IP and network drivers. If the
-m
option is not specified, the modules (if any)
specified in the DEFAULT_INTERFACE_MODULES variable are used for configuring
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
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 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 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 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 2: December 2007 Update
−
1
−
Hewlett-Packard Company
369
