نام (NAME)

systemd-cat - متصل کردن خروجی استاندارد یک فرآیند به لاگ سیستم‌دی (journal)

خلاصه دستور (SYNOPSIS)

systemd-cat [OPTIONS...] [COMMAND] [ARGUMENTS...]

systemd-cat [OPTIONS...]

توضیحات (DESCRIPTION)

systemd-cat می‌تواند برای متصل کردن خروجی استاندارد و خروجی خطای استاندارد یک دستور به ژورنال، یا به عنوان یک ابزار فیلتر در خط لوله پوسته (shell pipeline) برای انتقال خروجی تولیدشده توسط عنصر قبلی پایپ‌لاین به ژورنال استفاده شود.

اگر هیچ پارامتری ارسال نشود، systemd-cat هر آنچه را که از ورودی استاندارد (stdin) می‌خواند در ژورنال می‌نویسد.

اگر پارامترهایی ارسال شوند، آن‌ها به صورت خط فرمان اجرا می‌شوند در حالی که خروجی استاندارد (stdout) و خروجی خطای استاندارد (stderr) آن‌ها به ژورنال متصل است، به طوری که تمام آنچه می‌نویسند در ژورنال ذخیره می‌شود.

گزینه‌ها (OPTIONS)

گزینه‌های زیر پشتیبانی می‌شوند:

-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=

فضای‌نام ژورنال (journal namespace) را مشخص می‌کند که ورودی/خروجی استاندارد باید به آن متصل شود. برای جزئیات درباره فضاهای نام ژورنال، systemd-journald.service(8) را ببینید.

در نسخه 256 اضافه شد.

کدهای خروج (EXIT STATUS)

در صورت موفقیت، 0 برگردانده می‌شود، در غیر این صورت یک کد خطای غیر صفر برگردانده خواهد شد.

مثال‌ها (EXAMPLES)

مثال ۱. اجرای یک برنامه

این دستور /bin/ls را اجرا کرده و خروجی استاندارد و خروجی خطای آن را به ژورنال متصل می‌کند:

# systemd-cat ls

مثال ۲. استفاده در یک خط لوله پوسته

این دستور یک خط لوله پوسته ایجاد کرده و /bin/ls را فراخوانی می‌کند و خروجی تولیدشده توسط آن را در ژورنال می‌نویسد:

# ls | systemd-cat

با وجود اینکه این دو مثال اثرات بسیار مشابهی دارند، اما مثال اول ارجح است، زیرا تنها یک فرآیند در هر زمان اجرا می‌شود و هر دو خروجی stdout و stderr ضبط می‌شوند، در حالی که در مثال دوم، فقط stdout ضبط می‌شود.

همچنین ببینید (SEE ALSO)

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