'\" t
.\"     Title: perf-buildid-cache
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 09/04/2026
.\"    Manual: perf Manual
.\"    Source: perf
.\"  Language: English
.\"
.TH "PERF\-BUILDID\-CACHE" "1" "09/04/2026" "perf" "perf Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
perf-buildid-cache \- مدیریت حافظهٔ نهان build\-id\&.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIperf buildid\-cache <options>\fR
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور حافظهٔ نهان build\-id را مدیریت می‌کند\&. این ابزار می‌تواند فایل‌ها را به/از حافظهٔ نهان اضافه، حذف، به‌روزرسانی و پاکسازی (purge) کند\&. در آینده همچنین باید بتواند حد بالای فضای مورد استفاده توسط حافظهٔ نهان و غیره را تعیین کند\&. این دستور همچنین باینری هدف را برای SDT (ردیابی ایستا تعریف‌شده یا Statically Defined Tracing) پویش کرده و آن را به همراه buildid\-cache ثبت می‌کند، که توسط perf\-probe استفاده خواهد شد\&. برای جزئیات بیشتر، \fBperf-probe\fR(1) را ببینید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-a, \-\-add=
.RS 4
افزودن فایل مشخص‌شده به حافظهٔ نهان\&.
.RE
.PP
\-f, \-\-force
.RS 4
بدون اعتراض، انجام بده (اجبار در انجام عملیات)\&.
.RE
.PP
\-k, \-\-kcore
.RS 4
افزودن فایل kcore مشخص‌شده به حافظهٔ نهان\&. برای میزبان فعلی، این فایل /proc/kcore است که برای خواندن نیاز به دسترسی‌های ریشه (root) دارد\&. توجه داشته باشید که اجرای
\fIperf buildid\-cache\fR
با کاربر ریشه ممکن است حافظهٔ نهان build\-id کاربر ریشه را به‌روزرسانی کند، نه حافظهٔ کاربر عادی را\&. از گزینهٔ \-v برای مشاهدهٔ محل ایجاد فایل استفاده کنید\&. توجه داشته باشید که فایل رونوشت‌شده فقط شامل بخش‌های کد است، نه کل تصویر core\&. همچنین توجه داشته باشید که فایل‌های «kallsyms» و «modules» نیز باید در همان دایرکتوری باشند و آن‌ها نیز رونوشت می‌شوند\&. هر ۳ فایل فقط با مجوزهای خواندن برای کاربر ریشه ایجاد می‌شوند\&. اگر از پیش یک kcore در حافظهٔ نهان (با همان build\-id) وجود داشته باشد که همان ماژول‌ها را در همان آدرس‌ها داشته باشد، kcore اضافه نخواهد شد\&. از گزینهٔ \-v برای بررسی اینکه آیا در عمل رونوشتی از kcore گرفته شده است یا خیر استفاده کنید\&.
.RE
.PP
\-r, \-\-remove=
.RS 4
حذف باینری کش‌شده‌ای که همان build\-id فایل مشخص‌شده را دارد از حافظهٔ نهان\&.
.RE
.PP
\-p, \-\-purge=
.RS 4
پاکسازی تمام باینری‌های کش‌شده از جمله حافظه‌های نهان قدیمی‌تری که مسیر مشخص‌شده را دارند از حافظهٔ نهان\&.
.RE
.PP
\-P, \-\-purge\-all
.RS 4
پاکسازی تمام باینری‌های کش‌شده\&. این کار کل حافظهٔ نهان را خالی می‌کند\&.
.RE
.PP
\-M, \-\-missing=
.RS 4
فهرست کردن build idهای ناموجود در حافظهٔ نهان برای فایل مشخص‌شده\&.
.RE
.PP
\-u, \-\-update=
.RS 4
به‌روزرسانی فایل مشخص‌شده در حافظهٔ نهان\&. توجه داشته باشید که این گزینه مدخل‌های قدیمی‌تر را حذف نمی‌کند، زیرا ممکن است هنوز برای حاشیه‌نویسی (annotating) داده‌های perf\&.data قدیمی (یا از راه دور) مورد نیاز باشند\&. تنها در صورتی که حافظهٔ نهانی دقیقاً با همان build\-id وجود داشته باشد، با مورد جدید جایگزین می‌شود\&. از این گزینه می‌توان برای به‌روزرسانی kallsyms و dso هسته به vmlinux به منظور پشتیبانی از حاشیه‌نویسی استفاده کرد\&.
.RE
.PP
\-l, \-\-list
.RS 4
فهرست کردن تمام باینری‌های معتبر از حافظهٔ نهان\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
نمایش جزئیات بیشتر\&.
.RE
.sp
\-\-target\-ns=PID: دریافت اطلاعات mount namespace از PID هدف\&. این گزینه هنگام ایجاد uprobe برای فرایندی استفاده می‌شود که در یک mount namespace متفاوت از ابزار perf(1) قرار دارد\&.
.PP
\-\-debuginfod[=URLs]
.RS 4
مشخص کردن نشانی debuginfod مورد استفاده هنگام بازیابی باینری‌های perf\&.data؛ این گزینه از همان نحو متغیر DEBUGINFOD_URLS پیروی می‌کند، مانند:
.sp
.if n \{\
.RS 4
.\}
.nf
buildid\-cache\&.debuginfod=http://192\&.168\&.122\&.174:8002
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
اگر URLs مشخص نشده باشد، از مقدار متغیر محیطی
سیستمی DEBUGINFOD_URLS استفاده می‌شود\&.
.fi
.if n \{\
.RE
.\}
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBperf-record\fR(1), \fBperf-report\fR(1), \fBperf-buildid-list\fR(1)