IP
TCP/IP command reference
iMG/RG Software Reference Manual (IPNetwork Functions)
4-24
4.1.8.2.20 IP INTERFACE ADD SECONDARYIPADDRESS
Syntax
IP INTERFACE {<name>|<number>} ADD SECONDARYIPADDRESS <ipaddress>
[<netmask>]
Description
This command adds a secondary IP address to an existing IP interface. A secondary
address may be used to create an extra IP address on an interface for management pur-
poses, or to allow the IP stack to route between two subnets on the same interface.
The functionality of secondary IP addresses depends on several parameters including the
type of IP interface and the netmask:
•
If a secondary address is on the same subnet as the primary interface address, you
do not need to specify a subnet mask for that secondary address. This applies to all
interface types.
•
If a secondary address is on a different subnet to the primary address, and the inter-
face is Ethernet or a transport using a bridged encapsulation, you must specify the
subnet mask. The IP stack will listen on the new address for connections to local
services (e.g., for management purposes), and will also route packets to the new
subnet.
•
If a secondary address is on a different subnet to the primary address, and the inter-
face is a point-to-point interface, specifying a netmask is optional.
•
For the same behavior as described for Ethernet interfaces above, the subnet mask
should be specified.
•
If the subnet mask is not specified, the IP address will not be associated with any
subnet, but will still be recognized as one of the IP stack’s own addresses for local
traffic.
Note:
The ability to specify a subnet mask with a secondary address is still supported, but superseded by the
functionality of virtual interfaces. You should USE VIRTUAL INTERFACES instead; see
IP
ATTACHVIRTUAL
. Support for adding secondary IP addresses including subnet mask specification will be
withdrawn in a future releases.
Options
The following table gives the range of values for each option that can be specified with
this command and a Default Value (if applicable).
Option
Description
Default Value
name
An existing IP interface. To display interface names, use the
IP LIST INTERFACES command.
N/A
number
An existing IP interface. To display interface numbers, use
the IP LIST INTERFACES command. The number appears
in the first column under the heading ID.
N/A