.\" Copyright (C) 2014 Marko Myllynen <myllynen@redhat.com>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.TH "ICONVCONFIG" "8" "مه ۲۰۲۵" "man-pages" "دستورهای مدیریتی و نگهداری"
.SH "نام (NAME)"
iconvconfig \- ایجاد و به‌روزرسانی حافظه موقت پیکربندی ماژول‌های iconv
.SH "خلاصه دستور (SYNOPSIS)"
\fBiconvconfig\fP [\fIگزینه‌ها\fR] [\fIدایرکتوری\fR]...
.SH "توضیحات (DESCRIPTION)"
دستور \fBiconvconfig\fR فایل‌های پیکربندی تبدیل مجموعه‌نویسه‌های iconv را خوانده و یک فایل حافظه موقت دودویی سریع (cache) برای بارگذاری سریع‌تر توابع کتابخانه C ایجاد می‌کند.
.PP
تابع
.BR iconv (3)
در لایه درونی خود از ماژول‌های
.I gconv
برای تبدیل به یک مجموعه‌نویسه و از آن استفاده می‌کند. یک فایل پیکربندی برای تعیین ماژول‌های مورد نیاز جهت انجام تبدیل به کار می‌رود. از آنجا که بارگذاری و تجزیه چنین فایل پیکربندی می‌تواند سرعت برنامه‌های استفاده‌کننده از
.BR iconv (3)
را کاهش دهد، سازوکار حافظه موقت (کش) به کار گرفته می‌شود.
.PP
برنامه
.B iconvconfig
فایل‌های پیکربندی ماژول iconv را می‌خواند و یک فایل حافظه موقت پیکربندی ماژول gconv با قابلیت بارگذاری سریع می‌نویسد.
.PP
علاوه بر ماژول‌های gconv ارائه‌شده توسط سیستم، کاربر می‌تواند با استفاده از متغیر محیطی
.BR GCONV_PATH
دایرکتوری‌های سفارشی ماژول‌های gconv را مشخص کند. با این حال، حافظه موقت پیکربندی ماژول iconv تنها زمانی استفاده می‌شود که متغیر محیطی
.B GCONV_PATH
تنظیم نشده باشد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B "\-\-nostdlib"
عدم جستجو در دایرکتوری پیش‌فرض gconv سیستم، و جستجو تنها در دایرکتوری‌های ارائه‌شده در خط فرمان.
.TP
.BI \-\-output= outputfile
.TQ
.BI \-o\~ outputfile
استفاده از
.I outputfile
برای خروجی، به جای محل پیش‌فرض حافظه موقت در سیستم.
.TP
.BI \-\-prefix= pathname
تعیین پیشوندی که به ابتدای مسیرهای سیستمی اضافه می‌شود. بخش «فایل‌ها» را در ادامه ببینید. به طور پیش‌فرض این پیشوند خالی است. در صورت تنظیم پیشوند به
.IR foo ،
پیکربندی ماژول gconv از
.I foo/usr/lib/gconv/gconv\-modules
خوانده شده و حافظه موقت در
.I foo/usr/lib/gconv/gconv\-modules.cache
نوشته خواهد شد.
.TP
.B \-\-help
.TQ
.B \-?
نمایش چکیده نحوه استفاده و خروج.
.TP
.B \-\-usage
نمایش چکیده کوتاهی از نحوه استفاده و خروج.
.TP
.B \-\-version
.TQ
.B \-V
نمایش شماره نسخه، مجوز و سلب مسئولیت ضمانت برای
.BR iconv .
.SH "وضعیت خروج (EXIT STATUS)"
مقدار صفر در صورت موفقیت، و غیر صفر در صورت بروز خطا.
.SH "فایل‌ها (FILES)"
.TP
.I /usr/lib/gconv
مسیر معمول و پیش‌فرض ماژول‌های gconv.
.TP
.I /usr/lib/gconv/gconv\-modules
فایل پیکربندی معمول و پیش‌فرض سیستم برای ماژول‌های gconv.
.TP
.I /usr/lib/gconv/gconv\-modules.cache
حافظه موقت پیکربندی معمول ماژول‌های gconv در سیستم.
.PP
بسته به معماری سیستم، فایل‌های فوق ممکن است در دایرکتوری‌هایی با پیشوند مسیر
.I /usr/lib64
قرار داشته باشند.
.SH "همچنین ببینید (SEE ALSO)"
.BR iconv (1),
.BR iconv (3)