Sinopsis
localedef [-bcDlUv] [-f karakter_haritası] [-i kaynak_dosyası] [-u kod_kümesi] [-w genişlik_dosyası] yerel_adı
Açıklama
localedef yardımcı programı, yerel kategorilerine yönelik kaynak tanımlarını, işlemsel davranışları yerel ortam değişkenlerinin ayarlanmasıyla belirlenen işlevler ve yardımcı programlar tarafından kullanılabilir bir biçime dönüştürür; bkz. environ(7).
Yardımcı program, aynı yerel öğeye ait bir veya daha fazla yerel kategorisi için kaynak tanımlarını -i seçeneğinde belirtilen dosyadan (belirtilmişse) veya standart girdiden okur.
Her kategori kaynak tanımı, ilgili ortam değişkeni adı ile tanımlanır ve bir END kategori-adı ifadesi ile sonlandırılır. Aşağıdaki kategoriler desteklenmektedir:
LC_CTYPE Karakter sınıflandırmasını ve büyük/küçük harf dönüşümünü tanımlar.
LC_COLLATE Karşılaştırma (collation) kurallarını tanımlar.
LC_MONETARY Parasal bilgilerin biçimlendirilmesinde kullanılan biçimi ve sembolleri tanımlar.
LC_NUMERIC Parasal olmayan sayısal düzenleme için ondalık sınırlayıcıyı, gruplandırmayı ve gruplandırma sembolünü tanımlar.
LC_TIME Tarih ve saat bilgilerinin biçimini ve içeriğini tanımlar.
LC_MESSAGES Olumlu ve olumsuz yanıtların biçimini ve değerlerini tanımlar.
Aşağıdaki seçenekler desteklenmektedir:
-b: Çıktı için big-endian bayt sırasını kullanır.-c: Uyarı mesajları verilmiş olsa bile kalıcı çıktı oluşturur.-D: BSD tarzı çıktı. Varsayılan olan localename dizinini oluşturmak ve o dizinde LC_CTYPE, LC_COLLATE vb. dosyaları oluşturmak yerine, çıktı dosya adları “<yerel_adı>.<kategori>” biçimindedir ve geçerli dizine dökülür.-fkarakter_haritası: Karakter sembollerinin ve karşılaştırma öğesi sembollerinin gerçek karakter kodlamalarıyla eşleşmesini içeren bir dosyanın yolunu belirtir. Sembolik adlar (karşılaştırma sembolü anahtar kelimesinde tanımlanan karşılaştırma sembolleri dışındakiler) kullanılıyorsa bu seçenek belirtilmelidir. -f seçeneği mevcut değilse varsayılan karakter eşlemesi kullanılır.-ikaynak_dosyası: Kaynak tanımlarını içeren bir dosyanın yol adını belirtir. Bu seçenek mevcut değilse, kaynak tanımları standart girdiden okunur.-l: Çıktı için little-endian bayt sırasını kullanır.-ukod_kümesi: Kodlama değerleri ISO/IEC 10646-1:2000 standart konum sabiti değerleri cinsinden tanımlanan karakter sembolleri ve karşılaştırma öğesi sembollerinin hedef eşlemesi olarak kullanılan bir kod kümesinin adını belirtir. Bkz. NOTLAR.-U: Eşleşen karakter tanımı olmayan karakter sembollerinin varlığını yok sayar. Bu, bazı semboller belirli bir kodlamada mevcut olmasa bile, birden fazla kodlama genelinde ortak bir yerel tanım dosyasının kullanılmasını kolaylaştırır.-v: Standart çıktıda ayrıntılı hata ayıklama çıktısı verir.-wgenişlik_dosyası: Karakter ekran genişliği tanımlarını içeren dosyanın yol adını belirtir. Sağlanmazsa varsayılan ekran genişlikleri varsayılır; bu durum genellikle görüntülemek için tek bir karakter hücresinden fazlasını gerektiren Doğu Asya kodlamalarını veya ek ekran genişliği kaplamayan birleştirici ya da vurgu işaretlerini hesaba katmaz.-Vsürüm: Yerel tanımının sürümünü açıklayan bir sürüm dizesi belirtir. Bu dize querylocale(3) ile alınabilir ve uygulamaların yerel tanımı değişikliklerini algılamasına izin vermeyi amaçlar. Şu anda yalnızca LC_COLLATE kategorisi için saklanmaktadır.
Aşağıdaki işlenenler (operands) gereklidir:
yerel_adı Yereli tanımlar. Ad bir veya daha fazla eğik çizgi (/) karakteri içeriyorsa, yerel_adı, oluşturulan yerel tanımlarının saklanacağı bir yol adı olarak yorumlanacaktır. Bu yetenek, uygun ayrıcalıklara sahip kullanıcılarla sınırlandırılabilir. (Tek bir yerel_adı belirtmenin bir sonucu olarak, tek bir çalıştırmada birkaç kategori işlenebilse de, yalnızca aynı yerele ait kategoriler işlenebilir.)
Çıktı
localedef, -D (BSD çıktısı) seçeneğiyle aksi belirtilmedikçe, yerelin verilerini temsil eden bir dosya dizini oluşturur. Tanımların libc ile bağlantılı programlar tarafından görülebilmesi için bu dizinin içerikleri genellikle /usr/share/locale dizininin uygun alt dizinine kopyalanmalıdır.
Ortam
localedef'in yürütülmesini etkileyen aşağıdaki ortam değişkenlerinin tanımları için environ(7)'ye bakın: LANG, LC_ALL, LC_COLLATE, LC_CTYPE, LC_MESSAGES, LC_MONETARY, LC_NUMERIC, LC_TIME ve NLSPATH.
Çıkış Durumu
Aşağıdaki çıkış değerleri döndürülür:
0 Hiçbir hata oluşmadı ve yereller başarıyla oluşturuldu.
1 Uyarılar oluştu ve yereller başarıyla oluşturuldu.
2 Yerel belirtimi uygulama sınırlarını aştı veya kullanılan kodlanmış karakter kümesi ya da kümeleri uygulama tarafından desteklenmedi ve hiçbir yerel oluşturulmadı.
3 Uyarılar veya hatalar oluştu ve hiçbir çıktı oluşturulmadı.
Bir hata algılanırsa hiçbir kalıcı çıktı oluşturulmayacaktır.
Ayrıca Bakınız
locale(1), iconv_open(3), nl_langinfo(3), querylocale(3), strftime(3), environ(7)
Uyarılar
Uyarılar oluşursa, -c seçeneği belirtilmişse kalıcı çıktı oluşturulacaktır. Aşağıdaki koşullar uyarı mesajlarının verilmesine neden olur:
• LC_CTYPE veya LC_COLLATE kategorilerinin açıklamaları için charmap dosyasında bulunmayan sembolik bir ad kullanılırsa (diğer kategoriler için bu bir hata durumu olacaktır).
• Kaynak dosyada uygulama tarafından desteklenmeyen isteğe bağlı anahtar kelimeler mevcutsa.
Notlar
-u seçeneği kullanıldığında, kod_kümesi seçeneği-argümanı, ISO/IEC 10646-1:2000 standart konum sabiti değerlerinin dönüştürüldüğü bir kod kümesinin adı olarak yorumlanır. Hem ISO/IEC 10646-1:2000 standart konum sabiti değerleri hem de diğer biçimler (ondalık, onaltılık veya sekizlik) charmap dosyası içinde geçerli kodlama değereridir. Kod kümesi, iconv_open(3) işlevi tarafından desteklenen herhangi bir kod kümesi olabilir.
kod_kümesi'nin charmap belirtimi, mb_cur_max veya mb_cur_min ile -u seçeneği-argümanı kod_kümesi tarafından temsil edilen kod kümesinin karşılık gelen değeri arasında çelişkiler oluştuğunda, localedef yardımcı programı bir hata ile başarısız olur.
Taşınabilir karakter kümesinin karakterlerinin sembolik adları için belirtilen charmap kodlama değerleri ile US-ASCII tarafından tanımlanan karakter kodlama değerleri arasında çelişkiler oluştuğunda, sonuç belirsizdir.
Geçmiş
localedef ilk olarak FreeBSD 11'de göründü.
illumos için Garrett D'Amore garrett@nexenta.com tarafından yazılmıştır. DragonFly üzerinde sorunsuz bir şekilde derlemek için gerekli değişiklikleri John Marino draco@marino.st sağlamıştır. Baptiste Daroussin bapt@FreeBSD.org bunu FreeBSD'ye taşımış ve tree(3) yapısına dönüştürmüştür.
macOS 26.4 29 Haziran 2023 macOS 26.4