ckgid(1M) ckgid(1M)
NAME
ckgid, errgid, helpgid, valgid - Zur Eingabe sowie Überprüfung der
Richtigkeit einer Gruppennummer auffordern
SYNTAX
/usr/bin/ckgid [-Q] [-W width] [-m] [-d default] [-h help] [-e error]
[-p prompt] [-k pid [-s signal]]
/usr/sadm/bin/errgid [-W] [-e error]
/usr/sadm/bin/helpgid [-W] [-m] [-h help]
/usr/sadm/bin/valgid input
BESCHREIBUNG
ckgid fordert den Benutzer zu einer Eingabe auf und überprüft die Ein-
gabe auf ihre Gültigkeit. Mit diesem Kommando werden u. a. folgende
Elemente definiert: die Meldung für einen Prompt, auf den eine bereits
vorhandene Gruppennummer eingegeben werden sollte, der Text für Hilfe-
und Fehlermeldungen und ein Standardwert (der benutzt wird, wenn der
Benutzer auf den Prompt mit einem Carriage-Return-Zeichen reagiert).
Meldungen dürfen höchstens 70 Zeichen lang sein und werden automatisch
formatiert. Zwischenräume in der Definition (auch das Zeilenende-
Zeichen) werden entfernt. Die Option -W unterdrückt die automatische
Formatierung. Beginnt oder endet die Definition einer Meldung mit
einer Tilde, wird der Standardtext an dieser Stelle eingefügt. Es kön-
nen also Standardtext und vom Benutzer definierter Text zusammen ange-
zeigt werden.
Werden der Prompt, die Hilfe- oder die Fehlermeldung nicht definiert,
so wird die (unter HINWEISE angegebene) Standardmeldung angezeigt.
Mit dem Kommando ckgid sind drei visuelle Module verbunden, nämlich
errgid zur Formatierung und Anzeige einer Fehlermeldung, helpgid zur
Formatierung und Anzeige einer Hilfemeldung und valgid zur Überprüfung
der Benutzereingabe. Diese Module sollten zusammen mit FML-Objekten
benutzt werden. In diesem Fall definiert das FML-Objekt den Prompt.
OPTIONEN
-Q Gibt an, daß quit keine gültige Eingabe ist.
-W width Gibt an, daß der Prompt sowie die Hilfe- und Fehlermel-
dungen alle auf eine Zeilenlänge von width Zeichen forma-
tiert werden.
-m Zeigt eine Liste aller Gruppen an, wenn Hilfe angefordert
wird oder der Benutzer einen Fehler macht.
-d default Definiert den Standardwert als default. Der Standardwert
wird nicht auf seine Gültigkeit hin überprüft und braucht
daher keinen Kriterien zu entsprechen.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
ckgid(1M) ckgid(1M)
-h help Definiert die Hilfemeldung als help.
-e error Definiert die Fehlermeldung als error.
-p prompt Definiert den Prompt als prompt.
-k pid Gibt an, daß ein Signal an die Prozeßnummer pid gesendet
werden soll, wenn der Benutzer den Prozeß abbricht.
-s signal Gibt an, daß das Signal signal an die Prozeßnummer pid,
die mit der Option -k definiert wurde, geschickt wird,
wenn der Benutzer quit wählt. Wird kein Signal angegeben,
so wird SIGTERM benutzt.
input Ist die Eingabe, die anhand von /etc/group überprüft
wird.
DIAGNOSE
Beim Kommando ckgid gibt es folgende Rückkehrcodes:
0 = Aufgabe erfolgreich beendet
1 = EOF bei der Eingabe
2 = Falsche Verwendung
3 = Abbruch durch Benutzer (quit)
HINWEISE
Der Standard-Prompt für ckgid lautet:
Enter the name of an existing group [?,q]:
[Name einer bereits vorhandenen Gruppe eingeben [?,q]:]
Die Standard-Fehlermeldung lautet:
ERROR - Please enter the name of an existing group.
[ERROR - Bitte den Namen einer bereits vorhandenen Gruppe
eingeben.]
(Wurde die Option -m mit ckgid benutzt, so wird hier eine Liste
der gültigen Gruppen angezeigt.)
Die Standard-Hilfemeldung lautet:
Please enter an existing group name.
[Bitte den Namen einer bereits vorhandenen Gruppe eingeben.]
(Wurde die Option -m mit ckgid benutzt, so wird hier eine Liste
der gültigen Gruppen angezeigt.)
Ist die Option quit erlaubt und wird sie ausgewählt, wird q zusammen
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
ckgid(1M) ckgid(1M)
mit dem Rückkehrcode 3 zurückgegeben. Der Modul valgid erzeugt keine
Ausgabe. Bei erfolgreicher Ausführung gibt er null, andernfalls eine
Zahl ungleich null zurück.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98