.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.3 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 "DNF-AUTOMATIC" "8" "Dec 17, 2025" "4.24.0" "DNF"
.SH "نام (NAME)"
dnf-automatic \- اجرای خودکار و دوره‌ای ارتقا و به‌روزرسانی بسته‌ها در DNF
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBdnf\-automatic [<config file>]\fP
.SH "توضیحات (DESCRIPTION)"
.sp
رابط خط فرمان جایگزین برای \fBdnf upgrade\fP همراه با امکانات ویژه جهت مناسب‌سازی آن برای اجرای خودکار و منظم از طریق تایمرهای systemd، جاب‌های cron و موارد مشابه.
.sp
عملکرد این ابزار معمولاً توسط فایل پیکربندی یا واحدهای تایمر با عملکردهای خاص کنترل می‌شود (در ادامه ببینید). این دستور تنها یک آرگومان اختیاری را می‌پذیرد که به فایل پیکربندی اشاره دارد، به‌علاوه برخی آرگومان‌های کنترلی که برای استفاده توسط سرویس‌های پشتیبان واحدهای تایمر در نظر گرفته شده‌اند. اگر هیچ فایل پیکربندی از طریق خط فرمان ارائه نشود، از \fB/etc/dnf/automatic.conf\fP استفاده می‌شود.
.sp
این ابزار متاداده بسته‌ها را در صورت نیاز همگام‌سازی کرده و سپس به‌روزرسانی‌های موجود برای سیستم مورد نظر را بررسی می‌کند و پس از آن یا خارج می‌شود، یا بسته‌ها را بارگیری می‌کند و یا آن‌ها را بارگیری کرده و اعمال می‌نماید. نتیجه عملیات توسط یک سازوکار انتخابی، برای نمونه از طریق خروجی استاندارد، رایانامه (ایمیل) یا پیام‌های MOTD گزارش داده می‌شود.
.sp
واحد تایمر سیستم‌دی \fBdnf\-automatic.timer\fP مطابق با آنچه در فایل پیکربندی مشخص شده است (در ادامه ببینید)، در رابطه با بارگیری یا اعمال به‌روزرسانی‌ها رفتار خواهد کرد. چند واحد تایمر دیگر نیز ارائه شده‌اند که با رفتارهای استاندارد مشخصی، تنظیمات فایل پیکربندی را بازنویسی (override) می‌کنند:
.INDENT 0.0
.IP \(bu 2
dnf\-automatic\-notifyonly
.IP \(bu 2
dnf\-automatic\-download
.IP \(bu 2
dnf\-automatic\-install
.UNINDENT
.sp
صرف‌نظر از تنظیمات فایل پیکربندی، تایمر اول تنها در دسترس بودن به‌روزرسانی‌ها را اطلاع‌رسانی می‌کند. تایمر دوم آن‌ها را بارگیری کرده اما نصب نمی‌کند. تایمر سوم آن‌ها را بارگیری و نصب می‌نماید.
.SH "اجرای DNF-AUTOMATIC (RUN DNF-AUTOMATIC)"
.sp
می‌توانید گزینه‌ای را که بیشترین مطابقت را با نیازهای شما دارد انتخاب کنید، \fB/etc/dnf/automatic.conf\fP را برای هرگونه رفتار خاص سفارشی‌سازی نمایید، و واحد تایمر مربوطه را فعال کنید.
.sp
برای مثال: \fBsystemctl enable \-\-now dnf\-automatic\-notifyonly.timer\fP
.SH "قالب فایل پیکربندی (CONFIGURATION FILE FORMAT)"
.sp
فایل پیکربندی به بخش‌های موضوعی مجزا تقسیم شده است.
.SS "بخش [commands] ([commands] section)"
.sp
تنظیم حالت عملکرد برنامه.
.INDENT 0.0
.TP
.B \fBapply_updates\fP
بولی (boolean)، پیش‌فرض: False
.sp
مشخص می‌کند که آیا بسته‌های شامل به‌روزرسانی‌های موجود باید توسط \fBdnf\-automatic.timer\fP اعمال شوند (یعنی از طریق RPM نصب شوند) یا خیر. این گزینه مستلزم \fBdownload_updates\fP است\&. توجه داشته باشید که اگر این مقدار روی \fBFalse\fP تنظیم شود، بسته‌های بارگیری‌شده تا تراکنش موفق بعدی DNF در حافظه موقت (کَش) باقی می‌مانند. توجه داشته باشید که سایر واحدهای تایمر این تنظیم را بازنویسی می‌کنند.
.TP
.B \fBdownload_updates\fP
بولی (boolean)، پیش‌فرض: False
.sp
مشخص می‌کند که آیا بسته‌های شامل به‌روزرسانی‌های موجود باید توسط \fBdnf\-automatic.timer\fP بارگیری شوند یا خیر\&. توجه داشته باشید که سایر واحدهای تایمر این تنظیم را بازنویسی می‌کنند.
.TP
.B \fBnetwork_online_timeout\fP
زمان به ثانیه، پیش‌فرض: 60
.sp
حداکثر زمانی که dnf\-automatic منتظر برخط (آنلاین) شدن سیستم می‌ماند. مقدار 0 به این معنی است که تشخیص در دسترس بودن شبکه نادیده گرفته خواهد شد.
.TP
.B \fBrandom_sleep\fP
زمان به ثانیه، پیش‌فرض: 0
.sp
حداکثر تاخیر تصادفی پیش از بارگیری. توجه داشته باشید که به‌طور پیش‌فرض، تایمرهای \fBsystemd\fP نیز یک تاخیر تصادفی تا سقف ۱ ساعت اعمال می‌کنند.
.UNINDENT
.INDENT 0.0
.TP
.B \fBupgrade_type\fP
یکی از مقادیر \fBdefault\fP، \fBsecurity\fP، پیش‌فرض: \fBdefault\fP
.sp
نوع ارتقاهایی که باید بررسی شوند. مقدار \fBdefault\fP نشان‌دهنده جستجو برای تمام به‌روزرسانی‌های موجود است، و \fBsecurity\fP تنها مواردی را که دارای اعلان امنیتی (security advisory) صادرشده هستند بررسی می‌کند.
.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
فهرست، پیش‌فرض: \fBemail, stdio, motd\fP
.sp
فهرست منتشرکننده‌ها (emitters) برای گزارش نتایج از طریق آن‌ها. منتشرکننده‌های موجود عبارتند از: \fBstdio\fP برای چاپ نتیجه در خروجی استاندارد، \fBcommand\fP برای ارسال نتیجه به یک دستور سفارشی، \fBcommand_email\fP برای ارسال رایانامه (ایمیل) با استفاده از یک دستور، \fBemail\fP برای ارسال گزارش از طریق ایمیل، و \fBmotd\fP که نتیجه را به فایل \fI/etc/motd\fP ارسال می‌کند.
.TP
.B \fBsystem_name\fP
رشته، پیش‌فرض: نام میزبان (hostname) سیستم داده‌شده
.sp
نامی که سیستم در گزارش‌ها با آن خوانده می‌شود.
.TP
.B \fBsend_error_messages\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
پیکربندی منتشرکننده ایمیل.
.INDENT 0.0
.TP
.B \fBemail_from\fP
رشته، پیش‌فرض: \fBroot\fP
.sp
نشانی فرستنده پیام (\(dqFrom:\(dq).
.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 یا بدون رمزنگاری استفاده شود.
.TP
.B \fBemail_to\fP
فهرست، پیش‌فرض: \fBroot\fP
.sp
فهرست گیرندگان پیام.
.UNINDENT
.SS "بخش [base] ([base] section)"
.sp
می‌تواند برای بازنویسی تنظیمات موجود در فایل پیکربندی اصلی DNF استفاده شود. مرجع پیکربندی DNF را در \fBdnf.conf(5)\fP ببینید.
.SH "همچنین ببینید (SEE ALSO)"
.INDENT 0.0
.IP \(bu 2
\fBdnf(8)\fP، \fBdnf.conf(5)\fP، \fBsystemd.timer(5)\fP
.UNINDENT
.SH "نویسندگان (AUTHORS)"
فایل AUTHORS را در توزیع منبع DNF ببینید.
.SH "حق نشر (COPYRIGHT)"
2012-2020, Red Hat, Licensed under GPLv2+
.\" End of generated man page.