admipinterface(1M) DG/UX 5.4.2 admipinterface(1M)
NAME
admipinterface - manage the TCP/IP network interfaces database
SYNOPSIS
admipinterface -o add -d device [ -m netmask ] [ -b 0 | 1 ] [ -p
link-protocol ] [ -t template ] hostname
admipinterface -o delete hostname ...
admipinterface -o modify [ -n new-hostname ] [ -d device ] [ -m
netmask ] [ -b 0 | 1 ] [ -p link-protocol ] [ -t template
] hostname
admipinterface -o list [ -qv ] [ hostname ... ]
admipinterface -o start hostname ...
admipinterface -o stop hostname ...
DESCRIPTION
admipinterface manages the TCP/IP network interfaces database. A
TCP/IP network interfaces database entry consists of: a hostname
(which must have an hosts(4) entry) or an Internet address, an
interface name, a device name(which must have a /dev entry), a
netmask, a broadcast address for broadcasting interfaces, and an IXE
template for ixe(7) interfaces.
Operations
add Add a new network interface to the network interfaces
database.
delete Remove one or more network interface entries from the
network interfaces database.
modify Change a network interface entry in the network interfaces
database. The hostname, device, netmask, broadcast
address, link-level protocol, and template name may be
edited.
list List one or more network interfaces in the network
interfaces database. Information is listed about each of
the hostnames given; if no hostnames are given or hostname
is all, information about all network interfaces is listed.
start Start one or more network interfaces from the network
interfaces database using the ifconfig command.
stop Stop one or more network interfaces from the network
interfaces database using the ifconfig command.
Options
-d device device is the device name which must have a /dev entry.
The devices currently supported are: inen(7), hken(7),
Licensed material--property of copyright holder(s) 1
admipinterface(1M) DG/UX 5.4.2 admipinterface(1M)
ixe(7), loop(7), vitr(7).
-m netmask
netmask is the hexdecimal mask that masks off the host part
from the network part of the Internet address . Without
this option the default netmask will be used. The default
netmask does not allow subnetting.
-b 0 | 1 broadcast-polarity specifies whether the host part of the
broadcast address is composed of 1's or 0's. The default is
1.
-p link-protocol
link-protocol is the Link level protocol used to build the
network protocol stack. The Link level protocols currently
supported are: ether and 802.3. This option is only valid
for inen and hken devices. The link-protocol defaults to
ether. If the link-protocol is not ether, then the
interface name will be derived by prepending link-protocol
onto device, otherwise the interface name will be the same
as the device name. For example, if device is hken0, and
link-protocol is 802.3, then the interface name will be
802.3hken0. However, if link-protocol is ether, then the
interface name will be hken0.
-t template
template is the file that contains IXE information for X.25
network interfaces. This option is only valid for ixe
interfaces.
-n new-hostname
new-hostname is the new hostname that will replace hostname
in the modify command. Without this option the hostname is
not changed.
-q "Quiet." Produce an unformatted listing (i.e. no headers,
fields delimited by a single space).
-v "Verbose." Produce a formatted listing with headers and
aligned columns. This option is enabled by default.
EXAMPLES
In the following examples, the system administrator performs the
following actions: add the my-host-ixe0 and my-host-ixe1 ixe
interfaces; add the my-host hken0 interface; modify the my-host hken0
interface by specifying a subnet mask.
admipinterface -o add -d ixe0 -m 0xffff0000 -t ixe0.file my-host-ixe0
admipinterface -o add -d ixe1 -m 0xffff0000 -t ixe1.file my-host-ixe1
admipinterface -o add -d hken0 -b 1 -p ether my-host
admipinterface -o modify -m 0xffffff00 my-host
Licensed material--property of copyright holder(s) 2
admipinterface(1M) DG/UX 5.4.2 admipinterface(1M)
FILES
/etc/tcpip.params
File that contains the network interfaces database.
OUTPUT
The list operation writes its output to stdout.
The verbose form of the list operation outputs the entry in aligned
columns with column headers.
If -q option is specified with the list operation, headers are
suppressed and each entry is printed on a separate line. The fields
within the entry are delimited by a single space, and are in the
following order:
hostname interface device netmask broadcast link-protocol
template
DIAGNOSTICS
Warnings
- The delete, start, or stop operation is requested, and hostname
does not exist.
Errors
- The add operation is requested, and hostname already exists.
- The modify operation is requested, and hostname does not exist.
- The modify operation is requested, and new-hostname already
exists.
Exit Codes
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
NOTES
Only the system administrator is granted access to the add, delete,
modify, start, and stop operations. Anyone with read access to the
network interfaces database file is granted access to the list
operation.
SEE ALSO
ifconfig(1M), hosts(4), tcpip.params(4M), hken(7), inen(7), loop(7),
vitr(7); ixe(7) in the X.25 product.
Licensed material--property of copyright holder(s) 3