'\" t .\" Title: logger .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.26 .\" Date: 2026-05-18 .\" Manual: أوامر المستخدم .\" Source: util-linux 2.42.1 .\" Language: English .\" .TH "LOGGER" "1" "2026-05-18" "util\-linux 2.42.1" "أوامر المستخدم" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .ss \n[.ss] 0 .nh .ad l .de URL \fI\\$2\fP <\\$1>\\$3 .. .als MTO URL .if \n[.g] \{\ . mso www.tmac . am URL . ad l . . . am MTO . ad l . . . LINKSTYLE blue R < > .\} .SH "الاسم" logger \- أدخِل رسائل في سجل النظام .SH "موجز" .sp \fBlogger\fP [خيارات] \fIرسالة\fP .SH "الوصف" .sp تنشئ أداة \fBlogger\fP مدخلات في سجل النظام. .sp عند وجود معطى \fIرسالة\fP الاختياري، فإنه يُكتب في السجل. إذا لم يكن موجودًا، ولم يُعطَ الخيار \fB\-f\fP أيضًا، فسيُسجل الدخل القياسي. .SH "الخيارات" .sp \fB\-d\fP، \fB\-\-udp\fP .RS 4 استخدم مخططات البيانات (UDP) فقط. تُحاول عملية الاتصال مبدئيًا عبر منفذ syslog المحدد في \fI/etc/services\fP، وغالبًا ما يكون 514. .sp انظر أيضًا \fB\-\-server\fP و \fB\-\-socket\fP لتحديد مكان الاتصال. .RE .sp \fB\-e\fP، \fB\-\-skip\-empty\fP .RS 4 تجاهل الأسطر الفارغة عند معالجة الملفات. يُعرف السطر الفارغ بأنه سطر لا يحتوي على أي محارف. وبالتالي، فإن السطر الذي يتكون من مسافات بيضاء فقط لا يُعتبر فارغًا. لاحظ أنه عند تحديد خيار \fB\-\-prio\-prefix\fP، لا تكون الأولوية جزءًا من السطر. وبذلك، يكون السطر الفارغ في هذا الوضع هو السطر الذي لا يحتوي على أي محارف بعد بادئة الأولوية (مثلًا، \fB<13>\fP). .RE .sp \fB\-f\fP، \fB\-\-file\fP \fIملف\fP .RS 4 سجل محتويات \fIملف\fP المحدد. لا يمكن دمج هذا الخيار مع رسالة من سطر الأوامر. .RE .sp \fB\-i\fP .RS 4 سجل معرف العملية (PID) لعملية \fBlogger\fP مع كل سطر. .RE .sp \fB\-\-id\fP[\fB=\fP\fIمعرف\fP] .RS 4 سجل معرف العملية (PID) لعملية \fBlogger\fP مع كل سطر. عند تحديد المعطى الاختياري \fIمعرف\fP، فإنه يُستخدم بدلًا من معرف العملية لأمر \fBlogger\fP. يُوصى باستخدام \fB\-\-id=$$\fP (معرف العملية الأب PPID) في البرمجيات النصية التي ترسل رسائل متعددة. .sp لاحظ أن بنية تسجيل النظام (على سبيل المثال \fBsystemd\fP عند الإنصات على \fI/dev/log\fP) قد تتبع بيانات اعتماد المقابس المحلية لتجاوز معرف العملية (PID) المحدد في الرسالة. يستطيع \fBlogger\fP(1) ضبط بيانات اعتماد تلك المقابس على \fIالمعرف\fP المعطى، ولكن فقط إذا كنت تملك صلاحيات الجذر وكانت العملية ذات المعرف المحدد موجودة، وإلا فلن تُعدل بيانات اعتماد المقبس وسيُتجاهل المشكل بصمت. .RE .sp \fB\-\-journald\fP[\fB=\fP\fIملف\fP] .RS 4 اكتب مدخلة في سجل \fBsystemd\fP. تُقرأ المدخلة من \fIملف\fP المعطى عند تحديده، وإلا فمن الدخل القياسي. يجب أن يبدأ كل سطر بحقل يقبله \fBjournald\fP؛ انظر \fBsystemd.journal\-fields\fP(7) للتفاصيل. يُعد استخدام حقل MESSAGE_ID فكرة جيدة عمومًا، لأنه يجعل العثور على المدخلات سهلًا. أمثلة: .RS 3 .ll -.6i .sp .if n .RS 4 .nf .fam C logger \-\-journald <\fP. .sp إذا لم تحتوي البادئة على مرفق، فسيُضبط المرفق آلياً إلى ما هو محدد في الخيار \fB\-p\fP. وبالمثل، إذا لم تتوفر بادئة، فسيُسجل السطر باستخدام \fIأولوية\fP المعطاة مع \fB\-p\fP. .sp لا يؤثر هذا الخيار على رسالة سطر الأوامر. صُمم هذا الخيار رئيسياً لحالات الاستخدام التي يُستخدم فيها \fBlogger\fP في أنبوب (مثل: daemon | logger \-\-prio\-prefix) لقراءة رسائل متعددة بأولويات مختلفة. .RE .sp \fB\-\-rfc3164\fP .RS 4 يستخدم ميفاق سجل نظام BSD‏ \c .URL "https://tools.ietf.org/html/rfc3164" "RFC 3164" "" لإرسال الرسائل إلى حاسوب خادم بعيد. .RE .sp \fB\-\-rfc5424\fP[\fB=\fP\fIwithout\fP] .RS 4 يستخدم ميفاق سجل النظام \c .URL "https://tools.ietf.org/html/rfc5424" "RFC 5424" "" لإرسال الرسائل إلى حاسوب خادم بعيد. يمكن أن يكون معامل \fIwithout\fP الاختياري قائمة مفصولة بفواصل من القيم التالية: \fBnotq\fP، \fBnotime\fP، \fBnohost\fP. .sp تعمل قيمة \fBnotq\fP على حجب البيانات المهيكلة لجودة الوقت من الرسالة المرسلة. تُظهر معلومات جودة الوقت ما إذا كانت الساعة المحلية متزامنة بالإضافة إلى أقصى عدد من الميكروثانية التي قد ينحرف عنها الطابع الزمني. تُحجب جودة الوقت آلياً أيضاً عند تحديد \fB\-\-sd\-id timeQuality\fP. .sp تعمل قيمة \fBnotime\fP (التي تتضمن \fBnotq\fP) على حجب الطابع الزمني الكامل للمرسل الذي يكون بتنسيق ISO\-8601، بما في ذلك الميكروثانية والمنطقة الزمنية. .sp تعمل قيمة \fBnohost\fP على حجب معلومات \fBgethostname\fP(2) من ترويسة الرسالة. .sp أصبح ميفاق RFC 5424 هو المبدئي لأداة \fBlogger\fP منذ الإصدار 2.26. .RE .sp \fB\-s\fP، \fB\-\-stderr\fP .RS 4 إخراج الرسالة إلى الخطأ القياسي بالإضافة إلى سجل النظام. تُخرج الرسالة الكاملة بنفس الصيغة المرسلة إلى syslog أو journald، بما في ذلك الأولوية وحقول أخرى محتملة. صُمم هذا الخيار رئيسياً لأغراض تنقيح الأخطاء وغالباً ما يُستخدم مع \fB\-\-no\-act\fP. .RE .sp \fB\-\-sd\-id\fP \fIاسم\fP[\fB@\fP\fI‎خانات\fP] .RS 4 يحدد معرف عنصر بيانات مهيكلة لترويسة رسالة RFC 5424. يجب استخدام الخيار قبل \fB\-\-sd\-param\fP لتقديم عنصر جديد. عدد عناصر البيانات المهيكلة غير محدود. المعرف (\fIاسم\fP بالإضافة إلى \fB@\fP\fIخانات\fP المحتملة) حساس لحالة الأحرف ويحدد نوع العنصر والغرض منه بشكل فريد. يجب ألا يوجد نفس المعرف أكثر من مرة في الرسالة الواحدة. جزء \fB@\fP\fIخانات\fP مطلوب للمعرفات غير القياسية التي يحددها المستخدم. .sp تولد أداة \fBlogger\fP حالياً عنصر \fBtimeQuality\fP القياسي فقط. تصف مواصفة RFC 5424 أيضاً العناصر \fBorigin\fP (مع المعاملات \fBip\fP و \fBenterpriseId\fP و \fBsoftware\fP و \fBswVersion\fP) والعنصر \fBmeta\fP (مع المعاملات \fBsequenceId\fP و \fBsysUpTime\fP و \fBlanguage\fP). يمكن تحديد معرفات هذه العناصر دون لاحقة \fB@\fP\fIخانات\fP. .RE .sp \fB\-\-sd\-param\fP \fIاسم\fP=\fI‎قيمة\fP .RS 4 يحدد معامل عنصر بيانات مهيكل، وهو زوج من الاسم والقيمة. يجب استخدام الخيار بعد \fB\-\-sd\-id\fP ويمكن تحديده أكثر من مرة لنفس العنصر. لاحظ أن علامات الاقتباس حول \fIقيمة\fP مطلوبة ويجب الهروب منها في سطر الأوامر. .sp .if n .RS 4 .nf .fam C logger \-\-rfc5424 \-\-sd\-id zoo@123\& \(rs \-\-sd\-param tiger="hungry"\& \(rs \-\-sd\-param zebra="running"\& \(rs \-\-sd\-id manager@123\& \(rs \-\-sd\-param onMeeting="yes"\& \(rs "this is message" .fam .fi .if n .RE .sp ينتج: .sp \fB<13>1 2015\-10\-01T14:07:59.168662+02:00 ws kzak \- \- [timeQuality tzKnown="1" isSynced="1" syncAccuracy="218616"][zoo@123 tiger="hungry" zebra="running"][manager@123 onMeeting="yes"] this is message\fP .RE .sp \fB\-S\fP، \fB\-\-size\fP \fIحجم\fP .RS 4 يضبط الحجم الأقصى المسموح به للرسالة على \fIحجم\fP. الحجم المبدئي هو 1KiB محرف، وهو الحد المستخدم تقليديًا والمحدد في RFC 3164. مع RFC 5424، أصبح هذا الحد مرنًا. الافتراض الجيد هو أن مستقبلي RFC 5424 يمكنهم معالجة رسائل بحجم 4KiB على الأقل. .sp تقبل معظم أجهزة الاستقبال رسائل أكبر من 1KiB عبر أي نوع من ميفاقات syslog. وعلى هذا النحو، يؤثر خيار \fB\-\-size\fP على \fBlogger\fP في جميع الحالات (ليس فقط عند استخدام \fB\-\-rfc5424\fP). .sp ملاحظة: حد حجم الرسالة يحدد الحجم الإجمالي للرسالة، بما في ذلك ترويسة syslog. تختلف أحجام الترويسة اعتمادًا على الخيارات المحددة وطول اسم المضيف. كقاعدة عامة، لا تزيد الترويسات عادةً عن 50 إلى 80 محرفًا. عند اختيار الحد الأقصى لحجم الرسالة، من المهم التأكد من أن المستقبل يدعم الحجم الأقصى أيضًا، وإلا فقد تُبتر الرسائل. ومرة أخرى، كقاعدة عامة، يجب أن يكون حجم الرسالة من 2 إلى 4 KiB مقبولًا بشكل عام، بينما يجب التحقق من عمل أي حجم أكبر من ذلك. .RE .sp \fB\-\-socket\-errors\fP \fIوضع\fP .RS 4 اطبع الأخطاء المتعلقة باتصالات مقابس Unix. يمكن أن يكون \fIوضع\fP هو \fBon\fP أو \fBoff\fP أو \fBauto\fP. عندما يكون الوضع \fBauto\fP (المبدئي)، سيكتشف \fBlogger\fP ما إذا كانت عملية البدء هي \fBsystemd\fP(1)، وإذا كان الأمر كذلك، فسيُفترض أنه يمكن استخدام \fI/dev/log\fP مبكرًا عند الإقلاع. لن يتسبب فقدان \fI/dev/log\fP في أنظمة البدء الأخرى في حدوث أخطاء، تمامًا كما هو الحال عند استخدام استدعاء النظام \fBopenlog\fP(3). كانت أداة \fBlogger\fP(1) قبل الإصدار 2.26 تستخدم \fBopenlog\fP(3)، وبالتالي كانت غير قادرة على اكتشاف فقدان الرسائل المرسلة إلى مقابس Unix. .sp عندما لا تُفعل الأخطاء، لن يتم الإبلاغ عن الرسائل المفقودة وستؤدي إلى حالة خروج ناجحة لأداة \fBlogger\fP(1). .RE .sp \fB\-T\fP، \fB\-\-tcp\fP .RS 4 استخدم التدفق (TCP) فقط. تُحاول عملية الاتصال مبدئيًا عبر منفذ \fIsyslog\-conn\fP المحدد في \fI/etc/services\fP، وغالبًا ما يكون \fI601\fP. .sp انظر أيضًا \fB\-\-server\fP و \fB\-\-socket\fP لتحديد مكان الاتصال. .RE .sp \fB\-t\fP، \fB\-\-tag\fP \fIوسم\fP .RS 4 ضع وسم \fIوسم\fP المحدد على كل سطر مراد تسجيله. الوسم المبدئي هو اسم المستخدم الذي ولج إلى الطرفية (أو اسم مستخدم بناءً على معرف المستخدم الفعلي). .RE .sp \fB\-u\fP، \fB\-\-socket\fP \fIمقبس\fP .RS 4 اكتب في \fIالمقبس\fP المحدد بدلاً من مقبس سجل النظام. .RE .sp \fB\-\-\fP .RS 4 أنهِ قائمة المعطيات. يسمح هذا لـ \fIالرسالة\fP أن تبدأ بشرطة (\-). .RE .sp \fB\-h\fP، \fB\-\-help\fP .RS 4 اعرض نص المساعدة ثم اخرج. .RE .sp \fB\-V\fP، \fB\-\-version\fP .RS 4 اعرض الإصدار واخرج. .RE .SH "حالة الخروج" .sp تخرج أداة \fBlogger\fP بالقيمة 0 عند النجاح، وبقيمة أكبر من 0 عند حدوث خطأ. .SH "المرافق والمستويات" .sp أسماء المرافق الصالحة هي: .sp \fBauth\fP .br \fBauthpriv\fP لمعلومات الاستيثاق ذات الطبيعة الحساسة .br \fBcron\fP .br .sp \fBdaemon\fP .br \fBftp\fP .br \fBkern\fP لا يمكن إنتاجها من عملية في مساحة المستخدم، وتُحوّل آلياً إلى \fBuser\fP .br .sp \fBlpr\fP .br \fBmail\fP .br \fBnews\fP .br \fBsyslog\fP .br \fBuser\fP .br \fBuucp\fP .br \fBlocal0\fP .br إلى .br \fBlocal7\fP .br \fBsecurity\fP مرادف مهجور لـ \fBauth\fP .sp أسماء المستويات الصالحة هي: .sp \fBemerg\fP .br \fBalert\fP .br \fBcrit\fP .br \fBerr\fP .br \fBwarning\fP .br \fBnotice\fP .br \fBinfo\fP .br \fBdebug\fP .br \fBpanic\fP مرادف مهجور لـ \fBemerg\fP .br \fBerror\fP مرادف مهجور لـ \fBerr\fP .br \fBwarn\fP مرادف مهجور لـ \fBwarning\fP .br .sp لمعرفة ترتيب الأولويات والأغراض المقصودة من هذه المرافق والمستويات، راجع \fBsyslog\fP(3). .SH "متوافق مع" .sp يُتوقع أن يكون الأمر \fBlogger\fP متوافقًا مع معيار IEEE Std 1003.2 ("POSIX.2"). .SH "أمثلة" .RS 3 .ll -.6i .sp logger رُسّخ النظام .sp logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc .sp logger \-n loghost.example.com System rebooted .br .RE .ll .SH "المؤلفين" .sp كُتب الأمر \fBlogger\fP في الأصل بواسطة جامعة كاليفورنيا في 1983\-1993 وأعيدت كتابته لاحقًا بواسطة \c .MTO "kzak\(atredhat.com" "Karel Zak" "،" و .MTO "rgerhards\(atadiscon.com" "Rainer Gerhards" "،" و .MTO "kerolasa\(atiki.fi" "Sami Kerola" "." .SH "انظر أيضاً" .sp \fBjournalctl\fP(1)، \fBsyslog\fP(3)، \fBsystemd.journal\-fields\fP(7) .SH "التبليغ عن الأخطاء" .sp لتقارير العِلل، استخدم \c .URL "https://github.com/util\-linux/util\-linux/issues" "مُتتبع المشكلات" "." .SH "التوفر" .sp الأمر \fBlogger\fP جزء من حزمة util\-linux التي يمكن تنزيلها من \c .URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "أرشيف نواة لينكس" "."