Manual page for NLSADMIN(8)
listen, nlsadmin - network listener service administration for RFS
This program is available with the
software installation option.
[a manual with the abbreviation INSTALL]
for information on how to install optional software.
configures, initiates and terminates network listener
servers for the local host. Each network (transport provider)
has an associated
daemon to service it locally. The
daemon for each is configured separately.
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.
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.
without any options gives a brief usage message.
refers to a particular
is the relative path name of the entry under
for a given network.
Report the status of all of the listener processes installed on this
- -e service_code net_spec
- -d service_code net_spec
Enable or disable, respectively, the service indicated by
for the specified network.
The service must have previously been added to the listener for that
network (see the
When a listener is disabled, processes serving prior requests
continue until they complete.
- -r service_code net_spec
Remove the entry for the
from that listener's list of services.
- -i net_spec
Initialize or change a listener process for the network specified by
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
If the listener process is active,
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.
- -s net_spec
- -k net_spec
Start or kill, respectively, the listener process for the
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
with group ID (GID)
appear in the system password file
directory listed for the
is concatenated with
to determine the location of the listener
configuration information for each network.
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
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
is the transport address on which to listen,
and is interpreted using a syntax that allows for a
variety of address formats. By default
is interpreted as the symbolic
representation of the transport address. An
preceded by a
lets you enter an address in hexadecimal notation.
must be quoted if it contains any blanks. If
is just a dash
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
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
Add a new service to the list of services available through the
is the code for the service,
is the command to be invoked in response to that service code, comprised of
the full path name of the server and its arguments, and
is a brief (free-form) description of the service for use in various
must be quoted if it contains arguments for the server.
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
option is specified, the entry is marked as an administrative entry.
are reserved for administrative
entries, which are those that require special handling internally.
In particular, code
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
- -qz code net_spec
Query the status of the service with service code
Exit with a status of 0 if the service is enabled, 1
if the service is disabled, or greater than 1 on error.
- -z code net_spec
Print a report on the server associated with
that has service code
giving the same information as in the
Print the status of the listener process for
If the command is not run under the proper
an error message is sent
to the standard error, and the command terminates.
[a manual with the abbreviation NETP]
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97