نام (NAME)

localedef - کامپایل پروندههای تعریف محلیسازی (Locale)

خلاصه دستور (SYNOPSIS)

localedef [گزینه‌ها] outputpath

localedef --add-to-archive [گزینه‌ها] compiledpath

localedef --delete-from-archive [گزینه‌ها] localename ...

localedef --list-archive [گزینه‌ها]

localedef --help

localedef --usage

localedef --version

توضیحات (DESCRIPTION)

برنامه localedef فایل‌های مشخص‌شده charmap (نگاشت نویسه) و input (ورودی) را می‌خواند، آن‌ها را به یک ساختار دودویی کامپایل می‌کند که توابع محلی‌سازی در کتابخانه C (setlocale(3), localeconv(3) و غیره) بتوانند به سرعت از آن استفاده کنند، و خروجی را در outputpath قرار می‌دهد.

آرگومان outputpath به صورت زیر تفسیر می‌شود:

•: اگر outputpath شامل نویسه اسلش ('/') باشد، به عنوان نام دایرکتوری‌ای که تعاریف خروجی باید در آن ذخیره شوند تفسیر می‌گردد. در این حالت، برای هر دسته‌بندی محلی (LC_TIME, LC_NUMERIC و غیره) یک فایل خروجی جداگانه وجود دارد.
•: اگر گزینه --no-archive استفاده شود، outputpath نام یک زیردایرکتوری در /usr/lib/locale است که فایل‌های کامپایل‌شده به تفکیک هر دسته‌بندی در آن قرار می‌گیرند.
•: در غیر این صورت، outputpath نام یک محلی (locale) در نظر گرفته می‌شود و داده‌های کامپایل‌شده محلی به فایل آرشیو /usr/lib/locale/locale-archive افزوده می‌گردد. آرشیو محلی یک فایل نگاشت‌شده در حافظه (memory-mapped) است که شامل تمامی محلی‌های ارائه‌شده توسط سامانه می‌باشد؛ این فایل توسط تمام برنامه‌های محلی‌سازی‌شده در زمانی که متغیر محیطی LOCPATH تنظیم نشده باشد، استفاده می‌شود.

در هر حال، اگر دایرکتوری‌ای که localedef تلاش می‌کند فایل‌های محلی را در آن بنویسد از قبل ایجاد نشده باشد، اجرای برنامه متوقف می‌شود.

اگر هیچ charmapfile (فایل نگاشت نویسه) مشخص نشود، مقدار ANSI_X3.4-1968 (برای ASCII) به طور پیش‌فرض استفاده می‌شود. اگر هیچ inputfile (فایل ورودی) مشخص نشود، یا اگر به صورت یک خط تیره (-) داده شود، localedef داده‌ها را از ورودی استاندارد می‌خواند.

گزینهها (OPTIONS)

گزینه‌های انتخاب عملیات (Operation-selection options)

تعداد کمی از گزینه‌ها به localedef دستور می‌دهند که کاری غیر از کامپایل تعاریف محلی انجام دهد. در هر نوبت تنها باید از یکی از این گزینه‌ها استفاده شود.

--add-to-archive: دایرکتوری‌های compiledpath را به فایل آرشیو محلی اضافه می‌کند. این دایرکتوری‌ها باید توسط اجراهای قبلی localedef، با استفاده از --no-archive ایجاد شده باشند.
--delete-from-archive: محلی‌های نام‌برده‌شده را از فایل آرشیو محلی حذف می‌کند.
--list-archive: فهرست محلی‌های موجود در فایل آرشیو محلی را نمایش می‌دهد.

سایر گزینه‌ها (Other options)

برخی از گزینه‌های زیر تنها برای عملیات خاصی معنادار هستند؛ به طور کلی، باید کاملاً آشکار باشد که کدام گزینه‌ها برای چه عملیاتی هستند. توجه داشته باشید که عملکرد -f و -c برعکس آن چیزی است که ممکن است انتظار داشته باشید؛ به این معنا که -f همانند --force نیست.

