DNF4.CONF(5)

الاسم
dnf4.conf - مرجع ضبط DNF

الوصف

يستخدم DNF <https://github.com/rpm-software-management/dnf/> مبدئيًا ملف الضبط الشامل في /etc/dnf/dnf.conf وجميع ملفات *.repo الموجودة تحت /etc/yum.repos.d. تُستخدم الأخيرة عادةً لضبط المستودع وتتقدم على الضبط الشامل.

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

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

ضبط خاص بالتوزيعة

يمكن تعيين خيارات الضبط، وتحديدًا best و skip_if_unavailable، في ملف ضبط DNF بواسطة توزيعتك لتجاوز قيم DNF المبدئية.

خيارات [MAIN]

allow_vendor_change
    منطقي

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

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

arch
    سلسلة نصية

    المعمارية المستخدمة لتثبيت الحزم. تُكتشف آليًا مبدئيًا. تُستخدم غالبًا مع خيار ignorearch.

assumeno
    منطقي

    إذا فُعّل فستفترض dnf الإجابة No حيث تطلب عادةً تأكيدًا من مدخلات المستخدم. المبدئي هو False.

assumeyes
    منطقي

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

autocheck_running_kernel
    منطقي

    فحص آلي عما إذا كانت هناك وحدة نواة مثبتة أحدث مع تحديث أمني من النواة التي تعمل حاليًا. المبدئي هو True.

basearch
    سلسلة نصية

    المعمارية الأساسية المستخدمة لتثبيت الحزم. تُكتشف آليًا مبدئيًا.

best
    منطقي

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

cachedir
    سلسلة نصية

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

cacheonly
    منطقي

    إذا ضُبط على True فسيعمل DNF بالكامل من خبيئة النظام، ولن يحدّث الخبيئة وسيتخدمها حتى في حال انتهاء صلاحيتها. المبدئي هو False.

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

check_config_file_age
    منطقي

    يحدد ما إذا كان ينبغي لـ dnf إنهاء صلاحية البيانات الحافية للمستودعات آليًا، والتي تكون أقدم من ملف ضبطها المقابل (عادةً ملف dnf.conf وملف foo.repo). المبدئي هو True (إجراء الفحص). يتأثر انتهاء صلاحية البيانات الحافية أيضًا بعمر البيانات الحافية. انظر أيضًا metadata_expire.

clean_requirements_on_remove
    منطقي

    إزالة الاعتماديات التي لم تعد مستخدمة أثناء الأمر dnf remove. لا تتأهل الحزمة للإزالة عبر clean_requirements_on_remove إلا إذا ثُبّتت من خلال DNF وليس بناءً على طلب صريح من المستخدم، أي سُحبت كاعتمادية. المبدئي هو True. (لا تُزال حزم installonlypkgs آليًا أبدًا.)

config_file_path
    سلسلة نصية

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

debuglevel
    integer

    مستوى خرج رسائل التنقيح، في النطاق من 0 إلى 10. كلما زاد الرقم وُضع المزيد من خرج التنقيح في الخرج القياسي stdout. المبدئي هو 2.

debug_solver
    منطقي

    يتحكم في ما إذا كان ينبغي إنشاء ملفات تنقيح libsolv عند حل المعاملة. تُنشأ ملفات التنقيح في دليل ./debugdata. المبدئي هو False.

defaultyes
    منطقي

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

diskspacecheck
    منطقي

    يتحكم في ما إذا كان ينبغي لـ rpm فحص المساحة المتاحة على القرص أثناء المعاملة. المبدئي هو True.

errorlevel
    integer

    مستوى خرج رسائل الخطأ، في النطاق من 0 إلى 10. كلما زاد الرقم وُضع المزيد من خرج الخطأ في الخطأ القياسي stderr. المبدئي هو 3. هذا مهجور في DNF ويُتجاوز بواسطة خيار سطر الأوامر --verbose <#verbose-options-label>.

exclude_from_weak
    list

    منع تثبيت الحزم كاعتماديات ضعيفة (موصى بها recommends أو مكملة supplements). يمكن تحديد الحزم باسم أو بنمط مطابقة وتُفصل بفاصلة. القيمة المبدئية هي [].

exclude_from_weak_autodetect
    منطقي

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

