table of contents
- trixie-backports 4.32.4-1~bpo13+1
- testing 4.32.4-1
- unstable 4.32.4-1
| SYSTEMD-COREDUMP(8) | systemd-coredump | SYSTEMD-COREDUMP(8) |
الاسم¶
systemd-coredump، systemd-coredump.socket، systemd-coredump@.service، systemd-coredump-register.service، systemd-coredumpd.service - الحصول على تفريغات النواة وحفظها ومعالجتها
موجز¶
/usr/lib/systemd/systemd-coredump
/usr/lib/systemd/systemd-coredump --backtrace
/usr/lib/systemd/systemd-coredump --manager
/usr/lib/systemd/systemd-coredump --check-requirements
systemd-coredump.socket
systemd-coredump@.service
systemd-coredump-register.service
systemd-coredumpd.service
الوصف¶
systemd-coredump@.service هي خدمة نظام لمعالجة تفريغات النواة. ستسجل ملخصًا للحدث في systemd-journald.service(8)، بما في ذلك معلومات عن معرف العملية، المالك، الإشارة التي قتلت العملية، وتتبع المكدس إن أمكن. قد تحفظ أيضًا تفريغ النواة للمعالجة لاحقًا. انظر قسم "معلومات عن العملية المنهارة" أدناه.
سلوك برنامج معين عند استقبال إشارة تحكمه عدة عوامل موصوفة بالتفصيل في core(5). على وجه الخصوص، لن تتم معالجة تفريغ النواة إلا عندما تكون حدود موارد العملية ذات الصلة (RLIMIT_CORE) كافية.
يمكن كتابة تفريغات النواة في السجل أو حفظها كملف. في كلتا الحالتين، يمكن استرجاعها لمزيد من المعالجة، على سبيل المثال في gdb(1). انظر coredumpctl(1)، ولا سيما الأفعال list و debug.
بشكل مبدئي، سيسجل systemd-coredump تفريغ النواة في السجل، بما في ذلك تتبع المكدس إن أمكن، ويخزن تفريغ النواة (صورة لمحتويات ذاكرة العملية) نفسه في ملف خارجي في /var/lib/systemd/coredump/. تُحذف تفريغات النواة هذه بعد بضعة أيام بشكل مبدئي؛ انظر /usr/lib/tmpfiles.d/systemd.conf للتفاصيل. لاحظ أن إزالة ملفات النواة من نظام الملفات وتطهير إدخالات السجل مستقلان، وقد يكون ملف النواة موجودًا بدون إدخال السجل، وقد تشير إدخالات السجل إلى ملفات نواة مُزالة منذ ذلك الحين. تُرفق بعض البيانات الوصفية بملفات النواة في شكل سمات موسعة، لذا تكون ملفات النواة مفيدة لبعض الأغراض حتى بدون البيانات الوصفية الكاملة المتاحة في إدخال السجل.
لمزيد من التفاصيل انظر معالجة تفريغ النواة في systemd[1].
نظرة عامة¶
يقوم الملف القابل للتنفيذ systemd-coredump بالعمل الفعلي، ولكن يُستدعى بشكل مختلف بناءً على إمكانيات النواة المشغلة.
عندما تدعم النواة بروتوكول مقبس تفريغ النواة (انظر "متطلبات النواة" أدناه، عمومًا النواة v6.19 أو أحدث)، تنشئ الخدمة systemd-coredumpd.service مقبس Unix وتنصت عليه، وتكتب الخدمة systemd-coredump-register.service مسار المقبس إلى /proc/sys/kernel/core_pattern. وعند انهيار عملية، تتصل النواة بالمقبس وترسل تفريغ النواة الخاص بالعملية عبر المقبس. بعد ذلك، تنقل الخدمة systemd-coredumpd.service التفريغ إلى الحاوية المقابلة إذا كانت العملية المنهارة في بيئة حاوية، وإلا فيُحفظ التفريغ في التخزين المحلي وتُكتب معلومات العملية المنهارة في السجل.
عندما لا تستوفي النواة المشغلة هذه المتطلبات، يُستدعى الملف القابل للتنفيذ systemd-coredump مرتين: مرة كمعالج بواسطة النواة، والمرة الثانية في systemd-coredump@.service لكتابة البيانات فعليًا إلى السجل ومعالجة وحفظ ملف النواة.
عندما تستدعي النواة systemd-coredump لمعالجة تفريغ النواة بهذه الطريقة، يعمل في وضع مميز، وسيتصل بالمقبس الذي أنشأته وحدة systemd-coredump.socket، والتي بدورها ستُولد مثيلًا غير مميز من systemd-coredump@.service لمعالجة تفريغ النواة. وبالتالي فإن systemd-coredump.socket و systemd-coredump@.service هما وحدتان مساعدتان تقومان بالمعالجة الفعلية لتفريغات النواة وتخضعان لإدارة الخدمة العادية.
انظر "الوحدات" أدناه للحصول على تفاصيل حول الوحدات الفردية المشاركة في أي من الوضعين.
خيارات سطر الأوامر¶
عادةً لا يُستدعى systemd-coredump مباشرةً بواسطة المستخدم، بل بواسطة النواة أو الوحدات الموضحة أدناه. ويدعم أوضاع الاستدعاء التالية:
(بلا خيار)
--backtrace
--manager
أُضيف في الإصدارة 262.
--check-requirements
أُضيف في الإصدارة 262.
متطلبات النواة لمقبس تفريغ النواة¶
يتطلب بروتوكول مقبس تفريغ النواة، المستخدم بواسطة systemd-coredumpd.service و systemd-coredump-register.service، ما يلي:
تُفحص هذه الشروط باستخدام systemd-coredump --check-requirements قبل بدء systemd-coredumpd.service و systemd-coredump-register.service. وإذا لم تُستوفَ المتطلبات، يتراجع systemd-coredump بدلاً من ذلك إلى الاستدعاء القديم عبر systemd-coredump.socket و systemd-coredump@.service.
الوحدات¶
تشارك الوحدات التالية في معالجة تفريغات النواة. ويعتمد أي منها يكون نشطًا على ما إذا كان بروتوكول مقبس تفريغ النواة متاحًا، انظر "متطلبات النواة" أعلاه.
systemd-coredumpd.service
تُقرأ التهيئة في coredump.conf(5) مرة واحدة عند بدء systemd-coredumpd.service. وبما أن الخدمة تستمر في التشغيل بعد ذلك (بدلاً من استدعائها من جديد لكل تفريغ نواة، كما هو الحال مع systemd-coredump@.service)، فإن التغييرات على coredump.conf وتضميناته لا تُلتطق آليًا. أعد تحميل الخدمة لتطبيق تغييرات التهيئة، انظر coredump.conf(5) للحصول على التفاصيل.
أُضيف في الإصدارة 262.
systemd-coredump-register.service
لأن الملف /run/sysctl.d/60-coredump.conf يأخذ الأسبقية، وفقًا لقواعد ترتيب sysctl.d(5) المعتادة، على الملف /usr/lib/sysctl.d/50-coredump.conf الموصوف في "التهيئة" أدناه، فإن حجب أو تجاوز 50-coredump.conf وحده ليس كافيًا لتثبيت kernel.core_pattern مخصص على نظام تكون فيه systemd-coredumpd.service نشطة. انظر "التهيئة" أدناه لمعرفة كيفية منع ذلك.
أُضيف في الإصدارة 262.
systemd-coredump.socket, systemd-coredump@.service
تفريغات النواة في الحاويات/مساحات الأسماء¶
ستحاول خدمة systemd-coredump@.service آليًا استخراج تتبع مكدس من عملية أثناء انهيارها. سيتم حل رموز تتبع المكدس هذه بناءً على معلومات التصحيح المضمنة في صورة ELF المنهارة، أو معلومات التصحيح المكافئة المتاحة بشكل منفصل على نظام التشغيل المضيف. بالنسبة للعمليات التي تنهار داخل حاويات محلية أو صناديق رمل أخرى قائمة على مساحة أسماء التحميل، فإن معلومات التصحيح المساعدة هذه غير متاحة عادةً على المضيف (ببساطة لأن الحاويات تشغل عادةً إصدارات برامج مختلفة عن المضيف). يوفر systemd-coredump آليتين لمعالجة هذا:
إذا تم تمكين كل من CoredumpReceive= على وحدة الحاوية التي ينتمي إليها تفريغ النواة، و EnterNamespace= في ملف التكوين coredump.conf، فإن الأول له الأسبقية.
الضبط¶
بالنسبة للبرامج التي بدأها systemd، يمكن تعيين حدود موارد العملية بواسطة التوجيه LimitCORE=، انظر systemd.exec(5).
لكي تستخدمه النواة لمعالجة تفريغات النواة، يجب تكوين systemd-coredump في معامل sysctl(8) kernel.core_pattern. يتم شرح بناء جملة هذا المعامل في core(5). يقوم systemd بتثبيت الملف /usr/lib/sysctl.d/50-coredump.conf الذي يهيئ kernel.core_pattern وفقًا لذلك. يمكن إخفاء هذا الملف أو تجاوزه لاستخدام إعداد مختلف باتباع قواعد sysctl.d(5) العادية. إذا تم تعديل تكوين sysctl، فيجب تحديثه في النواة قبل أن يصبح ساري المفعول، انظر sysctl(8) و systemd-sysctl(8).
في الأنظمة التي تكون فيها systemd-coredumpd.service نشطة (انظر "متطلبات النواة" و "الوحدات" أعلاه)، تكتب systemd-coredump-register.service ضبط kernel.core_pattern الخاص بها إلى /run/sysctl.d/60-coredump.conf كلما كانت systemd-coredumpd.service تعمل، ويأخذ هذا الملف الأسبقية على /usr/lib/sysctl.d/50-coredump.conf. ونتيجة لذلك، فإن حجب أو تجاوز 50-coredump.conf وحده لا يتجاوز kernel.core_pattern المبدئي في مثل هذه الأنظمة، نظرًا لأن 60-coredump.conf سيظل ساري المفعول. لتعيين نمط مخصص kernel.core_pattern خاص بك على نظام يعمل فيه service systemd-coredumpd.service، يجب إيقافه وتعطيله:
systemctl disable --now systemd-coredumpd.service
لاستخدامه في وضع --backtrace، يجب تثبيت معالج تتبع خلفي مناسب على جانب المرسل. على سبيل المثال، في حالة python(1)، يعني هذا وجوب تثبيت sys.excepthook، انظر systemd-coredump-python[3].
يُضبط سلوك systemd-coredump نفسه عبر ملف التهيئة /etc/systemd/coredump.conf والمقتطفات المقابلة /etc/systemd/coredump.conf.d/*.conf، انظر coredump.conf(5). عند معالجة تفريغات النواة عبر systemd-coredump@.service (انظر "الوحدات" أعلاه)، يُستدعى مثيل جديد من systemd-coredump عند استلام كل تفريغ نواة، وستصبح التغييرات في هذه الملفات سارية المفعول في المرة التالية التي يُستلم فيها تفريغ نواة. وعندما تُعالج تفريغات النواة بدلاً من ذلك بواسطة systemd-coredumpd.service طويلة التشغيل، تتطلب تغييرات التهيئة إعادة تحميل صريحة لتلك الخدمة لتصبح سارية المفعول؛ انظر coredump.conf(5) للحصول على التفاصيل.
تُقيد الموارد المستخدمة بواسطة ملفات التفريغ الأساسي بطريقتين. يمكن ضبط معاملات مثل الحجم الأقصى للتفريغات الأساسية والملفات الملتقطة في ملفات /etc/systemd/coredump.conf والمقتطفات المذكورة أعلاه. بالإضافة إلى ذلك، يُقيد وقت تخزين ملفات التفريغ الأساسي بواسطة systemd-tmpfiles، والإعدادات المقابلة موجودة مبدئيًا في /usr/lib/tmpfiles.d/systemd.conf. المبدئي هو حذف التفريغات الأساسية بعد بضعة أيام؛ انظر الملف أعلاه للتفاصيل.
تعطيل معالجة التفريغ الأساسي¶
لتعطيل المعالجة التي قد تكون كثيفة الموارد بواسطة systemd-coredump، اضبط
Storage=none ProcessSizeMax=0
في coredump.conf(5).
معلومات حول العملية المتعطلة¶
يمكن استخدام coredumpctl(1) لاسترداد التفريغات الأساسية المحفوظة بغض النظر عن موقعها، وعرض المعلومات، ومعالجتها، على سبيل المثال، بتمريرها إلى مصحح أخطاء غنو (gdb).
يمكن أيضًا عرض البيانات المخزنة في السجل باستخدام journalctl(1) كالمعتاد (أو من أي عملية أخرى، باستخدام واجهة برمجة تطبيقات sd-journal(3)). تحتوي الرسائل ذات الصلة على MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1:
$ journalctl MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1 -o verbose ... MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1 COREDUMP_PID=552351 COREDUMP_UID=1000 COREDUMP_GID=1000 COREDUMP_SIGNAL_NAME=SIGSEGV COREDUMP_SIGNAL=11 COREDUMP_CODE=2 COREDUMP_TIMESTAMP=1614342930000000 COREDUMP_COMM=Web Content COREDUMP_EXE=/usr/lib64/firefox/firefox COREDUMP_USER_UNIT=app-gnome-firefox-552136.scope COREDUMP_CMDLINE=/usr/lib64/firefox/firefox -contentproc -childID 5 -isForBrowser ... COREDUMP_CGROUP=/user.slice/user-1000.slice/user@1000.service/app.slice/app-....scope COREDUMP_FILENAME=/var/lib/systemd/coredump/core.Web....552351.....zst ...
تُحفظ الحقول التالية (إذا كانت معروفة) مع إدخال السجل
COREDUMP_UID=, COREDUMP_PID=, COREDUMP_GID=
عندما كانت العملية المتعطلة جزءًا من حاوية (أو في مساحة اسم عملية أو مستخدم بشكل عام)، فهذه هي القيم كما تُرى خارجيًا، في مساحة الاسم حيث يعمل systemd-coredump.
أُضيف في الإصدار 248.
COREDUMP_BY_PIDFD=
أُضيف في الإصدار 258.
COREDUMP_TIMESTAMP=
أُضيف في الإصدار 248.
COREDUMP_RLIMIT=
أُضيف في الإصدار 248.
COREDUMP_UNIT=, COREDUMP_SLICE=
عندما كانت العملية المتعطلة داخل حاوية، فهذه هي أسماء الوحدات خارج الحاوية، في مدير النظام الرئيسي.
أُضيف في الإصدار 248.
COREDUMP_CGROUP=
عندما كانت العملية المتعطلة داخل حاوية، هذا هو المسار الكامل كما يُرى من خارج الحاوية.
أُضيف في الإصدار 248.
COREDUMP_PROC_CGROUP=
عندما كانت العملية المتعطلة داخل حاوية، هذا هو المسار الكامل كما يُرى من خارج الحاوية.
أُضيف في الإصدار 248.
COREDUMP_OWNER_UID=، COREDUMP_USER_UNIT=، COREDUMP_SESSION=
عندما كانت العملية المتعطلة داخل حاوية، فهذه هي القيم خارج الحاوية، في النظام الرئيسي.
أُضيف في الإصدار 248.
COREDUMP_SIGNAL_NAME=، COREDUMP_SIGNAL=
أُضيف في الإصدار 248.
COREDUMP_CODE=
أُضيف في الإصدار 261.
COREDUMP_CWD=، COREDUMP_ROOT=
عندما تكون العملية المتعطلة داخل حاوية، هذه المسارات نسبية لجذر مساحة أسماء التثبيت للحاوية.
أُضيف في الإصدار 248.
COREDUMP_DUMPABLE=
أُضيف في الإصدار 258.
COREDUMP_OPEN_FDS=
fd:/path/to/file pos: ... flags: ... ... fd:/path/to/file pos: ... flags: ... ...
السطر الأول يحتوي على رقم واصف الملف fd والمسار، بينما تُظهر الأسطر التالية محتويات /proc/pid/fdinfo/fd.
أُضيف في الإصدار 248.
COREDUMP_EXE=
عندما تكون العملية المتعطلة داخل حاوية، هذا المسار نسبي لجذر مساحة أسماء التثبيت للحاوية.
أُضيف في الإصدار 248.
COREDUMP_CMDLINE=، COREDUMP_COMM=، COREDUMP_ENVIRON=، COREDUMP_PROC_AUXV=، COREDUMP_PROC_LIMITS=، COREDUMP_PROC_MAPS=، COREDUMP_PROC_MOUNTINFO=، COREDUMP_PROC_STATUS=
انظر proc(5) لمزيد من المعلومات.
أُضيف في الإصدار 248.
COREDUMP_HOSTNAME=
عندما كانت العملية المنهارة في حاوية، هذا هو اسم مضيف الحاوية.
أُضيف في الإصدار 248.
COREDUMP_CONTAINER_CMDLINE=
أُضيف في الإصدار 248.
COREDUMP=
أُضيف في الإصدار 248.
COREDUMP_FILENAME=
أُضيف في الإصدار 248.
COREDUMP_TRUNCATED=
أُضيف في الإصدار 248.
COREDUMP_PACKAGE_NAME=, COREDUMP_PACKAGE_VERSION=, COREDUMP_PACKAGE_JSON=
أُضيف في الإصدار 249.
MESSAGE=
أُضيف في الإصدار 248.
توجد حقول أخرى متنوعة في إدخال السجل، لكنها تتعلق بعملية التسجيل، أي systemd-coredump، وليس العملية المنهارة. انظر systemd.journal-fields(7).
يتم حفظ الحقول التالية (إذا كانت معروفة) مع الملف الخارجي المدرج في COREDUMP_FILENAME= كسمات ممتدة:
user.coredump.pid, user.coredump.uid, user.coredump.gid, user.coredump.signal, user.coredump.timestamp, user.coredump.rlimit, user.coredump.hostname, user.coredump.comm, user.coredump.exe
أُضيف في الإصدار 248.
يمكن عرضها باستخدام getfattr(1). لملف النواة الموصوف في إدخال السجل الموضح أعلاه:
$ getfattr --absolute-names -d /var/lib/systemd/coredump/core.Web....552351.....zst # file: /var/lib/systemd/coredump/core.Web....552351.....zst user.coredump.pid="552351" user.coredump.uid="1000" user.coredump.gid="1000" user.coredump.signal="11" user.coredump.timestamp="1614342930000000" user.coredump.comm="Web Content" user.coredump.exe="/usr/lib64/firefox/firefox" ...
انظر أيضًا¶
coredump.conf(5), coredumpctl(1), systemd-journald.service(8), systemd-tmpfiles(8), core(5), sysctl.d(5), systemd-sysctl.service(8), معالجة تفريغ النواة في systemd[1]
ملاحظات¶
- 1.
- معالجة تفريغ النواة في systemd
- 2.
- تنسيق تصدير اليوميات
- 3.
- systemd-coredump-python
ترجمة¶
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>
هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.
| systemd 262.1 |