-f charmapfile
--charmap=charmapfile: فایلی را مشخص می‌کند که مجموعه نویسه‌های مورد استفاده توسط فایل ورودی را تعریف می‌نماید. اگر charmapfile شامل یک نویسه اسلش ('/') باشد، به عنوان نام نگاشت نویسه تفسیر می‌شود. در غیر این صورت، فایل در دایرکتوری جاری و دایرکتوری پیش‌فرض برای نگاشت‌های نویسه جستجو می‌شود. اگر متغیر محیطی I18NPATH تنظیم شده باشد، مسیرهای $I18NPATH/charmaps و $I18NPATH نیز پس از دایرکتوری جاری جستجو می‌شوند. دایرکتوری پیش‌فرض برای نگاشت‌های نویسه با اجرای دستور localedef --help چاپ می‌شود.
-i inputfile
--inputfile=inputfile: فایل تعریف محلی را برای کامپایل مشخص می‌کند. فایل در دایرکتوری جاری و دایرکتوری پیش‌فرض برای فایل‌های تعریف محلی جستجو می‌شود. اگر متغیر محیطی I18NPATH تنظیم شده باشد، مسیرهای $I18NPATH/locales و $I18NPATH نیز پس از دایرکتوری جاری جستجو می‌شوند. دایرکتوری پیش‌فرض برای فایل‌های تعریف محلی با اجرای دستور localedef --help چاپ می‌شود.
-u repertoirefile
--repertoire-map=repertoirefile: نگاشت‌ها از نام‌های نمادین به نقاط کد یونیکد (Unicode code points) را از repertoirefile می‌خواند. اگر repertoirefile شامل یک نویسه اسلش ('/') باشد، به عنوان مسیر فایل نگاشت مجموعه نشانه‌ها (repertoire map) تفسیر می‌شود. در غیر این صورت، فایل در دایرکتوری جاری و دایرکتوری پیش‌فرض برای نگاشت‌های مجموعه نشانه‌ها جستجو می‌شود. اگر متغیر محیطی I18NPATH تنظیم شده باشد، مسیرهای $I18NPATH/repertoiremaps و $I18NPATH نیز پس از دایرکتوری جاری جستجو می‌شوند. دایرکتوری پیش‌فرض برای نگاشت‌های مجموعه نشانه‌ها با اجرای دستور localedef --help چاپ می‌شود.
-A aliasfile
--alias-file=aliasfile: از aliasfile برای جستجوی نام‌های مستعار برای نام‌های محلی استفاده می‌کند. هیچ فایل مستعاری به طور پیش‌فرض وجود ندارد.
--force
-c: نوشتن فایل‌های خروجی حتی در صورتی که هشدارهایی درباره فایل ورودی تولید شده باشد.
--verbose
-v: تولید هشدارهای اضافی درباره خطاهایی که معمولاً نادیده گرفته می‌شوند.
--big-endian: تولید خروجی با ترتیب بایت بزرگ‌پایان (Big-endian).
--little-endian: تولید خروجی با ترتیب بایت کوچک‌پایان (Little-endian).
--no-archive: از فایل آرشیو محلی استفاده نمی‌کند، بلکه در عوض outputpath را به عنوان یک زیردایرکتوری در همان دایرکتوری فایل آرشیو محلی ایجاد می‌کند، و فایل‌های خروجی جداگانه‌ای را برای دسته‌بندی‌های محلی درون آن می‌سازد. این گزینه برای جلوگیری از رونویسی محلی‌های سفارشیِ ایجادشده با localedef توسط به‌روزرسانی‌های آرشیو محلی سامانه سودمند است.
--no-hard-links: عدم ایجاد پیوندهای سخت (Hard links) میان محلی‌های نصب‌شده.
--no-warnings=warnings: فهرستی از هشدارهای جداشده با کاما برای غیرفعال کردن. هشدارهای پشتیبانی‌شده عبارتند از ascii و intcurrsym.
--posix: پیروی دقیق از استاندارد POSIX. به منزله فعال بودن گزینه --verbose است. این گزینه در حال حاضر اثر دیگری ندارد. سازگاری با POSIX در صورت تنظیم بودن متغیر محیطی POSIXLY_CORRECT نیز مفروض در نظر گرفته می‌شود.
--prefix=pathname: پیشوندی را برای اضافه شدن به ابتدای مسیر کامل آرشیو تعیین می‌کند. به طور پیش‌فرض، پیشوند خالی است. با تنظیم پیشوند روی foo، آرشیو در مسیر foo/usr/lib/locale/locale-archive قرار می‌گیرد.
--quiet: فرونشاندن تمام اعلان‌ها و هشدارها، و گزارش کردن صرفاً خطاهای مهلک.
--replace: جایگزین کردن یک محلی در فایل آرشیو محلی. بدون این گزینه، اگر محلی از قبل در فایل آرشیو وجود داشته باشد، خطایی رخ می‌دهد.
--warnings=warnings: فهرستی از هشدارهای جداشده با کاما برای فعال کردن. هشدارهای پشتیبانی‌شده عبارتند از ascii و intcurrsym.
--help
-?: چاپ خلاصه استفاده و خروج. همچنین مسیرهای پیش‌فرض مورد استفاده توسط localedef را چاپ می‌کند.
--usage: چاپ خلاصه کوتاهی از نحوه استفاده و خروج.
--version
-V: چاپ شماره نسخه، مجوز، و سلب مسئولیت ضمانت برای localedef.

وضعیت خروج (EXIT STATUS)

یکی از مقادیر خروج زیر می‌تواند توسط localedef بازگردانده شود:

0: دستور با موفقیت انجام شد.
1: هشدارها یا خطاهایی رخ داد، اما فایل‌های خروجی نوشته شدند.
4: خطاهایی رخ داد و هیچ خروجی‌ای ایجاد نشد.

محیط (ENVIRONMENT)

POSIXLY_CORRECT: در صورت تنظیم بودن این متغیر محیطی، پرچم --posix مفروض در نظر گرفته می‌شود.
I18NPATH: فهرستی از دایرکتوری‌های جستجو برای فایل‌ها که با دونقطه (:) از هم جدا شده‌اند.

فایلها (FILES)

/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: فایل خروجی که شامل اطلاعات مربوط به رده‌بندی نویسه‌ها (character classes) است.
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: فایل خروجی که شامل اطلاعات درباره قالب‌بندی مقادیر داده و زمان است.

استانداردها (STANDARDS)

POSIX.1-2008.

مثالها (EXAMPLES)

کامپایل فایل‌های محلی برای زبان فنلاندی با مجموعه نویسه 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

همچنین ببینید (SEE ALSO)

locale(1), charmap(5), locale(5), repertoiremap(5), locale(7)