exit_on_lock
    منطقي

    هل ينبغي لعميل dnf الخروج فورًا عندما يكون القفل محجوزًا بواسطة شيء آخر. المبدئي هو False.

gpgkey_dns_verification
    منطقي

    هل ينبغي لـ dnf محاولة التحقق آليًا من مفاتيح تحقق GPG باستخدام نظام DNS. يتطلب هذا الخيار تثبيت وحدة بايثون unbound (python3-unbound) على نظام العميل. يحتوي هذا النظام على ميزتين رئيسيتين. الأولى هي فحص ما إذا كان أي من المفاتيح المثبتة بالفعل قد أُبطل. الإزالة الآلية للمفتاح ليست متاحة بعد، لذا فالأمر متروك للمستخدم لإزالة المفاتيح المبطلة من النظام. الميزة الثانية هي التحقق الآلي من المفاتيح الجديدة عند إضافة مستودع إلى النظام. في الوضع التفاعلي، تُكتب النتيجة إلى الخرج كاقتراح للمستخدم. في الوضع غير التفاعلي (أي عند استخدام -y)، سيقبل هذا النظام آليًا المفاتيح المتاحة في DNS والموقعة بشكل صحيح باستخدام DNSSEC. سيقبل أيضًا المفاتيح غير الموجودة في نظام DNS ويُثبت عدم وجودها تعمويًا باستخدام DNSSEC. هذا مخصص أساسًا للحفاظ على التوافق الخلفي. المبدئي هو False.

group_package_types
    list

    قائمة بالتالي: اختياري (optional)، ومبدئي (default)، وإلزامي (mandatory). تخبر dnf بأي نوع من الحزم في المجموعات سيُثبّت عند استدعاء 'groupinstall'. المبدئي هو: default, mandatory.

ignorearch
    منطقي

    إذا ضُبط على True، فسيسمح RPM بمحاولات تثبيت حزم غير متوافقة مع معمارية المعالج CPU. القيمة المبدئية هي False. يُستخدم غالبًا مع خيار arch.

installonlypkgs
    list

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

installonly_limit
    integer

    عدد حزم installonly المسموح بتثبيتها بالتزامن. القيمة المبدئية هي 3. العدد الأدنى لحزم installonly هو 2. تعني القيمة 0 عددًا غير محدود من حزم installonly. القيمة 1 غير مسموح بها صراحةً لأنها تعقد ترقيات النواة بسبب حماية النواة التي تعمل حاليًا من الإزالة.

installroot
    سلسلة نصية

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

install_weak_deps
    منطقي

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

keepcache
    منطقي

    يحتفظ بالحزم المنزلة في الخبيئة عند ضبطه على True. حتى إذا ضُبط على False ولم تُثبّت الحزم، فستظل قائمة حتى المعاملة الناجحة التالية. المبدئي هو False.

logdir
    سلسلة نصية

    الدليل الذي ستُخزن فيه ملفات السجل. المبدئي هو /var/log.

logfilelevel
    integer

    مستوى خرج رسائل ملف السجل، في النطاق من 0 إلى 10. كلما زاد الرقم وُضع المزيد من خرج التنقيح في السجلات. المبدئي هو 9.

    يتحكم هذا الخيار في dnf.log و dnf.librepo.log و hawkey.log. على الرغم من أن dnf.librepo.log و hawkey.log لا يتأثران إلا بضبط logfilelevel إلى 10.

log_compress
    منطقي

    عند ضبطه على True، تُضغط ملفات السجل عندما تُدوّر. المبدئي هو False.

log_rotate
    integer

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

log_size
    حجم التخزين

    تُدوّر ملفات السجل عندما تنمو لتصبح أكبر من عدد بايتات log_size. إذا كان log_size هو 0، فلن يُجرى التدوير. المبدئي هو 1 ميجابايت. الوحدات الصالحة هي 'k' و 'M' و 'G'.

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

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

    الفترة الدنيا بين تشغيلين متتاليين لـ makecache timer. سيتوقف الأمر فورًا إذا كانت الفترة الزمنية أقل من هذه الفترة منذ آخر تشغيل له. لا يؤثر على تشغيل makecache البسيط. استخدم 0 لتعطيل المزامنة الآلية للبيانات الحافية تمامًا. يتوافق المبدئي مع ثلاث ساعات. تُقرّب القيمة إلى الساعة التالية التي بدأت.

