DNF5.CONF(5)

الاسم
dnf5.conf - مرجع ضبط DNF5

الوصف

يستخدم DNF5 مبدئيًا ملف الضبط الشامل في /etc/dnf/dnf.conf.

يأتي ملف الضبط بتنسيق INI ويتكون من إعلان أقسام وخيارات بصيغة الاسم=القيمة أسفل كل قسم في سطر منفصل. هناك نوعان من الأقسام في ملفات الضبط: رئيس ومستودع. يحدد القسم الرئيس كل خيارات الضبط الشاملة ويجب أن يكون هناك قسم واحد فقط منه.

تحدد أقسام المستودعات ضبط كل مستودع (بعيد أو محلي). يعمل اسم قسم المستودع بين الأقواس كمرجع لمعرف المستودع (repo ID) ويجب أن يكون فريدًا عبر ملفات الضبط. الأحرف المسموح بها في سلسلة معرف المستودع هي الحروف الأبجدية الصغيرة والكبيرة، والأرقام، و -، و _، و . و :. يجب أن يتكون الحد الأدنى لملف ضبط المستودع، بصرف النظر عن معرف المستودع، من تعريف لخيار baseurl أو metalink أو mirrorlist.

خيارات [MAIN]

allow_downgrade
    منطقي

    إذا فُعّل، يسمح DNF5 بخفض إصدار الحزم أثناء حل الاعتماديات.

    القيمة المبدئية: True.

allow_vendor_change
    منطقي

    إذا عُطّل، سيلتزم DNF5 بالمورد عند ترقية حزم rpm أو خفض إصدارها.

    القيمة المبدئية: True.

    تحذير: هذا الخيار غير مدعوم حاليًا لأوامر downgrade و distro-sync

assumeno
    منطقي

    إذا فُعّل، سيفترض DNF5 الإجابة No في المواضع التي يطلب فيها عادةً تأكيدًا من مدخلات المستخدم

    القيمة المبدئية: False.

assumeyes
    منطقي

    إذا فُعّل، سيفترض DNF5 الإجابة Yes في المواضع التي يطلب فيها عادةً تأكيدًا من مدخلات المستخدم (انظر أيضًا defaultyes).

    القيمة المبدئية: False.

best
    منطقي

    إذا كان True، يوجه برنامج الحل إما لاستخدام حزمة بأعلى إصدار متاح أو الفشل. إذا كان False، فلا يفشل إذا تعذر تثبيت الإصدار الأحدث وينتقل إلى الإصدار الأقل.

    القيمة المبدئية: True.

    ملاحظة: يمكن تعيين هذا الخيار على وجه الخصوص في ملف الضبط الخاص بك بواسطة التوزيعة لديك.

cachedir
    سلسلة نصية

    مسار إلى دليل تستخدمه الأنظمة الفرعية المختلفة لـ DNF5 لتخزين بيانات الخبيئة بما في ذلك البيانات الوصفية للمستودعات والحزم المُنـزّلة. له قيمة مبدئية معقولة قابلة للكتابة من قِبل الجذر اعتمادًا على التوزيعة. يحتاج DNF5 إلى القدرة على إنشاء ملفات وأدلة في هذا الموقع.

    المبدئي للمستخدم العادي: ~/.cache/libdnf5.

    بالنسبة للمستخدم الخارق، تُكتب القيمة فوقها بواسطة خيار system_cachedir.

cacheonly
    سلسلة نصية

    يمكن أن يكون all، أو metadata، أو none.

    إذا عُيّن على all، سيعمل DNF5 بالكامل من خبيئة النظام، ولن يحدّث الخبيئة وسيجري استخدام خبيئة النظام حتى لو انتهت صلاحيتها.

    إذا عُيّن على metadata، سيخزن DNF5 البيانات الوصفية في الخبيئة فقط.

    القيمة المبدئية: none.

    ملاحظة: ملاحظات واجهة برمجة التطبيقات: يجب ضبطها قبل إنشاء كائنات المستودع. يجب على الملحقات ضبط هذا في خطاف pre_config. تُتجاهل التغييرات اللاحقة.

check_config_file_age
    منطقي

    إذا فُعّل، ينبغي لـ DNF5 إنهاء صلاحية البيانات الوصفية للمستودعات آليًا، والتي تكون أقدم من ملف الضبط المقابل لها (عادةً ملف dnf.conf وملف foo.repo).

    القيمة المبدئية: True.

    ملاحظة: يتأثر انتهاء صلاحية البيانات الوصفية أيضًا بعمر البيانات الوصفية. انظر أيضًا

    metadata_expire.

clean_requirements_on_remove
    منطقي

    إذا فُعّل، سيزيل DNF5 الاعتماديات التي لم تعد مستخدمة أثناء أمر dnf remove. تتأهل الحزمة للإزالة عبر clean_requirements_on_remove فقط إذا ثُبّتت من خلال DNF5 وليس بناءً على طلب مستخدم صريح، أي أنها سُحبت كاعتمادية.

    لا تُزال حزم installonlypkgs آليًا أبدًا.

    القيمة المبدئية: True.

debugdir
    سلسلة نصية

    الموقع الذي ستُنشأ فيه ملفات تنقيح libsolv عند تفعيلها بواسطة debug_solver.

    المبدئي ./debugdata.

debug_solver
    منطقي

    إذا فُعّل، ستُنشأ ملفات تنقيح libsolv عند حل العملية. تُنشأ ملفات التنقيح في دليل debugdir.

    القيمة المبدئية: False.

defaultyes
    منطقي

    إذا فُعّل، ستكون الإجابة المبدئية لطلبات تأكيد المستخدم هي Yes. يجب عدم الخلط بينه وبين assumeyes الذي لن يطلب أي تأكيد على الإطلاق.

    القيمة المبدئية: False.

destdir
    سلسلة نصية

    إعادة توجيه الحزم المُنـزّلة إلى الدليل المقدم.

    المبدئي: <package repository cachedir>/packages

exclude_from_weak
    list

    منع تثبيت الحزم كاعتماديات ضعيفة (موصى بها أو مكملة). يمكن تحديد الحزم باسم أو بنمط مطابقة (glob) ومفصولة بفاصلة.

    المبدئي هو [].

