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.