الاسم¶
pacman.conf - ملف
تهيئة مدير
الحزم pacman
الوصف¶
يحاول Pacman،
باستخدام
libalpm(3)، قراءة
pacman.conf في كل مرة
يُستدعى
فيها. يُقسم
ملف
التهيئة
هذا إلى
أقسام أو
مستودعات.
يُعرّف كل
قسم مستودع
حزم يمكن لـ
pacman استخدامه
عند البحث
عن الحزم في
وضع --sync.
الاستثناء
من ذلك هو
قسم
الخيارات،
الذي
يُعرّف
الخيارات
العامة.
تُدعم
التعليقات
فقط ببدء
سطر برمز
الهاش (#). لا
يمكن أن
تبدأ
التعليقات
في منتصف
السطر.
مثال¶
#
# pacman.conf
#
[options]
NoUpgrade = etc/passwd etc/group etc/shadow
NoUpgrade = etc/fstab
[core]
Include = /etc/pacman.d/core
[custom]
Server = file:///home/pkgs
ملاحظة
يجب أن
يكون كل
توجيه
بصيغة CamelCase. إذا
لم يُحترم
حالة
الأحرف، لن
يُتعرف على
التوجيه.
على سبيل
المثال. noupgrade أو
NOUPGRADE لن يعملا.
الخيارات¶
RootDir = /path/to/root/dir
يضبط
الدليل
الجذر
المبدئي
لتثبيت pacman
فيه.
يُستخدم
هذا الخيار
إذا أردت
تثبيت حزمة
على قسم
مؤقت موصول
يملكه نظام
آخر، أو
لتثبيت chroot.
ملاحظة:
إذا لم
يُحدد مسار
قاعدة
البيانات
أو ملف
السجل في
سطر
الأوامر أو
في
pacman.conf(5)،
سيكون
موقعهما
المبدئي
داخل هذا
المسار
الجذر.
DBPath = /path/to/db/dir
يتجاوز
الموقع
المبدئي
لدليل
قاعدة
البيانات
العلوي.
المبدئي هو
/var/lib/pacman/. لن يحتاج
معظم
المستخدمين
لضبط هذا
الخيار.
ملاحظة:
إذا حُدد،
هذا مسار
مطلق ولا
يُسبق
المسار
الجذر
آلياً.
CacheDir = /path/to/cache/dir
يتجاوز
الموقع
المبدئي
لدليل
خبيئة
الحزم.
المبدئي هو
/var/cache/pacman/pkg/. يمكن
تحديد أدلة
خبيئة
متعددة،
وتُجرّب
بالترتيب
المدرج في
ملف
التهيئة.
إذا لم
يُعثر على
ملف في أي
دليل
خبيئة،
سيُحمل إلى
أول دليل
خبيئة
بصلاحية
كتابة.
ملاحظة:
هذا مسار
مطلق، لا
يُسبق
المسار
الجذر
آلياً.
HookDir = /path/to/hook/dir
يضيف
أدلة للبحث
عن خطافات alpm
بالإضافة
إلى دليل
خطافات
النظام (/usr/share/libalpm/hooks/).
المبدئي هو
/etc/pacman.d/hooks. يمكن
تحديد أدلة
متعددة
بحيث تكون
للخطافات
في الأدلة
اللاحقة
أولوية على
الخطافات
في الأدلة
السابقة.
ملاحظة:
هذا مسار
مطلق، لا
يُسبق
المسار
الجذر
آلياً.
لمزيد من
المعلومات
عن خطافات alpm،
انظر
alpm-hooks(5).
GPGDir = /path/to/gpg/dir
يتجاوز
الموقع
المبدئي
للدليل
المحتوي
على ملفات
تهيئة GnuPG.
المبدئي هو
/etc/pacman.d/gnupg/. يجب أن
يحتوي هذا
الدليل على
ملفين: pubring.gpg و trustdb.gpg.
يحمل pubring.gpg
المفاتيح
العامة
لجميع
الحزميين.
يحتوي trustdb.gpg على
ما يسمى
بقاعدة
ثقة، التي
تحدد أن
المفاتيح
أصلية
وموثوقة.
ملاحظة:
هذا مسار
مطلق، لا
يُسبق
المسار
الجذر
آلياً.
LogFile = /path/to/log/file
يتجاوز
الموقع
المبدئي
لملف سجل pacman.
المبدئي هو
/var/log/pacman.log. هذا مسار
مطلق ولا
يُسبق
الدليل
الجذر.
HoldPkg = package ...
إذا حاول
مستخدم --remove
حزمة مدرجة
في HoldPkg، سيطلب
pacman تأكيداً
قبل
المتابعة.
يُسمح
بأنماط glob على
نمط
الصدفة.
IgnorePkg = package ...
يوجه pacman
لتجاهل أي
ترقيات
لهذه
الحزمة عند
تنفيذ --sysupgrade.
يُسمح
بأنماط glob على
نمط
الصدفة.
IgnoreGroup = group ...
يوجه pacman
لتجاهل أي
ترقيات
لجميع
الحزم في
هذه
المجموعة
عند تنفيذ
--sysupgrade. يُسمح
بأنماط glob على
نمط
الصدفة.
Include = /path/to/config/file
يضمّن
ملف تهيئة
آخر. يمكن
لهذا الملف
تضمين
مستودعات
أو خيارات
تهيئة عامة.
ستُوسع
أحرف البدل
في
المسارات
المحددة
بناءً على
قواعد
glob(7).
Architecture = auto &| i686 &| x86_64 | ...
إذا
ضُبط،
سيسمح pacman فقط
بتثبيت
الحزم ذات
البنى
المعطاة
(مثل i686، x86_64،
إلخ). القيمة
الخاصة auto
ستستخدم
بنية
النظام،
المقدمة
عبر “uname -m”. إذا
لم يُضبط،
لا تُجرى
فحوصات
بنية.
ملاحظة:
الحزم ذات
البنية
الخاصة any
يمكن
تثبيتها
دائماً،
لأنها
مصممة
لتكون
مستقلة عن
البنية.
XferCommand = /path/to/command %u [%o]
إذا
ضُبط،
سيُستخدم
برنامج
خارجي
لتحميل
جميع
الملفات
البعيدة.
ستُستبدل
جميع حالات %u
بعنوان URL
للتحميل.
إذا وُجدت،
ستُستبدل
حالات %o باسم
الملف
المحلي،
بالإضافة
إلى امتداد
“.part”، مما
يسمح
لبرامج مثل wget
باستئناف
الملفات
بشكل صحيح.
هذا
الخيار
مفيد
للمستخدمين
الذين
يواجهون
مشاكل مع
دعم HTTP/FTP
المدمج، أو
يحتاجون
لدعم وكيل
أكثر
تقدماً
يأتي مع
أدوات مثل wget.
NoUpgrade = file ...
جميع
الملفات
المدرجة
بتوجيه NoUpgrade لن
تُلمس
أبداً
أثناء
تثبيت/ترقية
حزمة،
وسُتثبت
الملفات
الجديدة
بامتداد .pacnew.
تشير هذه
الملفات
إلى ملفات
في أرشيف
الحزمة،
لذا لا
تضمّن
الشرطة
المائلة
البادئة (RootDir)
عند
تحديدها.
يُسمح
بأنماط glob على
نمط الصدفة.
من الممكن
عكس
التطابقات
بسبق ملف
بعلامة
تعجب. ستؤدي
الملفات
المعكوسة
إلى إعادة
إدراج
الملفات
المدرجة
سابقاً في
القائمة
السوداء
إلى
القائمة
البيضاء.
ستتجاوز
التطابقات
اللاحقة
التطابقات
السابقة.
يجب تخطي
علامة تعجب
أو شرطة
مائلة
عكسية
بادئة
حرفية.
NoExtract = file ...
جميع
الملفات
المدرجة
بتوجيه NoExtract لن
تُستخرج
أبداً من
حزمة إلى
نظام
الملفات.
يمكن أن
يكون هذا
مفيداً
عندما لا
تريد تثبيت
جزء من حزمة.
على سبيل
المثال،
إذا كان جذر
httpd الخاص بك
يستخدم index.php،
فلن تريد
استخراج
ملف index.html من
حزمة apache.
تشير هذه
الملفات
إلى ملفات
في أرشيف
الحزمة،
لذا لا
تضمّن
الشرطة
المائلة
البادئة (RootDir)
عند
تحديدها.
يُسمح
بأنماط glob على
نمط الصدفة.
من الممكن
عكس
التطابقات
بسبق ملف
بعلامة
تعجب. ستؤدي
الملفات
المعكوسة
إلى إعادة
إدراج
الملفات
المدرجة
سابقاً في
القائمة
السوداء
إلى
القائمة
البيضاء.
ستتجاوز
التطابقات
اللاحقة
التطابقات
السابقة.
يجب تخطي
علامة تعجب
أو شرطة
مائلة
عكسية
بادئة
حرفية.
CleanMethod = KeepInstalled &| KeepCurrent
إذا ضُبط
على KeepInstalled
(المبدئي)،
ستنظف
عملية -Sc
الحزم غير
المثبتة
بعد الآن
(غير
الموجودة
في قاعدة
البيانات
المحلية).
إذا ضُبط
على KeepCurrent،
ستنظف -Sc
الحزم
القديمة
(غير
الموجودة
في أي قاعدة
بيانات
مزامنة).
السلوك
الثاني
مفيد عندما
تُشارك
خبيئة
الحزم بين
أجهزة
متعددة،
حيث تكون
قواعد
البيانات
المحلية
مختلفة
عادةً، لكن
قواعد
بيانات
المزامنة
المستخدمة
قد تكون
نفسها. إذا
حُددت كلتا
القيمتين،
تُنظف
الحزم فقط
إذا لم تكن
مثبتة
محلياً
وغير
موجودة في
أي قاعدة
بيانات
مزامنة
معروفة.
SigLevel = ...
اضبط
مستوى
التحقق من
التوقيع
المبدئي.
لمزيد من
المعلومات،
راجع
التحقق من
توقيع
الحزمة
وقاعدة
البيانات
أدناه.
LocalFileSigLevel = ...
اضبط
مستوى
التحقق من
التوقيع
لتثبيت
الحزم
باستخدام
العملية "-U"
على ملف
محلي.
يستخدم
القيمة من SigLevel
كمبدئي.
RemoteFileSigLevel = ...
اضبط
مستوى
التحقق من
التوقيع
لتثبيت
الحزم
باستخدام
العملية "-U"
على عنوان URL
لملف بعيد.
يستخدم
القيمة من SigLevel
كمبدئي.
UseSyslog
سجل
رسائل
الإجراءات
عبر syslog().
سيُدرج هذا
إدخالات
السجل في /var/log/messages
أو ما
يعادله.
Color
فعّل
الألوان
آليًا فقط
عندما يكون
مخرج pacman على tty.
NoProgressBar
عطّل
أشرطة
التقدم. هذا
مفيد
للمحطات
التي لا
تدعم أحرف
الهروب.
CheckSpace
نفّذ
فحصًا
تقريبيًا
لمساحة
القرص
المتاحة
الكافية
قبل تثبيت
الحزم.
VerbosePkgLists
اعرض اسم
الحزم
المستهدفة
وإصدارها
وحجمها
منسقة
كجدول
لعمليات
الترقية
والمزامنة
والإزالة.
DisableDownloadTimeout
عطّل
القيم
المبدئية
لحد السرعة
المنخفضة
ومهلة
التنزيلات.
استخدم هذا
إذا واجهت
مشكلات في
تنزيل
الملفات مع
وكيل (proxy) أو
بوابة
أمنية.
ParallelDownloads = ...
حدد عدد
تيارات
التنزيل
المتزامنة.
يجب أن تكون
القيمة
عددًا
صحيحًا
موجبًا. إذا
لم تُضبط
خيار
التهيئة
هذا،
يُستخدم
تيار تنزيل
واحد فقط (أي
تحدث
التنزيلات
بشكل
تسلسلي).
DownloadUser = username
حدد
المستخدم
الذي
سيُتحول
إليه
لتنزيل
الملفات.
إذا لم
تُضبط خيار
التهيئة
هذا، تُجرى
التنزيلات
كمستخدم
يشغل pacman.
DisableSandbox
عطّل
الصندوق
الرملي
المطبق على
عملية
تنزيل
الملفات
على أنظمة
لينكس
بالكامل.
يعادل
تحديد DisableSandboxFilesystem و
DisableSandboxSyscalls معًا.
DisableSandboxFilesystem
عطّل جزء
قيود نظام
الملفات من
بيئة العزل
المطبقة
على عملية
تنزيل
الملفات في
أنظمة
لينكس. مفيد
إذا واجهت
إخفاقات
متعلقة بـ Landlock
أثناء
تنزيل
الملفات
عند تشغيل
نواة لينكس
لا تدعم هذه
الميزة.
DisableSandboxSyscalls
عطّل جزء
تصفية
استدعاءات
النظام (syscall) من
بيئة العزل
المطبقة
على عملية
تنزيل
الملفات في
أنظمة
لينكس. مفيد
إذا واجهت
إخفاقات
متعلقة بـ seccomp
أثناء
تنزيل
الملفات
عند تشغيل
نواة لينكس
لا تدعم هذه
الميزة.
أقسام المستودع¶
يُعرّف كل
قسم مستودع
اسم قسم
وموقعًا
واحدًا على
الأقل حيث
يمكن
العثور على
الحزم.
يُعرّف اسم
القسم
بالسلسلة
داخل
الأقواس
المربعة
(الاثنان
أعلاه هما
core و custom). يجب
أن تكون
أسماء
المستودعات
فريدة
والاسم local
محجوز
لقاعدة
بيانات
الحزم
المثبتة.
تُعرّف
المواقع
بتوجيه Server
وتتبع بنية
تسمية URL. إذا
أردت
استخدام
دليل محلي،
يمكنك
تحديد
المسار
الكامل
ببادئة
“file://”، كما هو
موضح
أعلاه.
طريقة
شائعة
لتعريف
مواقع
قاعدة
البيانات
تستخدم
توجيه Include.
لكل مستودع
مُعرّف في
ملف
التهيئة،
يمكن
لتوجيه Include
واحد أن
يحتوي على
ملف يسرد
الخوادم
لذلك
المستودع.
ترتيب
المستودعات
في ملفات
التهيئة
مهم؛
المستودعات
المدرجة
أولاً
ستأخذ
الأولوية
على تلك
المدرجة
لاحقًا في
الملف
عندما يكون
للحزم في
مستودعين
أسماء
متطابقة،
بغض النظر
عن رقم
الإصدار.
Include = path
ضمّن ملف
تهيئة آخر.
يمكن لهذا
الملف
تضمين
مستودعات
أو خيارات
تهيئة عامة.
سيتم توسيع
أحرف البدل
في
المسارات
المحددة
بناءً على
قواعد
glob(7).
CacheServer = url
URL كامل
لموقع حيث
يمكن
العثور على
الحزم
والتوقيعات
(إن وجدت)
لهذا
المستودع.
ستُجرب
خوادم
الخبيئة
قبل أي
خوادم غير
خبيئة، ولن
تُزال من
مجموعة
الخوادم
لأخطاء
تنزيل 404، ولن
تُستخدم
لملفات
قاعدة
البيانات.
Server = url
URL كامل
لموقع حيث
يمكن
العثور على
قاعدة
البيانات
والحزم
والتوقيعات
(إن وجدت)
لهذا
المستودع.
أثناء
التحليل،
سيُعرّف pacman
المتغير $repo
باسم القسم
الحالي.
يُستخدم
هذا غالبًا
في الملفات
المحددة
باستخدام
توجيه Include
حتى تتمكن
جميع
المستودعات
من استخدام
نفس ملف
المرآة.
يُعرّف pacman
أيضًا
المتغير $arch
بالقيمة
الأولى (أو
الوحيدة)
لخيار Architecture،
لذا يمكن
استخدام
نفس ملف
المرآة حتى
لبنى
مختلفة.
SigLevel = ...
اضبط
مستوى
التحقق من
التوقيع
لهذا
المستودع.
لمزيد من
المعلومات،
راجع
التحقق من
توقيع
الحزمة
وقاعدة
البيانات
أدناه.
Usage = ...
اضبط
مستوى
الاستخدام
لهذا
المستودع.
يأخذ هذا
الخيار
قائمة من
الرموز
التي يجب أن
تكون واحدة
على الأقل
مما يلي:
Sync
يفعّل
التحديثات
لهذا
المستودع.
Search
يفعّل
تثبيت
الحزم من
هذا
المستودع
أثناء
عملية --sync.
Install
يفعّل
تثبيت
الحزم من
هذا
المستودع
أثناء
عملية --sync.
Upgrade
يسمح
لهذا
المستودع
بأن يكون
مصدرًا
صالحًا
للحزم عند
تنفيذ --sysupgrade.
All
يفعّل
جميع
الميزات
المذكورة
أعلاه
للمستودع.
هذا هو
المبدئي
إذا لم
يُحدد.
لاحظ أنه
يمكن
التعامل مع
مستودع
مفعّل بشكل
صريح، بغض
النظر عن
مستوى
الاستخدام
المضبوط.
التحقق من توقيع الحزم وقاعدة البيانات¶
التوجيه
SigLevel صالح في
كل من قسمي [options]
والمستودع.
إذا
استُخدم في
[options]، فإنه
يضبط قيمة
مبدئية لأي
مستودع لا
يوفر
الإعداد.
•إذا
ضُبط على Never،
فلن يحدث أي
تحقق من
التوقيع.
•إذا
ضُبط على
Optional،
فسيُتحقق
من
التوقيعات
عند
وجودها،
ولكن قواعد
البيانات
والحزم غير
الموقعة
ستُقبل
أيضًا.
•إذا
ضُبط على
Required، فستكون
التوقيعات
مطلوبة على
جميع الحزم
وقواعد
البيانات.
بدلاً من
ذلك، يمكنك
الحصول على
تحكم أكثر
دقة بدمج
بعض
الخيارات
والبادئات
الموصوفة
أدناه.
تُعالج
جميع
الخيارات
في ملف
الإعدادات
بطريقة من
الأعلى إلى
الأسفل،
ومن اليسار
إلى
اليمين،
حيث تتجاوز
الخيارات
اللاحقة
و/أو تُكمل
الخيارات
السابقة.
إذا حُدد SigLevel
في قسم
مستودع،
فإن القيمة
الابتدائية
هي تلك من
قسم [options]، أو
المبدئي
النظامي
المدمج كما
هو موضح
أدناه إذا
لم يُحدد.
تُقسم
الخيارات
إلى
مجموعتين
رئيسيتين،
موصوفتين
أدناه.
المصطلحات
المستخدمة
مثل “موثوق
بها بشكل
هامشي” هي
مصطلحات
يستخدمها
GnuPG، لمزيد من
المعلومات
يُرجى
الرجوع إلى
gpg(1).
متى
يُتحقق
تتحكم
هذه
الخيارات
في ما إذا
كان التحقق
من التوقيع
يجب أن يحدث
ومتى.
Never
يُقمع
جميع
التحقق من
التوقيع،
حتى لو كانت
التوقيعات
موجودة.
Optional
تُفحص
التوقيعات
إذا كانت
موجودة؛
غياب
التوقيع
ليس خطأ.
التوقيع
غير الصالح
هو خطأ
قاتل،
وكذلك
التوقيع من
مفتاح غير
موجود في
حلقة
المفاتيح.
Required
(المبدئي)
التوقيعات
مطلوبة؛
غياب
التوقيع أو
توقيع غير
صالح هو خطأ
قاتل،
وكذلك
التوقيع من
مفتاح غير
موجود في
حلقة
المفاتيح.
ما هو
مسموح به
تتحكم
هذه
الخيارات
في
التوقيعات
التي
تُعتبر
مسموحة.
لاحظ أن
أياً من هذه
الخيارات
لا يسمح
بقبول
التوقيعات
غير
الصالحة أو
المنتهية
الصلاحية،
أو تلك
الصادرة عن
مفاتيح
ملغاة.
TrustedOnly (مبدئي)
إذا تم
فحص توقيع،
يجب أن يكون
في سلسلة
المفاتيح
وموثوقاً
به
بالكامل؛
الثقة
الهامشية
لا تفي بهذا
المعيار.
TrustAll
إذا تم
فحص توقيع،
يجب أن يكون
في سلسلة
المفاتيح،
لكن لا
يُطلب
تعيين
مستوى ثقة
له (مثلاً،
ثقة غير
معروفة أو
هامشية).
يمكن
إضافة
بادئة Package أو
Database إلى
الخيارات
في كلا
المجموعتين،
مما يجعلها
تؤثر فقط
على نوع
الكائن
المحدد. على
سبيل
المثال، PackageTrustAll
سيسمح
بتوقيعات
ذات مستوى
ثقة هامشي
أو غير
معروف
للحزم.
المبدئي
المضمن هو
التالي:
SigLevel = Required TrustedOnly
استخدام مستودعك الخاص¶
إذا كان
لديك
العديد من
الحزم
المخصصة
الخاصة بك،
فغالباً ما
يكون من
الأسهل
إنشاء
مستودع
محلي مخصص
خاص بك
بدلاً من
تثبيتها
جميعاً
باستخدام
خيار --upgrade. كل
ما عليك
فعله هو
إنشاء
قاعدة
بيانات حزم
مضغوطة في
الدليل
الذي يحتوي
على هذه
الحزم حتى
يتمكن pacman من
العثور
عليها عند
تشغيله مع
--refresh.
repo-add /home/pkgs/custom.db.tar.gz /home/pkgs/*.pkg.tar.gz
سيُنشئ
الأمر
أعلاه
قاعدة
بيانات
مضغوطة
باسم /home/pkgs/custom.db.tar.gz.
لاحظ أن
قاعدة
البيانات
يجب أن تكون
بالشكل
المحدد في
ملف
الإعدادات
وأن {ext} هو
نوع ضغط
صالح كما هو
موثق في repo-add(8).
هذا كل شيء!
الآن قم
بتكوين
القسم
المخصص
الخاص بك في
ملف
الإعدادات
كما هو موضح
في مثال
الإعدادات
أعلاه.
سيستخدم Pacman
الآن
مستودع
الحزم
الخاص بك.
إذا أضفت
حزماً
جديدة إلى
المستودع،
تذكر إعادة
إنشاء
قاعدة
البيانات
واستخدام
خيار pacman --refresh.
لمزيد من
المعلومات
حول أمر repo-add،
انظر “repo-add --help”
أو repo-add(8).
العلل¶
علل؟ لا بد
أنك تمزح؛
لا توجد علل
في هذا
البرنامج.
ولكن إذا
صدف وكنا
مخطئين،
فيُرجى
الإبلاغ
عنها في
متتبع
المشكلات
في https://gitlab.archlinux.org/pacman/pacman/-/issues
مع معلومات
محددة مثل
سطر
الأوامر
الخاص بك،
وطبيعة
العلة،
وحتى قاعدة
بيانات
الحزمة إذا
كان ذلك
يساعد.
المؤلفون¶
المصينون
الحاليون:
•آلان
مكراي <allan@archlinux.org>
•أندرو
غريغوري
<andrew.gregory.8@gmail.com>
•Morgan Adamiec
<morganamilo@archlinux.org>
المساهمون
الرئيسون
السابقون:
•Judd Vinet <jvinet@zeroflux.org>
•أوريليان
فوريه <aurelien@archlinux.org>
•آرون
غريفين
<aaron@archlinux.org>
•دان
ماكغي <dan@archlinux.org>
•Xavier Chantry <shiningxc@gmail.com>
•Nagy Gabor <ngaba@bibl.u-szeged.hu>
•ديف
رايزنر
<dreisner@archlinux.org>
•إيلي
شوارتز
<eschwartz@archlinux.org>
للمساهمين
الإضافيين،
استخدم git shortlog -s
على مستودع
pacman.git.
ترجمة¶
تُرجمت
هذه الصفحة
من الدليل
بواسطة
زايد
السعيدي
<zayed.alsaidi@gmail.com>
هذه
الترجمة هي
وثيقة
مجانية؛
راجع
رخصة
جنو العامة
الإصدار 3
أو ما بعده
للاطلاع
على شروط
حقوق النشر.
لا توجد أي
ضمانات.
إذا وجدت
أي أخطاء في
ترجمة صفحة
الدليل
هذه، يرجى
إرسال بريد
إلكتروني
إلى قائمة
بريد
المترجمين:
kde-l10n-ar@kde.org.