exclude_from_weak_autodetect
    منطقي

    إذا فُعّل، سيكتشف DNF5 آليًا الاعتماديات الضعيفة غير المستوفاة (الموصى بها أو المكملة) للحزم المثبتة على النظام. لن يجري تثبيت مزودي هذه الاعتماديات الضعيفة بواسطة dnf كاعتماديات ضعيفة بعد الآن (سيظلون يثبتون إذا سُحبوا كاعتمادية عادية).

    المبدئي هو true.

excludeenvs
    list

    استبعاد البيئات، المحددة بمعرف أو بنمط مطابقة ومفصولة بفاصلة، من جميع العمليات.

    يمكن تعطيله باستخدام خيار الضبط disable_excludes.

    القيمة المبدئية: [].

excludegroups
    list

    استبعاد المجموعات، المحددة بمعرف أو بنمط مطابقة ومفصولة بفاصلة، من جميع العمليات.

    يمكن تعطيله باستخدام خيار الضبط disable_excludes.

    القيمة المبدئية: [].

group_package_types
    list

    قائمة مما يلي: optional، أو default، أو mandatory، أو conditional.

    يخبر DNF5 بنوع الحزم في المجموعات التي سيجري تثبيتها عند استدعاء 'group install <group-spec>' أو 'install @<group-spec>'.

    المبدئي: default, mandatory, conditional.

ignorearch
    منطقي

    إذا فُعّل، سيسمح RPM بمحاولات تثبيت حزم غير متوافقة مع معمارية المعالج (CPU).

    القيمة المبدئية: False.

installonlypkgs
    list

    قائمة بأسماء الحزم التي يجب تثبيتها فقط، ولا تجري ترقيتها أبدًا. تقع النواة (Kernels) على وجه الخصوص في هذه الفئة. لا تُزال هذه الحزم أبدًا بواسطة dnf autoremove حتى لو ثُبّتت كاعتماديات (انظر clean_requirements_on_remove لمعرفة تفاصيل الإزالة الآلية). يلحق هذا الخيار قيم القائمة بقائمة installonlypkgs المبدئية التي يستخدمها DNF5. ينظم عدد إصدارات الحزم المحتفظ بها بواسطة installonly_limit.

installonly_limit
    integer

    عدد حزم installonly المسموح بتثبيتها بالتزامن.

    القيمة 1 غير مسموح بها صراحةً لأنها تعقد ترقيات النواة بسبب حماية النواة العاملة من الإزالة.

    الحد الأدنى هو 2.

    تعني القيمة 0 عددًا غير محدود من حزم installonly.

    القيمة المبدئية: 3.

installroot
    سلسلة نصية

    جذر نظام الملفات لجميع عمليات التحزيم. يتطلب مسارًا مطلقًا. انظر أيضًا خيار سطر الأوامر --installroot.

    القيمة المبدئية: /.

install_weak_deps
    منطقي

    إذا فُعّل، عندما يوشك تثبيت حزمة جديدة، فإن جميع الحزم المرتبطة بعلاقة اعتمادية ضعيفة (علامات Recommends أو Supplements) مع هذه الحزمة ستُسحب إلى العملية.

    القيمة المبدئية: True.

keepcache
    منطقي

    إذا فُعّل، يحتفظ بالحزم المُنـزّلة في الخبيئة. إذا عُطّل، ستستمر الخبيئة حتى العملية الناجحة التالية حتى لو لم يجرِ تثبيت أي حزم.

    القيمة المبدئية: False.

logdir
    سلسلة نصية

    الدليل الذي ستُخزن فيه ملفات السجل.

    المبدئي للمستخدم العادي: ~/.local/state.

    المبدئي للمستخدم الخارق: /var/log.

log_rotate
    integer

    تدوّر ملفات السجل بعدد مرات log_rotate قبل إزالتها. إذا كان log_rotate هو 0، فلن يجرى التدوير.

    القيمة المبدئية: 4.

log_size
    حجم التخزين

    تدوّر ملفات السجل عندما تنمو لتصبح أكبر من log_size بايت. إذا كان log_size هو 0، فلن يجرى التدوير.

    ينطبق الحجم على ملفات السجل الفردية، وليس مجموع جميع ملفات السجل. انظر أيضًا log_rotate.

    القيمة المبدئية: 1M.

module_platform_id
    سلسلة نصية

    عين هذا على $name:$stream لتجاوز معرف المنصة PLATFORM_ID المكتشف من /etc/os-release. هذا ضروري لإجراء ترقية للنظام والانتقال إلى منصة جديدة.

    المبدئي: فارغ.

module_stream_switch
    منطقي

    إذا فُعّل، يسمح بتبديل التدفقات المفعلة لوحدة ما.

    القيمة المبدئية: False.

multilib_policy
    سلسلة نصية

    يتيح التحكم في كيفية التعامل مع حزم multilib أثناء عمليات التثبيت.

    يمكن أن يكون إما best ليفضل برنامج حل الاعتماديات الحزم التي تطابق معمارية النظام بشكل أفضل، أو all لتثبيت الحزم لجميع المعماريات المتاحة.

    القيمة المبدئية: best.

obsoletes
    منطقي

    إذا فُعّل، يستخدم DNF5 منطق معالجة الحزم المتقادمة (obsoletes)، مما يعني أنه يتحقق مما إذا كانت أي اعتماديات للحزمة المحددة لم تعد مطلوبة ويزيلها.

    مفيد عند إجراء ترقيات على مستوى التوزيعة.

    له تأثير أثناء عمليات التثبيت/الترقية.

    خيار سطر الأوامر: --obsoletes

    القيمة المبدئية: True.

optional_metadata_types
    list

    قائمة مما يلي: comps، أو filelists، أو other، أو presto، أو updateinfo، أو all

    يحدد أنواع البيانات الوصفية المراد تحميلها بالإضافة إلى البيانات الوصفية الأساسية primary و modules، والتي تُحمّل دائمًا. لاحظ أن أوامر DNF الفردية قد توسع هذه القائمة في وقت التشغيل.

    ملاحظة: تتضمن القائمة فقط أنواع البيانات الوصفية التي يتعرف عليها DNF. ومع ذلك، قد تتضمن البيانات الوصفية للمستودع أنواعًا أخرى مختلفة (على سبيل المثال، AppStream أو البيانات الوصفية المخزنة كقواعد بيانات بدلاً من ملفات XML). تمثل القيمة الخاصة all جميع أنواع البيانات الوصفية الموجودة في المستودع، بما في ذلك تلك غير المعروفة لـ DNF.

    القيمة المبدئية: comps,updateinfo

