NIO CommKit Host Interface Installation and System Administration Manual

NLSADMIN(1M) NLSADMIN(1M)
E-39 CommKit Host Interface, Release 4.0
–s net_spec
–k net_spec Start or kill, respectively, the listener process for the indicated network.
When a listener is killed, processes that are still running as a result of
prior service requests will continue unaffected. The listener runs under
its own ID of listen with group ID (GID) adm. This GID appear in the
system password file /etc/passwd; the directory listed for the GID is
concatenated with net_spec to determine the location of the listener
configuration information for each network.
Program nlsadmin may be invoked by any user to generate reports, but
all operations that affect a listener’s status or configuration are restricted
to the super-user.
–v net_spec Verbose. Report on the servers associated with net_spec, giving the
service code, status, command, and comment for each.
–l addr net_spec Change or set the address for the general listener service. This is the
address generally used by remote processes to access the servers
available through the listener (see the –a option). Argument addr is the
transport address on which to listen, and is interpreted using a syntax that
allows for a variety of address formats. By default addr is interpreted as
the symbolic ASCII representation of the transport address. An addr
preceded by a ‘\x’ (BACKSLASH-X) lets you enter an address in
hexadecimal notation. Note: addr must be quoted if it contains any
blanks. If addr is just a dash (‘—’), nlsadmin merely reports the
currently configured address.
A change of address does not take effect until the next time the listener
for that network is started.
–t addr net_spec Change or set the address on which the listener listens for requests for
terminal service. Otherwise, this is similar to –l. A terminal service
address should not be defined unless the appropriate remote login
software is available; if such software is available, it must be configured
as service code 1 (see the –a option).
[–m] –a service_code –c cmd –y comment –p module1[,module2,...,moduleN] net_spec
Add a new service to the list of services available through the indicated
listener. Argument service_code is the code for the service. Argument
cmd is the command to be invoked in response to that service code,
comprised of the full path name of the server and its arguments, module1
through moduleN are the streams modules to be pushed before cmd is
invoked. Argument comment is a brief (free-form) description of the
service for use in various reports. Note: cmd must be quoted if it
contains arguments for the server. Similarly, comment must also be
quoted, so as to appear to be a single word to the shell. When a service is
added, it is initially enabled (see the –e and –d options).
If the –m option is specified, the entry is marked as an administrative
entry. Service codes 1 through 100 are reserved for administrative
entries, which are those that require special handling internally. In
particular, code 1 is assigned to the remote login service, which is the
service automatically invoked for connections to the terminal login
address.
A service must explicitly be added to the listener for each network on
which that service is to be available. This operation is normally
performed only when the service is installed on a machine, or when
populating the list of services for a new network.