نام (NAME)

opensnoop.bt - ردیابی فراخوانی‌های سیستمی open()، openat() و openat2() با استفاده از bpftrace/eBPF

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

opensnoop.bt -- [--depth=<N>] [--errname]

توضیحات (DESCRIPTION)

ابزار opensnoop فراخوانی‌های سیستمی open()، openat() و openat2() را ردیابی می‌کند و نشان می‌دهد کدام فرآیندها در تلاش برای باز کردن کدام پرونده‌ها هستند. این ابزار می‌تواند برای تعیین موقعیت پرونده‌های پیکربندی و لاگ، یا عیب‌یابی برنامه‌هایی که با شکست مواجه می‌شوند، به‌ویژه در هنگام راه‌اندازی، مفید باشد.

این ابزار از طریق ردیابی نقطه ردیابی (tracepoint) فراخوانی‌های سیستمی open()، openat() و openat2() کار می‌کند.

از آنجا که این ابزار از BPF استفاده می‌کند، تنها کاربر ریشه (root) می‌تواند از آن استفاده کند.

گزینه‌ها (OPTIONS)

--depth=<N>: برای تنظیم حداکثر عمق مسیر پشتیبانی‌شده استفاده می‌شود، مقدار پیش‌فرض ۳۵ است.
--errname: نمایش پیام خطا به‌جای errno.

پیش‌نیازها (REQUIREMENTS)

CONFIG_BPF و bcc.

مثال‌ها (EXAMPLES)

ردیابی تمام فراخوانی‌های سیستمی open()، openat() و openat2():: # opensnoop.bt

فیلدها (FIELDS)

PID: شناسه فرآیند (Process ID)
COMM: نام فرآیند
FD: توصیف‌کننده پرونده (در صورت موفقیت)، یا -1 (در صورت شکست)
ERR: شماره خطا (به errno.h سیستم مراجعه کنید)
PATH: مسیر بازگشایی (Open path)

بار پردازشی (OVERHEAD)

این ابزار نقطه ردیابی open را ردیابی کرده و برای هر رویداد خروجی را چاپ می‌کند. از آنجا که نرخ این رویدادها معمولاً کم انتظار می‌رود (کمتر از ۱۰۰۰ در ثانیه)، بار پردازشی نیز ناچیز برآورد می‌شود. اگر برنامه‌ای دارید که با نرخ بالایی ()open را فراخوانی می‌کند، پیش از استفاده بار پردازشی را آزمایش کرده و بررسی نمایید.

منبع (SOURCE)

این ابزار برگرفته از bpftrace است.

: https://github.com/bpftrace/bpftrace

همچنین در توزیع bpftrace به فایل همراه _examples.txt که شامل نمونه‌های استفاده، خروجی و توضیحات این ابزار است مراجعه کنید.

این یک نسخه bpftrace از ابزار bcc با همین نام است. ابزار bcc ممکن است گزینه‌ها و سفارشی‌سازی‌های بیشتری ارائه دهد.

: https://github.com/iovisor/bcc

سیستم‌عامل (OS)

Linux

پایداری (STABILITY)

ناپایدار - در حال توسعه.

نویسندگان (AUTHORS)

Brendan Gregg, Rong Tao <rongtao@cestc.cn>

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

statsnoop.bt(8), execsnoop.bt(8)