persistdir
    سلسلة نصية

    الدليل الذي يخزن فيه DNF5 بياناته الدائمة بين عمليات التشغيل.

    القيمة المبدئية: /var/lib/dnf.

pluginconfpath
    list

    قائمة بالأدلة التي يُبحث فيها عن تكوينات ملحقات libdnf5 لتحميلها.

    تُحلّل جميع ملفات الضبط الموجودة في هذه الأدلة، والتي تسمى بنفس اسم الملحق.

    القيمة المبدئية: /etc/dnf/libdnf5-plugins.

pluginpath
    list

    قائمة بالأدلة التي يُبحث فيها عن ملحقات libdnf5 لتحميلها. تُستخدم الملحقات الموجودة في أي من الأدلة في خيار الضبط هذا.

    القيمة المبدئية: /usr/lib64/libdnf5/plugins/

plugins
    منطقي

    إذا فُعّل، تُفعل ملحقات libdnf5.

    القيمة المبدئية: True.

protected_packages
    list

    يحتوي خيار قائمة الإلحاق هذا على أسماء الحزم التي يجب ألا يزيلها DNF5 تمامًا أبدًا.

    تجري حمايتها عبر الحزم المتقادمة (Obsoletes) بالإضافة إلى إزالات المستخدم/الملحقات.

    القيمة المبدئية: dnf5,glob:/etc/dnf/protected.d/*.conf.

    ملاحظة: يمكن لأي حزم يجب حمايتها القيام بذلك عن طريق تضمين ملف في /etc/dnf/protected.d يحتوي على اسم الحزمة الخاصة بها.

    سيحمي DNF5 أيضًا الحزمة المقابلة للإصدار الحالي من النواة. انظر أيضًا خيار protect_running_kernel.

protect_running_kernel
    منطقي

    يتحكم في ما إذا كانت الحزمة المقابلة للإصدار الحالي من النواة محمية من الإزالة.

    القيمة المبدئية: True.

    ملاحظة: خيار التوافق مع YUM

recent
    integer

    يعين الفترة الزمنية بالأيام المستخدمة لخيار --recent في أوامر repoquery <#repoquery-command-ref-label>، و info <#info-command-ref-label> و list <#list-command-ref-label>.

    القيمة المبدئية: 7

reposdir
    list

    مواقع ملفات ضبط المستودعات.

    قد يختلف سلوك reposdir عند استخدامه جنبًا إلى جنب مع خيار --installroot.

    القيمة المبدئية: [/etc/yum.repos.d, /etc/distro.repos.d, /usr/share/dnf5/repos.d]

skip_broken
    منطقي

    إذا فُعّل، سيتجاوز DNF5 الحزم غير القابلة للتثبيت بدلاً من الفشل أثناء حل الاعتماديات.

    القيمة المبدئية: False.

skip_unavailable
    منطقي

    إذا فُعّل، سيتجاوز DNF5 الحزم غير المتاحة بدلاً من الفشل أثناء إعداد عمليات rpm.

    القيمة المبدئية: False.

    system_cachedir سلسلة نصية

    بالنسبة للمستخدم الخارق، تُكتب القيمة فوق قيمة خيار cachedir.

    يسمح بالتمييز بين دليل خبيئة المستخدم ودليل خبيئة المستخدم الخارق.

    القيمة المبدئية: /var/cache/libdnf5.

system_state_dir
    سلسلة نصية

    موقع ملفات حالة النظام. انظر dnf5-system-state(7)، وحالة النظام <#systemstate-misc-ref-label> لمزيد من التفاصيل.

    القيمة المبدئية: /usr/lib/sysimage/libdnf5.

    transaction_history_dir سلسلة نصية

    موقع قاعدة بيانات التاريخ.

    له نفس قيمة system_state_dir مبدئيًا.

tsflags
    list

    قائمة بالسلاسل التي تضيف أعلامًا إضافية لمعاملة RPM.
    tsflag value | علم معاملة RPM
    noscripts | RPMTRANS_FLAG_NOSCRIPTS
    test | RPMTRANS_FLAG_TEST
    notriggers | RPMTRANS_FLAG_NOTRIGGERS
    nodocs | RPMTRANS_FLAG_NODOCS
    justdb | RPMTRANS_FLAG_JUSTDB
    nocontexts | RPMTRANS_FLAG_NOCONTEXTS
    nocaps | RPMTRANS_FLAG_NOCAPS
    nocrypto | RPMTRANS_FLAG_NOFILEDIGEST
    deploops | RPMTRANS_FLAG_DEPLOOPS

    سيعين خيار nocrypto أيضًا علامتي VS‏ _RPMVSF_NOSIGNATURES و _RPMVSF_NODIGESTS.

    يوفر خيار test فحصًا للعملية دون تنفيذها فعليًا. يتضمن ذلك تنـزيل الحزم، وفحص مفاتيح OpenPGP (بما في ذلك الاستيراد الدائم لمفاتيح إضافية إذا لزم الأمر)، وفحص rpm لمنع تعارض الملفات.

    خيار nocaps مدعوم في إصدار rpm-4.14 أو الأحدث. عند استخدام nocaps مع عدم دعم rpm له، يبلغ DNF5 عنه فقط كعلامة tsflag غير صالحة.

    المبدئي: فارغ.

    use_host_config استخدام ملفات الضبط وتعاريف المتغيرات من النظام المضيف بدلاً من جذر التثبيت (installroot). انظر <#installroot-misc-ref-label> dnf5-installroot(7) لمزيد من المعلومات.

    القيمة المبدئية: False.

varsdir
    list

    قائمة بالأدلة التي يُبحث فيها عن ملفات تعاريف المتغيرات.

    انظر ملفات المتغيرات في مرجع الضبط.

    القيمة المبدئية: /etc/dnf/vars.

zchunk
    منطقي

    إذا فُعّل، تضغط البيانات الوصفية للمستودع باستخدام تنسيق zchunk (إذا كان متاحًا).

    القيمة المبدئية: True.

خيارات [MAIN] - الألوان

color_list_available_upgrade
    لون

    لون الحزم المتاحة التي تكون أحدث من الحزم المثبتة. يُستخدم هذا الخيار أثناء عمليات القائمة.

    القيمة المبدئية: bold,blue.

color_list_available_downgrade
    لون

    لون الحزم المتاحة التي تكون أقدم من الحزم المثبتة. يُستخدم هذا الخيار أثناء عمليات القائمة.

    القيمة المبدئية: dim,magenta.

color_list_available_reinstall
    لون

    لون الحزم المتاحة المطابقة للإصدارات المثبتة والمتاحة لإعادة التثبيت. يُستخدم هذا الخيار أثناء عمليات القائمة.

    القيمة المبدئية: bold,green.

color_list_available_install
    لون

    لون الحزم المتاحة للتثبيت ولم يثبت أي من إصداراتها مسبقًا. يُستخدم هذا الخيار أثناء عمليات القائمة.

    القيمة المبدئية: bold,cyan.

color_update_installed
    لون

    لون الحزم المزالة. يُستخدم هذا الخيار أثناء عرض العمليات.

    القيمة المبدئية: dim,red.

color_update_label
    لون

    لون الحزم المحلية المثبتة من مستودع @commandline. يُستخدم هذا الخيار أثناء عرض العمليات.

    القيمة المبدئية: dim,green.

color_update_remote
    لون

    لون الحزم التي ثُبّتت/رُقّيت/أُعِيدت لإصدار أقدم من مستودعات بعيدة. يُستخدم هذا الخيار أثناء عرض العمليات.

    القيمة المبدئية: bold,green.

color_search_match
    لون

    لون الأنماط المطابقة في مخرجات البحث.

    القيمة المبدئية: bold,magenta.

خيارات المستودع

baseurl
    list

    قائمة بعناوين URL للمستودع.

    مبدئي [].

    تُجرّب عناوين URL بالترتيب المذكور (يكافئ سلوك “failovermethod=priority” في yum).

cost
    integer

    التكلفة النسبية للوصول إلى هذا المستودع، وقيمتها المبدئية 1000. تُقارن هذه القيمة عندما تتساوى أولويات مستودعين. ويُختار المستودع ذو التكلفة الأقل. يفيد هذا الخيار في جعل المكتبة تفضل المستودعات الموجودة على القرص على المستودعات البعيدة.

enabled
    منطقي

    تضمين هذا المستودع كمصدر للحزم.

    القيمة المبدئية: True.

gpgkey
    list

    عناوين URL لملفات مفاتيح OpenPGP التي يمكن استخدامها لتوقيع البيانات الوصفية وحزم هذا المستودع. إذا تعذر التحقق من ملف باستخدام المفاتيح المستوردة بالفعل، تُحاول عملية استيراد المفاتيح من هذا الخيار ثم تُستخدم المفاتيح للتحقق.

    القيمة المبدئية: []

وصلة_معدنية
    سلسلة نصية

    عنوان URL لملف metalink الخاص بالمستودع.

    القيمة المبدئية: None.

mirrorlist
    سلسلة نصية

    عنوان URL لقائمة المرايا (mirrorlist) الخاصة بالمستودع.

    القيمة المبدئية: None.

name
    سلسلة نصية

    اسم المستودع بصيغة قابلة للقراءة البشرية. القيمة المبدئية هي معرف (ID) المستودع.

priority
    integer

    قيمة أولوية هذا المستودع. إذا كان هناك أكثر من حزمة مرشحة لعملية معينة، تُختار الحزمة من المستودع ذي قيمة الأولوية الأقل، وربما يحدث ذلك على الرغم من كونها أقل ملاءمة من نواحٍ أخرى (مثل كونها إصدارًا أقدم).

    القيمة المبدئية: 99

type
    سلسلة نصية

    نوع البيانات الوصفية للمستودع. القيم المدعومة هي: rpm-md. وأسماء مستعارة لـ rpm-md: rpm، وrepomd، وrpmmd، وyum، وYUM.

    المبدئي: فارغ.

أسماء مستودعات المصدر ومعلومات التنقيح

لمستودع معين بمعرف على شكل "<ID>-rpms"، يُتوقع أن يكون لمستودع المصدر المقابل له معرف على شكل "<ID>-source-rpms" ولمستودع معلومات التنقيح معرف على شكل "<ID>-debug-rpms". خلاف ذلك (إذا لم يكن لمعرف المستودع اللاحقة "-rpms")، يُتوقع أن يكون لمستودع المصدر معرف على شكل "<ID>-source" ولمستودع معلومات التنقيح معرف على شكل "<ID>-debuginfo".

على سبيل المثال، للمستودع "fedora"، مستودع المصدر هو "fedora-source" ومستودع معلومات التنقيح هو "fedora-debuginfo". للمستودع "fedora-rpms"، مستودع المصدر هو "fedora-source-rpms" ومستودع معلومات التنقيح هو "fedora-debug-rpms".

متغيرات المستودع

الجانب الأيمن لكل خيار مستودع يمكن إغناؤه بالمتغيرات التالية:

$arch يشير إلى معمارية المعالج للنظام، مثل aarch64 و i586 و i686 و x86_64.

$basearch يشير إلى المعمارية الأساسية للنظام. على سبيل المثال، تمتلك آلات i686 و i586 معمارية أساسية هي i386، ولدى آلات AMD64 و Intel64 معمارية أساسية هي x86_64.

$releasever يشير إلى إصدار نظام التشغيل الذي يشتقه DNF5 من المعلومات المتاحة في RPMDB.

بالإضافة إلى هذه المتغيرات المضمنة برمجياً، يمكن أيضًا استخدام متغيرات معرّفة من قبل المستخدم. ويمكن تعريفها إما عبر ملفات المتغيرات، أو باستخدام متغيرات بيئية خاصة. يجب أن تبدأ أسماء هذه المتغيرات بالبادئة _DNF_VAR ويمكن أن تتكون فقط من أحرف أبجدية رقمية وشرطات سفلية:

    $ DNF_VAR_MY_VARIABLE=value

لاستخدام هذا المتغير في إعداد المستودع الخاص بك، أزل البادئة. مثلاً:

    [myrepo]
    baseurl=https://example.site/pub/fedora/$MY_VARIABLE/releases/$releasever

لاحظ أنه ليس من الممكن تجاوز المتغيرات arch و basearch باستخدام ملفات المتغيرات أو متغيرات البيئة.

على الرغم من تشجيع المستخدمين على استخدام المتغيرات المسماة، إلا أن المتغيرات البيئية المرقمة من DNF0 إلى DNF9 لا تزال مدعومة:

    $ DNF1=value
    [myrepo]
    baseurl=https://example.site/pub/fedora/$DNF1/releases/$releasever

خيارات لكل من [MAIN] و REPO

يمكن تطبيق بعض الخيارات إما في القسم الرئيسي، أو لكل مستودع، أو بمزيج منهما. تُستخدم القيمة المقدمة في القسم الرئيسي لجميع المستودعات كقيمة مبدئية، والتي يمكن للمستودعات بعد ذلك تجاوزها في ضبطها الخاص.

bandwidth
    حجم التخزين

    إجمالي عرض النطاق الترددي المتاح للتنزيل. يكون ذا مغزى عند استخدامه مع خيار الخنق (throttle).

    القيمة المبدئية: 0.

build_cache
    منطقي

    في حال تفعيله، سيحفظ DNF5 خبيئة libsolv المولدة من البيانات الوصفية المنزلة في cachedir. تُحمل ملفات solv هذه أثناء التشغيل اللاحق مما يسرّع DNF5 بشكل ملحوظ.

    القيمة المبدئية: True.

countme
    منطقي

    عند التفعيل، سيُختار طلب HTTP GET واحد فقط لملف metalink عشوائيًا كل أسبوع ليحمل علم URL خاصًا.

    تسمح هذه العلامة لمزود المستودع بتقدير عدد الأنظمة التي تستهلك المستودع، عن طريق عد مثل هذه الطلبات على مدار أسبوع. هذه الطريقة أكثر دقة من مجرد عد عناوين IP الفريدة (التي تخضع لكل من الإفراط في العد ونقص العد بسبب عقود DHCP القصيرة و NAT، على التوالي).

    هذا ليس طلب HTTP خارج النطاق قُدم لهذا الغرض وحده. فقط الطلبات التي يبدأها DNF أثناء التشغيل العادي، مثل التحقق من تحديثات البيانات الوصفية، يمكنها الحصول على هذه العلامة.

    العلم هو معامل بسيط "countme=N" يُلحق برابط metalink حيث N هو عدد صحيح يمثل "وعاء" العمر الذي ينتمي إليه هذا النظام. حُدِّدَت أربعة أوعية، بناءً على عدد الأسابيع الكاملة التي مرت منذ تثبيت النظام:
    bucket | عمر النظام
    1 | الأسبوع الأول
    2 | أول شهر (2 - 4 أسابيع)
    3 | أول 6 أشهر (5 - 24 أسبوعًا)
    4 | أكثر من 6 أشهر (> 24 أسبوعاً)

    يهدف هذا الرقم إلى المساعدة في تمييز الحواسيب قصيرة العمر (التي تُستخدم مرة واحدة) عن التثبيتات طويلة الأمد والحصول على صورة أفضل لكيفية استخدام الأنظمة بمرور الوقت.

    لتحديد وقت تثبيت النظام ("الحقبة")، يُستخدم وقت تعديل ملف machine-id(5) كمصدر وحيد للحقيقة. يرتبط هذا الملف دلالياً بدورة حياة النظام حيث يُملأ عادةً في وقت التثبيت أو أثناء التمهيد الأول بواسطة أداة التثبيت أو نظام البدء (مثل systemd(1)) على التوالي، ويظل دون تغيير.

    إذا كان الملف فارغًا أو مفقودًا (كما في الحاويات)، فإن وقت الطلب الأول على الإطلاق الذي أُجري باستخدام عنوان URL الموسع لـ metalink (أي مع استبدال أي متغيرات مستودع مثل $releasever) والذي حمل العلامة، يُعلَن كحقبة (epoch).

    إذا لم يُعرف رابط metalink لهذا المستودع ولكن عُرف رابط mirrorlist، فسيُستخدم الأخير لهذا الغرض بدلا منه.

    القيمة المبدئية: False.

disable_excludes
    list

    يُستخدم لتعطيل تصفية الحزم والمجموعات والبيئات. يمكن أن يتضمن قائمة بمعرفات المستودعات (يُسمح بأنماط المطابقة globs) التي تُتجاهل استثناءات الحزم الخاصة بها. إذا كان يحتوي على القيمة الخاصة main، تُتجاوز الاستثناءات من ملفات الضبط الرئيسة. وإذا كان يحتوي على القيمة الخاصة *، فلا تُطبّق أي تصفية للاستثناءات على الإطلاق.

enablegroups
    منطقي

    في حال تفعيله، سيسمح DNF5 باستخدام مجموعات الحزم.

    القيمة المبدئية: True.

excludepkgs
    list

    استبعاد حزم هذا المستودع، المحددة باسم أو نمط مطابقة وفاصلاً بينها بفاصلة، من جميع العمليات.

    يمكن تعطيله باستخدام خيار الضبط disable_excludes.

    القيمة المبدئية: [].

fastestmirror
    منطقي

    إذا مُكنت، تُستخدم كمون مقبس TCP للعثور على أقرب مرآة متاحة. ثم تُختار مرآة عشوائيا بكمون أقل من ضعف أدنى كمون لأغراض موازنة الحمل. يتجاوز هذا الترتيب المقدم من ملف mirrorlist/metalink نفسه، ولا يأخذ في الاعتبار معاملات mirrorlist مثل عرض نطاق المرآة ولا المرايا المفضلة لعناوين IP للعميل.

    القيمة المبدئية: False.

pkg_gpgcheck
    منطقي

    ما إذا كان يجب إجراء فحص توقيع OpenPGP على الحزم الموجودة في هذا المستودع.

    المبدئي هو False.

    لا ينطبق على الحزم الممررة مباشرة كوسائط، لأنها ليست في أي مستودع، انظر localpkg_gpgcheck.

    لأسباب تتعلق بالتوافقية، يُدعم خيار gpgcheck أيضًا ولكن pkg_gpgcheck هو المفضل.

includepkgs
    list

    تضمين حزم هذا المستودع، المحددة باسم أو نمط مطابقة وفاصلاً بينها بفاصلة، في جميع العمليات.

    عكس excludepkgs، حيث سيستبعد DNF5 أي حزمة في المستودع لا تطابق هذه القائمة.

    يعمل هذا بالتزامن مع excludepkgs ولا يتجاوزه، فمثلاً إذا ضبطت 'excludepkgs=*.i386' و 'includepkgs=python*' فسيظهر لـ DNF5 في هذا المستودع الحزم التي تبدأ بـ python فقط والتي لا تملك معمارية i386.

    يمكن تعطيله باستخدام خيار الضبط disable_excludes.

    القيمة المبدئية: [].

ip_resolve
    عنوان ip

    يحدد كيفية دمج DNF5 لأسماء المضيفين. اضبط هذا على 4 أو IPv4 أو 6 أو IPv6 للدمج إلى عناوين IPv4 أو IPv6 فقط.

    القيمة المبدئية: whatever.

localpkg_gpgcheck
    منطقي

    في حال تفعيله، سيجري DNF5 فحص توقيع OpenPGP على الحزم المحلية (الحزم الموجودة في ملف، وليس في مستودع).

    القيمة المبدئية: False.

max_parallel_downloads
    integer

    الحد الأقصى لعدد التنزيلات المتزامنة. الحد الأقصى هو 20.

    القيمة المبدئية: 3.

انتهاء_البيانات_الواصفة
    الوقت بالثواني

    الفترة التي يُفحص بعدها المستودع البعيد لتحديث البيانات الوصفية وفي حال وجود تحديث تُحدّث خبيئة البيانات الوصفية المحلية. يمكن أن تكون -1 أو never لجعل صلاحية المستودع لا تنتهي أبداً.

    يمكن أيضًا إطلاق انتهاء صلاحية البيانات الوصفية عبر تغيير الطابع الزمني لملفات الضبط (dnf.conf، و<repo>.repo).

    انظر أيضًا check_config_file_age.

    القيمة المبدئية: 60 * 60 * 48, 48 hours.

minrate
    حجم التخزين

    يضبط حد السرعة المنخفضة بالبايت في الثانية. إذا كان الخادم يرسل البيانات بنفس هذه السرعة أو أقل منها لمدة تعادل ثواني خيار المهلة (timeout) على الأقل، فإن DNF5 يقطع الاتصال.

    القيمة المبدئية: 1000.

password
    سلسلة نصية

    كلمة المرور المستخدمة للاتصال بمستودع يتطلب استيثاق HTTP الأساسي.

    المبدئي: فارغ.

proxy
    سلسلة نصية

    عنوان URL لخادم الوكيل للاتصال من خلاله.

    تُضبط على سلسلة نصية فارغة في ضبط المستودع لتعطيل إعداد الوكيل الموروث من القسم الرئيس. التنسيق المتوقع لهذا الخيار هو <scheme>://<ip-or-hostname>[:port]. (للتوافقية مع الإصدارات السابقة، يمكن استخدام '_none_' بدلاً من السلسلة الفارغة.)

    المبدئي: فارغ.

    ملاحظة: تكون متغيرات بيئة curl (مثل http_proxy) فعالة إذا كان هذا الخيار غير مضبوط (أو إذا ضُبط '_none_' في ضبط المستودع). انظر صفحة دليل curl للمزيد من التفاصيل.

proxy_username
    سلسلة نصية

    اسم المستخدم للاستخدام عند الاتصال بخادم الوكيل.

    المبدئي: فارغ.

proxy_password
    سلسلة نصية

    كلمة المرور للاستخدام عند الاتصال بخادم الوكيل.

    المبدئي: فارغ.

proxy_auth_method
    سلسلة نصية

    طريقة الاستيثاق التي يستخدمها خادم الوكيل. القيم الصالحة هي
    method | المعنى
    basic | استيثاق HTTP الأساسي
    digest | استيثاق HTTP المختصر (Digest)
    negotiate | استيثاق HTTP Negotiate (SPNEGO)
    ntlm | استيثاق HTTP NTLM
    digest_ie | استيثاق HTTP المختصر (Digest) بنكهة IE
    ntlm_wb | تفويض NTLM إلى مساعد winbind
    none | بدون طريقة استيثاق
    any | جميع الطرق المناسبة

    القيمة المبدئية: any.

proxy_sslcacert
    سلسلة نصية

    المسار إلى الملف الذي يحتوي على سلطات الشهادات للتحقق من شهادات SSL للوكيل.

    المبدئي: فارغ، ويستخدم المبدئي للنظام.

proxy_sslclientcert
    سلسلة نصية

    المسار إلى شهادة عميل SSL المستخدمة للاتصال بخادم الوكيل.

    المبدئي: فارغ.

proxy_sslclientkey
    سلسلة نصية

    المسار إلى مفتاح عميل SSL المستخدم للاتصال بخادم الوكيل.

    المبدئي: فارغ.

proxy_sslverify
    منطقي

    في حال تفعيله، يُتحقق من شهادات SSL للوكيل. إذا تعذر استيثاق العميل، يفشل الاتصال ولا يُستخدم المستودع بعد ذلك. إذا كان False، يمكن استخدام اتصالات SSL ولكن لا يُتحقق من الشهادات.

    القيمة المبدئية: True.

repo_gpgcheck
    منطقي

    في حال تفعيله، سيجري DNF5 فحص توقيع OpenPGP على البيانات الوصفية لهذا المستودع.

    ملاحظة: تُخزن مفاتيح OpenPGP لهذا الفحص بشكل منفصل عن مفاتيح OpenPGP المستخدمة في التحقق من توقيع الحزم. علاوة على ذلك، تُخزن أيضًا بشكل منفصل لكل مستودع.

    هذا يعني أن DNF5 قد يطلب استيراد نفس المفتاح عدة مرات. على سبيل المثال، عندما يكون المفتاح قد استورد بالفعل للتحقق من توقيع الحزمة وفُعّل هذا الخيار، فقد تبرز الحاجة لاستيراده مجدداً للمستودع.

    القيمة المبدئية: False.

skip_if_unavailable
    منطقي

    في حال تفعيله، سيستمر DNF5 في العمل ويعطل المستودع الذي تعذرت مزامنته لأي سبب. لا يؤثر هذا الخيار على تخطي الحزم غير المتاحة بعد حل الاعتماديات. للتحقق من عدم إمكانية الوصول للمستودع، استخدمه بالتزامن مع خيار سطر أوامر التحديث.

    القيمة المبدئية: False.

    ملاحظة: يمكن ضبط هذا الخيار على وجه الخصوص في ملف الضبط الخاص بك بواسطة التوزيعة.

sslcacert
    سلسلة نصية

    المسار إلى الملف الذي يحتوي على سلطات الشهادات للتحقق من شهادات SSL.

    المبدئي: فارغ، ويستخدم المبدئي للنظام.

sslclientcert
    سلسلة نصية

    المسار إلى شهادة عميل SSL المستخدمة للاتصال بالمواقع البعيدة.

    المبدئي: فارغ.

sslclientkey
    سلسلة نصية

    المسار إلى مفتاح عميل SSL المستخدم للاتصال بالمواقع البعيدة.

    المبدئي: فارغ.

sslverify
    منطقي

    في حال تفعيله، يُتحقق من شهادات SSL البعيدة. إذا تعذر استيثاق العميل، يفشل الاتصال ولا يُستخدم المستودع بعد ذلك. في حال تعطيله، يمكن استخدام اتصالات SSL ولكن لا يُتحقق من الشهادات.

    القيمة المبدئية: True.

throttle
    حجم التخزين

    يحد من سرعة التنزيل. قد يكون قيمة مطلقة أو نسبة مئوية نسبة إلى قيمة خيار عرض النطاق الترددي (bandwidth). القيمة 0 تعني عدم وجود خنق.

    القيمة المبدئية: 0.

timeout
    الوقت بالثواني

    عدد الثواني للانتظار قبل انتهاء مهلة الاتصال. يُستخدم بالتزامن مع خيار الحد الأدنى للمعدل (minrate).

    القيمة المبدئية: 30.

username
    سلسلة نصية

    اسم المستخدم للاستخدام عند الاتصال بالمستودع عبر استيثاق HTTP الأساسي.

    المبدئي: فارغ.

user_agent
    سلسلة نصية

    سلسلة وكيل المستخدم (User-Agent) لتضمينها في طلبات HTTP المرسلة بواسطة DNF5.

    القيمة المبدئية:

        libdnf (NAME VERSION_ID; VARIANT_ID; OS.BASEARCH)

    ملاحظة: تعد المعرفات NAME وVERSION_ID وVARIANT_ID معرفات لنظام التشغيل تُقرأ من ملف os-release(5)، ويمثل OS وBASEARCH اسم نظام التشغيل النموذجي والمعمارية الأساسية على التوالي. مثال:

        libdnf (Fedora 39; server; Linux.x86_64)

أنواع الخيارات

boolean
    نوع بيانات بقيمتين محتملتين فقط.

    يمكن استخدام أحد الخيارات التالية: 1، و0، وTrue، وFalse، وyes، وno.

color
    سلسلة نصية تصف اللون والمعدّلات ويفصل بينها بفاصلة، على سبيل المثال red,bold.

•   الألوان: black، وblue، وcyan، وgreen، وmagenta، وred، وwhite، وyellow.

•   المعدّلات: bold، وblink، وdim، وnormal، وreverse، وunderline.

integer
    عدد صحيح يمكن كتابته بدون مكون كسري.

نوع عنوان ip
    سلسلة نصية تصف أنواع عناوين ip.

    يمكن استخدام أحد الخيارات التالية: 4، وIPv4، و6، وIPv6.

list
    سلسلة نصية تمثل سلسلة واحدة أو أكثر تفصل بينها مسافات أو علامات الفاصلة.

حجم التخزين
    سلسلة نصية تمثل أحجام التخزين وتتكون من عدد صحيح ووحدة.

    الوحدات الصالحة هي k، وM، وG.

string
    إنه تسلسل من الرموز أو الأرقام بدون أي محرف مسافة بيضاء.

الوقت بالثواني
    سلسلة نصية تمثل وحدات الوقت بالثواني. يمكن ضبطها على -1 أو never.

أدلة الضبط الإضافية (DROP-IN)

يُحمل DNF5 خيارات الضبط المعرّفة في ملف الضبط الرئيس وملفات ضبط المستخدم وملفات ضبط التوزيعة.

تُعالج ملفات الضبط وفقاً لهذا الترتيب:

1.  تُفرز ملفات الضبط أبجدياً في قائمة أسماء من دليل ضبط التوزيعة. إذا وجد ملف يحمل نفس الاسم في كلا الدليلين، يُضاف الملف من دليل ضبط المستخدم فقط إلى القائمة. وبالتالي يُحجب ملف التوزيعة بواسطة ملف المستخدم.

2.  تُجلب الخيارات بالترتيب من القائمة. يتجاوز الضبط الوارد في الملف التالي الضبط السابق له. والخيارات الأخيرة هي التي تُعتمد.

  مثال لملفات الضبط

ملفات ضبط المستخدم:

•   /etc/dnf/dnf.conf

•   /etc/dnf/libdnf5.conf.d/20-user-settings.conf

•   /etc/dnf/libdnf5.conf.d/60-something.conf

•   /etc/dnf/libdnf5.conf.d/80-user-settings.conf

    ملفات ضبط التوزيعة:

•   /usr/share/dnf5/libdnf.conf.d/50-something.conf

•   /usr/share/dnf5/libdnf.conf.d/60-something.conf

•   /usr/share/dnf5/libdnf.conf.d/90-something.conf

    ترتيب تحميل الملفات الناتج مبدئياً (يُتخطى الملف usr/share/dnf5/libdnf.conf.d/60-something.conf/، حيث حُجب بواسطة ملف المستخدم etc/dnf/libdnf5.conf.d/60-something.conf/):

1.  /etc/dnf/libdnf5.conf.d/20-user-settings.conf

2.  /usr/share/dnf5/libdnf.conf.d/50-something.conf

3.  /etc/dnf/libdnf5.conf.d/60-something.conf

4.  /etc/dnf/libdnf5.conf.d/80-user-settings.conf

5.  /usr/share/dnf5/libdnf.conf.d/90-something.conf

6.  /etc/dnf/dnf.conf

  الملفات والمجلدات

دليل ضبط المستخدم
    /etc/dnf/libdnf5.conf.d/

ملفات ضبط المستخدم
    /etc/dnf/libdnf5.conf.d/20-user-settings.conf

دليل ضبط التوزيعة
    /usr/share/dnf5/libdnf.conf.d/

ملفات ضبط التوزيعة
    /usr/share/dnf5/libdnf.conf.d/50-something.conf

أدلة المستودعات الإضافية (DROP-IN)

بعد تحميل إعدادات المستودع، يمكن زيادة تحميل إعدادات مستودعات أخرى من دليل تخطي مستودعات المستخدم ودليل تخطي مستودعات التوزيع.

صيغة الملفات داخل الأدلة هي نفس صيغة ملفات إعدادات المستودع. الخيارات في الملفات المُتخطاة يمكنها تعديل المستودعات الحالية ولكن لا يمكنها إنشاء مستودعات جديدة.

تدعم ملفات التخطي الأنماط الشاملة (globs) في معرف المستودع من أجل دعم التعديلات الجماعية لمعاملات المستودع.

تُعالج تخطيات المستودع وفقًا لهذا الترتيب:

1.  تُحمل الملفات من /usr/share/dnf5/repos.override.d/ و /etc/dnf5/repos.override.d/ في قائمة مرتبة أبجديًا. وفي حال كانت الملفات تحمل الاسم نفسه، يُستخدم الملف من /etc/dnf5/repos.override.d/. يعني هذا أن القائمة تحتوي فقط على أسماء ملفات فريدة. ويعني هذا أيضًا أنه يمكن حجب ملفات إعدادات المستودع ببساطة عن طريق إنشاء ملف بالاسم نفسه في دليل التخطي /etc.

2.  تُطبق الخيارات من الملفات بالترتيب الذي حُملت به. الخيار الأخير هو الذي يُعتمد.

    ملاحظة: انظر أيضًا وثائق أمر مدير الإعدادات (Config-manager Command) <#config-manager-plugin-ref-label> لمعرفة مكان استخدام التخطيات.

  مثال للإعداد

    # تمكين `skip_if_unavailable` لجميع المستودعات
    [*]
    skip_if_unavailable = true
    # ثم تعطيل `skip_if_unavailable` للمستودعات التي تبدأ معرفاتها بـ "fedora"
    [fedora*]
    skip_if_unavailable = false

  مثال لملفات الضبط

يوضح هذا المثال الترتيب الذي تُعالج به ملفات التخطي.

الملفات التي تحتوي على تخطيات مستودعات المستخدم:

•   /etc/dnf/repos.overide.d/20-user-overrides.repo

•   /etc/dnf/repos.overide.d/60-something2.repo

•   /etc/dnf/repos.overide.d/80-user-overrides.repo

•   /etc/dnf/repos.overide.d/99-config-manager.repo

    الملفات التي تحتوي على تخطيات مستودعات التوزيع:

•   /usr/share/dnf5/repos.overide.d/50-something2.repo

•   /usr/share/dnf5/repos.overide.d/60-something2.repo

•   /usr/share/dnf5/repos.overide.d/90-something2.repo

    ترتيب معالجة الملفات الناتج:

1.  /etc/dnf/repos.overide.d/20-user-overrides.repo

2.  /usr/share/dnf5/repos.overide.d/50-something2.repo

3.  /etc/dnf/repos.overide.d/60-something2.repo

4.  /etc/dnf/repos.overide.d/80-user-overrides.repo

5.  /usr/share/dnf5/repos.overide.d/90-something2.repo

6.  /etc/dnf/repos.overide.d/99-config-manager.repo

  الملفات والمجلدات

دليل تخطي مستودعات المستخدم
    /etc/dnf/repos.override.d/

ملفات تخطي مستودعات المستخدم
    /etc/dnf/repos.override.d/20-user-overrides.repo

دليل تخطي مستودعات التوزيع
    /usr/share/dnf5/repos.override.d/

ملفات تخطي مستودعات التوزيع
    /usr/share/dnf5/repos.override.d/50-something2.repo

الملفات

ملف الضبط الرئيس
    /etc/dnf/dnf.conf

ملفات الخبيئة
    /var/cache/libdnf5

ملفات المستودع
    /etc/yum.repos.d/

المتغيرات
    تُحوّل أي خاصية مسمى ملف في /etc/dnf/vars إلى متغير يسمى باسم ملف الاسم (أو تتخطى أيًا من المتغيرات المذكورة أعلاه باستثناء تلك المحددة من سطر الأوامر). قد تحتوي أسماء الملفات على أحرف وأرقام وشرطات سفلية فقط ويجب أن تكون بحروف صغيرة. تُقرأ المتغيرات أيضًا من /etc/yum/vars لأسباب تتعلق بالتوافق مع YUM.

أدلة

  أدلة المستودع

تُسرد الأدلة بالترتيب الذي تُعالج به.

ملاحظة: على عكس التخطيات التي تعدل إعداد مستودع حالي، فإن الإعدادات في هذه الأدلة تُعرف مستودعات جديدة. لا يمكن تعريف مستودعات بالمعرف نفسه. وإذا عُرّفت مستودعات متعددة بالمعرف نفسه، فسيُحمل الإعداد الأول فقط. وسيؤدي تحميل الإعداد التالي إلى تسجيل خطأ.

دليل مستودعات YUM
    /etc/yum.repos.d/

دليل مستودعات التوزيع في /etc
    /etc/distro.repos.d/

دليل مستودعات التوزيع في /usr
    /usr/share/dnf5/repos.d/

  أدلة المتغيرات

دليل المتغيرات
    /etc/dnf/vars/

دليل متغيرات التوزيع
    /usr/share/dnf5/vars.d/

انظر أيضًا

•   dnf5(8)، مرجع أوامر DNF5 <#command-ref-label>

•   dnf5.conf-todo(5)، الخيارات الموثقة/المُضمّنة في DNF ولكن ليس في DNF5 <#dnf5-conf-todo-label>

•   dnf5.conf-deprecated(5)، خيارات الإعداد المهجورة في DNF5 <#dnf5-conf-deprecated-label>

المؤلف
انظر AUTHORS.md في توزيعة مصدر dnf5.

حقوق النسخ
المساهمون في مشروع dnf5.

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.