cktime(1M) cktime(1M)
NAME
cktime, errtime, helptime, valtime - Zeigt eine Eingabeaufforderung
an; überprüft eine Uhrzeitangabe und gibt sie zurück
SYNTAX
/usr/bin/cktime [-Q] [-W width] [-f format] [-d default] [-h help]
[-e error] [-p prompt] [-k pid [-s signal]]
/usr/sadm/bin/errtime [-W] [-e error] [-f format]
/usr/sadm/bin/helptime [-W] [-h help] [-f format]
/usr/sadm/bin/valtime [-f format] input
BESCHREIBUNG
cktime gibt eine Eingabeaufforderung aus und überprüft die Eingabe.
Außerdem kann damit eine Eingabeaufforderung definiert werden, auf die
mit einer Uhrzeitangabe geantwortet werden soll, sowie Text für Hilfe-
und Fehlermeldungen und ein Standardwert, der zurückgegeben wird, wenn
der Benutzer als Antwort <RETURN> eingibt. Die Antwort des Benutzers
muß dem definierten Uhrzeitformat entsprechen.
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 cktime sind drei visuelle Module verbunden, und
zwar errtime (formatiert eine Fehlermeldung und zeigt sie an), help-
time (formatiert eine Hilfemeldung und zeigt sie an) und valtime
(überprüft die Eingabe). Sie sollten diese Module zusammen mit FML-
Objekten benutzen. Dabei bestimmt das FML-Objekt die Eingabeaufforde-
rung. Wird format in den Modulen errtime und helptime definiert,
beschreibt die Meldung das erwartete Format.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
cktime(1M) cktime(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.
-f Gibt das Format an, anhand dessen die Eingabe überprüft wird.
Folgende Formate sind möglich:
%H = Stunde (00 - 23)
%I = Stunde (00 - 12)
%M = Minute (00 - 59)
%p = Vormittag bzw. Nachmittag
%r = Zeitangabe %I:%M:%S%p
%R = Zeitangabe %H:%M (Standardformat)
%S = Sekunden (00 - 59)
%T = Zeitangabe %H:%M:%S
-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 Die Eingabe, die anhand der Formatkriterien überprüft wird.
DIAGNOSE
0 = Erfolgreiche Ausführung
1 = EOF (Dateiende) bei Eingabe
2 = Falsche Verwendung
3 = Abbruch durch Benutzer (quit)
4 = Verstümmeltes Formatargument
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
cktime(1M) cktime(1M)
HINWEISE
Die Standard-Eingabeaufforderung für cktime lautet:
Enter the time of day [?,q]:
(Uhrzeit eingeben [?,q]:)
Die Standard-Fehlermeldung lautet:
ERROR - Please enter the time of day, using the following format:
format
(FEHLER - Bitte Uhrzeit im folgenden Format eingeben:
format)
Die Standard-Hilfemeldung lautet:
Please enter the time of day, using the following format:
format
(Bitte Uhrzeit im folgenden Format eingeben:
format)
Wird die Option quit ausgewählt (und ist sie zulässig), wird q zusam-
men mit dem Rückkehrcode 3 zurückgegeben. Das Modul valtime 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