System Administration Commands pmadm(1M)
NAME
pmadm - port monitor administration
SYNOPSIS
pmadm -a [-p pmtag -t type] -s svctag -i id -m pmspecific -v ver
[-f xu]
[-y comment] [-z script]
pmadm -r -p pmtag -s svctag
pmadm -e -p pmtag -s svctag
pmadm -d -p pmtag -s svctag
pmadm -l [-t type -p pmtag] [-s svctag]
pmadm -L [-t type -p pmtag] [-s svctag]
pmadm -g -p pmtag -s svctag [-z script]
pmadm -g -s svctag -t type -z script
DESCRIPTION
pmadm is the administrative command for the lower level of
the Service Access Facility hierarchy, that is, for service
administration. A port may have only one service associated
with it although the same service may be available through
more than one port. In order to uniquely identify an
instance of a service, the pmadm command must identify both
the port monitor or port monitors through which the service
is available (-p or -t) and the service (-s). See .
pmadm performs the following functions:
o adds or removes a service
o enables or disables a service
o installs or replaces a per-service configuration
script
o prints requested service information
SunOS 5.11 Last change: 10 Nov 1998 1
System Administration Commands pmadm(1M)
Any user on the system may invoke pmadm to request service
status (-l or -L) or to print per-service configuration
scripts (-g without the -z option). pmadm with other options
may be executed only by a privileged user.
OPTIONS
The following options are supported:
-a Add a service. pmadm adds an entry for the
new service to the port monitor's adminis-
trative file. Because of the complexity of
the options and arguments that follow the
-a option, it may be convenient to use a
command script or the menu system to add
services.
-d Disable a service. Add x to the flag field
in the entry for the service svctag in the
port monitor's administrative file. This is
the entry used by port monitor pmtag. See
the -f option, below, for a description of
the flags available.
-e Enable a service. Remove x from the flag
field in the entry for the service svctag
in the port monitor administrative file.
This is the entry used by port monitor
pmtag. See the -f option, below, for a
description of the flags available.
-f xu The -f option specifies one or both of the
following two flags which are then included
in the flag field of the entry for the new
service in the port monitor's administra-
tive file. If the -f option is not
included, no flags are set and the default
conditions prevail. By default, a new ser-
vice is enabled and no utmpx entry is
created for it. An -f option without a fol-
lowing argument is illegal.
x Do not enable the service svctag
available through port monitor pmtag.
u Create a utmpx entry for service
svctag available through port monitor
pmtag.
SunOS 5.11 Last change: 10 Nov 1998 2
System Administration Commands pmadm(1M)
-g Print, install, or replace a per-service
configuration script. The -g option with a
-p option and a -s option prints the per-
service configuration script for service
svctag available through port monitor
pmtag. The -g option with a -p option, a -s
option, and a -z option installs the per-
service configuration script contained in
the file script as the per-service confi-
guration script for service svctag avail-
able through port monitor pmtag. The -g
option with a - s option, a -t option, and
a -z option installs the file script as the
per-service configuration script for ser-
vice svctag available through any port mon-
itor of type type. Other combinations of
options with -g are invalid.
-i id id is the identity that is to be assigned
to service svctag when it is started. id
must be an entry in /etc/passwd.
-l The -l option requests service information.
Used by itself and with the options
described below, it provides a filter for
extracting information in several different
groupings.
-l By itself, the -l
option lists all
services on the sys-
tem.
-l -p pmtag Lists all services
available through
port monitor pmtag.
-l -s svctag Lists all services
with tag svctag.
-l -p pmtag-ssvctag Lists service
svctag.
-l -t type Lists all services
available through
port monitors of
SunOS 5.11 Last change: 10 Nov 1998 3
System Administration Commands pmadm(1M)
type type.
-l -t type-ssvctag Lists all services
with tag svctag
available through a
port monitor of type
type.
Other combinations of options with -l are
invalid.
-L The -L option is identical to the -l option
except that output is printed in a con-
densed format.
-m pmspecific pmspecific is the port monitor-specific
portion of the port monitor administrative
file entry for the service.
-p pmtag Specifies the tag associated with the port
monitor through which a service (specified
as -s svctag) is available.
-r Remove a service. When pmadm removes a ser-
vice, the entry for the service is removed
from the port monitor's administrative
file.
-s svctag Specifies the service tag associated with a
given service. The service tag is assigned
by the system administrator and is part of
the entry for the service in the port
monitor's administrative file.
-t type Specifies the port monitor type.
-v ver Specifies the version number of the port
monitor administrative file. The version
number may be given as
-v 'pmspec -V
where pmspec is the special administrative
SunOS 5.11 Last change: 10 Nov 1998 4
System Administration Commands pmadm(1M)
command for port monitor pmtag. This spe-
cial command is ttyadm for ttymon and
nlsadmin for listen. The version stamp of
the port monitor is known by the command
and is returned when pmspec is invoked with
a -V option.
-y comment Associate comment with the service entry in
the port monitor administrative file.
-z script Used with the -g option to specify the name
of the file that contains the per-service
configuration script. Modifying a confi-
guration script is a three-step procedure.
First a copy of the existing script is made
(-g alone). Then the copy is edited.
Finally, the copy is put in place over the
existing script (-g with -z).
Options that request information write the requested infor-
mation to the standard output. A request for information
using the -l option prints column headers and aligns the
information under the appropriate headings. In this format,
a missing field is indicated by a hyphen. A request for
information in the condensed format using the -L option
prints the information in colon-separated fields; missing
fields are indicated by two successive colons. # is the com-
ment character.
EXAMPLES
Example 1 Adding a Service to a Port Monitor with the Tag
pmtag
The following command adds a service to a port monitor with
tag pmtag and gives the service the tag svctag. The port
monitor-specific information is generated by specpm. The
service defined by svctag will be invoked with identity
root.
pmadm -a -p pmtag -s svctag -i root -m `specpm -a arg1 -b arg2`-v `specpm -V`
Example 2 Adding a Service with Service Tab svctag
SunOS 5.11 Last change: 10 Nov 1998 5
System Administration Commands pmadm(1M)
The following command adds a service with service tag
svctag, identity guest, and port monitor-specific informa-
tion generated by specpm to all port monitors of type type:
pmadm -a -s svctag -i guest -t type -m `specpm -a arg1 -b arg2`-v `specpm -V`
Example 3 Removing a Service
The following command removes the service svctag from port
monitor pmtag:
pmadm -r -p pmtag -s svctag
Example 4 Enabling a Service
The following command enables the service svctag available
through port monitor pmtag:
pmadm -e -p pmtag -s svctag
Example 5 Disabling a Service
The following command disables the service svctag available
through port monitor pmtag:
pmadm -d -p pmtag -s svctag
Example 6 Listing Status Information
The following command lists status information for all ser-
vices:
pmadm -l
SunOS 5.11 Last change: 10 Nov 1998 6
System Administration Commands pmadm(1M)
Example 7 Listing Status Information
The following command lists status information for all ser-
vices available through the port monitor with tag ports:
pmadm -l -p ports
Example 8 Listing Status Information in Condensed Format
The following command lists the status information for all
services available through the port monitor with tag ports
in condensed format:
pmadm -L -p ports
Example 9 Listing Status Information for All Services
List status information for all services available through
port monitors of type listen:
pmadm -l -t listen
Example 10 Printing the per-service Configuration
The following command prints the per-service configuration
script associated with the service svctag available through
port monitor pmtag:
pmadm -g -p pmtag -s svctag
EXIT STATUS
The following exit values are returned:
0 Successful operation.
SunOS 5.11 Last change: 10 Nov 1998 7
System Administration Commands pmadm(1M)
>0 Operation failed.
FILES
/etc/saf/pmtag/config
/etc/saf/pmtag/svctag
/var/saf/pmtag/*
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWcsu
SEE ALSO
sac(1M), sacadm(1M), doconfig(3NSL), attributes(5)
SunOS 5.11 Last change: 10 Nov 1998 8
|
