Administering port services

Adding a service

pmadm adds a service by making an entry for the new service in the port monitor's administrative file. Be aware that a service implies a port and that there is a one-to-one mapping between ports and instances of services.

The first line of each port monitor administrative file is typically a comment line indicating the version of the port monitor.

Use the following command to add a new service to your system:

pmadm -a [ -p pmtag | -t pmtype ] -s svctag \
-m "pmspecific" -v ver [other options]

The -a option specifies that pmadm adds a new service by making an entry for it in the port monitor's administrative file.

The -p option specifies the tag, pmtag, associated with the port monitor through which a service, svctag, is available. pmtag and svctag are names you choose.

The -t option specifies the port monitor type.

When a service is added, the command line must contain either the -p or -t options, but not both. If -p is used, a service is added to a single port monitor, pmtag. If -t is used, instances of a service are added to all port monitors of type pmtype.

The -s option specifies the service tag, svctag.

The -m option allows port monitor-specific options to be included on the command line when adding a service. Generate this information by using a port monitor-specific command with whichever of its options are appropriate.

The -v option specifies the version number of the port monitor administrative file. The version stamp of the port monitor may be found by specifying the -V option to ttyadm(1M) for ttymon, and to nlsadmin(1M) for listen. For example:

-v `nlsadmin -V`

could be used to specify the version number of a port monitor of type listen.

The following example adds a service with service tag lp to all port monitors of type listen:

pmadm -a -s lp -t listen -i root -v `nlsadmin -V` \
-m `nlsadmin -p /var/spool/lp/fifos/listenS5`

There are several other options that you can use to customize the addition of a service. See pmadm(1M) for more information.

© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 22 April 2004