module_obsoletes
    منطقي

    يتحكم هذا الخيار في ما إذا كان ينبغي لـ dnf تطبيق المهجورات القياسية (modular obsoletes) عندما يكون ذلك ممكنًا. المبدئي هو False.

module_platform_id
    سلسلة نصية

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

module_stream_switch
    منطقي

    يتحكم هذا الخيار في ما إذا كان من الممكن تبديل التدفقات المفعّلة للوحدة. المبدئي هو False.

multilib_policy
    سلسلة نصية

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

obsoletes
    منطقي

    يؤثر هذا الخيار فقط أثناء التثبيت/التحديث. يفعّل منطق معالجة المهجورات في dnf، مما يعني أنه يجعل dnf تفحص ما إذا كانت أي اعتماديات للحزمة المحددة لم تعد مطلوبة وتزيلها. مفيد عند إجراء ترقيات على مستوى التوزيعة. المبدئي هو 'true'.

    خيار سطر الأوامر: --obsoletes <#obsoletes-option-label>

optional_metadata_types
    list

    قائمة بأنواع البيانات الحافية التي ستُحمّل بالإضافة إلى primary و modules و comps و updateinfo و presto، والتي تُحمّل دائمًا.

    تذكر أن القائمة يمكن توسيعها بواسطة أوامر فردية لطلب تحميل نوع بيانات حافية معين صراحةً.

    حاليًا تدعم القيمة filelists فقط. المبدئي هو قائمة فارغة.

persistdir
    سلسلة نصية

    الدليل الذي يخزن فيه DNF بياناته المستمرة بين التشغيلات. المبدئي هو "/var/lib/dnf".

persistence
    سلسلة نصية

    ما إذا كانت التغييرات يجب أن تستمر عبر إعادات تشغيل النظام. المبدئي هو auto. تمرير --transient <#transient-option-label> سيتجاوز هذا الإعداد إلى transient. القيم الصالحة هي:

•   auto: ستستمر التغييرات عبر إعادات التشغيل، إلا إذا كان الهدف نظام bootc قيد التشغيل وكان النظام بالفعل في حالة إلغاء القفل (أي أن /usr قابل للكتابة).

•   transient: ستُفقد التغييرات في إعادة التشغيل التالية. ينطبق فقط على أنظمة bootc. احذر من أن التغييرات في /etc و /var ستستمر، اعتمادًا على ضبط نظام bootc لديك. انظر أيضًا <https://bootc-dev.github.io/bootc/man/bootc-usr-overlay.html>.

•   persist: ستستمر التغييرات عبر إعادات التشغيل.

pluginconfpath
    list

    قائمة بالأدلة التي يُبحث فيها عن ضبوط الملحقات لتحميلها. تُحلل جميع ملفات الضبط الموجودة في هذه الأدلة، والتي تسمى بنفس اسم الملحق. المسار المبدئي هو /etc/dnf/plugins.

pluginpath
    list

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

plugins
    منطقي

    يتحكم في ما إذا كانت الملحقات مفعّلة. المبدئي هو True.

