ckuid(1M) ckuid(1M)
NAME
ckuid, erruid, helpuid, valuid - Fordert zur Eingabe einer Benutzer-
kennung auf und überprüft sie
SYNTAX
/usr/bin/ckuid [-Q] [-W width] [-m] [-d default] [-h help] [-e error]
[-p prompt] [-k pid [-s signal]]
/usr/sadm/bin/erruid [-W] [-e error]
/usr/sadm/bin/helpuid [-W] [-m] [-h help]
/usr/sadm/bin/valuid input
BESCHREIBUNG
ckuid gibt eine Eingabeaufforderung aus und überprüft die Antwort.
Zusätzlich kann damit eine Eingabeaufforderung definiert werden, auf
die mit einer existierenden Benutzerkennung geantwortet werden soll,
sowie Text für Hilfe- und Fehlermeldungen und ein Standardwert, der
zurückgegeben wird, wenn der Benutzer als Antwort <RETURN> eingibt.
Alle Meldungen dürfen 70 Zeichen lang sein und werden automatisch for-
matiert. In der Definition verwendete Zwischenraumzeichen einschließ-
lich des Neue-Zeile-Zeichens werden entfernt. Mit der Option -W wird
die automatische Formatierung ausgeschaltet. Steht am Anfang oder am
Ende einer Meldungsdefinition eine Tilde, wird an dieser Stelle der
Standardtext eingefügt, und sowohl der angepaßte als auch der Stan-
dardtext angezeigt.
Wird die Eingabeaufforderung, Hilfemeldung oder Fehlermeldung nicht
definiert, erscheint die Standardmeldung wie unter HINWEISE beschrie-
ben.
Mit dem Kommando ckuid sind drei visuelle Module verbunden, und zwar
erruid (formatiert eine Fehlermeldung und zeigt sie an), helpuid (for-
matiert eine Hilfemeldung und zeigt sie an) und valuid (überprüft die
Eingabe). Diese Module sollten Sie zusammen mit FML-Objekten benutzen.
Dabei definiert das FML-Objekt die Eingabeaufforderung.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
ckuid(1M) ckuid(1M)
OPTIONEN
-Q Gibt an, daß quit keine gültige Antwort ist.
-W Bestimmt, daß Eingabeaufforderungen, Hilfe- und Fehlermeldungen
mit der Länge width formatiert werden.
-m Zeigt eine Liste aller Benutzerkennungen an, wenn Hilfe ange-
fordert wird oder der Benutzer einen Fehler macht.
-d Definiert den Standardwert als default. Der Standardwert wird
nicht überprüft und muß daher keinem Kriterium entsprechen.
-h Definiert die Hilfemeldungen als help.
-e Definiert die Fehlermeldungen als error.
-p Definiert die Eingabeaufforderung als prompt.
-k Gibt an, daß ein Signal an die Prozeßnummer pid gesendet wird,
wenn der Benutzer die Ausführung abbricht.
-s Bestimmt, daß an die mit der Option -k definierte Prozeßnummer
pid ein Signal signal gesendet wird, wenn mit quit abgebrochen
wird. Wird kein Signal angegeben, wird SIGTERM verwendet.
input Eingabe, die anhand von /etc/passwd überprüft werden soll.
DIAGNOSE
0 = Erfolgreiche Ausführung
1 = EOF (Dateiende) bei Eingabe
2 = Falsche Verwendung
3 = Abbruch durch Benutzer (quit)
HINWEISE
Die Standard-Eingabeaufforderung bei ckuid lautet:
Enter the login name of an existing user [?,q]:
(Benutzernamen eines vorhandenen Benutzers eingeben [?,q]:)
Die Standard-Fehlermeldung lautet:
ERROR - Please enter the login name of an existing user.
Select the help option (?) for a list of valid login names.
(FEHLER - Bitte Benutzernamen eines vorhandenen Benutzers eingeben.
Hilfeoption (?) auswählen, damit eine Liste gültiger Benutzernamen
angezeigt wird.)
[Die letzte Zeile erscheint nur, wenn die Option -m von ckuid
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
ckuid(1M) ckuid(1M)
angegeben wird.]
Die Standard-Hilfemeldung lautet:
Please enter the login name of an existing user.
(Bitte Benutzernamen eines vorhanden Benutzers eingeben.)
[Wenn die Option -m von ckuid angegeben wird, wird auch eine Liste der
gültigen Gruppen angezeigt.]
Wird quit gewählt (und zulässig ist), wird q zusammen mit dem Rück-
kehrcode 3 zurückgegeben. Das Modul valuid erzeugt keinerlei Ausgabe.
Es gibt bei Erfolg eine Null zurück und ein anderes Zeichen, das nicht
Null ist, wenn die Operation fehlschlägt.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98