Befehl "localedef"

Online bearbeiten

Zweck

Konvertiert die Quellendateien von Ländereinstellungs- und Zeichensatzdateien (charmap), um eine Ländereinstellungsdatenbank zu erstellen.

Syntax

localedef [ -c ] [ -f Charmap ] [ -i SourceFile ] [ -L LinkOptions ] [ -m MethodFile ] LocaleName

Beschreibung

Der Befehl localedef konvertiert Quellendateien, die Definitionen ländereinstellungsabhängiger Informationen (z. B. Sortierung, Datums-/Zeitformate und Zeicheneigenschaften) enthalten, in eine zur Laufzeit verwendete Objektdatei mit Ländereinstellungen. Die vom Befehl localedef erstellte Objektdatei mit Ländereinstellungen wird dann von Befehlen und Subroutinen verwendet, die die Ländereinstellung mit der Subroutine setlocale festlegen.

Das Flag und die Variable -i Quellendatei geben die Datei an, die die Definitionen der Quellenkategorien enthält. Wenn das Flag -i nicht angegeben ist, wird die Datei aus der Standardeingabe gelesen.

Das Flag und die Variable -f CharMap geben eine Datei an, die Zeichensymbole den tatsächlichen Zeichencodierungen zuordnet. Mit dem Flag -f kann eine einzige Ländereinstellungsquellendefinition auf mehrere codierte Zeichensätze angewendet werden. Wenn das Flag -f nicht angegeben ist, ist der Standardwert für die Variable CharMap ISO8859-1.

Der Parameter Name_der_Ländereinstellung gibt den Ländereinstellungsnamen für die vom Befehl localedef aus den angegebenen Quellendateien generierte Ländereinstellungsdatenbank an. Der Parameter Name_der_Ländereinstellung kann entweder ein absoluter Pfadname für die Dateiposition oder ein relativer Pfadname sein.

Wenn eine Quellendefinition einer Ländereinstellungskategorie eine Kopieranweisung enthält und in der Anweisung eine vorhandene Ländereinstellung angegeben ist, die im System installiert ist, fährt der Befehl localedef so fort, als enthielte die Quellendefinition die gültige Kategoriequellendefinition für die angegebene Ländereinstellung.

Anmerkungen:
  1. Der Befehl localedef verwendet den C-Compiler zum Generieren der Ländereinstellungsdatenbank. Deshalb muss zur Verwendung dieses Befehls der C-Compiler installiert sein.
  2. Beim Ersetzen von systemweiten Datenbanken empfiehlt es sich, einen Warmstart durchzuführen, um sicherzustellen, dass die neue Ländereinstellung im gesamten System verwendet wird.

Wenn ein Fehler erkannt wird, wird keine permanente Ausgabe erstellt.

Wenn Warnungen auftreten, wird eine permanente Ausgabe erstellt, wenn das Flag -c angegeben ist. Die folgenden Bedingungen führen zur Ausgabe von Warnungen:

  • Für die Beschreibungen der Kategorien LC_TYPE oder LC_COLLATE wird ein symbolischer Name verwendet, der nicht in der Datei gefunden wird, auf die die Variable Charmap verweist. Dies ist eine Fehlerbedingung für andere Kategorien.
  • Die Anzahl der Operanden für das Schlüsselwort order_start überschreitet den Grenzwert COLL_WEIGHTS_MAX .
  • Die Quellendatei enthält optionale Schlüsselwörter, die von der Implementierung nicht unterstützt werden.

Flags

Element Beschreibung
-c Erzwingt das Erstellen von Ländereinstellungstabellen, selbst wenn Warnungen ausgegeben werden.
-f CharMap Gibt den Namen einer Datei an, die eine Zuordnung von Zeichensymbolen und Sortierelementsymbolen zu tatsächlichen Zeichencodierungen enthält. Eine Ländereinstellung wird nur einem einzigen codierten Zeichensatz zugeordnet. Wenn dieses Flag nicht angegeben ist, wird der codierte Zeichensatz ISO 8859-1 angenommen.
Hinweis: Die Verwendung bestimmter vom System bereitgestellter CharMap -Dateien wird vollständig unterstützt. Obwohl korrekt definierte benutzerdefinierte CharMap-Dateien ordnungsgemäß funktionieren können, ist das Ergebnis einer solchen Verwendung jedoch nicht garantiert.
-i SourceFile Gibt den Pfadnamen einer Datei an, die die Quellendefinitionen der Ländereinstellungskategorien enthält. Wenn dieses Flag nicht angegeben ist, werden die Quellendefinitionen aus der Standardeingabe gelesen.
-L LinkOptions Übergibt die angegebenen Linkoptionen an den Befehl ld, der zum Erstellen der Ländereinstellung verwendet wird.
-m MethodFile Gibt den Namen einer Methodendatei an, die die zu überschreibenden Methoden enthält, wenn eine Ländereinstellung erstellt wird. Die Methodendatei enthält benutzerdefinierte Subroutinen, die vorhandene Definitionen überschreiben, sowie einen Pfadnamen für die Bibliothek, die die angegebenen Subroutinen enthält. Der Befehl localedef liest die Methodendatei und verwendet beim Erstellen der Ländereinstellungsobjekte Einstiegspunkte. Die angegebenen Methoden für codierte Zeichensätze werden auch zum Parsen der mit der Variablen CharMap angegebenen Datei verwendet.
Hinweis: Um eine 64-Bit-Ländereinstellung zu erstellen, muss die Methodendatei den Pfad der Bibliothek als einzelnes Archiv angeben, das zwei gemeinsam genutzte Objekte enthält, eines 32 -Bit-und eines 64-Bit-Objekts, die die angegebenen Subroutinen enthalten. Die Angabe separater Pfade zu den gemeinsam genutzten 32-Bit- und 64-Bit-Objekten führt dazu, dass der Befehl localedef wegen eines inkompatiblen XCOFF-Formats fehlschlägt.
LocaleName Gibt den Namen der zu erstellenden Ländereinstellung an. Dieser Name kann anschließend für den Zugriff auf diese Ländereinstellungsinformationen verwendet werden.

Exitstatus

Der Befehl localedef gibt die folgenden Exitwerte zurück:

Element Beschreibung
0 Es sind keine Fehler aufgetreten und die Ländereinstellungen wurden erfolgreich erstellt.
1 Es sind Warnungen aufgetreten und die Ländereinstellungen wurden erfolgreich erstellt.
2. Die Ländereinstellungsspezifikation hat Grenzwerte überschritten oder die codierten Zeichensätze werden von der Implementierung nicht unterstützt und es wurde keine Ländereinstellung erstellt.
3 Die Erstellung neuer Ländereinstellungen wird nicht unterstützt.
> 3 Es sind Warnungen oder Fehler aufgetreten und es wurden keine Ländereinstellungen erstellt.

Beispiele

  1. Gehen Sie wie folgt vor, um eine Ländereinstellung mit dem NamenAustinGeben Sie in der Standardeingabe und unter Missachtung von Warnungen Folgendes ein:
    localedef  -c  Austin
  2. Gehen Sie wie folgt vor, um eine Ländereinstellung mit dem Namen AustinmitAustin.srcGeben Sie als Quelleneingabe Folgendes ein:
    localedef  -i  Austin.src  Austin