.\" Copyright 2001, Richard Braakman
.\" Copyright 2004, Alastair McKinstry
.\" Copyright 2005, Lars Wirzenius <liw@iki.fi>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.TH localedef 1 2026-02-08 "Linux man-pages 6.19"
.SH "نام (NAME)"
localedef \- کامپایل پروندههای تعریف محلیسازی (Locale)
.SH "خلاصه دستور (SYNOPSIS)"
.SY localedef
.RI [ گزینه‌ها ]
.I outputpath
.YS
.SY localedef
.B \-\-add\-to\-archive
.RI [ گزینه‌ها ]
.I compiledpath
.YS
.SY localedef
.B \-\-delete\-from\-archive
.RI [ گزینه‌ها ]
.IR localename \~.\|.\|.
.YS
.SY localedef
.B \-\-list\-archive
.RI [ گزینه‌ها ]
.YS
.SY localedef
.B \-\-help
.YS
.SY localedef
.B \-\-usage
.YS
.SY localedef
.B \-\-version
.YS
.SH "توضیحات (DESCRIPTION)"
برنامه
.B localedef
فایل‌های مشخص‌شده
.I charmap
(نگاشت نویسه) و
.I input
(ورودی) را می‌خواند،
آن‌ها را به یک ساختار دودویی کامپایل می‌کند که توابع محلی‌سازی در کتابخانه C
.RB ( setlocale (3),
.BR localeconv (3)
و غیره) بتوانند به سرعت از آن استفاده کنند،
و خروجی را در
.I outputpath
قرار می‌دهد.
.P
آرگومان
.I outputpath
به صورت زیر تفسیر می‌شود:
.IP \[bu] 3
اگر
.I outputpath
شامل نویسه اسلش ('/') باشد،
به عنوان نام دایرکتوری‌ای که تعاریف خروجی باید در آن ذخیره شوند تفسیر می‌گردد.
در این حالت،
برای هر دسته‌بندی محلی
.RI ( LC_TIME ,
.IR LC_NUMERIC
و غیره) یک فایل خروجی جداگانه وجود دارد.
.IP \[bu]
اگر گزینه
.B \-\-no\-archive
استفاده شود،
.I outputpath
نام یک زیردایرکتوری در
.I /usr/lib/locale
است که فایل‌های کامپایل‌شده به تفکیک هر دسته‌بندی در آن قرار می‌گیرند.
.IP \[bu]
در غیر این صورت،
.I outputpath
نام یک محلی (locale) در نظر گرفته می‌شود و داده‌های کامپایل‌شده محلی به فایل آرشیو
.I /usr/lib/locale/locale\-archive
افزوده می‌گردد.
آرشیو محلی یک فایل نگاشت‌شده در حافظه (memory-mapped) است که شامل تمامی محلی‌های ارائه‌شده توسط سامانه می‌باشد؛
این فایل توسط تمام برنامه‌های محلی‌سازی‌شده در زمانی که متغیر محیطی
.B LOCPATH
تنظیم نشده باشد، استفاده می‌شود.
.P
در هر حال،
اگر دایرکتوری‌ای که
.B localedef
تلاش می‌کند فایل‌های محلی را در آن بنویسد از قبل ایجاد نشده باشد، اجرای برنامه متوقف می‌شود.
.P
اگر هیچ
.I charmapfile
(فایل نگاشت نویسه) مشخص نشود،
مقدار
.I ANSI_X3.4\-1968
(برای ASCII) به طور پیش‌فرض استفاده می‌شود.
اگر هیچ
.I inputfile
(فایل ورودی) مشخص نشود،
یا اگر به صورت یک خط تیره
(\-)
داده شود،
.B localedef
داده‌ها را از ورودی استاندارد می‌خواند.
.SH "گزینهها (OPTIONS)"
.SS "گزینه‌های انتخاب عملیات (Operation-selection options)"
تعداد کمی از گزینه‌ها به
.B localedef
دستور می‌دهند که کاری غیر از کامپایل تعاریف محلی انجام دهد.
در هر نوبت تنها باید از یکی از این گزینه‌ها استفاده شود.
.TP
.B \-\-add\-to\-archive
دایرکتوری‌های
.I compiledpath
را به فایل آرشیو محلی اضافه می‌کند.
این دایرکتوری‌ها باید توسط اجراهای قبلی
.BR localedef ،
با استفاده از
.B \-\-no\-archive
ایجاد شده باشند.
.TP
.B \-\-delete\-from\-archive
محلی‌های نام‌برده‌شده را از فایل آرشیو محلی حذف می‌کند.
.TP
.B \-\-list\-archive
فهرست محلی‌های موجود در فایل آرشیو محلی را نمایش می‌دهد.
.SS "سایر گزینه‌ها (Other options)"
برخی از گزینه‌های زیر تنها برای عملیات خاصی معنادار هستند؛
به طور کلی،
باید کاملاً آشکار باشد که کدام گزینه‌ها برای چه عملیاتی هستند.
توجه داشته باشید که عملکرد
.B \-f
و
.B \-c
برعکس آن چیزی است که ممکن است انتظار داشته باشید؛
به این معنا که
.B \-f
همانند
.B \-\-force
نیست.
.TP
.BI \-f\~ charmapfile
.TQ
.BI \-\-charmap= charmapfile
فایلی را مشخص می‌کند که مجموعه نویسه‌های مورد استفاده توسط فایل ورودی را تعریف می‌نماید.
اگر
.I charmapfile
شامل یک نویسه اسلش ('/') باشد،
به عنوان نام نگاشت نویسه تفسیر می‌شود.
در غیر این صورت،
فایل در دایرکتوری جاری و دایرکتوری پیش‌فرض برای نگاشت‌های نویسه جستجو می‌شود.
اگر متغیر محیطی
.B I18NPATH
تنظیم شده باشد،
مسیرهای
.I $I18NPATH/charmaps
و
.I $I18NPATH
نیز پس از دایرکتوری جاری جستجو می‌شوند.
دایرکتوری پیش‌فرض برای نگاشت‌های نویسه با اجرای دستور
.B "localedef \-\-help"
چاپ می‌شود.
.TP
.BI \-i\~ inputfile
.TQ
.BI \-\-inputfile= inputfile
فایل تعریف محلی را برای کامپایل مشخص می‌کند.
فایل در دایرکتوری جاری و دایرکتوری پیش‌فرض برای فایل‌های تعریف محلی جستجو می‌شود.
اگر متغیر محیطی
.B I18NPATH
تنظیم شده باشد،
مسیرهای
.I $I18NPATH/locales
و
.I $I18NPATH
نیز پس از دایرکتوری جاری جستجو می‌شوند.
دایرکتوری پیش‌فرض برای فایل‌های تعریف محلی با اجرای دستور
.B "localedef \-\-help"
چاپ می‌شود.
.TP
.BI \-u\~ repertoirefile
.TQ
.BI \-\-repertoire\-map= repertoirefile
نگاشت‌ها از نام‌های نمادین به نقاط کد یونیکد (Unicode code points) را از
.I repertoirefile
می‌خواند.
اگر
.I repertoirefile
شامل یک نویسه اسلش ('/') باشد،
به عنوان مسیر فایل نگاشت مجموعه نشانه‌ها (repertoire map) تفسیر می‌شود.
در غیر این صورت،
فایل در دایرکتوری جاری و دایرکتوری پیش‌فرض برای نگاشت‌های مجموعه نشانه‌ها جستجو می‌شود.
اگر متغیر محیطی
.B I18NPATH
تنظیم شده باشد،
مسیرهای
.I $I18NPATH/repertoiremaps
و
.I $I18NPATH
نیز پس از دایرکتوری جاری جستجو می‌شوند.
دایرکتوری پیش‌فرض برای نگاشت‌های مجموعه نشانه‌ها با اجرای دستور
.B "localedef \-\-help"
چاپ می‌شود.
.TP
.BI \-A\~ aliasfile
.TQ
.BI \-\-alias\-file= aliasfile
از
.I aliasfile
برای جستجوی نام‌های مستعار برای نام‌های محلی استفاده می‌کند.
هیچ فایل مستعاری به طور پیش‌فرض وجود ندارد.
.TP
.B \-\-force
.TQ
.B \-c
نوشتن فایل‌های خروجی حتی در صورتی که هشدارهایی درباره فایل ورودی تولید شده باشد.
.TP
.B \-\-verbose
.TQ
.B \-v
تولید هشدارهای اضافی درباره خطاهایی که معمولاً نادیده گرفته می‌شوند.
.TP
.B \-\-big\-endian
تولید خروجی با ترتیب بایت بزرگ‌پایان (Big-endian).
.TP
.B \-\-little\-endian
تولید خروجی با ترتیب بایت کوچک‌پایان (Little-endian).
.TP
.B \-\-no\-archive
از فایل آرشیو محلی استفاده نمی‌کند، بلکه در عوض
.I outputpath
را به عنوان یک زیردایرکتوری در همان دایرکتوری فایل آرشیو محلی ایجاد می‌کند،
و فایل‌های خروجی جداگانه‌ای را برای دسته‌بندی‌های محلی درون آن می‌سازد.
این گزینه برای جلوگیری از رونویسی محلی‌های سفارشیِ ایجادشده با
.B localedef
توسط به‌روزرسانی‌های آرشیو محلی سامانه سودمند است.
.TP
.B \-\-no\-hard\-links
عدم ایجاد پیوندهای سخت (Hard links) میان محلی‌های نصب‌شده.
.TP
.BI \-\-no\-warnings= warnings
فهرستی از هشدارهای جداشده با کاما برای غیرفعال کردن.
هشدارهای پشتیبانی‌شده عبارتند از
.I ascii
و
.IR intcurrsym .
.TP
.B \-\-posix
پیروی دقیق از استاندارد POSIX.
به منزله فعال بودن گزینه
.B \-\-verbose
است.
این گزینه در حال حاضر اثر دیگری ندارد.
سازگاری با POSIX در صورت تنظیم بودن متغیر محیطی
.B POSIXLY_CORRECT
نیز مفروض در نظر گرفته می‌شود.
.TP
.BI \-\-prefix= pathname
پیشوندی را برای اضافه شدن به ابتدای مسیر کامل آرشیو تعیین می‌کند.
به طور پیش‌فرض،
پیشوند خالی است.
با تنظیم پیشوند روی
.IR foo ،
آرشیو در مسیر
.I foo/usr/lib/locale/locale\-archive
قرار می‌گیرد.
.TP
.B \-\-quiet
فرونشاندن تمام اعلان‌ها و هشدارها،
و گزارش کردن صرفاً خطاهای مهلک.
.TP
.B \-\-replace
جایگزین کردن یک محلی در فایل آرشیو محلی.
بدون این گزینه،
اگر محلی از قبل در فایل آرشیو وجود داشته باشد،
خطایی رخ می‌دهد.
.TP
.BI \-\-warnings= warnings
فهرستی از هشدارهای جداشده با کاما برای فعال کردن.
هشدارهای پشتیبانی‌شده عبارتند از
.I ascii
و
.IR intcurrsym .
.TP
.B \-\-help
.TQ
.B \-?
چاپ خلاصه استفاده و خروج.
همچنین مسیرهای پیش‌فرض مورد استفاده توسط
.B localedef
را چاپ می‌کند.
.TP
.B \-\-usage
چاپ خلاصه کوتاهی از نحوه استفاده و خروج.
.TP
.B \-\-version
.TQ
.B \-V
چاپ شماره نسخه،
مجوز،
و سلب مسئولیت ضمانت برای
.BR localedef .
.SH "وضعیت خروج (EXIT STATUS)"
یکی از مقادیر خروج زیر می‌تواند توسط
.B localedef
بازگردانده شود:
.TP
.B 0
دستور با موفقیت انجام شد.
.TP
.B 1
هشدارها یا خطاهایی رخ داد، اما فایل‌های خروجی نوشته شدند.
.TP
.B 4
خطاهایی رخ داد و هیچ خروجی‌ای ایجاد نشد.
.SH "محیط (ENVIRONMENT)"
.TP
.B POSIXLY_CORRECT
در صورت تنظیم بودن این متغیر محیطی، پرچم
.B \-\-posix
مفروض در نظر گرفته می‌شود.
.TP
.B I18NPATH
فهرستی از دایرکتوری‌های جستجو برای فایل‌ها که با دونقطه (:) از هم جدا شده‌اند.
.SH "فایلها (FILES)"
.TP
.I /usr/share/i18n/charmaps
مسیر پیش‌فرض معمول برای نگاشت‌های نویسه.
.TP
.I /usr/share/i18n/locales
مسیر پیش‌فرض معمول برای فایل‌های تعریف محلی.
.TP
.I /usr/share/i18n/repertoiremaps
مسیر پیش‌فرض معمول برای نگاشت‌های مجموعه نشانه‌ها.
.TP
.I /usr/lib/locale/locale\-archive
محل پیش‌فرض معمول برای فایل آرشیو محلی.
.TP
.I /usr/lib/locale
مسیر پیش‌فرض معمول برای فایل‌های داده کامپایل‌شده محلی‌ها به صورت مجزا.
.TP
.I outputpath/LC_ADDRESS
فایل خروجی که شامل اطلاعات مربوط به قالب‌بندی نشانی‌ها و موارد مرتبط با جغرافیا است.
.TP
.I outputpath/LC_COLLATE
فایل خروجی که شامل اطلاعات مربوط به قواعد مقایسه و ترتیب رشته‌ها است.
.TP
.I outputpath/LC_CTYPE
فایل خروجی که شامل اطلاعات مربوط به رده‌بندی نویسه‌ها (character classes) است.
.TP
.I outputpath/LC_IDENTIFICATION
فایل خروجی که شامل فراداده (متادیتا) درباره محلی است.
.TP
.I outputpath/LC_MEASUREMENT
فایل خروجی که شامل اطلاعات درباره یکاهای اندازه‌گیری محلی (سامانه متری در مقایسه با سامانه مرسوم ایالات متحده) است.
.TP
.I outputpath/LC_MESSAGES/SYS_LC_MESSAGES
فایل خروجی که شامل اطلاعات درباره زبانی است که پیام‌ها باید با آن نمایش یابند، و این‌که پاسخ مثبت یا منفی چگونه است.
.TP
.I outputpath/LC_MONETARY
فایل خروجی که شامل اطلاعات درباره قالب‌بندی مقادیر پولی است.
.TP
.I outputpath/LC_NAME
فایل خروجی که شامل اطلاعات درباره نحوه خطاب و القاب افراد است.
.TP
.I outputpath/LC_NUMERIC
فایل خروجی که شامل اطلاعات درباره قالب‌بندی مقادیر عددی غیرپولی است.
.TP
.I outputpath/LC_PAPER
فایل خروجی که شامل اطلاعات درباره تنظیمات مربوط به اندازه استاندارد کاغذ است.
.TP
.I outputpath/LC_TELEPHONE
فایل خروجی که شامل اطلاعات درباره قالب‌های مورد استفاده در خدمات تلفنی است.
.TP
.I outputpath/LC_TIME
فایل خروجی که شامل اطلاعات درباره قالب‌بندی مقادیر داده و زمان است.
.SH "استانداردها (STANDARDS)"
POSIX.1-2008.
.SH "مثالها (EXAMPLES)"
کامپایل فایل‌های محلی برای زبان فنلاندی با مجموعه نویسه UTF\-8 و افزودن آن به آرشیو پیش‌فرض محلی با نام
.BR fi_FI.UTF\-8 :
.P
.in +4n
.EX
localedef \-f UTF\-8 \-i fi_FI fi_FI.UTF\-8
.EE
.in
.P
مثال بعدی همان کار را انجام می‌دهد، اما فایل‌ها را در دایرکتوری
.I fi_FI.UTF\-8
تولید می‌کند که در صورت تنظیم بودن متغیر محیطی
.B LOCPATH
روی دایرکتوری جاری می‌تواند توسط برنامه‌ها استفاده شود (توجه داشته باشید که آرگومان پایانی باید شامل یک اسلش باشد):
.P
.in +4n
.EX
localedef \-f UTF\-8 \-i fi_FI ./fi_FI.UTF\-8
.EE
.in
.SH "همچنین ببینید (SEE ALSO)"
.BR locale (1),
.BR charmap (5),
.BR locale (5),
.BR repertoiremap (5),
.BR locale (7)