.TH "DBUS\-MONITOR" "1" "سپتامبر ۲۰۲۲" "D-Bus" "دستورهای کاربری"
.nh
.ad l
.SH "نام (NAME)"
dbus-monitor \- مانیتورینگ و رصد پیامهای گذرگاه D-Bus
.SH "خلاصه دستور (SYNOPSIS)"
.B dbus-monitor
[\fB\-\-system\fR | \fB\-\-session\fR | \fB\-\-address\fR \fIآدرس\fR]
[\fB\-\-profile\fR | \fB\-\-monitor\fR | \fB\-\-pcap\fR | \fB\-\-binary\fR]
[\fIالگوی_تطبیق\fR...]
.SH "توضیحات (DESCRIPTION)"
دستور \fBdbus-monitor\fR پیامهای عبوری از گذرگاه پیام D-Bus را دریافت کرده و در خروجی استاندارد نمایش میدهد.
برای اطلاعات بیشتر و دید کلی پیرامون پروژه به نشانی زیر مراجعه فرمایید:
.PP
.nf
<https://www.freedesktop.org/wiki/Software/dbus>
.fi
.PP
دو گذرگاه پیام شناخته‌شده وجود دارند: گذرگاه پیام سراسری کل سیستم (که در بسیاری از سیستم‌ها در قالب سرویس «messagebus» نصب و اجرا می‌شود) و گذرگاه پیام ویژهٔ نشست ورود هر کاربر (که با هر بار ورود کاربر به محیط سیستم آغاز به کار می‌کند). گزینه‌های
.B \-\-system
و
.B \-\-session
به دستور
.B dbus\-monitor
اعلام می‌کنند که به ترتیب گذرگاه سیستم یا نشست را پایش کند. در صورتی که هیچ‌یک مشخص نشوند،
.B dbus\-monitor
به‌طور پیش‌فرض گذرگاه نشست را رصد خواهد کرد.
.PP
دستور
.B dbus\-monitor
دارای دو حالت خروجی متنی متمایز است: حالت پایش سبک «کلاسیک» (classic)، و حالت پروفایل‌سازی (profiling). فرمت پروفایل‌سازی قالبی فشرده و تک‌خطی برای هر پیام به همراه اطلاعات زمانی با دقت میکروثانیه ارائه می‌دهد. گزینه‌های
.B \-\-profile
و
.B \-\-monitor
به ترتیب این دو شیوه خروجی را فعال می‌کنند.
.PP
همچنین
.B dbus\-monitor
دارای دو حالت خروجی باینری (دودویی) است: حالت باینری که با سوییچ
.B \-\-binary
انتخاب می‌شود، کل جریان خام پیام‌های باینری را (بدون دست‌تکانی اولیه احراز هویت) در خروجی می‌ریزد. حالت PCAP که با سوییچ
.B \-\-pcap
انتخاب می‌شود، یک هدر فایل PCAP به ابتدای جریان خروجی و یک هدر بستهٔ PCAP به ابتدای هر پیام الصاق می‌کند؛ با هدایت این خروجی به یک فایل، پرونده‌ای تولید می‌شود که مستقیماً در نرم‌افزارهای تحلیل شبکه نظیر Wireshark قابل بارگذاری و بررسی است.
.PP
اگر هیچ حالتی تعیین نشود،
.B dbus\-monitor
از قالب مانیتورینگ متنی استفاده می‌نماید.
.PP
به منظور هدایت
.B dbus\-monitor
برای دریافت و نمایش پیام‌های مورد نظر شما، می‌توانید مجموعه‌ای از «عبارت‌های نظارت» یا الگوهای تطبیق (watch expressions / match rules) را مشابه آنچه به تابع
.I dbus_bus_add_match
ارسال می‌شود، در آرگومان‌های خط فرمان وارد کنید.
.PP
پیکربندی امنیتی گذرگاه پیام ممکن است مانع از دسترسی و مشاهده تمامی پیام‌ها توسط
.B dbus\-monitor
گردد، به‌ویژه در حالتی که دستور را به عنوان کاربر عادی (غیر ریشه / non-root) اجرا می‌کنید.
.SH "گزینه‌ها (OPTIONS)"
\fB\-\-system\fR
.RS 4
پایش و نظارت بر گذرگاه پیام سراسری سیستم.
.RE
.PP
\fB\-\-session\fR
.RS 4
پایش و نظارت بر گذرگاه پیام نشست کاربری جاری. (حالت پیش‌فرض)
.RE
.PP
\fB\-\-address\fR \fIآدرس\fR
.RS 4
پایش یک گذرگاه پیام دلخواه که نشانی آن در آرگومان \fIآدرس\fR مشخص شده است.
.RE
.PP
\fB\-\-profile\fR
.RS 4
استفاده از قالب خروجی پروفایل‌سازی (تک‌خطی و فشرده با مهر زمانی دقیق بر حسب میکروثانیه).
.RE
.PP
\fB\-\-monitor\fR
.RS 4
استفاده از قالب خروجی مانیتورینگ استاندارد و با جزئیات کامل متنی. (حالت پیش‌فرض)
.RE
.PP
\fB\-\-pcap\fR
.RS 4
تولید خروجی در قالب فایل ضبط بستهٔ PCAP به همراه هدرهای مربوطه به منظور تجزیه و تحلیل در ابزارهایی مانند Wireshark.
.RE
.PP
\fB\-\-binary\fR
.RS 4
ارسال مستقیم کل جریان باینری و بدون ساختار پیام‌ها به خروجی (بدون اعمال دست‌تکانی اولیه ارتباط).
.RE
.SH "الگوهای تطبیق (MATCH RULES)"
الگوهای تطبیق (فیلترها) به شما اجازه می‌دهند تنها پیام‌های خاصی را شنود کنید. یک الگوی تطبیق از یک رشته حاوی کلیدها و مقادیر تشکیل شده که با کاما از یکدیگر جدا می‌شوند. کلیدهای معتبر عبارتند از:
.TP
.BI "type='" نوع "'"
نوع پیام عبوری، مانند
.B signal
(سیگنال)،
.B method_call
(فراخوانی متد)،
.B method_return
(پاسخ متد) یا
.B error
(خطا).
.TP
.BI "sender='" فرستنده "'"
نام سرویس یا نشانی فرستنده پیام در گذرگاه (مانند
.B org.freedesktop.DBus
یا نام منحصر‌به‌فرد مانند
.BR :1.42 ).
.TP
.BI "interface='" واسط "'"
نام رابط یا واسط کاربری هدف پیام (مانند
.BR org.gnome.TypingMonitor ).
.TP
.BI "member='" عضو "'"
نام متد یا نام سیگنال ارسالی.
.TP
.BI "path='" مسیر "'"
مسیر شیء D-Bus که پیام به آن تعلق دارد (مانند
.BR /org/freedesktop/DBus ).
.TP
.BI "path_namespace='" فضای_نام "'"
تطبیق تمامی اشیایی که مسیر آن‌ها با پیشوند مشخص‌شده آغاز می‌شود.
.TP
.BI "destination='" مقصد "'"
نام سرویس یا شناسه منحصر‌به‌فرد دریافت‌کننده پیام.
.TP
.BI "arg0='" مقدار "'" ", " "arg1='" مقدار "'..."
تطبیق آرگومان‌های ابتدایی موجود در بدنه پیام با مقدار مشخص‌شده.
.SH "مثال‌ها (EXAMPLES)"
در اینجا مثالی از شنود اعلان‌ها و سیگنال‌های مانیتور تایپ گنوم آورده شده است:
.PP
.nf
dbus\-monitor "type='signal',sender='org.gnome.TypingMonitor',interface='org.gnome.TypingMonitor'"
.fi
.PP
پایش فراخوانی‌های متد در گذرگاه سیستم:
.PP
.nf
dbus\-monitor \-\-system "type='method_call'"
.fi
.PP
ذخیره پیام‌های گذرگاه سیستم در قالب فایل PCAP جهت باز کردن در Wireshark:
.PP
.nf
dbus\-monitor \-\-system \-\-pcap > dbus_capture.pcap
.fi
.SH "نویسندگان (AUTHORS)"
دستور \fBdbus\-monitor\fR توسط Philip Blundell نوشته شده است. حالت خروجی پروفایل‌سازی نیز توسط Olli Salli اضافه گردید.
.SH "گزارش باگ‌ها (BUGS)"
لطفاً گزارش‌های اشکال و باگ‌ها را به فهرست پستی D-Bus یا سامانه پیگیری اشکالات ارسال کنید:
.PP
.nf
<https://www.freedesktop.org/wiki/Software/dbus>
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR dbus\-daemon (1),
.BR dbus\-send (1)