'\" t
.TH "ORG\&.FREEDESKTOP\&.TIMEDATE1" "5" "" "systemd 261.2" "org.freedesktop.timedate1"
.\" -----------------------------------------------------------------
.\" * 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.timedate1 \- رابط کاربری D-Bus سرویس systemd-timedated
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd-timedated.service\fR(8)
یک سرویس سیستمی است که می‌تواند برای کنترل ساعت سیستم و تنظیمات مرتبط به کار رود\&. این صفحه رابط D\-Bus را شرح می‌دهد\&.
.SH "رابط D-BUS (THE D-BUS INTERFACE)"
.PP
این سرویس رابط‌های زیر را روی گذرگاه ارائه می‌دهد:
.sp
.if n \{\
.RS 4
.\}
.nf
node /org/freedesktop/timedate1 {
  interface org\&.freedesktop\&.timedate1 {
    methods:
      SetTime(in  x usec_utc,
              in  b relative,
              in  b interactive);
      SetTimezone(in  s timezone,
                  in  b interactive);
      SetLocalRTC(in  b local_rtc,
                  in  b fix_system,
                  in  b interactive);
      SetNTP(in  b use_ntp,
             in  b interactive);
      ListTimezones(out as timezones);
    properties:
      readonly s Timezone = \*(Aq\&.\&.\&.\*(Aq;
      readonly b LocalRTC = \&.\&.\&.;
      @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false")
      readonly b CanNTP = \&.\&.\&.;
      readonly b NTP = \&.\&.\&.;
      @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false")
      readonly b NTPSynchronized = \&.\&.\&.;
      @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false")
      readonly t TimeUSec = \&.\&.\&.;
      @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false")
      readonly t RTCTimeUSec = \&.\&.\&.;
  };
  interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. };
  interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. };
  interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. };
};
.fi
.if n \{\
.RE
.\}
.SS "متدها (Methods)"
.PP
از
\fBSetTime()\fR
برای تغییر ساعت سیستم استفاده کنید\&. مقداری بر حسب میکروثانیه از مبدأ یونیکس (۱ ژانویه ۱۹۷۰ ساعت UTC) ارسال کنید\&. اگر
\fIrelative\fR
برابر با true باشد، مقدار میکروثانیه ارسالی به زمان فعلی سیستم اضافه خواهد شد\&. اگر false باشد، زمان فعلی سیستم بر روی مقدار میکروثانیه ارسال‌شده تنظیم خواهد شد\&. اگر زمان سیستم با این متد تنظیم شود، ساعت سخت‌افزاری (RTC) نیز به‌روزرسانی خواهد شد\&.
.PP
از
\fBSetTimezone()\fR
برای تنظیم منطقه زمانی سیستم استفاده کنید\&. مقداری مانند
"Europe/Berlin"
برای تنظیم منطقه زمانی ارسال کنید\&. مناطق زمانی معتبر در
/usr/share/zoneinfo/zone\&.tab
فهرست شده‌اند\&. اگر RTC به گونه‌ای پیکربندی شده باشد که بر اساس زمان محلی نگهداری شود، به همین ترتیب به‌روزرسانی خواهد شد\&.
.PP
از
\fBSetLocalRTC()\fR
برای کنترل اینکه آیا RTC در زمان محلی است یا UTC استفاده کنید\&. اکیداً توصیه می‌شود که RTC در UTC نگهداری شود\&. با این حال، برخی از سیستم‌عامل‌ها (مانند Windows) ساعت RTC را در زمان محلی نگه می‌دارند، که ممکن است فعال کردن این ویژگی را ضروری کند\&. توجه داشته باشید که این موضوع ممکن است مشکلات متعددی ایجاد کند چرا که تغییرات ساعت تابستانی ممکن است از دست بروند\&. اگر
\fIfix_system\fR
برابر با
"true"
باشد، زمان از RTC مجدداً خوانده شده و ساعت سیستم مطابق با تنظیم جدید تنظیم می‌شود\&. اگر
\fIfix_system\fR
برابر با
"false"
باشد، زمان سیستم با در نظر گرفتن تنظیمات جدید در RTC نوشته می‌شود\&. در نصاب‌ها و دیسک‌های زنده (livecd) که در آن‌ها RTC احتمالاً قابل اعتمادتر از زمان سیستم است از
\fIfix_system=true\fR
استفاده کنید\&. در رابط‌های کاربری پیکربندی که در طول کارکرد عادی سیستم اجرا می‌شوند و در آن‌ها ساعت سیستم احتمالاً قابل اعتمادتر از RTC است از
\fIfix_system=false\fR
استفاده کنید\&.
.PP
از
\fBSetNTP()\fR
برای کنترل اینکه آیا ساعت سیستم با استفاده از
systemd\-timesyncd
با شبکه همگام‌سازی می‌شود یا خیر استفاده کنید\&. این کار سرویس همگام‌سازی زمان انتخاب‌شده را فعال و راه‌اندازی، یا غیرفعال و متوقف خواهد کرد\&.
.PP
متد
\fBListTimezones()\fR
فهرستی از مناطق زمانی شناخته‌شده در سیستم محلی را به صورت آرایه‌ای از نام‌ها ("["Africa/Abidjan", "Africa/Accra", \&.\&.\&., "UTC"]") بازمی‌گرداند\&.
.SS "ویژگی‌ها (Properties)"
.PP
ویژگی
\fITimezone\fR
منطقه زمانی پیکربندی‌شده فعلی را نشان می‌دهد\&.
\fILocalRTC\fR
نشان می‌دهد که آیا RTC برای استفاده از UTC (مقدار false) یا منطقه زمانی محلی (مقدار true) پیکربندی شده است یا خیر\&.
\fICanNTP\fR
نشان می‌دهد که آیا سرویسی برای انجام همگام‌سازی زمان از طریق شبکه در دسترس است یا خیر، و
\fINTP\fR
نشان می‌دهد که آیا چنین سرویسی فعال است یا خیر\&.
.PP
ویژگی
\fINTPSynchronized\fR
نشان می‌دهد که آیا کرنل زمان را همگام‌شده گزارش می‌دهد یا خیر (مقایسه کنید با
\fBadjtimex\fR(3))\&.
\fITimeUSec\fR
و
\fIRTCTimeUSec\fR
زمان فعلی سیستم و ساعت RTC را نشان می‌دهند\&. هدف از این سه ویژگی این است که به کلاینت‌های راه دور امکان دسترسی به این اطلاعات از طریق D\-Bus داده شود\&. کلاینت‌های محلی می‌توانند مستقیماً به این اطلاعات دسترسی داشته باشند\&.
.PP
هر زمان که تنظیمات
\fITimezone\fR
و
\fILocalRTC\fR
از طریق دیمن تغییر کنند، سیگنال‌های
\fBPropertyChanged\fR
به کلاینت‌هایی که مشترک شده‌اند ارسال می‌شوند\&.
.PP
توجه داشته باشید که این سرویس شما را از تغییرات زمان سیستم مطلع نخواهد کرد\&. برای این منظور از
\fBtimerfd\fR(3)
همراه با
\fBCLOCK_REALTIME\fR
و
\fBTFD_TIMER_CANCEL_ON_SET\fR
استفاده کنید\&.
.SS "امنیت (Security)"
.PP
پارامترهای بولی
\fIinteractive\fR
می‌توانند برای کنترل اینکه آیا
\m[blue]\fBpolkit\fR\m[]\&\s-2\u[1]\d\s+2
باید در صورت لزوم به‌صورت تعاملی از کاربر اطلاعات احراز هویت را درخواست کند یا خیر، استفاده شوند\&.
.PP
اقدام polkit برای
\fBSetTimezone()\fR
برابر با
org\&.freedesktop\&.timedate1\&.set\-timezone
است\&. برای
\fBSetLocalRTC()\fR
برابر با
org\&.freedesktop\&.timedate1\&.set\-local\-rtc
بوده، برای
\fBSetTime()\fR
برابر با
org\&.freedesktop\&.timedate1\&.set\-time
و برای
\fBSetNTP()\fR
برابر با
org\&.freedesktop\&.timedate1\&.set\-ntp
است\&.
\fBListTimezones()\fR
به هیچ مجوزی نیاز ندارد\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBمثال\ \&۱.\ \&درون‌نگری org\&.freedesktop\&.timedate1 در گذرگاه\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ gdbus introspect \-\-system \e
  \-\-dest org\&.freedesktop\&.timedate1 \e
  \-\-object\-path /org/freedesktop/timedate1
.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-timedated.service\fR(8), \fBtimedatectl\fR(1), \m[blue]\fBاطلاعات بیشتر درباره نحوه تعامل ساعت سیستم و RTC\fR\m[]\&\s-2\u[3]\d\s+2
.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
.IP " 3." 4
اطلاعات بیشتر درباره نحوه تعامل ساعت سیستم و RTC
.RS 4
\%https://lists.freedesktop.org/archives/systemd-devel/2011-May/002526.html
.RE