admtcpipdaemon(1M) DG/UX R4.11MU05 admtcpipdaemon(1M)
NAME
admtcpipdaemon - manage the TCP/IP servers
SYNOPSIS
admtcpipdaemon -o add [ -I -s service -p protocol ] [ -a args ] [ -n
] server
admtcpipdaemon -o delete [ -I ] [ -q ] [ -n ] server ...
admtcpipdaemon -o modify [ -I [ -s service ] [ -p protocol ] ] [ -a
args ] [ -n ] [ -d new-server ] server
admtcpipdaemon -o list [ -I ] [ -qv ] [ all | server ... ]
admtcpipdaemon -o start server ...
admtcpipdaemon -o stop [ -q ] server ...
DESCRIPTION
Admtcpipdaemon manages the TCP/IP servers (daemons). The TCP/IP
servers are split into two databases: independent servers that run as
their own process, and inetd(1M) servers that are spawned off by the
inetd server when their services are requested.
The independent servers database consists of a list of server
programs and arguments to the program. Each of these servers will be
started when the TCP/IP network is started.
The inetd servers database consists of a list of server programs,
arguments to the program, the service implemented by the server, and
the protocol used by the server. The servers will be spawned off by
the inetd server if the inetd server is in the database of
independent servers.
Operations
add Add a server to the independent or inetd servers database.
delete Remove one or more servers from the independent or inetd
servers database.
modify Change a server from the independent or inetd servers
database.
list List one or more servers from the independent or inetd
servers database.
start Start or restart one or more servers from the independent
servers database.
stop Stop one or more servers from the independent servers
database.
Options
-I Perform the requested operation on the inetd servers
database. Without this option the operation is performed on
the independent servers database. This option is not valid
for the start or stop operations, which operate only on the
independent servers database.
-s service
service is the network service implemented by the server in
the inetd servers database. This service must be found in
the services(4) database. This option is only valid when
operating on the inetd servers database.
-p protocol
protocol is the transport protocol used by the server in
the inetd servers database. This protocol must be found in
the protocols(4) database. This option is only valid when
operating on the inetd servers database.
-a args args are the command line arguments to the server program.
-n Perform the requested operation without starting/stopping
the specified server program. For the add and modify
operations this causes the specified server program not to
be started after it is added/modified in the servers
database. For the delete operation this causes the
specified server program not to be stopped after it is
deleted from the servers database.
-d new-server
new-server is the new server name that replaces server in
the modify operation. Without this option the current
server program will be preserved.
-q For the list operation this produces an unformatted listing
(i.e., no headers). For the delete and stop operations it
suppresses confirmation messages.
-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 ftpd server to the inetd server database;
modify the ftpd server, changing the arguments to -d -l; add the smtp
server, to the independent server database with -q30m as its
argument.
admtcpipdaemon -o add -I -s ftp -p tcp ftpd
admtcpipdaemon -o modify -I -a "-d -l" ftpd
admtcpipdaemon -o add -a "-q30m" smtp
FILES
/etc/tcpip.params
File that contains the independent servers database.
/etc/inetd.conf
File that contains the inetd servers 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.
For inetd servers the fields are in the following order:
service protocol server args
For independent servers the fields are in the following order:
server args
DIAGNOSTICS
Warnings
- The delete, start, or stop operation is requested, and server
does not exist.
Errors
- The add operation is requested, and server already exists.
- The modify operation is requested, and server does not exist.
- The modify operation is requested, and new-server 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
Access to the add, delete, and modify operations is granted based on
write permissions for the given servers database file. Only a user
with appropriate privilege may perform these operations. Access to
the list operation is granted based on read permissions for the given
servers database file. Only a user with the privilege may perform
the start and stop operations.
On a generic DG/UX system, appropriate privilege is granted by having
an effective UID of 0 (root). See the appropriateprivilege(5) man
page for more information.
On a system with DG/UX information security, appropriate privilege is
granted by having one or more specific capabilities enabled in the
effective capability set of the user. See capdefaults(5) for the
default capabilities for this command.
SEE ALSO
capdefaults(5), inetd(1M), inetd.conf(4M), protocols(4),
services(4), tcpip.params(4M).
Licensed material--property of copyright holder(s)