localedef(1) | General Commands Manual | localedef(1) |
ИМЯ
localedef - компилирует файлы определения локали
СИНТАКСИС
localedef |
[параметры] путь_результата |
localedef |
--add-to-archive [параметры] путь_скомпилированного |
localedef |
--delete-from-archive [параметры] имя_локали … |
localedef |
--list-archive [параметры] |
localedef |
--help |
localedef |
--usage |
localedef |
--version |
ОПИСАНИЕ
Программа localedef читает заданные файлы карты символов (charmap) и входные файлы, компилирует их в двоичную форму для быстрого доступа из функций локали библиотеки C (setlocale(3), localeconv(3) и т. д.) и помещает результат в путь_результата.
Аргумент путь_результата рассматривается следующим образом:
- •
- Если путь_результата содержит косую черту («/»), то он считается именем каталога для хранения создаваемых определений. В этом случае создаётся отдельный файл результата для каждой категории локали (LC_TIME, LC_NUMERIC и так далее).
- •
- Если указан параметр --no-archive, то путь_результата считается именем подкаталога в /usr/lib/locale, где размещены скопированные файлы для каждой категории.
- •
- В противном случае, путь_результата считается именем локали и компилируемые данные локали добавляются в файл архива /usr/lib/locale/locale-archive. Файл архива — это файл отображаемый в память, который содержит все локали системы; он используется всеми локализованными программами, если не установлена переменная окружения LOCPATH.
В любом случае, localedef прекращает работу, если каталог, в который она пытается записать файлы локали, ещё не был создан.
Если файл карты символов не указан, то по умолчанию используется значение ANSI_X3.4-1968 (для ASCII). Если не указан входной файл, или если вместо него указан перенос (-), то localedef читает данные из стандартного входного потока.
ПАРАМЕТРЫ
Параметры действия-выбора
Некоторые параметры указывают localedef сделать что-то другое, а не компилировать определения локали. Одновременно может быть указан только один такой параметр.
- --add-to-archive
- Добавить каталоги путь_скомпилированного файл архива локалей. Каталоги должны быть созданы ранее запускавшимся localedef с параметром --no-archive.
- --delete-from-archive
- Удалить заданную локаль из файла архива локалей.
- --list-archive
- Показать список локалей, содержащихся в файле архива локалей.
Другие параметры
Следующие параметры имеют значение только для определённых операций; обычно, по названию понятно для каких. Заметим, что параметры -f и -c работают не так как можно ожидать, то есть -f это не тоже самое что --force.
- -f charmapfile, --charmap=charmapfile
- Задаёт файл, которым определяется набор символов, используемый в файле входных данных. Если значение файл_карты_символов содержит косую черту («/»), то оно рассматривается как название карты символов. В противном случае, файл ищется в текущем каталоге и каталоге по умолчанию для карт символов. Если установлена переменная окружения I18NPATH, то после текущего каталога также просматриваются $I18NPATH/charmaps/ и $I18NPATH/. Каталог по умолчанию для карт символов можно увидеть в выводе localedef --help.
- -i inputfile, --inputfile=inputfile
- Задаёт файл определения локали для компиляции. Файл ищется в текущем каталоге и каталоге по умолчанию для файлов определения локалей. Если установлена переменная окружения I18NPATH, то после текущего каталога также просматриваются $I18NPATH/locales/ и $I18NPATH. Каталог по умолчанию для файлов определения локалей можно увидеть в выводе localedef --help.
- -u repertoirefile, --repertoire-map=repertoirefile
- Из файла_набора читаются отображения символических имён в кодовые точки Юникода. Если значение файла_набора содержит косую черту («/»), то оно рассматривается имя пути карты набора (repertoire map). В противном случае, файл ищется в текущем каталоге и каталоге по умолчанию для карт наборов. Если установлена переменная окружения I18NPATH, то после текущего каталога также просматриваются $I18NPATH/repertoiremaps/ и $I18NPATH. Каталог по умолчанию для карт наборов можно увидеть в выводе localedef --help.
- -A aliasfile, --alias-file=aliasfile
- Использовать файл_псевдонимов для поиска псевдонимов имён локалей. Для файла псевдонимом нет файла по умолчанию.
- --force
- -c
- Записывать файлы результата даже, если есть предупреждения при генерации входных данных.
- --verbose
- -v
- Генерировать дополнительные предупреждения об ошибках, которые обычно игнорируются.
- --big-endian
- Генерировать вывод с прямым порядком байт (big endian).
- --little-endian
- Генерировать вывод с обратным порядком байт (little endian).
- --no-archive
- Не использовать файл архива локалей, вместо этого создать путь_результата в качестве подкаталога в текущем каталоге для файла архива локалей, и создать в нём отдельные файлы результата для категорий локали. Это позволяет не перезаписывать системный архив локалей пользовательскими локалями, созданными с помощью localedef.
- --no-hard-links
- Не создавать жёсткие ссылки между установленными локалями.
- --no-warnings=warnings
- Разделенный запятыми список отключённых предупреждений; поддерживаемые предупреждения: ascii и intcurrsym.
- --posix
- Жёстко следовать POSIX. Подразумевает --verbose. Этот параметр, в настоящее время, больше ничего не делает. Соответствие POSIX предполагается, если установлена переменная окружения POSIXLY_CORRECT.
- --prefix=путь
- Указывает префикс полного пути к архиву. По умолчанию префикс пуст. Если указать в качестве префикса foo, то архив будет помещён в foo/usr/lib/locale/locale-archive.
- --quiet
- Не показывать все уведомления и предупреждения; сообщать только о фатальных ошибках.
- --replace
- Заменить локаль в файле архива локалей. Без этого параметра, если локаль в архиве уже есть, то выдаётся ошибка.
- --warnings=warnings
- Разделенный запятыми список включённых предупреждений; поддерживаемые предупреждения: ascii и intcurrsym.
- --help
- -?
- Показать справку по использованию и завершить работу. Также выводятся пути по умолчанию, используемые в localedef.
- --usage
- Показать краткую справку по использованию и завершить работу.
- --version
- -V
- Показать номер версии, лицензию и уведомление о гарантиях для localedef.
КОД ЗАВЕРШЕНИЯ
Программа localedef может возвращать один из следующих кодов завершения:
- 0
- Команда успешно выполнена.
- 1
- Произошла ошибка или предупреждение, файлы результата записаны.
- 4
- Произошла ошибка, результат не записан.
СРЕДА ОКРУЖЕНИЯ
- POSIXLY_CORRECT
- Если эта переменная окружения установлена, то предполагается флаг --posix.
- I18NPATH
- Список каталогов через двоеточие для поиска файлов.
ФАЙЛЫ
- /usr/share/i18n/charmaps
- Обычный путь по умолчанию для файлов карт символов.
- /usr/share/i18n/locales
- Обычный путь по умолчанию для файлов определений локалей.
- /usr/share/i18n/repertoiremaps
- Обычный путь по умолчанию для файла карты набора.
- /usr/lib/locale/locale-archive
- Обычный путь по умолчанию для расположения архива локалей.
- /usr/lib/locale
- Обычный путь по умолчанию для скомпонованных файлов данных отдельных локалей.
- outputpath/LC_ADDRESS
- Файл результата содержит информацию о формате адресов и географических элементах.
- outputpath/LC_COLLATE
- Файл результата содержит информацию о правилах сравнения строк.
- outputpath/LC_CTYPE
- Файл результата содержит информацию о классах символов.
- outputpath/LC_IDENTIFICATION
- Файл результата содержит метаданные о локали.
- outputpath/LC_MEASUREMENT
- Файл результата содержит информацию о единицах измерения (метрическая или система мер США).
- outputpath/LC_MESSAGES/SYS_LC_MESSAGES
- Файл результата содержит информацию о языке, на котором должны выводиться сообщения и как выглядят ответы «да» и «нет».
- outputpath/LC_MONETARY
- Файл результата содержит информацию о правилах написания денежных единиц.
- outputpath/LC_NAME
- Файл результата содержит информацию об описании персон.
- outputpath/LC_NUMERIC
- Файл результата содержит информацию о правилах написания не денежных числовых единиц.
- outputpath/LC_PAPER
- Файл результата содержит информацию о параметрах, относящихся к размерам бумаги.
- outputpath/LC_TELEPHONE
- Файл результата содержит информацию о форматах, используемых в телефонных службах.
- outputpath/LC_TIME
- Файл результата содержит информацию о форматах значений даты и времени.
СТАНДАРТЫ
POSIX.1-2008.
ПРИМЕРЫ
Компилирование файлов локали для финских пользователей с набором символов UTF-8 и добавление к архиву локалей по умолчанию с именем fi_FI.UTF-8:
localedef -f UTF-8 -i fi_FI fi_FI.UTF-8
В следующем примере делается тоже самое, но файлы генерируются в каталоге fi_FI.UTF-8, который затем можно использовать в программах, установив переменную окружения LOCPATH равной текущему каталогу (заметим, что последний аргумент должен содержать косую черту):
localedef -f UTF-8 -i fi_FI ./fi_FI.UTF-8
СМОТРИТЕ ТАКЖЕ
locale(1), charmap(5), locale(5), repertoiremap(5), locale(7)
ПЕРЕВОД
Русский перевод этой страницы руководства разработал Artyom Kunyov <artkun@guitarplayer.ru>, Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Katrin Kutepova <blackkatelv@gmail.com>, Konstantin Shvaykovskiy <kot.shv@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>
Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику по его адресу электронной почты или по адресу списка рассылки русских переводчиков.
2 мая 2024 г. | Linux man-pages 6.8 |