'\" t
.TH "ORG\&.FREEDESKTOP\&.LOCALE1" "5" "" "systemd 261.2" "org.freedesktop.locale1"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
org.freedesktop.locale1 \- رابط کاربری D-Bus سرویس systemd-localed
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd-localed.service\fR(8)
یک سرویس سیستمی است که می‌تواند برای کنترل لوکال (locale) سیستم و نگاشت صفحه‌کلید از برنامه‌های کاربری استفاده شود\&. این صفحه رابط D\-Bus را شرح می‌دهد\&.
.SH "رابط D-BUS (THE D-BUS INTERFACE)"
.PP
این سرویس رابط‌های زیر را در گذرگاه ارائه می‌دهد:
.sp
.if n \{\
.RS 4
.\}
.nf
node /org/freedesktop/locale1 {
  interface org\&.freedesktop\&.locale1 {
    methods:
      SetLocale(in  as locale,
                in  b interactive);
      SetVConsoleKeyboard(in  s keymap,
                          in  s keymap_toggle,
                          in  b convert,
                          in  b interactive);
      SetX11Keyboard(in  s layout,
                     in  s model,
                     in  s variant,
                     in  s options,
                     in  b convert,
                     in  b interactive);
    properties:
      readonly as Locale = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.];
      readonly s X11Layout = \*(Aq\&.\&.\&.\*(Aq;
      readonly s X11Model = \*(Aq\&.\&.\&.\*(Aq;
      readonly s X11Variant = \*(Aq\&.\&.\&.\*(Aq;
      readonly s X11Options = \*(Aq\&.\&.\&.\*(Aq;
      readonly s VConsoleKeymap = \*(Aq\&.\&.\&.\*(Aq;
      readonly s VConsoleKeymapToggle = \*(Aq\&.\&.\&.\*(Aq;
  };
  interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. };
  interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. };
  interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. };
};
.fi
.if n \{\
.RE
.\}
.SS "متدها (Methods)"
.PP
اگر یک لوکال سیستمی جدید تنظیم کنید، تمام تنظیمات پیشین لوکال سیستم نادیده گرفته شده و تنظیمات جدید بر روی دیسک ذخیره خواهند شد\&. این لوکال همچنین به مدیر سیستم ارسال می‌شود و دیمن‌هایی که متعاقباً راه‌اندازی شوند، لوکال جدید سیستم را به ارث خواهند برد\&. توجه داشته باشید که دیمن‌هایی که از قبل در حال اجرا هستند، مقدار جدید را دریافت نخواهند کرد\&.
.PP
متد
\fBSetVConsoleKeyboard()\fR
می‌تواند برای تنظیم نگاشت کلید برای کنسول مجازی استفاده شود\&. به‌طور مشابه، متد
\fBSetX11Keyboard()\fR
می‌تواند برای تنظیم نگاشت پیش‌فرض کلید هر یک از سرورهای X11 به کار رود\&.
.PP
توجه داشته باشید که
\fBSetVConsoleKeyboard()\fR
نگاشت جدید کلید را فوراً روی کنسول اعمال می‌کند، در حالی که
\fBSetX11Keyboard()\fR
صرفاً یک پیش‌فرض تعیین می‌کند که ممکن است توسط نشست‌های بعدی استفاده شود\&.
.PP
آرگومان بولی
\fIconvert\fR
می‌تواند تنظیم شود تا در صورت تمایل پیکربندی صفحه‌کلید کنسول به نگاشت‌های صفحه‌کلید X11 و برعکس تبدیل شود\&. اگر true باشد و
\fBSetVConsoleKeyboard()\fR
استفاده شود، نزدیک‌ترین تنظیم صفحه‌کلید X11 برای تنظیم کنسول انتخاب‌شده اعمال می‌گردد\&. اگر true باشد و
\fBSetX11Keyboard()\fR
استفاده شود، نزدیک‌ترین تنظیم صفحه‌کلید کنسول برای تنظیم X11 انتخاب‌شده اعمال می‌گردد\&. از این رو، معمولاً فراخوانی تنها یکی از این دو تابع کافی است\&.
.PP
برای رابط‌های گرافیکی کاربری (UI) که نیاز به تنظیم نگاشت صفحه‌کلید سیستم دارند، کافی است
\fBSetX11Keyboard()\fR
را فراخوانی کنید،
\fIconvert=true\fR
را تنظیم کرده و از
\fBSetVConsoleKeyboard()\fR
صرف‌نظر کنید\&.
.PP
برای پارامترهای نگاشت کلیدی که تمایلی به تنظیم آن‌ها ندارید، از یک رشته خالی استفاده کنید\&.
.PP
پارامتر بولی
\fIinteractive\fR
می‌تواند برای کنترل این موضوع استفاده شود که آیا
\m[blue]\fBpolkit\fR\m[]\&\s-2\u[1]\d\s+2
در صورت نیاز باید به‌صورت تعاملی اعتبارنامه‌های احراز هویت را از کاربر بخواهد یا خیر\&.
.SS "سیگنال‌ها (Signals)"
.PP
هر زمان که لوکال یا نگاشت کلید سیستم از طریق دیمن تغییر کند، سیگنال‌های
\fBPropertyChanged\fR
به کلاینت‌هایی که مشترک شده‌اند ارسال می‌شوند\&.
.SS "ویژگی‌ها (Properties)"
.PP
لوکال سیستم در ویژگی
\fILocale\fR
نمایش داده می‌شود\&. این ویژگی یک آرایه شامل رشته‌هایی شبیه به تخصیص متغیرهای محیطی است\&. رشته‌های زیر شناخته‌شده هستند:
\fILANG=\fR,
\fILC_CTYPE=\fR,
\fILC_NUMERIC=\fR,
\fILC_TIME=\fR,
\fILC_COLLATE=\fR,
\fILC_MONETARY=\fR,
\fILC_MESSAGES=\fR,
\fILC_PAPER=\fR,
\fILC_NAME=\fR,
\fILC_ADDRESS=\fR,
\fILC_TELEPHONE=\fR,
\fILC_MEASUREMENT=\fR,
\fILC_IDENTIFICATION=\fR\&.
.PP
ویژگی‌های
\fIX11Layout\fR,
\fIX11Model\fR,
\fIX11Variant\fR
و
\fIX11Options\fR
مقادیر قابل پیکربندی با
\fBSetX11Keyboard()\fR
شرح‌داده‌شده در بالا (یا
\fBSetVConsoleKeyboard()\fR
همراه با
\fIconvert=true\fR)
را نشان می‌دهند\&. ویژگی‌های
\fIVConsoleKeymap\fR
و
\fIVConsoleKeymapToggle\fR
مقادیر قابل پیکربندی با
\fBSetVConsoleKeyboard()\fR
(یا
\fBSetX11Keyboard()\fR
همراه با
\fIconvert=true\fR)
را نشان می‌دهند\&.
.SS "امنیت (Security)"
.PP
تغییر لوکال یا نگاشت کلید سیستم با استفاده از این رابط از طریق polkit احراز هویت می‌شود\&. اقدام (action) مربوط به polkit برای
\fBSetLocale()\fR
برابر با
\fBorg\&.freedesktop\&.locale1\&.set\-locale\fR
است\&. اقدام polkit برای
\fBSetX11Keyboard()\fR
و
\fBSetVConsoleKeyboard()\fR
برابر با
\fBorg\&.freedesktop\&.locale1\&.set\-keyboard\fR
است\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBمثال\ \&۱.\ \&درون‌نگری org\&.freedesktop\&.locale1 در گذرگاه\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ gdbus introspect \-\-system \e
  \-\-dest org\&.freedesktop\&.locale1 \e
  \-\-object\-path /org/freedesktop/locale1
.fi
.if n \{\
.RE
.\}
.SH "سازگاری نسخه (VERSION COMPATIBILITY)"
.PP
این رابط‌های D\-Bus از
\m[blue]\fBدستورالعمل‌های معمول نسخه‌بندی رابط\fR\m[]\&\s-2\u[2]\d\s+2
پیروی می‌کنند\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd-localed.service\fR(8), \fBlocalectl\fR(1)
.SH "نکات (NOTES)"
.IP " 1." 4
polkit
.RS 4
\%https://www.freedesktop.org/software/polkit/docs/latest
.RE
.IP " 2." 4
دستورالعمل‌های معمول نسخه‌بندی رابط
.RS 4
\%https://0pointer.de/blog/projects/versioning-dbus.html
.RE