'\" t
.\"     Title: dmesg
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: دستورهای کاربری
.\"    Source: util-linux 2.42.3
.\"  Language: Persian
.\"
.TH "DMESG" "1" "2026-09-02" "util\-linux 2.42.3" "دستورهای کاربری"
.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)"
dmesg \- چاپ یا کنترل بافر حلقه‌ای هسته
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBdmesg\fP [options]
.sp
\fBdmesg\fP \fB\-\-clear\fP
.sp
\fBdmesg\fP \fB\-\-read\-clear\fP [options]
.sp
\fBdmesg\fP \fB\-\-console\-level\fP \fIlevel\fP
.sp
\fBdmesg\fP \fB\-\-console\-on\fP
.sp
\fBdmesg\fP \fB\-\-console\-off\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBdmesg\fP برای بررسی یا کنترل بافر حلقه‌ای هسته (kernel ring buffer) به کار می‌رود.
.sp
عملکرد پیش‌فرض، نمایش تمام پیام‌های موجود در بافر حلقه‌ای هسته است.
.SH "گزینه‌ها (OPTIONS)"
.sp
گزینه‌های \fB\-\-clear\fP، \fB\-\-read\-clear\fP، \fB\-\-console\-on\fP، \fB\-\-console\-off\fP و \fB\-\-console\-level\fP مانعة‌الجمع هستند.
.sp
\fB\-C\fP, \fB\-\-clear\fP
.RS 4
پاک‌سازی بافر حلقه‌ای.
.RE
.sp
\fB\-c\fP, \fB\-\-read\-clear\fP
.RS 4
پاک‌سازی بافر حلقه‌ای پس از چاپ محتویات آن.
.RE
.sp
\fB\-D\fP, \fB\-\-console\-off\fP
.RS 4
غیرفعال کردن چاپ پیام‌ها روی کنسول.
.RE
.sp
\fB\-d\fP, \fB\-\-show\-delta\fP
.RS 4
نمایش برچسب زمانی و اختلاف زمان سپری‌شده بین پیام‌ها. اگر همراه با \fB\-\-notime\fP استفاده شود، تنها اختلاف زمانی بدون برچسب زمانی چاپ می‌شود.
.RE
.sp
\fB\-E\fP, \fB\-\-console\-on\fP
.RS 4
فعال کردن چاپ پیام‌ها روی کنسول.
.RE
.sp
\fB\-e\fP, \fB\-\-reltime\fP
.RS 4
نمایش زمان محلی و اختلاف زمانی در قالبی خوانا برای انسان. توجه داشته باشید که تبدیل به زمان محلی ممکن است دقیق نباشد (برای جزئیات بیشتر به \fB\-T\fP مراجعه کنید).
.RE
.sp
\fB\-F\fP, \fB\-\-file\fP \fIfile\fP
.RS 4
خواندن پیام‌های گزارش سیستم (syslog) از \fIfile\fP مشخص‌شده. توجه داشته باشید که \fB\-F\fP از پیام‌های در قالب kmsg پشتیبانی نمی‌کند. به جای آن به \fB\-K\fP مراجعه کنید.
.RE
.sp
\fB\-f\fP, \fB\-\-facility\fP \fIlist\fP
.RS 4
محدود کردن خروجی به \fIlist\fP مشخص‌شده (جداشده با کاما) از تسهیلات (facilities). برای نمونه:
.sp
\fBdmesg \-\-facility=daemon\fP
.sp
تنها پیام‌های مربوط به دیمن‌های سیستم را چاپ می‌کند. برای مشاهده تمام تسهیلات موجود، خروجی \fB\-\-help\fP را ببینید.
.RE
.sp
\fB\-H\fP, \fB\-\-human\fP
.RS 4
فعال کردن خروجی خوانا برای انسان. همچنین گزینه‌های \fB\-\-color\fP، \fB\-\-reltime\fP و \fB\-\-nopager\fP را ببینید.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
استفاده از قالب خروجی JSON. قالب خروجی زمان تنها به صورت "sec.usec" است، سطح اولویت گزارش به‌طور پیش‌فرض رمزگشایی نمی‌شود (از \fB\-\-decode\fP برای تفکیک تسهیلات و اولویت استفاده کنید)، و سایر گزینه‌های قالب‌بندی خروجی یا قالب زمان بدون هشدار نادیده گرفته می‌شوند.
.RE
.sp
\fB\-K\fP, \fB\-\-kmsg\-file\fP \fIfile\fP
.RS 4
خواندن پیام‌های /dev/kmsg از \fIfile\fP مشخص‌شده. انتظار می‌رود رکوردهای مختلف با بایت NULL از یکدیگر جدا شده باشند.
.RE
.sp
\fB\-k\fP, \fB\-\-kernel\fP
.RS 4
چاپ پیام‌های هسته.
.RE
.sp
\fB\-L\fP, \fB\-\-color\fP[\fB=\fP\fIwhen\fP]
.RS 4
رنگ‌آمیزی خروجی. آرگومان اختیاری \fIwhen\fP می‌تواند \fBauto\fP (خودکار)، \fBnever\fP (هرگز) یا \fBalways\fP (همیشه) باشد. اگر آرگومان \fIwhen\fP حذف شود، به‌طور پیش‌فرض روی \fBauto\fP تنظیم می‌شود. رنگ‌ها را می‌توان غیرفعال کرد؛ برای مشاهده مقدار پیش‌فرض تعبیه‌شدهٔ فعلی به خروجی \fB\-\-help\fP مراجعه کنید. همچنین بخش \fBرنگ‌ها (COLORS)\fP را در ادامه ببینید.
.RE
.sp
\fB\-l\fP, \fB\-\-level\fP \fIlist\fP
.RS 4
محدود کردن خروجی به \fIlist\fP مشخص‌شده (جداشده با کاما) از سطوح (levels). برای نمونه:
.sp
\fBdmesg \-\-level=err,warn\fP
.sp
تنها پیام‌های خطا و هشدار را چاپ می‌کند. برای مشاهده تمام سطوح موجود، خروجی \fB\-\-help\fP را ببینید.
.sp
افزودن علامت مثبت \fB+\fP به انتهای نام یک سطح، تمام سطوح بالاتر را نیز شامل می‌شود. برای نمونه:
.sp
\fBdmesg \-\-level=err+\fP
.sp
سطوح \fBerr\fP، \fBcrit\fP، \fBalert\fP و \fBemerg\fP را چاپ خواهد کرد.
.sp
افزودن علامت مثبت به ابتدای نام سطح، تمام سطوح پایین‌تر را شامل می‌شود.
.RE
.sp
\fB\-n\fP, \fB\-\-console\-level\fP \fIlevel\fP
.RS 4
تنظیم \fIlevel\fP (سطحی) که پیام‌ها در آن روی کنسول چاپ می‌شوند. مقدار \fIlevel\fP یک عدد سطح یا نام اختصاری سطح است. برای مشاهده تمام سطوح موجود به خروجی \fB\-\-help\fP مراجعه کنید.
.sp
برای نمونه، \fB\-n 1\fP یا \fB\-n emerg\fP از نمایش تمام پیام‌ها روی کنسول، به جز پیام‌های اضطراری (وحشت هسته)، جلوگیری می‌کند. تمام سطوح پیام‌ها همچنان در \fI/proc/kmsg\fP نوشته می‌شوند، بنابراین هنوز می‌توان از \fBsyslogd\fP(8) برای کنترل دقیق محل نمایش پیام‌های هسته استفاده کرد. هنگام استفاده از گزینهٔ \fB\-n\fP، دستور \fBdmesg\fP بافر حلقه‌ای هسته را چاپ نکرده و آن را پاک نخواهد کرد.
.RE
.sp
\fB\-\-noescape\fP
.RS 4
کاراکترهای غیرقابل‌چاپ و بالقوه ناامن (مانند دنباله‌های چندبایتی معیوب، کاراکترهای کنترلی ترمینال و غیره) به دلایل امنیتی به‌طور پیش‌فرض به صورت \(rsx<hex> گریزدهی می‌شوند. این گزینه این قابلیت را کاملاً غیرفعال می‌کند. این ویژگی مثلاً برای مقاصد اشکال‌زدایی همراه با گزینهٔ \fB\-\-raw\fP مفید است. با احتیاط استفاده کنید و آن را به‌طور پیش‌فرض به کار نبرید.
.RE
.sp
\fB\-P\fP, \fB\-\-nopager\fP
.RS 4
خروجی به صفحه‌بند (pager) فرستاده نشود. صفحه‌بند به‌طور پیش‌فرض برای خروجی \fB\-\-human\fP فعال است.
.RE
.sp
\fB\-p\fP, \fB\-\-force\-prefix\fP
.RS 4
افزودن اطلاعات تسهیلات، سطح، یا برچسب زمانی به هر خط در پیام‌های چندخطی.
.RE
.sp
\fB\-r\fP, \fB\-\-raw\fP
.RS 4
چاپ بافر پیام خام؛ یعنی پیشوندهای سطح گزارش حذف نمی‌شوند، اما تمام کاراکترهای غیرقابل‌چاپ همچنان گریزدهی می‌شوند (همچنین به \fB\-\-noescape\fP مراجعه کنید).
.sp
توجه داشته باشید که قالب خام واقعی به روشی که \fBdmesg\fP پیام‌های هسته را می‌خواند بستگی دارد. دستگاه \fI/dev/kmsg\fP از قالبی متفاوت با \fBsyslog\fP(2) استفاده می‌کند. برای سازگاری با نسخه‌های پیشین، \fBdmesg\fP همیشه داده‌ها را در قالب \fBsyslog\fP(2) بازمی‌گرداند. خواندن داده‌های خام واقعی از \fI/dev/kmsg\fP برای نمونه با دستور \*(Aqdd if=/dev/kmsg iflag=nonblock\*(Aq امکان‌پذیر است.
.RE
.sp
\fB\-S\fP, \fB\-\-syslog\fP
.RS 4
اجبار \fBdmesg\fP به استفاده از رابط هستهٔ \fBsyslog\fP(2) برای خواندن پیام‌های هسته. حالت پیش‌فرض از زمان هستهٔ 3.5.0 استفاده از \fI/dev/kmsg\fP به جای \fBsyslog\fP(2) است.
.RE
.sp
\fB\-s\fP, \fB\-\-buffer\-size\fP \fIsize\fP
.RS 4
استفاده از بافری با اندازهٔ \fIsize\fP برای پرس‌وجو از بافر حلقه‌ای هسته. این اندازه به‌طور پیش‌فرض 16392 است. (اندازهٔ بافر پیش‌فرض syslog هسته در ابتدا 4096 بود، از نسخهٔ 1.3.54 به 8192 و از نسخهٔ 2.1.113 به 16384 تغییر یافت.) اگر بافر هسته را بزرگ‌تر از مقدار پیش‌فرض تنظیم کرده‌اید، می‌توان از این گزینه برای مشاهدهٔ کامل بافر استفاده کرد.
.RE
.sp
\fB\-T\fP, \fB\-\-ctime\fP
.RS 4
چاپ برچسب‌های زمانی خوانا برای انسان.
.sp
\fBتوجه داشته باشید که برچسب زمانی ممکن است دقیق نباشد!\fP منبع \fBزمان\fP مورد استفاده برای گزارش‌ها، پس از تعلیق (\fBSUSPEND\fP) یا ازسرگیری (\fBRESUME\fP) سیستم \fBبه‌روزرسانی نمی‌شود\fP. برچسب‌های زمانی بر اساس اختلاف فعلی بین ساعت زمان راه‌اندازی و ساعت یکنواخت (monotonic) تنظیم می‌شوند و این سازوکار تنها برای پیام‌هایی کار می‌کند که پس از آخرین ازسرگیری چاپ شده‌اند.
.RE
.sp
\fB\-\-since\fP \fItime\fP
.RS 4
نمایش گزارش‌ها از زمان مشخص‌شده. دقت کسری از ثانیه در دسترس است. تعیین زمان به صورت مطلق و همچنین با قالب نسبی (برای نمونه \*(Aq1 hour ago\*(Aq) امکان‌پذیر است. توجه داشته باشید که ممکن است برچسب زمانی دقیق نباشد و برای جزئیات بیشتر به \fB\-\-ctime\fP مراجعه کنید.
.RE
.sp
\fB\-\-until\fP \fItime\fP
.RS 4
نمایش گزارش‌ها تا زمان مشخص‌شده. دقت کسری از ثانیه در دسترس است. تعیین زمان به صورت مطلق و همچنین با قالب نسبی (برای نمونه \*(Aq1 hour ago\*(Aq) امکان‌پذیر است. توجه داشته باشید که ممکن است برچسب زمانی دقیق نباشد و برای جزئیات بیشتر به \fB\-\-ctime\fP مراجعه کنید.
.RE
.sp
\fB\-t\fP, \fB\-\-notime\fP
.RS 4
عدم چاپ برچسب‌های زمانی هسته.
.RE
.sp
\fB\-\-time\-format\fP \fIformat\fP
.RS 4
چاپ برچسب‌های زمانی با استفاده از قالب مشخص‌شدهٔ \fIformat\fP، که می‌تواند \fBctime\fP، \fBreltime\fP، \fBdelta\fP، \fBiso\fP یا \fBraw\fP باشد. سه قالب نخست نام‌های مستعار برای گزینه‌های مشخص قالب زمان هستند. قالب \fBraw\fP از قالب برچسب زمانی پیش‌فرض استفاده می‌کند که ثانیه‌های سپری‌شده از زمان راه‌اندازی را نمایش می‌دهد. قالب \fBiso\fP پیاده‌سازی قالب برچسب زمانی ISO\-8601 در \fBdmesg\fP است. هدف از این قالب، آسان کردن مقایسهٔ برچسب‌های زمانی بین دو سیستم و هرگونه تحلیل دیگر است. تعریف برچسب زمانی \fBiso\fP عبارت است از: YYYY\-MM\-DD<T>HH:MM:SS,<microseconds>\(<-+><timezone offset from UTC>.
.sp
قالب \fBiso\fP همان مشکل \fBctime\fP را دارد: در صورت تعلیق و ازسرگیری سیستم ممکن است زمان نادرست باشد.
.sp
می‌توان از \fB\-\-time\-format\fP چندین بار با مقادیر مختلف برای \fIformat\fP استفاده کرد تا هر یک از قالب‌های مشخص‌شده چاپ شوند.
.sp
در صورت تعیین هم‌زمان، \fBdelta\fP همیشه بعد از \fBctime\fP یا \fBraw\fP می‌آید.
.RE
.sp
\fB\-u\fP, \fB\-\-userspace\fP
.RS 4
چاپ پیام‌های فضای کاربری (userspace).
.RE
.sp
\fB\-w\fP, \fB\-\-follow\fP
.RS 4
انتظار برای پیام‌های جدید. این قابلیت تنها در سیستم‌هایی که \fI/dev/kmsg\fP در آن‌ها قابل خواندن است (از هستهٔ 3.5.0 به بعد) پشتیبانی می‌شود.
.RE
.sp
\fB\-W\fP, \fB\-\-follow\-new\fP
.RS 4
انتظار و چاپ تنها پیام‌های جدید.
.RE
.sp
\fB\-x\fP, \fB\-\-decode\fP
.RS 4
رمزگشایی شماره‌های تسهیلات و سطح (اولویت) به پیشوندهای خوانا برای انسان.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "رنگ‌ها (COLORS)"
.sp
رنگ‌آمیزی خروجی بر اساس قابلیت‌های \fBterminal\-colors.d\fP(5) پیاده‌سازی شده است. رنگ‌آمیزی ضمنی را می‌توان با ایجاد یک پروندهٔ خالی
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/dmesg.disable\fP
.br
.RE
.ll
.sp
برای دستور \fBdmesg\fP یا برای تمامی ابزارها با ایجاد پروندهٔ
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/disable\fP
.br
.RE
.ll
.sp
غیرفعال کرد.
.sp
از نسخهٔ 2.41، متغیر محیطی $NO_COLOR نیز برای غیرفعال‌سازی رنگ‌آمیزی خروجی پشتیبانی می‌شود، مگر اینکه صراحتاً با گزینه‌ای در خط فرمان فعال شده باشد.
.sp
تنظیمات کاربر در مسیرهای \fI$XDG_CONFIG_HOME/terminal\-colors.d\fP یا \fI$HOME/.config/terminal\-colors.d\fP بر تنظیمات سراسری سیستم اولویت دارند.
.sp
توجه داشته باشید که ممکن است رنگ‌آمیزی خروجی به‌طور پیش‌فرض فعال باشد و در این صورت نیازی به وجود پیشین شاخه‌های \fIterminal\-colors.d\fP نیست.
.sp
نام‌های منطقی رنگ‌ها که توسط \fBdmesg\fP پشتیبانی می‌شوند عبارتند از:
.sp
\fBsubsys\fP
.RS 4
پیشوند زیرسیستم پیام (برای نمونه: "ACPI:").
.RE
.sp
\fBtime\fP
.RS 4
برچسب زمانی پیام.
.RE
.sp
\fBtimebreak\fP
.RS 4
برچسب زمانی پیام در قالب کوتاه ctime در خروجی‌های \fB\-\-reltime\fP یا \fB\-\-human\fP.
.RE
.sp
\fBalert\fP
.RS 4
متن پیام با اولویت گزارش هشدار.
.RE
.sp
\fBcrit\fP
.RS 4
متن پیام با اولویت گزارش بحرانی.
.RE
.sp
\fBerr\fP
.RS 4
متن پیام با اولویت گزارش خطا.
.RE
.sp
\fBwarn\fP
.RS 4
متن پیام با اولویت گزارش اخطار.
.RE
.sp
\fBsegfault\fP
.RS 4
متن پیامی که خطای نقص بخش‌بندی حافظه (segmentation fault) را گزارش می‌کند.
.RE
.SH "کدهای خروج (EXIT STATUS)"
.sp
دستور \fBdmesg\fP ممکن است با خطای عدم دسترسی (permission denied) مواجه شود. این مورد معمولاً به دلیل تنظیم هستهٔ \fBdmesg_restrict\fP است؛ لطفاً برای جزئیات بیشتر به \fBsyslog\fP(2) مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.sp
دستور \fBdmesg\fP در ابتدا توسط \c
.MTO "tytso\(atathena.mit.edu" "Theodore Ts\(cqo" "."
نوشته شده است.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBterminal\-colors.d\fP(5),
\fBsyslogd\fP(8)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
استفاده کنید.
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBdmesg\fP بخشی از بستهٔ util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "آرشیو هسته لینوکس" "."
دریافت کرد.