.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "DNF5-AUTOMATIC" "8" "Sep 06, 2026" "" "dnf5"
.SH "نام (NAME)"
dnf5-automatic \- دستور اجرای خودکار به‌روزرسانی‌ها در DNF5
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBdnf5 automatic [options]\fP
.SH "توضیحات (DESCRIPTION)"
.sp
رابط خط فرمان جایگزین برای \fBdnf upgrade\fP همراه با امکانات ویژه جهت مناسب‌سازی آن برای اجرای خودکار و منظم از طریق تایمرهای systemd، جاب‌های cron و موارد مشابه.
.sp
نحوه عملکرد این ابزار توسط فایل‌های پیکربندی کنترل می‌شود. مقادیر پیش‌فرض از فایل پیکربندی \fB/usr/share/dnf5/dnf5\-plugins/automatic.conf\fP تنظیم می‌گردند. سپس بازنویسی‌های مختص هر میزبان از فایل \fB/etc/dnf/automatic.conf\fP اعمال می‌شوند.
.sp
این ابزار متاداده بسته‌ها را در صورت نیاز همگام‌سازی کرده و سپس به‌روزرسانی‌های موجود برای سیستم مورد نظر را بررسی می‌کند؛ پس از آن یا خارج می‌شود، یا بسته‌ها را بارگیری می‌کند و یا به‌روزرسانی‌ها را بارگیری کرده و اعمال می‌نماید. در نهایت، نتیجه عملیات توسط سازوکار انتخاب‌شده گزارش داده می‌شود؛ به عنوان مثال از طریق خروجی استاندارد، رایانامه (ایمیل) یا پیام‌های MOTD.
.sp
واحد تایمر سیستم‌دی \fBdnf5\-automatic.timer\fP مطابق با آنچه در فایل پیکربندی مشخص شده است (در ادامه ببینید)، در رابطه با بارگیری یا اعمال به‌روزرسانی‌ها رفتار خواهد کرد.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \fB\-\-timer\fP
.nf
اعمال تاخیر تصادفی پیش از اجرا.
.fi
.sp
.UNINDENT
.sp
گزینه‌های زیر می‌توانند برای بازنویسی مقادیر تعیین‌شده در فایل پیکربندی استفاده شوند.
.INDENT 0.0
.TP
.B \fB\-\-downloadupdates\fP
.nf
بارگیری خودکار بسته‌های به‌روزرسانی‌شده.
.fi
.sp
.TP
.B \fB\-\-no\-downloadupdates\fP
.nf
بسته‌های به‌روزرسانی‌شده را به صورت خودکار بارگیری نکن.
.fi
.sp
.TP
.B \fB\-\-installupdates\fP
.nf
نصب خودکار به‌روزرسانی‌های بارگیری‌شده (گزینه \-\-downloadupdates را نیز در بر دارد).
.fi
.sp
.TP
.B \fB\-\-no\-installupdates\fP
.nf
به‌روزرسانی‌های بارگیری‌شده را به صورت خودکار نصب نکن.
.fi
.sp
.UNINDENT
.SH "اجرای سرویس خودکار DNF5 (RUN DNF5 AUTOMATIC SERVICE)"
.sp
این سرویس معمولاً با استفاده از تایمر سیستم‌دی \fBdnf5\-automatic.timer\fP اجرا می‌شود. برای پیکربندی سرویس، فایل \fB/etc/dnf/automatic.conf\fP را سفارشی‌سازی کنید. می‌توانید فایل پیکربندی توزیع را از \fB/usr/share/dnf5/dnf5\-plugins/automatic.conf\fP کپی کرده و به عنوان مبنا استفاده نمایید، یا فایل پیکربندی اختصاصی خود را از ابتدا فقط با بازنویسی‌های لازم ایجاد کنید.
.sp
سپس واحد تایمر را فعال کنید:
.sp
\fBsystemctl enable \-\-now dnf5\-automatic.timer\fP
.SH "قالب فایل پیکربندی (CONFIGURATION FILE FORMAT)"
.sp
فایل پیکربندی به بخش‌های موضوعی مختلف تقسیم شده است.
.SS "بخش [commands] ([commands] section)"
.sp
تنظیم حالت عملکرد برنامه.
.INDENT 0.0
.TP
.B \fBapply_updates\fP
بولی (boolean)، پیش‌فرض: False
.sp
مشخص می‌کند که آیا بسته‌های شامل به‌روزرسانی‌های موجود باید توسط \fBdnf5\-automatic.timer\fP اعمال شوند (یعنی از طریق RPM نصب شوند) یا خیر. این گزینه مستلزم \fBdownload_updates\fP است. توجه داشته باشید که اگر این مقدار روی \fBFalse\fP تنظیم شود، بسته‌های بارگیری‌شده تا تراکنش موفق بعدی DNF در حافظه موقت (کَش) باقی می‌مانند.
.TP
.B \fBdownload_updates\fP
بولی (boolean)، پیش‌فرض: True
.sp
مشخص می‌کند که آیا بسته‌های شامل به‌روزرسانی‌های موجود باید توسط \fBdnf5\-automatic.timer\fP بارگیری شوند یا خیر.
.TP
.B \fBnetwork_online_timeout\fP
زمان به ثانیه، پیش‌فرض: 60
.sp
حداکثر زمانی (به ثانیه) که \fBdnf5 automatic\fP منتظر برخط (آنلاین) شدن سیستم می‌ماند. مقدار 0 به این معنی است که تشخیص در دسترس بودن شبکه نادیده گرفته می‌شود.
.TP
.B \fBrandom_sleep\fP
زمان به ثانیه، پیش‌فرض: 0
.sp
حداکثر تاخیر تصادفی پیش از بارگیری (تنها در صورتی اعمال می‌شود که از گزینه \fB\-\-timer\fP استفاده شده باشد). توجه داشته باشید که به طور پیش‌فرض، تایمرهای \fBsystemd\fP نیز یک تاخیر تصادفی تا سقف ۱ ساعت اعمال می‌کنند.
.UNINDENT
.INDENT 0.0
.TP
.B \fBupgrade_type\fP
یکی از مقادیر \fBdefault\fP، \fBsecurity\fP، \fBdistro\-sync\fP، پیش‌فرض: \fBdefault\fP
.sp
نوع ارتقاهایی که باید بررسی شوند. مقدار \fBdefault\fP به معنای جستجو برای تمام به‌روزرسانی‌های موجود است، \fBsecurity\fP فقط مواردی را که دارای هشدار امنیتی صادرشده هستند بررسی می‌کند، و \fBdistro\-sync\fP بسته‌ها را با آخرین نسخه‌های موجود در مخازن فعال همگام‌سازی می‌نماید (مشابه دستور \fBdnf5 distro\-sync\fP).
.TP
.B \fBreboot\fP
یکی از مقادیر \fBnever\fP، \fBwhen\-changed\fP، \fBwhen\-needed\fP، پیش‌فرض: \fBnever\fP
.sp
زمان راه‌اندازی مجدد (ریبوت) سیستم پس از ارتقاها را تعیین می‌کند. مقدار \fBnever\fP سیستم را ریبوت نمی‌کند. مقدار \fBwhen\-changed\fP پس از هرگونه ارتقا راه‌اندازی مجدد را آغاز می‌کند. مقدار \fBwhen\-needed\fP تنها در صورتی سیستم را ریبوت می‌کند که برای اعمال تغییرات ضروری باشد، مانند زمانی که systemd یا کرنل (هسته سیستم‌عامل) ارتقا یافته باشند.
.TP
.B \fBreboot_command\fP
رشته، پیش‌فرض: \fBshutdown \-r +5 \(aqRebooting after applying package updates\(aq\fP
.sp
دستوری را که باید برای راه‌اندازی مجدد سیستم اجرا شود مشخص می‌کند. برای مثال، برای نادیده گرفتن تاخیر ۵ دقیقه‌ای و پیام همگانی (wall)، از \fBshutdown \-r\fP استفاده کنید.
.UNINDENT
.SS "بخش [emitters] ([emitters] section)"
.sp
انتخاب نحوه گزارش نتایج.
.INDENT 0.0
.TP
.B \fBemit_via\fP
فهرست، پیش‌فرض: \fBstdio\fP
.sp
فهرست منتشرکننده‌ها (emitters) برای گزارش نتایج از طریق آن‌ها. منتشرکننده‌های موجود عبارتند از: \fBstdio\fP برای چاپ نتیجه در خروجی استاندارد، \fBcommand\fP برای ارسال نتیجه به یک دستور سفارشی، \fBcommand_email\fP برای ارسال ایمیل با استفاده از یک دستور، \fBemail\fP برای ارسال گزارش از طریق ایمیل با استفاده از سرور SMTP (نیازمندی‌ها را در بخش \fB[email]\fP ببینید)، و \fBmotd\fP که نتیجه را به فایل \fI/etc/motd.d/dnf5\-automatic\fP ارسال می‌کند.
.TP
.B \fBsystem_name\fP
رشته، پیش‌فرض: نام میزبان (hostname) سیستم داده‌شده
.sp
نامی که سیستم در گزارش‌ها با آن خوانده می‌شود.
.TP
.B \fBemit_no_updates\fP
بولی (boolean)، پیش‌فرض: False
.sp
مشخص می‌کند که آیا در صورت عدم رخ دادن رویدادی خاص \- یعنی عملیات موفق بوده و هیچ بسته‌ای برای نصب در دسترس نبوده یا نصب نشده است \- پیامی ارسال شود یا خیر.
.UNINDENT
.SS "بخش [command] ([command] section)"
.sp
پیکربندی منتشرکننده دستوری. متغیرهای قابل استفاده در آرگومان‌های رشته قالب‌بندی شامل \fBbody\fP با بدنه پیام است.
.INDENT 0.0
.TP
.B \fBcommand_format\fP
رشته قالب‌بندی، پیش‌فرض: \fBcat\fP
.sp
دستور شل برای اجرا.
.TP
.B \fBstdin_format\fP
رشته قالب‌بندی، پیش‌فرض: \fB{body}\fP
.sp
داده‌هایی که باید از طریق ورودی استاندارد (stdin) به دستور ارسال شوند.
.UNINDENT
.SS "بخش [command_email] ([command_email] section)"
.sp
پیکربندی منتشرکننده ایمیل دستوری. متغیرهای قابل استفاده در آرگومان‌های رشته قالب‌بندی عبارتند از: \fBbody\fP با بدنه پیام، \fBsubject\fP با موضوع ایمیل، \fBemail_from\fP با نشانی \(dqFrom:\(dq و \fBemail_to\fP با فهرستی از گیرندگان که با فاصله از هم جدا شده‌اند.
.INDENT 0.0
.TP
.B \fBcommand_format\fP
رشته قالب‌بندی، پیش‌فرض: \fBmail \-Ssendwait \-s {subject} \-r {email_from} {email_to}\fP
.sp
دستور شل برای اجرا.
.TP
.B \fBemail_from\fP
رشته، پیش‌فرض: \fBroot\fP
.sp
نشانی فرستنده پیام (\(dqFrom:\(dq).
.TP
.B \fBemail_to\fP
فهرست، پیش‌فرض: \fBroot\fP
.sp
فهرست گیرندگان پیام.
.TP
.B \fBstdin_format\fP
رشته قالب‌بندی، پیش‌فرض: \fB{body}\fP
.sp
داده‌هایی که باید از طریق ورودی استاندارد (stdin) به دستور ارسال شوند.
.UNINDENT
.SS "بخش [email] ([email] section)"
.sp
پیکربندی منتشرکننده ایمیل. این منتشرکننده پیام‌ها را مستقیماً از طریق یک سرور SMTP با استفاده از \fBlibcurl\fP ارسال می‌کند و به \fBlibcurl\fP همراه با پشتیبانی از پروتکل SMTP نیاز دارد. برخی توزیع‌ها نسخه‌ای کمینه از libcurl را بدون پشتیبانی از SMTP ارائه می‌دهند. در فدورا، این مشکل با اجرای دستور \fBdnf5 swap libcurl\-minimal libcurl\fP برطرف می‌شود. به عنوان راهکار جایگزین، می‌توانید از منتشرکننده \fBcommand_email\fP استفاده کنید که نیازی به پشتیبانی SMTP در libcurl ندارد. اطلاعات احراز هویت برای سرور SMTP از فایل \fB~/.netrc\fP خوانده می‌شود.
.INDENT 0.0
.TP
.B \fBemail_from\fP
رشته، پیش‌فرض: \fBroot\fP
.sp
نشانی فرستنده پیام (\(dqFrom:\(dq).
.TP
.B \fBemail_to\fP
فهرست، پیش‌فرض: \fBroot\fP
.sp
فهرست گیرندگان پیام.
.TP
.B \fBemail_host\fP
رشته، پیش‌فرض: \fBlocalhost\fP
.sp
نام میزبان سرور SMTP که برای ارسال پیام استفاده می‌شود.
.TP
.B \fBemail_port\fP
عدد صحیح، پیش‌فرض: \fB25\fP
.sp
شماره درگاهی (پورت) که باید در سرور SMTP به آن متصل شد.
.TP
.B \fBemail_tls\fP
یکی از مقادیر \fBno\fP، \fByes\fP، \fBstarttls\fP، پیش‌فرض: \fBno\fP
.sp
مشخص می‌کند که برای اتصال به سرور SMTP از TLS، STARTTLS یا بدون رمزنگاری استفاده شود.
.UNINDENT
.SS "بخش [base] ([base] section)"
.sp
می‌تواند برای بازنویسی تنظیمات موجود در فایل پیکربندی اصلی DNF استفاده شود. \fBdnf5.conf(5)\fP را ببینید.
.SH "نویسندگان (AUTHORS)"
فایل AUTHORS.md را در توزیع منبع dnf5 ببینید.
.SH "حق نشر (COPYRIGHT)"
مشارکت‌کنندگان در پروژه dnf5.
.\" End of generated man page.