pmadm(1M) pmadm(1M)
NAME
pmadm - Anschlußüberwachungsprogramme verwalten
SYNTAX
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
BESCHREIBUNG
pmadm ist das Verwaltungskommando für die untere Ebene der Hierarchie
der Service Access Facility (SAF), d. h. für die Verwaltung von Dien-
sten. Ein Anschluß darf nur mit einem Dienst verbunden sein, aber der-
selbe Dienst kann über mehrere Anschlüsse zur Verfügung stehen. Um
einen Ableger eines Dienst eindeutig erkennen zu können, muß das Kom-
mando pmadm sowohl das (die) Anschlußüberwachungsprogramm(e), über das
(die) der Dienst verfügbar ist (-p oder -t) und den Dienst selbst (-s)
identifizieren. Näheres ergibt sich aus den Beschreibungen der Optio-
nen weiter unten.
pmadm führt die folgenden Funktionen aus:
- Dienst hinzufügen oder entfernen
- Dienst aktivieren oder deaktivieren
- Konfigurationsskript für einen Dienst installieren oder ersetzen
- angeforderte Dienst-Informationen ausgeben
Ein beliebiger Systembenutzer kann das Kommando pmadm aufrufen, um den
Dienst-Status abzurufen (-l oder -L) oder um die Konfigurationsskripts
der Dienste auszugeben (-g ohne die Option -z). Soll pmadm mit anderen
Optionen ausgeführt werden, so ist dies nur für einen dazu berechtig-
ten Benutzer möglich.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
pmadm(1M) pmadm(1M)
OPTIONEN
-a Fügt einen Dienst hinzu. pmadm fügt einen Eintrag für den neuen
Dienst zu der Verwaltungsdatei des Anschlußüberwachungsprogramms
hinzu. Da die Optionen und Argumente, die auf die Option -a fol-
gen können, recht kompliziert sind, ist es unter Umständen ange-
bracht, ein Kommandoskript oder das Menüsystem zum Hinzufügen von
Diensten zu benutzen. Wenn Sie das Menüsystem benutzen, geben Sie
sysadm ports ein und wählen dann die Option portservices aus.
-d Dienst deaktivieren. Fügt ein x zu dem Flag-Feld im Eintrag des
Dienstes svctag in der Verwaltungsdatei des Anschlußüberwachungs-
programms ein. Dieser Eintrag wird von dem Anschlußüberwachungs-
programm pmtag verwendet. Sie finden eine Beschreibung der ver-
fügbaren Flags weiter unten unter der Option -f.
-e Dienst aktivieren. Löscht x aus dem Flag-Feld im Eintrag des
Dienstes svctag in der Verwaltungsdatei des Anschlußüberwachungs-
programms. Dieser Eintrag wird von dem Anschlußüberwachungspro-
gramm pmtag verwendet. Sie finden eine Beschreibung der verfügba-
ren Flags weiter unten unter der Option -f.
-f xu
Die Option -f gibt mindestens eines der folgenden beiden Flags
an, das/die dann in das Flag-Feld für den Eintrag des neuen Dien-
stes in der Verwaltungsdatei des Anschlußüberwachungsprogramms
geschrieben wird/werden. Ist die Option -f nicht angegeben, wer-
den keine Flags eingestellt. Es gelten dann die Standardbedingun-
gen. Standardmäßig ist ein neuer Dienst aktiv, und es wird kein
utmp-Eintrag dafür erzeugt. Angabe der Option -f ohne ein Argu-
ment ist nicht zulässig.
x Der Dienst svctag, der über das Anschlußüberwachungsprogramm
pmtag verfügbar ist, soll nicht aktiviert werden.
u Für den Dienst svctag, der über das Anschlußüberwachungspro-
gramm pmtag verfügbar ist, soll ein utmp-Eintrag erzeugt
werden.
-g Installiert oder ersetzt ein Konfigurationsskript für einen
Dienst bzw. gibt dieses aus. Wird die Option -g zusammen mit den
Optionen -p und f4-s aufgerufen, so wird das Konfigurationsskript
für den Dienst svctag ausgegeben, der über das Anschlußüberwa-
chungsprogramm pmtag verfügbar ist. Wird die Option -g zusammen
mit den Optionen -p, -s und -z angegeben, so wird das Konfigura-
tionsskript, das in der Datei script enthalten ist, als Konfigu-
rationsskript für den Dienst svctag installiert, der über das
Anschlußüberwachungsprogramm pmtag verfügbar ist. Wird die Option
-g zusammen mit den Optionen -s, -t und -z aufgerufen, so wird
die Datei script als Konfigurationsskript für den Dienst svctag
installiert, der über ein beliebiges Anschlußüberwachungsprogramm
des Typs type verfügbar ist. Andere Kombinationen von Optionen
mit der Option -g sind ungültig.
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
pmadm(1M) pmadm(1M)
-i id
id ist die Kennung, die dem Dienst svctag beim Start zugewiesen
wird. id muß ein Eintrag in /etc/passwd sein.
-l Fordert Informationen über Dienste an. Wird diese Option allein
bzw. zusammen mit den unten aufgeführten Optionen benutzt, stellt
sie einen Filter zur Verfügung, mit dem Informationen in ver-
schiedenen Kombinationen abgerufen werden können.
-l Wird diese Option allein angegeben, so listet sie
alle Dienste des Systems auf.
-l -p pmtag Listet alle Dienste auf, die über das Anschluß-
überwachungsprogramm pmtag verfügbar sind.
-l -s svctag Listet alle Dienste mit der Marke svctag auf.
-l -p pmtag -s svctag
Listet den Dienst svctag auf.
-l -t type Listet alle Dienste auf, die über ein Anschluß-
überwachungsprogramm des Typs type verfügbar sind.
-l -t type -s svctag
Listet alle Dienste mit der Marke svctag auf, die
über ein Anschlußüberwachungsprogramm des Typs
type verfügbar sind.
Andere Kombinationen von Optionen mit der Option -l sind ungültig.
-L Die Option -L stimmt mit der Option -l überein, abgesehen davon,
daß bei -L die Ausgabe komprimiert wird.
-m pmspecific
pmspecific ist derjenige Teil des Eintrags für den Dienst in die
Verwaltungsdatei des Anschlußüberwachungsprogramms, der für das
Anschlußüberwachungsprogramm spezifisch ist.
-p pmtag
Gibt die Marke zu dem Anschlußüberwachungsprogramm an, über das
ein Dienst (der als -s svctag angegeben ist) verfügbar ist.
-r Entfernt einen Dienst. Wenn pmadm einen Dienst entfernt, wird der
Eintrag für den Dienst aus der Verwaltungsdatei des Anschlußüber-
wachungsprogramms gelöscht.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98
pmadm(1M) pmadm(1M)
-s svctag
Gibt die Marke an, die mit einem bestimmten Dienst in Verbindung
gebracht wird. Diese Marke wird vom Systemverwalter vergeben und
ist Teil des Eintrags für den Dienst in der Verwaltungsdatei für
das Anschlußüberwachungsprogramm.
-t type
Gibt den Typ des Anschlußüberwachungsprogramms an.
-v ver
Gibt die Versionsnummer der Verwaltungsdatei für das Anschluß-
überwachungsprogramm an. Die Versionsnummer kann folgendermaßen
angegeben werden:
-v `pmspec -V`
Hierbei ist pmspec das spezielle Verwaltungskommando für das
Anschlußüberwachungsprogramm pmtag. Dieses spezielle Kommando ist
ttyadm für ttymon bzw. nlsadmin für listen. Das Kommando kennt
den Versionsstempel des Anschlußüberwachungsprogramms. Dieser
Versionsstempel wird zurückgegeben, wenn pmspec mit der Option -V
aufgerufen wird.
-y comment
Verbindet den Kommentar comment mit dem Eintrag für den Dienst in
der Verwaltungsdatei für das Anschlußüberwachungsprogramm.
-z script
Wird zusammen mit der Option -g benutzt, um den Namen der Datei
anzugeben, die das Konfigurationsskript für einen Dienst enthält.
Wollen Sie ein Konfigurationsskript ändern, so gehen Sie in drei
Schritten vor. Zuerst kopieren Sie das vorhandene Skript (mit -g
ohne weitere Optionen). Dann editieren Sie die Kopie. Schließlich
überschreiben Sie das vorhandene Skript mit der geänderten Kopie
(mit -g zusammen mit -z).
DIAGNOSE
Ist das Kommando pmadm erfolgreich, so hat es den Rückkehrcode 0.
Tritt ein Fehler auf, hat es einen Rückkehrcode ungleich null.
HINWEISE
Optionen, die Informationen anfordern, schreiben diese Informationen
in die Standardausgabe. Werden Informationen mit Hilfe der Option -l
angefordert, so werden auch Spaltentitel ausgegeben und die Informa-
tionen unter den entsprechenden Titeln ausgerichtet. In diesem Format
steht ein Bindestrich für ein fehlendes Feld. Werden Informationen
über die Option -L in komprimiertem Format angefordert, so werden sie
in Feldern ausgegeben, die durch Doppelpunkte voneinander getrennt
sind; zwei aufeinanderfolgende Doppelpunkte zeigen dann an, daß ein
Feld fehlt. # ist das Kommentarzeichen.
Seite 4 Reliant UNIX 5.44 Gedruckt 11/98
pmadm(1M) pmadm(1M)
BEISPIELE
Angenommen, es soll ein Dienst zu einem Anschlußüberwachungsprogramm
mit der Marke pmtag hinzugefügt werden. Dem Dienst soll die Marke
svctag zugeordnet werden. Informationen, die für das Anschlußüberwa-
chungsprogramm spezifisch sind, sollen von specpm erzeugt werden. Der
durch svctag definierte Dienst soll mit der Kennung root aufgerufen
werden. Dazu wird folgendes eingegeben:
pmadm -a -p pmtag -s svctag -i root -m `specpm -a arg1 \
-b arg2` -v `specpm -V`
Das folgende Beispiel fügt einen Dienst mit der Marke svctag und der
Kennung guest, zu allen Anschlußüberwachungsprogrammen des Typs type
hinzu, wobei Informationen, die für das Anschlußüberwachungsprogramm
spezifisch sind, über specpm erzeugt werden:
pmadm -a -s svctag -i guest -t type -m `specpm -a arg1 \
-b arg2` -v `specpm -V`
Das folgende Beispiel entfernt den Dienst svctag aus dem Anschlußüber-
wachungsprogramm pmtag:
pmadm -r -p pmtag -s svctag
Das folgende Beispiel aktiviert den Dienst svctag, der über das
Anschlußüberwachungsprogramm pmtag verfügbar ist:
pmadm -e -p pmtag -s svctag
Das folgende Beispiel deaktiviert den Dienst svctag, der über das
Anschlußüberwachungsprogramm pmtag verfügbar ist:
pmadm -d -p pmtag -s svctag
Das folgende Beispiel listet Status-Informationen für alle Dienste
auf:
pmadm -l
Das folgende Beispiel listet Status-Informationen für alle Dienste
auf, die über das Anschlußüberwachungsprogramm mit der Marke ports
verfügbar sind:
pmadm -l -p ports
Das folgende Beispiel listet dieselben Informationen wie im vorange-
henden Beispiel im komprimierten Format auf:
pmadm -L -p ports
Seite 5 Reliant UNIX 5.44 Gedruckt 11/98
pmadm(1M) pmadm(1M)
Das folgende Beispiel listet Status-Informationen für alle Dienste
auf, die über Anschlußüberwachungsprogramme des Typs listen verfügbar
sind:
pmadm -l -t listen
Das folgende Beispiel gibt das Konfigurationsskript für den Dienst
svctag aus, der über das Anschlußüberwachungsprogramm pmtag verfügbar
ist:
pmadm -g -p pmtag -s svctag
DATEIEN
/etc/saf/pmtag/config
/etc/saf/pmtag/svctag
/var/saf/pmtag/*
SIEHE AUCH
listen(1M), nlsadmin(1M), sac(1M), sacadm(1M), ttyadm(1M), ttymon(1M),
doconfig(3C).
Seite 6 Reliant UNIX 5.44 Gedruckt 11/98