pfmt(1) pfmt(1)
NAME
pfmt - Fehlermeldung im Standardformat anzeigen
SYNTAX
pfmt [-l label] [-s severity] [-g catalog:msgid] format [args]
BESCHREIBUNG
pfmt verwendet die Zeichenkette format, um die in args angegebenen
Argumente im Stil von printf zu formatieren. Wurde die Option -g ange-
geben, ruft pfmt eine internationalisierte Version der Zeichenkette
format aus einer Meldungsdatenbank der internationalen Umgebung ab.
Die Ausgabe wird auf die Standard-Fehlerausgabe (stderr) geschrieben.
pfmt formatiert die Ausgabe im Standardformat für Fehlermeldungen. Die
Option -l label gibt die mit der Meldung anzuzeigende Marke (bei-
spielsweise "UX:cat") an.
label ist eine aus maximal 25 Zeichen bestehende Zeichenkette, der
automatisch ein Doppelpunkt (:) angehängt wird. Wird diese Option
nicht angegeben, wird keine Marke als Teil der Nachricht angezeigt.
Die Umgebungsvariable LCALLLABELS legt fest, ob dem Meldungstext
Marken hinzugefügt werden. Der Wert der Umgebungsvariablen
LCALLLABELS wird während der Formatierung der ersten Meldung abgeru-
fen. Marken werden allen nachfolgenden Meldungen auf dieselbe Art hin-
zugefügt (bzw. nicht hinzugefügt). Wird die Umgebungsvariable
LCALLLABELS nach der ersten Meldung geändert oder gesetzt, hat dies
keine Auswirkungen auf den aktuellen Formatierungsvorgang.
Ist LCALLLABELS auf den Wert 1 gesetzt, wird die Marke in die Mel-
dung eingeschlossen. Ist LCALLLABELS nicht gesetzt, leer oder auf
den Wert 0 gesetzt, wird lediglich der Meldungstext angezeigt. Alle
anderen Werte für LCALLLABELS erzeugen undefinierte Ergebnisse.
Die folgende Meldung wird beispielsweise erzeugt, wenn die Umgebungs-
variable LCALLLABELS auf den Wert 1 gesetzt ist:
UX:cat: ERROR: Cannot open door: No such file or directory
Wäre LCALLLABELS nicht gesetzt, leer oder auf den Wert 0 gesetzt,
würde anstelle der Meldung oben die folgende Meldung angezeigt werden:
cat: Cannot open door: No such file or directory
Die Option -s severity gibt die Gewichtungszeichenkette an, die mit
der Meldung angezeigt werden soll. Gültige Zeichenketten sind die
Standardgewichtungen im Format ihrer Ausgabezeichenkette (d. h. HALT,
ERROR, INFO, WARNING und "TO FIX") oder ihres Schlüsselworts (d. h.
halt, error, info, warn und action) bzw. einer beliebigen anderen
benutzerdefinierten Zeichenkette. Einer benutzerdefinierten Zeichen-
kette wird der ganzzahlige Gewichtungswert 5 zugeordnet. Der Gewich-
tung wird ein Doppelpunkt (:) angehängt. Wird keine Gewichtung
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
pfmt(1) pfmt(1)
angegeben, wird die Gewichtung ERROR verwendet.
Die Option -g catalog:msgnum gibt an, daß eine internationalisierte
Version der Zeichenkette format aus einer Meldungsdatenbank abgerufen
werden soll.
catalog gibt die Meldungsdatenbank an, die die internationalisierte
Version der Zeichenkette format enthält. catalog darf maximal 14 Zei-
chen lang sein. Diese Zeichen müssen aus der Menge aller Zeichenwerte
außer \0 (Null) sowie den ASCII-Codes für / (Slash) und : (Doppel-
punkt), ausgewählt werden.
msgnum ist eine positive Zahl, die den Index der Zeichenkette in der
Meldungsdatenbank angibt.
Ist der Katalog nicht in der aktuellen (durch die Umgebungsvariablen
LCMESSAGES oder LANG definierten) internationalen Umgebung vorhanden,
oder liegt die Meldungsnummer außerhalb des zulässigen Bereichs, ver-
sucht pfmt die Meldung aus der internationalen Umgebung C abzurufen.
Schlägt dieser zweite Abruf fehl, verwendet pfmt die Zeichenkette for-
mat wie in der Kommandozeile übergeben.
Wenn catalog kein gültiger Katalogname oder msgnum keine gültige Num-
mer ist, gibt pfmt die Zeichenkette Message not found!!\n format aus.
STANDARDFORMAT FÜR FEHLERMELDUNGEN
pfmt zeigt Fehlermeldungen im folgenden Format an:
label: severity: text
Wenn über die Option -l label keine Marke label definiert wurde, wird
die Meldung im folgenden Format angezeigt:
severity: text
Wird pfmt zweimal aufgerufen, um eine Fehlermeldung sowie Hinweise zur
Fehlerbehebung oder Wiederherstellung anzuzeigen, kann die Ausgabe
folgendermaßen aussehen:
label: severity: text
label: TO FIX: text
ENDE-STATUS
Bei Erfolg wird pfmt mit dem Code 0 beendet. Bei einem Fehlschlag wird
pfmt mit einem der folgenden Codes beendet:
1 Schreibfehler
3 Syntaxfehler
BEISPIEL
pfmt -l UX:test -s error "Syntax error\n"
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
pfmt(1) pfmt(1)
Dieses Kommando gibt folgende Meldung aus:
UX:test: ERROR: Syntax error
SIEHE AUCH
fmtmsg(1), gettxt(1), lfmt(1), printf(1), environ(5).
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98