protected_packages
    list

    قائمة بالحزم التي لا ينبغي لـ DNF إزالتها تمامًا أبدًا. إنها محمية عبر المهجورات (Obsoletes) بالإضافة إلى إزالات المستخدم/الملحقات.

    المبدئي هو: dnf و glob:/etc/yum/protected.d/*.conf و glob:/etc/dnf/protected.d/*.conf. لذا فإن أي حزم ينبغي حمايتها يمكنها فعل ذلك بتضمين ملف في /etc/dnf/protected.d يحتوي على اسم الحزمة بداخله.

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

protect_running_kernel
    منطقي

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

releasever
    سلسلة نصية

    يُستخدم لاستبدال $releasever في ضبط المستودع.

    سُتشتّق المتغيرات $releasever_major و $releasever_minor آليًا من $releasever بتقسيمه عند أول .. على سبيل المثال، إذا ضُبط $releasever على 1.23، فإن $releasever_major سيكون 1 و $releasever_minor سيكون 23.

    يمكن أيضًا تعيين $releasever_major و $releasever_minor بواسطة التوزيعة.

    انظر أيضًا متغيرات المستودع (repo variables).

reposdir
    list

    يبحث DNF عن ملفات ضبط المستودع في المسارات المحددة بواسطة reposdir. قد يختلف سلوك reposdir عند استخدامه مع خيار --installroot.

rpmverbosity
    سلسلة نصية

    مستوى خرج السكربت الصغير لتنقيح RPM. واحد من: critical أو emergency أو error أو warn أو info أو debug. المبدئي هو info.

strict
    منطقي

    إذا عُطّل، فستُتجاوز جميع الحزمة غير المتاحة أو الحزم ذات الاعتماديات المعطوبة الممررة إلى أمر DNF دون إثارة الخطأ الذي يتسبب في فشل العملية برمتها. يعمل حاليًا مع أمر التثبيت (install) فقط. المبدئي هو True.

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 فحصًا للمعاملة دون إجرائها. يتضمن ذلك تنزيل الحزم، وفحص مفاتيح gpg (بما في ذلك الاستيراد الدائم لمفاتيح إضافية إذا لزم الأمر)، وفحص rpm لمنع تعارض الملفات. خيار nocaps مدعوم مع rpm-4.14 أو الأحدث. عند استخدام nocaps ولكن rpm لا يدعمه، يبلغ DNF عنه فقط كعلم tsflag غير صالح.

upgrade_group_objects_upgrade
    منطقي

    اضبط هذا على False لتعطيل التشغيل الآلي للأمر group upgrade عند تشغيل الأمر upgrade. المبدئي هو True (إجراء العملية).

usr_drift_protected_paths
    list

    قائمة بالمسارات المحتمل أن تسبب مشكلات عندما تنجرف محتوياتها بالنسبة إلى /usr، مثل /etc/pam.d/*. إذا كانت معاملة عابرة (transient) ستعدل هذه المسارات، يجهض DNF العملية ويطبع خطأً. يدعم أنماط المطابقة (globs). القيمة المبدئية هي glob:/etc/dnf/usr-drift-protected-paths.d/*.conf. لذا يمكن حماية قائمة من المسارات بإنشاء ملف .conf في /etc/dnf/usr-drift-protected-paths.d/ يحتوي على مسار واحد (أو نمط مطابقة) في كل سطر.

    عند استخدام persistence=transient على أنظمة bootc، تُنشأ طبقة فوقية عابرة (transient overlay) على /usr، وأي تغييرات يجريها DNF على /usr ستُنبذ عند إعادة التشغيل. ومع ذلك، فإن المسارات الأخرى مثل /etc و /var (غالبًا) لا تكون مدعومة بطبقة فوقية عابرة، لذا فإن التغييرات عليها ستستمر عبر إعادات التشغيل. عادةً ما يكون هذا "الانجراف في نظام الملفات" مقبولاً، ولكنه قد يسبب مشكلات في مواقف معينة. على سبيل المثال، قد يشير ملف ضبط في /etc مشترك بين حزم متعددة إلى ملف .so تحت /usr/lib64 لم يعد موجودًا.

varsdir
    list

    قائمة بالأدلة التي يُبحث فيها عن ملفات تعريف المتغيرات. القيمة المبدئية هي "/etc/dnf/vars", "/etc/yum/vars". انظر ملفات المتغيرات في مرجع الضبط.

zchunk
    منطقي

    يفعّل أو يعطّل استخدام البيانات الحافية للمستودع المضغوطة باستخدام صيغة zchunk (إذا كانت متاحة). المبدئي هو True.

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

color
    سلسلة نصية

    يتحكم في ما إذا كان DNF يستخدم خرجًا ملونًا على سطر الأوامر. القيم الممكنة: "auto" و "never" و "always". المبدئي هو "auto".

color_list_available_downgrade
    لون

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

color_list_available_install
    لون

    لون الحزم المتاحة للتثبيت ولم يُثبّت أي إصدار منها. يُستخدم هذا الخيار أثناء عمليات السرد. المبدئي هو عريض،سماوي (bold,cyan).

color_list_available_reinstall
    لون

    لون الحزم المتاحة المطابقة للإصدارات المثبتة والمتاحة لإعادة التثبيت. المبدئي هو عريض،تحته_خط،أخضر (bold,underline,green). يُستخدم الخيار أثناء عمليات السرد.

color_list_available_upgrade
    لون

    لون الحزم المتاحة الأحدث من الحزم المثبتة. المبدئي هو عريض،أزرق (bold,blue). يُستخدم الخيار أثناء عمليات السرد.

color_list_installed_extra
    لون

    لون الحزم المثبتة التي ليس لها أي إصدار ضمن الحزم المتاحة. يُستخدم الخيار أثناء عمليات السرد. المبدئي هو عريض،أحمر (bold,red).

color_list_installed_newer
    لون

    لون الحزم المثبتة الأحدث من أي إصدار ضمن الحزم المتاحة. يُستخدم الخيار أثناء عمليات السرد. المبدئي هو عريض،أصفر (bold,yellow).

color_list_installed_older
    لون

    لون الحزم المثبتة الأقدم من أي إصدار ضمن الحزم المتاحة. يُستخدم الخيار أثناء عمليات السرد. المبدئي هو أصفر (yellow).

color_list_installed_reinstall
    لون

    لون الحزم المثبتة والموجودة ضمن الحزم المتاحة ويمكن إعادة تثبيتها. يُستخدم الخيار أثناء عمليات السرد. المبدئي هو سماوي (cyan).

color_search_match
    لون

    لون الأنماط المتطابقة في خرج البحث. المبدئي هو عريض،أرجواني (bold,magenta).

color_update_installed
    لون

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

color_update_local
    لون

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

color_update_remote
    لون

    لون الحزم التي تُثبّت/تُرقّى/تُخفّض من مستودعات عن بعد. يُستخدم هذا الخيار أثناء عرض المعاملات. المبدئي هو عريض،أخضر (bold,green).

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

baseurl
    list

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

    تُجرّب عناوين URL بالترتيب المدرج (ما يعادل سلوك "failovermethod=priority" في أداة yum).

cost
    integer

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

enabled
    منطقي

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

gpgkey
    قائمة من السلاسل

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

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

    عنوان URL لـ metalink الخاص بالمستودع. القيمة المبدئية هي None.

mirrorlist
    سلسلة نصية

    عنوان URL لـ mirrorlist الخاص بالمستودع. القيمة المبدئية هي None.

module_hotfixes
    منطقي

    اضبط هذا على True لتعطيل ترشيح حزم RPM القياسية وجعل جميع حزم RPM من المستودع متاحة. المبدئي هو False. يسمح هذا للمستخدم بإنشاء مستودع يحتوي على إصلاحات عاجلة منتقاة بعناية ومضمنة في مجموعة حزم على نظام قياسي (modular system).

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 يشير إلى إصدار الإطلاق لنظام التشغيل الذي يشتقه DNF من المعلومات المتوفرة في RPMDB.

$releasever_major الإصدار الرئيسي لـ $releasever، أي مكون $releasever الواقع قبل علامة . الأولى.

$releasever_minor الإصدار الفرعي لـ $releasever، أي مكون $releasever الواقع بعد علامة . الأولى.

بالإضافة إلى هذه المتغيرات المدمجة كودياً، يمكن استخدام متغيرات معرفة من قبل المستخدم. يمكن تعريفها إما عبر ملفات المتغيرات، أو باستخدام متغيرات بيئية خاصة. يجب أن تبدأ أسماء هذه المتغيرات بالبادئة 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

يُدعم شكل محدود من التوسع في المعاملات الشبيه بـ الصدفة للمتغيرات.

${my_variable:-word} إذا كان my_variable غير معين أو فارغاً، سيُستبدل بـ word. خلاف ذلك، ستُستبدل قيمة my_variable.

${my_variable:+word} إذا كان my_variable معيناً وليس فارغاً، سيُستبدل بـ word. خلاف ذلك، ستُستبدل السلسلة الفارغة.

يمكن تداخل توسعات المعاملات حتى عمق أقصاه 32. على سبيل المثال:

    ${my_defined_variable:+${my_undefined_variable:-foobar}}

سوف يُؤول إلى foobar.

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

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

bandwidth
    حجم التخزين

    إجمالي عرض النطاق الترددي المتاح للتنزيل. يكون ذا معنى عند استخدامه مع خيار الخنق. حجم التخزين يكون بالبايت مبدئياً ولكن يمكن تحديده بوحدة تخزين. الوحدات الصالحة هي 'k' و 'M' و 'G'.

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.

deltarpm
    منطقي

    عند تمكينه، سيوفر DNF عرض النطاق الترددي عن طريق تنزيل ملفات دلتا RPM أصغر بكثير، وإعادة بنائها إلى RPM محلياً. ومع ذلك، فإن هذا يستهلك الكثير من المعالج والإدخال/الإخراج. المبدئي هو False. يتطلب وجود /usr/bin/applydeltarpm على النظام.

deltarpm_percentage
    integer

    عندما يكون الحجم النسبي للدلتا مقابل الحزمة أكبر من هذا، لا تُستخدم الدلتا. القيمة المبدئية هي 75 (يجب أن تكون الدلتا أصغر بنسبة 25% على الأقل من الحزمة). استخدم 0 لإيقاف معالجة دلتا rpm. المستودعات المحلية (التي تستخدم <file://> baseurl) تكون دلتا rpms معطلة فيها مبدئياً.

enablegroups
    منطقي

    يحدد ما إذا كان DNF سيسمح باستخدام مجموعات الحزم لهذا المستودع. المبدئي هو True (مجموعات الحزم مسموح بها).

excludepkgs
    list

    استبعاد حزم هذا المستودع، المحددة باسم أو نمط تعميم ومفصولة بفاصلة، من جميع العمليات. يمكن تعطيله باستخدام مفتاح سطر الأوامر --disableexcludes. القيمة المبدئية هي [].

fastestmirror
    منطقي

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

gpgcheck
    منطقي

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

    يمكن استخدام هذا الخيار فقط لتعزيز سياسة أمان RPM النشطة المحددة باستخدام ماكرو %_pkgverify_level (راجع ملف /usr/lib/rpm/macros للحصول على التفاصيل). هذا يعني أنه إذا ضُبط الماكرو على 'signature' أو 'all' وكان هذا الخيار False، فسيُتجاوز إلى True أثناء وقت تشغيل DNF، وسيُطبع تحذير. لإسكات التحذير، تأكد من أن هذا الخيار هو True لكل مستودع مُموّن، وقم أيضًا بتمكين localpkg_gpgcheck.

includepkgs
    list

    تضمين حزم هذا المستودع، المحددة باسم أو نمط تعميم ومفصولة بفاصلة، في جميع العمليات. عكس excludepkgs، حيث سيستبعد DNF أي حزمة في المستودع لا تطابق هذه القائمة. يعمل هذا بالتزامن مع excludepkgs ولا يتجاوزه، لذلك إذا قمت بضبط 'excludepkgs=*.i386' و 'includepkgs=python*' فلن يرى DNF في هذا المستودع سوى الحزم التي تبدأ بـ python والتي لا تحتوي على بنية i386. يمكن تعطيله باستخدام مفتاح سطر الأوامر --disableexcludes. القيمة المبدئية هي [].

ip_resolve
    نوع عنوان IP

    يحدد كيف يقوم DNF بحل أسماء المضيفين. اضبط هذا على '4'/'IPv4' أو '6'/'IPv6' للحل إلى عناوين IPv4 أو IPv6 فقط. مبدئياً، يقوم DNF بالحل إلى أي من العنوانين.

localpkg_gpgcheck
    منطقي

    ما إذا كان سيُجرى فحص توقيع GPG على الحزم المحلية (الحزم الموجودة في ملف، وليس في مستودع). المبدئي هو False. يخضع هذا الخيار لسياسة أمان RPM النشطة (راجع gpgcheck لمزيد من التفاصيل).

max_parallel_downloads
    integer

    الحد الأقصى لعدد تنزيلات الحزم الفورية المتزامنة. القيمة المبدئية هي 3. الحد الأقصى هو 20.

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

    الفترة التي يُفحص بعدها المستودع البعيد للبحث عن تحديثات البيانات الوصفية وفي الحالة الإيجابية تُحدث خبيئة البيانات الوصفية المحلية. المبدئي يتوافق مع 48 ساعة. اضبط هذا على -1 أو never لكي لا يُعتبر المستودع منتهي الصلاحية أبداً. يمكن أيضًا إطلاق انتهاء صلاحية البيانات الوصفية عن طريق تغيير الطابع الزمني لملفات التكوين (dnf.conf، و <repo>.repo). انظر أيضًا check_config_file_age.

minrate
    حجم التخزين

    يحدد هذا حد السرعة المنخفضة بالبايت في الثانية. إذا كان الخادم يرسل البيانات بنفس هذه السرعة أو أقل منها لمدة تساوي على الأقل ثواني خيار المهلة، يجهض DNF الاتصال. المبدئي هو 1000. الوحدات الصالحة هي 'k' و 'M' و 'G'.

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_sslverify
    منطقي

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

proxy_sslclientcert
    سلسلة نصية

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

proxy_sslclientkey
    سلسلة نصية

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

repo_gpgcheck
    منطقي

    ما إذا كان سيُجرى فحص توقيع GPG على البيانات الوصفية لهذا المستودع. المبدئي هو False. لاحظ أن مفاتيح GPG لهذا الفحص تُخزن بشكل منفصل عن مفاتيح GPG المستخدمة في فحص توقيع الحزمة. علاوة على ذلك، تُخزن أيضًا بشكل منفصل لكل مستودع.

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

retries
    integer

    اضبط إجمالي عدد محاولات إعادة التنزيل للحزم. العدد تراكمي، على سبيل المثال لـ retries=10، سيفشل dnf بعد فشل تنزيل أي حزمة للمرة الحادية عشرة. ضبط هذا على 0 يجعل dnf يحاول للأبد. المبدئي هو 10.

skip_if_unavailable
    منطقي

    إذا تم تمكينه، سيستمر DNF في العمل ويعطل المستودع الذي تعذر مزامنته لأي سبب. لا يؤثر هذا الخيار على تخطي الحزم غير المتوفرة بعد حل الاعتمادات. للتحقق من عدم إمكانية الوصول للمستودع، استخدمه مدمجاً مع خيار سطر أوامر التحديث <#refresh-command-label>. المبدئي هو False. لاحظ أن هذا الخيار على وجه الخصوص يمكن تعيينه في ملف التكوين الخاص بك بواسطة التوزيعة.

sslcacert
    سلسلة نصية

    المسار إلى الملف الذي يحتوي على سلطات الشهادات للتحقق من شهادات SSL. فارغ مبدئياً - يستخدم المبدئي للنظام.

sslverify
    منطقي

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

sslverifystatus
    منطقي

    عند تمكينه، يُفحص وضع الإلغاء لشهادة الخادم باستخدام امتداد TLS المسمى "Certificate Status Request" (المعروف باسم تدبيس OCSP). المبدئي هو False.

sslclientcert
    سلسلة نصية

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

sslclientkey
    سلسلة نصية

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

throttle
    حجم التخزين

    يحد من سرعة التنزيل. قد يكون قيمة مطلقة أو نسبة مئوية، نسيباً إلى قيمة خيار عرض النطاق الترددي. القيمة 0 تعني عدم الخنق (المبدئي). القيمة المطلقة تكون بالبايت مبدئياً ولكن يمكن تحديدها بوحدة تخزين. الوحدات الصالحة هي 'k' و 'M' و 'G'.

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

    عدد الثواني للانتظار للاتصال قبل انتهاء المهلة. يُستخدم بالتزامن مع خيار minrate. المبدئي هو 30 ثانية.

username
    سلسلة نصية

    اسم المستخدم المستخدم للاتصال بالمستودع باستخدام استيثاق HTTP الأساسي. فارغ مبدئياً.

user_agent
    سلسلة نصية

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

        libdnf (NAME VERSION_ID; VARIANT_ID; OS.BASEARCH)

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

        libdnf (Fedora 31; server; Linux.x86_64)

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

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

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

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

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

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

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

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

•   المعدلات: bold, blink, dim, normal, reverse, underline

الملفات

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

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

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

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

انظر أيضًا

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

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

حقوق النسخ
2012-2020، Red Hat، مرخص بموجب GPLv2+

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

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

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