admnetwork(1M) DG/UX 5.4.2 admnetwork(1M)
NAME
admnetwork - manage network database
SYNOPSIS
admnetwork -o add [ -y ] [ -l alias-list ] -a network-address
network-name
admnetwork -o modify [ -y ] [ -n new-network-name ] [ -a network-
address ] [ -l alias-list ] network-name
admnetwork -o delete [ -yq ] network-name ...
admnetwork -o list [ -y ] [ -qv ] [ -s ] [ network-name ... ]
DESCRIPTION
admnetwork manages the local or the NIS (YP) network database. The
network(4) database consists of a list of network names and the
Internet address for each.
Operations
add Add a new network entry.
modify Change an existing entry to contain a new network name or a
new network address, or both.
delete Remove an entry from the network database.
list List one or more entries from the network database.
Information is listed about each of the network-names
given; if network-name is "all", information about all
networks is listed.
Options
-y Perform the requested operation on the global NIS database.
Without this option, the requested operation is performed
on the local database in the /etc directory. If specified
with the add, delete, or modify operations, this option is
valid only if the machine on which the command is run is
the NIS master. The -y option uses the default domain name
derived from the SRC_DIR variable specified in the NIS
makefile (/etc/yp/Makefile).
-a network-address
network-address is the Internet address of the network. If
this option is excluded on modify, the current Internet
address for the network is preserved.
-l alias-list
alias-list is a comma-separated list of aliases by which
the network can be referenced. If this option is excluded
on modify, the current alias list for the network is
preserved.
-q "Quiet." Produce an unformatted listing (i.e. no headers,
Licensed material--property of copyright holder(s) 1
admnetwork(1M) DG/UX 5.4.2 admnetwork(1M)
fields delimited by a single space). When this option is
used with the delete operation, no confirmation is
presented before the network-name is deleted.
-s "Sort." Sort the listing by network name.
-v "Verbose." Produce a formatted listing with headers and
aligned columns. This is the default.
admnetwork expects all network addresses to be of the form
a.b.c.d,
where a is a decimal number between 0 and 224, and b, c, and d are
decimal numbers between 0 and 255. The address must have all four
octets.
OUTPUT
The list operation writes its output to stdout.
The verbose form of the list operation outputs the name and Internet
address for each network. Information is printed 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:
network_name internet_address
FILES
/etc/networks
Local networks database file.
DIAGNOSTICS
Warnings
None.
Errors
- The -y option is specified for an add, delete, or modify
operation and the host is not the NIS master.
- The add operation is requested, and network-name or network-
address already exists.
- The modify operation is requested, and new-network-name or
network-address already exists.
- The delete or modify operation is requested, and network-name
does not exist.
- The network-address is not a valid network address.
- The -y option is given, and there is an error exporting NIS maps.
Licensed material--property of copyright holder(s) 2
admnetwork(1M) DG/UX 5.4.2 admnetwork(1M)
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. does not exist.
NOTES
You must have write permission to the networks database to use the
add, delete, and modify operations. Usually, only the super-user has
such permission.
SEE ALSO
domainname(1), sysadm(1M), networks(4).
Licensed material--property of copyright holder(s) 3