SYSTEMD-CAT(1)

الاسم
systemd-cat - وصل خط أنابيب أو مخرجات برنامج مع السجل

موجز

systemd-cat [خيارات...] [أمر] [وسائط...]

systemd-cat [خيارات...]

الوصف

يمكن استخدام systemd-cat لوصل المخرج القياسي ومخرج الخطأ لأمر مع السجل، أو كأداة تصفية في خط أنابيب الصدفة لتمرير المخرجات التي يولدها عنصر خط الأنابيب السابق إلى السجل.

إذا لم يُمرر أي معامل، يكتب systemd-cat كل ما يقرأه من المدخل القياسي (stdin) إلى السجل.

إذا مُررت معاملات، تُنفذ كسطر أوامر مع وصل المخرج القياسي (stdout) ومخرج الخطأ القياسي (stderr) بالسجل، بحيث يُخزن كل ما يكتبه في السجل.

الخيارات

الخيارات التالية مفهومة:

-h، --help
    اطبع نص مساعدة قصير واخرج.

--version
    اطبع سلسلة إصدار قصيرة واخرج.

-t, --identifier=
    حدد سلسلة قصيرة تُستخدم لتعريف أداة التسجيل. إذا لم تُحدد، لا تُعين سلسلة تعريف لإدخال السجل، ويُستخدم اسم الملف التنفيذي (أو "cat" إذا قُرئ المدخل من أنبوب) لوصف مصدر السجل بدلاً من ذلك.

-p، --priority=
    حدد مستوى الأولوية المبدئي للرسائل المسجلة. مرر واحدة من "emerg"، "alert"، "crit"، "err"، "warning"، "notice"، "info"، "debug"، أو قيمة بين 0 و7 (المقابلة لنفس المستويات المسماة). قيم الأولوية هذه هي نفسها المعرفة بواسطة syslog(3). المبدئي هو "info". لاحظ أن هذا يتحكم فقط في المبدئي، قد تُسجل الأسطر الفردية بمستويات مختلفة إذا سُبقت بذلك. للتفاصيل، انظر --level-prefix= أدناه.

--stderr-priority=
    يحدد مستوى الأولوية المبدئي للرسائل من مخرج الخطأ القياسي (stderr) للعملية. استخدام هذا الخيار هو نفسه خيار --priority= أعلاه، ويمكن استخدام كليهما معًا. عند استخدام كليهما، يحدد --priority= الأولوية المبدئية للمخرج القياسي (stdout).

    إذا لم يُحدد --stderr-priority=، ستُسجل الرسائل من stderr بنفس مستوى الأولوية المبدئي مثل stdout.

    أيضًا، لاحظ أنه عندما يستخدم stdout وstderr نفس الأولوية المبدئية، ستُرتّب الرسائل ترتيبًا صارمًا، لأن قناة واحدة تُستخدم لكليهما. عندما تختلف الأولوية المبدئية، تُستخدم قناتان، وبالتالي لن تُرتّب رسائل stdout ترتيبًا صارمًا بالنسبة لرسائل stderr - رغم أنها ستميل إلى الترتيب التقريبي.

    أُضيف في الإصدارة 241.

--level-prefix=
    يتحكم في ما إذا كانت الأسطر المقروءة تُحلل لبادئات مستوى أولوية syslog. إذا مُكّن (المبدئي)، يُسجل سطر مسبوق ببادئة أولوية مثل "<5>" بالأولوية 5 ("notice")، وبالمثل لمستويات الأولوية الأخرى. يأخذ وسيطًا منطقيًا.

--namespace=
    يحدد مساحة اسم السجل التي يجب وصل الإدخال/الإخراج القياسي بها. للتفاصيل حول مساحات أسماء السجل، انظر systemd-journald.service(8).

    أُضيف في الإصدار 256.

حالة الخروج

عند النجاح، يُعاد الرقم 0، وإلا فيُعاد رمز فشل غير صفري.

أمثلة

مثال 1. استدعاء برنامج

يستدعي هذا /bin/ls مع وصل المخرج القياسي والخطأ بالسجل:

    # systemd-cat ls

مثال 2. الاستخدام في خط أنابيب الصدفة

يبني هذا خط أنابيب صدفة يستدعي أيضًا /bin/ls ويكتب المخرجات التي يولدها إلى السجل:

    # ls | systemd-cat

على الرغم من أن المثالين لهما تأثيرات متشابهة جدًا، إلا أن الأول مفضل، نظرًا لأن عملية واحدة فقط تعمل في كل مرة ويُلتقط كل من stdout وstderr، بينما في المثال الثاني، يُلتقط stdout فقط.

انظر أيضًا

systemd(1), systemctl(1), logger(1)

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

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

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