NIO CommKit Host Interface Installation and System Administration Manual

NLSADMIN(1M) NLSADMIN(1M)
E-38 CommKit Host Interface, Release 4.0
NAME
listen, nlsadmin – network listener service administration for Datakit TLI interface
SYNOPSIS
nlsadmin [ –mx ][–edr “service_code net_spec”][ –ikqsv net_spec] [ –lt addr net_spec ]
[ –a service_code [ –p modules ] –c command –y comment net_spec ]
[ –qz code net_spec ] [ –z code net_spec ] [ net_spec ]
/usr/net/nls/listen
AVAILABILITY
This program is available with the Datakit Host software installation only. Refer to the Datakit Host
Installation Manual for more information.
DESCRIPTION
The nlsadmin program configures, initiates and terminates network listener (listen) servers for the local host.
Each network (transport provider) has an associated listen daemon to service it locally. The listen daemon
for each is configured separately. A listen daemon accepts network service requests when they arrive, and
spawns servers in response to those requests. It can be used on any network (transport provider) that conforms
to the transport provider specification.
Program nlsadmin can also report on the listener processes on a machine, either individually (per network)
or collectively.
Changing the list of services provided by the listener produces immediate changes, while changing an address
on which the listener listens has no effect until the listener is restarted.
Running nlsadmin without any options displays a brief usage message.
OPTIONS
The net_spec argument to nlsadmin refers to a particular listen daemon. Specifically, net_spec is the relative
path name of the entry under /dev for a given network.
–x Report the status of all of the listener processes installed on this machine.
–e service_code net_spec
–d service_code net_spec Enable or disable, respectively, the service indicated by service_code for
the specified network. The service must have previously been added to
the listener for that network (see the –a option). When a listener is
disabled, processes serving prior requests continue until they complete.
–r service_code net_spec Remove the entry for the service_code from that listener’s list of
services.
–i net_spec Initialize or change a listener process for the network specified by
net_spec. That is, create and initialize the files required by the listener.
Initializing a listener with this option does not start it running. The
listener must be initialized before assigning addressing or services. Note:
the listener should only be initialized once for a given network.
–q net_spec Query the status of the listener process for the specified network. If the
listener process is active, nlsadmin exits with a status of 0. If no such
process is active, the exit code is 1. The exit code will be greater than 1
if there is an error.