HP-UX Reference (11i v1 00/12) - 1M System Administration Commands A-M (vol 3)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

351

352

353

354

355

356

357

358

359

360

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man1m/!!!intro.1m

________________________________________________________________

___ ___

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

NAME

ifconﬁg - conﬁgure network interface parameters

SYNOPSIS

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

work 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.

The second form of the command, without address_family, displays the current conﬁguration for interface.

If address_family is also speciﬁed, ifconfig reports only the details speciﬁc to that address family.

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:

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)).

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. Therefore, it is necessary to specify the address_family, which may affect

interpretation of the remaining parameters on the command line. The only address

family currently supported is

inet (DARPA-Internet family).

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)).

interface A string of the form nameunit, 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 ﬂag has no effect if the hardware is "down".

down Mark an interface "down". When an interface is marked "down", the

system will not attempt to transmit messages through that interface.

broadcast (Inet only) Specify the address that represents broadcasts to the net-

work. The default broadcast address is the address with a host part

of all 1’s.

metric n Set the routing metric of the interface to n. The default is 0. The

routing metric is used by the routing protocol (see gated(1M)).

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

(Inet only) Specify how much of the address to reserve for subdivid-

ing networks into sub-networks or aggregating networks into super-

nets. mask can be speciﬁed as a single hexadecimal number with a

leading 0x, with a dot-notation Internet address, or with a pseudo-

network name listed in the network table (see networks(4)). For sub-

dividing networks into sub-networks, mask must include the network

part of the local address, and the subnet part which is taken from the

host ﬁeld of the address. mask must contain 1’s in the bit positions

in the 32-bit address that are to be used for the network and subnet

parts, and 0’s in the host part. The 1’s in the mask must be

HP-UX Release 11i: December 2000 − 1 − Section 1M−−337

___