ckpath(1M) ckpath(1M)
NAME
ckpath, errpath, helppath, valpath - Zeigt eine Eingabeaufforderung
an; überprüft einen Pfadnamen und gibt ihn zurück
SYNTAX
/usr/bin/ckpath [-Q] [-W width] [-a|l] [-b|c|g|y] [-n|[o|z]] [-rtwx]
[-d default] [-h help] [-e error] [-p prompt]
[-k pid [-s signal]]
/usr/sadm/bin/errpath [-W] [-a|l] [-b|c|g|y] [-n|[o|z]] [-rtwx]
[-e error]
/usr/sadm/bin/helppath [-W] [-a|l] [-b|c|g|y] [-n|[o|z]] [-rtwx]
[-h help]
/usr/sadm/bin/valpath [-a|l] [-b|c|g|y] [-n|[o|z]] [-rtwx] input
BESCHREIBUNG
ckpath gibt eine Eingabeaufforderung an den Benutzer aus und überprüft
die Antwort. Zusätzlich kann eine Eingabeaufforderung definiert wer-
den, auf die mit einem Pfadnamen geantwortet werden soll. Ebenso wird
Text für Hilfe- und Fehlermeldungen und ein Standardwert definiert,
der zurückgegeben wird, wenn der Benutzer als Antwort <RETURN> ein-
gibt.
Der Pfadname muß den Kriterien entsprechen, die mit der ersten Gruppe
von Optionen festgelegt wurden. Sind keine Kriterien angegeben, muß es
sich um den Pfadnamen einer normalen Datei handeln, die noch nicht
besteht. Ist weder -a (absolut) noch -l (relativ) angegeben, werden
beide als gültig angenommen.
Alle Meldungen dürfen maximal 70 Zeichen lang sein und werden automa-
tisch formatiert. 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 Standardtext werden angezeigt.
Wird die Eingabeaufforderung, Hilfemeldung oder Fehlermeldung nicht
definiert, erscheint die Standardmeldung wie unter HINWEISE beschrie-
ben.
Mit dem Kommando ckpath sind drei visuelle Module verbunden, und zwar
errpath (formatiert eine Fehlermeldung und zeigt sie an), helppath
(formatiert eine Hilfemeldung und zeigt sie an) und valpath (überprüft
die Antwort). Diese Module sollten Sie zusammen mit FACE-Objekten
benutzen. In diesem Falle definiert das FACE-Objekt die Eingabeauffor-
derung.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
ckpath(1M) ckpath(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.
-a Der Pfadname muß einen absoluten Pfad bezeichnen.
-l Der Pfadname muß einen relativen Pfad bezeichnen.
-b Der Pfadname muß eine blockorientierte Gerätedatei bezeichnen.
-c Der Pfadname muß eine zeichenorientierte Gerätedatei bezeich-
nen.
-g Der Pfadname muß eine reguläre Datei bezeichnen.
-y Der Pfadname muß ein Verzeichnis bezeichnen.
-n Der Pfadname darf nicht existieren.
-o Der Pfadname muß existieren.
-z Der Pfadname muß länger als 0 Byte sein.
-r Der Pfadname muß lesbar sein.
-t Der Pfadname muß erstellbar sein. Der Pfadname wird angelegt,
sofern er noch nicht vorhanden ist.
-w Der Pfadname muß schreibbar sein.
-x Der Pfadname muß ausführbar sein.
-d Definiert default als den Standardwert. Der Standardwert wird
nicht überprüft und muß daher keinerlei Kriterien entsprechen.
-h Definiert help als die Hilfemeldungen.
-e Definiert error als die Fehlermeldung.
-p Definiert prompt als die Eingabeaufforderung.
-k Gibt an, daß an die Prozeßnummer pid ein Signal gesendet wird,
wenn der Benutzer die Ausführung durch quit abbricht.
-s Bestimmt, daß an die mit der Option -k definierte Prozeßnummer
pid ein Signal signal gesendet wird, wenn quit ausgewählt wird.
Wird kein Signal angegeben, wird SIGTERM verwendet.
input Eingabe, die anhand der Prüfoptionen überprüft wird.
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
ckpath(1M) ckpath(1M)
DIAGNOSE
0 = Erfolgreiche Ausführung
1 = EOF (Dateiende) bei Eingabe
2 = Falsche Verwendung
3 = Abbruch durch Benutzer (quit)
4 = Sich gegenseitig ausschließende Optionen
HINWEISE
Der Text der Standardmeldungen für ckpath hängt von den verwendeten
Optionen für die einzelnen Kriterien ab. Ein Beispiel für die
Standard-Eingabeaufforderung von ckpath (mit der Option -a):
Enter a pathname [?,q]:
(Pfadnamen eingeben [?,q]:)
Ein Beispiel für eine Standard-Fehlermeldung (mit der Option -a) lau-
tet:
ERROR - Invalid pathname entered.
A pathname is a filename, optionally preceded by parent directories.
(FEHLER - Pfadname ungültig.
Ein Pfadname ist ein Dateiname, dem optional Vaterverzeichnisse
vorausgehen.)
Ein Beispiel für eine Standard-Hilfemeldung lautet:
A pathname is a filename, optionally preceded by parent directories.
The pathname you enter:
- must contain 1 to {NAMEMAX} characters
- must not contain a spaces or special characters
(Ein Pfadname ist ein Dateiname, dem optional Vaterverzeichnisse
vorausgehen.
Der eingegebene Pfadname
- muß 1 bis {NAMEMAX} Zeichen enthalten
- darf keine Leerzeichen oder Sonderzeichen enthalten)
NAMEMAX ist eine Systemvariable, die in limits.h definiert ist.
Wird die Option quit ausgewählt (und ist sie zulässig), wird q zusam-
men mit dem Rückkehrcode 3 zurückgegeben. Das Modul valpath erzeugt
keinerlei Ausgabe. Es gibt bei Erfolg eine Null zurück und einen ande-
ren Wert, wenn die Operation fehlschlägt.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98