perf-buildid-cache -
مدیریت
حافظهٔ
نهان build-id.
perf buildid-cache <options>
این دستور
حافظهٔ
نهان build-id را
مدیریت
می‌کند. این
ابزار
می‌تواند
فایل‌ها را
به/از
حافظهٔ
نهان
اضافه،
حذف،
به‌روزرسانی
و پاکسازی (purge)
کند. در
آینده
همچنین
باید
بتواند حد
بالای فضای
مورد
استفاده
توسط
حافظهٔ
نهان و غیره
را تعیین
کند. این
دستور
همچنین
باینری هدف
را برای SDT
(ردیابی
ایستا
تعریف‌شده
یا Statically Defined Tracing)
پویش کرده و
آن را به
همراه buildid-cache
ثبت
می‌کند، که
توسط perf-probe
استفاده
خواهد شد.
برای
جزئیات
بیشتر، perf-probe(1)
را ببینید.
-a, --add=
افزودن
فایل
مشخص‌شده
به حافظهٔ
نهان.
-f, --force
بدون
اعتراض،
انجام بده
(اجبار در
انجام
عملیات).
-k, --kcore
افزودن
فایل kcore
مشخص‌شده
به حافظهٔ
نهان. برای
میزبان
فعلی، این
فایل /proc/kcore است
که برای
خواندن
نیاز به
دسترسی‌های
ریشه (root) دارد.
توجه داشته
باشید که
اجرای perf buildid-cache
با کاربر
ریشه ممکن
است حافظهٔ
نهان build-id
کاربر ریشه
را
به‌روزرسانی
کند، نه
حافظهٔ
کاربر عادی
را. از
گزینهٔ -v
برای
مشاهدهٔ
محل ایجاد
فایل
استفاده
کنید. توجه
داشته
باشید که
فایل
رونوشت‌شده
فقط شامل
بخش‌های کد
است، نه کل
تصویر core.
همچنین
توجه داشته
باشید که
فایل‌های
«kallsyms» و «modules»
نیز باید در
همان
دایرکتوری
باشند و
آن‌ها نیز
رونوشت
می‌شوند. هر
۳ فایل فقط
با مجوزهای
خواندن
برای کاربر
ریشه ایجاد
می‌شوند.
اگر از پیش
یک kcore در
حافظهٔ
نهان (با
همان build-id) وجود
داشته باشد
که همان
ماژول‌ها
را در همان
آدرس‌ها
داشته
باشد، kcore
اضافه
نخواهد شد.
از گزینهٔ -v
برای بررسی
اینکه آیا
در عمل
رونوشتی از
kcore گرفته شده
است یا خیر
استفاده
کنید.
-r, --remove=
حذف
باینری
کش‌شده‌ای
که همان build-id
فایل
مشخص‌شده
را دارد از
حافظهٔ
نهان.
-p, --purge=
پاکسازی
تمام
باینری‌های
کش‌شده از
جمله
حافظه‌های
نهان
قدیمی‌تری
که مسیر
مشخص‌شده
را دارند از
حافظهٔ
نهان.
-P, --purge-all
پاکسازی
تمام
باینری‌های
کش‌شده. این
کار کل
حافظهٔ
نهان را
خالی
می‌کند.
-M, --missing=
فهرست
کردن build idهای
ناموجود در
حافظهٔ
نهان برای
فایل
مشخص‌شده.
-u, --update=
به‌روزرسانی
فایل
مشخص‌شده
در حافظهٔ
نهان. توجه
داشته
باشید که
این گزینه
مدخل‌های
قدیمی‌تر
را حذف
نمی‌کند،
زیرا ممکن
است هنوز
برای
حاشیه‌نویسی
(annotating) داده‌های
perf.data قدیمی (یا
از راه دور)
مورد نیاز
باشند. تنها
در صورتی که
حافظهٔ
نهانی
دقیقاً با
همان build-id وجود
داشته
باشد، با
مورد جدید
جایگزین
می‌شود. از
این گزینه
می‌توان
برای
به‌روزرسانی
kallsyms و dso هسته به
vmlinux به منظور
پشتیبانی
از
حاشیه‌نویسی
استفاده
کرد.
-l, --list
فهرست
کردن تمام
باینری‌های
معتبر از
حافظهٔ
نهان.
-v, --verbose
نمایش
جزئیات
بیشتر.
--target-ns=PID: دریافت
اطلاعات mount namespace
از PID هدف. این
گزینه
هنگام
ایجاد uprobe
برای
فرایندی
استفاده
می‌شود که
در یک mount namespace
متفاوت از
ابزار perf(1)
قرار دارد.
--debuginfod[=URLs]
مشخص
کردن نشانی
debuginfod مورد
استفاده
هنگام
بازیابی
باینری‌های
perf.data؛ این
گزینه از
همان نحو
متغیر DEBUGINFOD_URLS
پیروی
می‌کند،
مانند:
buildid-cache.debuginfod=http://192.168.122.174:8002
اگر URLs مشخص نشده باشد، از مقدار متغیر محیطی
سیستمی DEBUGINFOD_URLS استفاده می‌شود.
