'\" t .\" Title: logger .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.26 .\" Date: 2026-09-02 .\" Manual: User Commands .\" Source: util-linux 2.42.3 .\" Language: Persian .\" .TH "LOGGER" "1" "2026-09-02" "util\-linux 2.42.3" "User Commands" .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 "نام (NAME)" logger \- ارسال پیام به سیستم گزارش‌گیری وقایع لینوکس (Syslog) .SH "خلاصه دستور (SYNOPSIS)" .sp \fBlogger\fP [options] \fImessage\fP .SH "توضیحات (DESCRIPTION)" .sp دستور \fBlogger\fP ورودی‌هایی را در گزارش وقایع سیستم ثبت می‌کند. .sp هنگامی که آرگومان اختیاری \fImessage\fP وجود داشته باشد، در لاگ نوشته می‌شود. اگر وجود نداشته باشد و گزینهٔ \fB\-f\fP نیز داده نشده باشد، ورودی استاندارد ثبت می‌شود. .SH "گزینه‌ها (OPTIONS)" .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 نادیده گرفتن خطوط خالی هنگام پردازش فایل‌ها. یک خط خالی به عنوان خطی بدون هیچ نویسه‌ای تعریف می‌شود. بنابراین خطی که تنها شامل نویسه‌های فاصله خالی (whitespace) باشد خالی در نظر گرفته نمی‌شود. توجه داشته باشید که وقتی گزینهٔ \fB\-\-prio\-prefix\fP مشخص شده باشد، اولویت بخشی از خط نیست. بنابراین یک خط خالی در این حالت خطی است که بعد از پیشوند اولویت (مانند \fB<13>\fP) هیچ نویسه‌ای نداشته باشد. .RE .sp \fB\-f\fP, \fB\-\-file\fP \fIfile\fP .RS 4 ثبت محتویات \fIfile\fP مشخص‌شده در لاگ. این گزینه نمی‌تواند با یک پیام خط فرمان ترکیب شود. .RE .sp \fB\-i\fP .RS 4 ثبت PID فرآیند \fBlogger\fP همراه با هر خط. .RE .sp \fB\-\-id\fP[\fB=\fP\fIid\fP] .RS 4 ثبت PID فرآیند \fBlogger\fP همراه با هر خط. هنگامی که آرگومان اختیاری \fIid\fP مشخص شود، به جای PID دستور \fBlogger\fP از آن استفاده می‌شود. استفاده از \fB\-\-id=$$\fP (شناسه والد یا PPID) در اسکریپت‌هایی که چندین پیام ارسال می‌کنند توصیه می‌شود. .sp توجه داشته باشید که زیرساخت گزارش‌گیری وقایع سیستم (به عنوان مثال \fBsystemd\fP هنگام شنود روی \fI/dev/log\fP) ممکن است اعتبارنامه‌های سوکت محلی (local socket credentials) را برای لغو PID مشخص‌شده در پیام دنبال کند. دستور \fBlogger\fP(1) قادر است آن اعتبارنامه‌های سوکت را روی \fIid\fP داده‌شده تنظیم کند، اما تنها در صورتی که دسترسی ریشه (root) داشته باشید و فرآیندی با PID مشخص‌شده وجود داشته باشد؛ در غیر این صورت اعتبارنامه‌های سوکت تغییر نمی‌کنند و این موضوع بدون هشدار نادیده گرفته می‌شود. .RE .sp \fB\-\-journald\fP[\fB=\fP\fIfile\fP] .RS 4 نوشتن یک ورودی در ژورنال \fBsystemd\fP. در صورت مشخص شدن \fIfile\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 اگر پیشوند حاوی facility نباشد، facility به مقدار مشخص‌شده توسط گزینهٔ \fB\-p\fP بازمی‌گردد. به‌طور مشابه، اگر هیچ پیشوندی ارائه نشود، خط با استفاده از \fIpriority\fP داده‌شده با \fB\-p\fP لاگ می‌شود. .sp این گزینه بر پیام‌های خط فرمان تأثیری ندارد. این گزینه در درجه اول برای مواردی طراحی شده است که در آن‌ها \fBlogger\fP در یک خط لوله (مانند daemon | logger \-\-prio\-prefix) برای خواندن چندین پیام با اولویت‌های متفاوت استفاده می‌شود. .RE .sp \fB\-\-rfc3164\fP .RS 4 استفاده از پروتکل syslog در \c .URL "https://tools.ietf.org/html/rfc3164" "RFC 3164" "" (BSD syslog) برای ارسال پیام‌ها به یک سرور راه دور. .RE .sp \fB\-\-rfc5424\fP[\fB=\fP\fIwithout\fP] .RS 4 استفاده از پروتکل syslog در \c .URL "https://tools.ietf.org/html/rfc5424" "RFC 5424" "" برای ارسال پیام‌ها به یک سرور راه دور. آرگومان اختیاری \fIwithout\fP می‌تواند فهرستی از مقادیر زیر باشد که با کاما جدا شده‌اند: \fBnotq\fP، \fBnotime\fP، \fBnohost\fP. .sp مقدار \fBnotq\fP داده‌های ساختاریافتهٔ کیفیت زمان (time\-quality) را از پیام ارسال‌شده حذف می‌کند. اطلاعات کیفیت زمان نشان می‌دهد که آیا ساعت محلی همگام‌سازی شده است یا خیر، به همراه حداکثر تعداد میکروثانیه‌هایی که برچسب زمانی ممکن است انحراف داشته باشد. همچنین کیفیت زمان هنگامی که \fB\-\-sd\-id timeQuality\fP مشخص شود، به‌طور خودکار سرکوب می‌شود. .sp مقدار \fBnotime\fP (که شامل \fBnotq\fP نیز می‌شود) کل برچسب زمانی فرستنده را که در قالب ISO\-8601 است، شامل میکروثانیه‌ها و منطقه زمانی، حذف می‌کند. .sp مقدار \fBnohost\fP اطلاعات فراخوانی \fBgethostname\fP(2) را از سربرگ پیام حذف می‌کند. .sp پروتکل RFC 5424 از نگارش 2.26 پیش‌فرض دستور \fBlogger\fP بوده است. .RE .sp \fB\-s\fP, \fB\-\-stderr\fP .RS 4 ارسال پیام به خطای استاندارد و همچنین لاگ سیستم. کل پیام به همان شکلی که به syslog یا journald فرستاده می‌شود خروجی داده می‌شود، شامل اولویت و احتمالاً سایر فیلدها. این گزینه در درجه اول برای مقاصد اشکال‌زدایی طراحی شده است و اغلب با \fB\-\-no\-act\fP استفاده می‌شود. .RE .sp \fB\-\-sd\-id\fP \fIname\fP[\fB@\fP\fIdigits\fP] .RS 4 مشخص کردن شناسه عنصر داده ساختاریافته برای یک سربرگ پیام RFC 5424. این گزینه باید پیش از \fB\-\-sd\-param\fP برای معرفی یک عنصر جدید استفاده شود. تعداد عناصر داده ساختاریافته نامحدود است. شناسه (\fIname\fP به علاوه احتمالاً \fB@\fP\fIdigits\fP) به بزرگی و کوچکی حروف حساس است و نوع و هدف عنصر را به صورت یکتا مشخص می‌کند. همان شناسه نباید بیش از یک بار در یک پیام وجود داشته باشد. بخش \fB@\fP\fIdigits\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\fIdigits\fP مشخص شوند. .RE .sp \fB\-\-sd\-param\fP \fIname\fP=\fIvalue\fP .RS 4 مشخص کردن یک پارامتر عنصر داده ساختاریافته، یک جفت نام و مقدار. این گزینه باید پس از \fB\-\-sd\-id\fP استفاده شود و ممکن است بیش از یک بار برای همان عنصر مشخص گردد. توجه داشته باشید که علامت‌های نقل‌قول در اطراف \fIvalue\fP الزامی هستند و باید در خط فرمان گریز (escape) داده شوند. .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 \fIsize\fP .RS 4 تنظیم حداکثر اندازه مجاز پیام به \fIsize\fP. مقدار پیش‌فرض 1KiB نویسه است، که محدودیتی است که به صورت سنتی استفاده شده و در RFC 3164 مشخص شده است. با RFC 5424، این محدودیت انعطاف‌پذیر شده است. یک فرض خوب این است که گیرنده‌های RFC 5424 حداقل می‌توانند پیام‌های 4KiB را پردازش کنند. .sp اکثر گیرنده‌ها پیام‌های بزرگتر از 1KiB را روی هر نوع پروتکل syslog می‌پذیرند. به این ترتیب، گزینهٔ \fB\-\-size\fP در تمام موارد بر \fBlogger\fP تأثیر می‌گذارد (نه تنها زمانی که از \fB\-\-rfc5424\fP استفاده شده باشد). .sp نکته: محدودیت اندازه پیام، اندازه کلی پیام شامل سربرگ syslog را محدود می‌کند. اندازه سربرگ بسته به گزینه‌های انتخاب‌شده و طول نام میزبان متفاوت است. به عنوان یک قاعده تجربی، سربرگ‌ها معمولاً طولانی‌تر از 50 تا 80 نویسه نیستند. هنگام انتخاب حداکثر اندازه پیام، مهم است که مطمئن شوید گیرنده نیز از حداکثر اندازه پشتیبانی می‌کند، در غیر این صورت ممکن است پیام‌ها کوتاه (truncate) شوند. باز هم به عنوان یک قاعده کلی، اندازه پیام دو تا چهار KiB عموماً باید مناسب باشد، در حالی که هر مقدار بزرگتر باید بررسی شود تا از کارکرد آن اطمینان حاصل گردد. .RE .sp \fB\-\-socket\-errors\fP \fImode\fP .RS 4 چاپ خطاهای مربوط به اتصالات سوکت یونیکس. مقدار \fImode\fP می‌تواند \fBon\fP، \fBoff\fP، یا \fBauto\fP باشد. هنگامی که حالت \fBauto\fP (پیش‌فرض) باشد، \fBlogger\fP تشخیص خواهد داد که آیا فرآیند init همان \fBsystemd\fP(1) است یا خیر، و در این صورت، این فرض در نظر گرفته می‌شود که \fI/dev/log\fP می‌تواند در اوایل بوت استفاده شود. نبودِ \fI/dev/log\fP در سایر سیستم‌های init باعث ایجاد خطا نخواهد شد، درست مانند زمانی که از فراخوانی سیستمی \fBopenlog\fP(3) استفاده می‌شود. دستور \fBlogger\fP(1) پیش از نگارش 2.26 از \fBopenlog\fP(3) استفاده می‌کرد، و بنابراین قادر به تشخیص از دست رفتن پیام‌های ارسال‌شده به سوکت‌های یونیکس نبود. .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 \fItag\fP .RS 4 علامت‌گذاری هر خط ثبت‌شده در لاگ با \fItag\fP مشخص‌شده. برچسب پیش‌فرض نام کاربری است که به ترمینال وارد شده است (یا نام کاربری بر اساس شناسه کاربری مؤثر). .RE .sp \fB\-u\fP, \fB\-\-socket\fP \fIsocket\fP .RS 4 نوشتن در \fIsocket\fP مشخص‌شده به جای سوکت لاگ سیستم. .RE .sp \fB\-\-\fP .RS 4 پایان دادن به فهرست آرگومان‌ها. این امکان را فراهم می‌کند که \fImessage\fP با یک خط تیره (\-) آغاز شود. .RE .sp \fB\-h\fP, \fB\-\-help\fP .RS 4 نمایش متن راهنما و خروج. .RE .sp \fB\-V\fP, \fB\-\-version\fP .RS 4 نمایش نسخه و خروج. .RE .SH "وضعیت خروج (EXIT STATUS)" .sp ابزار \fBlogger\fP در صورت موفقیت با مقدار 0 و در صورت بروز خطا با مقدار >0 خارج می‌شود. .SH "تسهیلات و سطوح (FACILITIES AND LEVELS)" .sp نام‌های معتبر تسهیلات (facilities) عبارتند از: .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 نام‌های معتبر سطوح (levels) عبارتند از: .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 "انطباق با استانداردها (CONFORMING TO)" .sp انتظار می‌رود دستور \fBlogger\fP با استاندارد IEEE Std 1003.2 ("POSIX.2") سازگار باشد. .SH "مثال‌ها (EXAMPLES)" .RS 3 .ll -.6i .sp logger System rebooted .sp logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc .sp logger \-n loghost.example.com System rebooted .br .RE .ll .SH "نویسندگان (AUTHORS)" .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 "همچنین ببینید (SEE ALSO)" .sp \fBjournalctl\fP(1), \fBsyslog\fP(3), \fBsystemd.journal\-fields\fP(7) .SH "گزارش باگ‌ها (REPORTING BUGS)" .sp برای گزارش باگ‌ها، از \c .URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "." استفاده کنید. .SH "دسترسی (AVAILABILITY)" .sp دستور \fBlogger\fP بخشی از بستهٔ util\-linux است که می‌توان آن را از \c .URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "." دریافت کرد.