'\" t
.\"     Title: readprofile
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: إدارة النظام
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "READPROFILE" "8" "2026-05-18" "util\-linux 2.42.1" "إدارة النظام"
.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 "الاسم"
readprofile \- يقرأ معلومات تشكيلة النواة
.SH "موجز"
.sp
\fBreadprofile\fP [خيارات]
.SH "الإصدارة"
.sp
توثق صفحة الدليل هذه الإصدارة 2.0 من البرنامج.
.SH "الوصف"
.sp
يستخدم الأمر \fBreadprofile\fP معلومات \fI/proc/profile\fP لطباعة بيانات ascii على المخرج القياسي. نُظم المخرج في ثلاثة أعمدة: الأول هو عدد تكتكات الساعة، والثاني هو اسم دالة C في النواة حيث حدثت تلك التكتكات العديدة، والثالث هو \f(CRالحمل\fP المُطبع للإجراء، ومحسوب كنسبة بين عدد التكتكات وطول الإجراء. مُلئ المخرج بفراغات لتسهيل القراءة.
.sp
This utility is a diagnostic tool and is not designed or intended for use in security\-sensitive contexts (e.g., setuid, setgid, sudo, or similar privilege\-elevation scenarios). It is installed without any special permissions.
.SH "الخيارات"
.sp
\fB\-a\fP، \fB\-\-all\fP
.RS 4
اطبع كل الرموز في ملف الخارطة. مبدئيًا، لا تُطبع الإجراءات ذات التكتكات المُبلغ عنها.
.RE
.sp
\fB\-b\fP، \fB\-\-histbin\fP
.RS 4
اطبع أعداد سلال المدرج التكراري الفردية.
.RE
.sp
\fB\-i\fP، \fB\-\-info\fP
.RS 4
معلومات. يجعل هذا \fBreadprofile\fP يطبع فقط خطوة التشكيلة المستخدمة من قبل النواة. خطوة التشكيلة هي دقة ذاكرة التشكيلة الوسيطة، وتُختار أثناء ضبط النواة (من خلال \fBmake config\fP)، أو في سطر أوامر النواة. إذا استُخدم مفتاح \fB\-t\fP (المقتضب) مع \fB\-i\fP فسيُطبع الرقم العشري فقط.
.RE
.sp
\fB\-m\fP، \fB\-\-mapfile\fP \fImapfile\fP
.RS 4
يحدد ملف خريطة (mapfile)، والذي يكون مبدئياً \fI/boot/System.map\fP. يجب عليك تحديد ملف الخريطة في سطر الأوامر إذا لم تكن نواتك الحالية هي الأخيرة التي ترجمتها، أو إذا كنت تحتفظ بـ System.map في مكان آخر. إذا انتهى اسم ملف الخريطة بـ ‎\fI.gz\fP‎، فإنه يُفك ضغطه تلقائياً.
.RE
.sp
\fB\-n\fP, \fB\-\-no\-auto\fP
.RS 4
يعطل الاكتشاف الآلي لترتيب البايتات.
.RE
.sp
\fB\-M\fP، \fB\-\-multiplier\fP \fImultiplier\fP
.RS 4
في بعض البنيات، يمكن تغيير التردد الذي ترسل به النواة مقاطعات التشكيلة (profiling) إلى كل معالج. يتيح لك هذا الخيار ضبط التردد، كمضاعف لتردد ساعة النظام، HZ. أسقطت نواة لينكس 2.6.16 دعم المضاعف لمعظم الأنظمة. يعيد هذا الخيار أيضاً ضبط خبيئة التشكيلة، ويتطلب صلاحيات المستخدم الخارق.
.RE
.sp
\fB\-p\fP، \fB\-\-profile\fP \fIpro\-file\fP
.RS 4
حدد خبيئة تشكيلة مختلفة، وهي مبدئياً \fI/proc/profile\fP. استخدام تشكيلة (profile) مختلفة مفيد إذا أردت \*(Aqتجميد\*(Aq تشكيلة النواة في وقت ما وقراءتها لاحقاً. يمكن نسخ ملف \fI/proc/profile\fP باستخدام \fBcat\fP(1) أو \fBcp\fP(1). لم يعد هناك دعم لخبايأ التشكيلة المضغوطة، كما كان في \fBreadprofile\-1.1\fP، لأن البرنامج يحتاج لمعرفة حجم الخبيئة مسبقاً.
.RE
.sp
\fB\-r\fP، \fB\-\-reset\fP
.RS 4
Reset the profiling buffer. This can only be invoked by root, because \fI/proc/profile\fP is readable by everybody but writable only by the superuser.
.RE
.sp
\fB\-s, \-\-counters\fP
.RS 4
اطبع العدادات الفردية داخل الدوال.
.RE
.sp
\fB\-v\fP، \fB\-\-verbose\fP
.RS 4
مُطوّل. نُظم المخرج في أربعة أعمدة ومُلئ بالفراغات. العمود الأول هو عنوان RAM لدالة النواة، والثاني هو اسم الدالة، والثالث هو عدد تكتكات الساعة والأخير هو الحمل المُطبع.
.RE
.sp
\fB\-h\fP، \fB\-\-help\fP
.RS 4
اعرض نص المساعدة ثم اخرج.
.RE
.sp
\fB\-V\fP، \fB\-\-version\fP
.RS 4
اعرض الإصدار واخرج.
.RE
.SH "الملفات"
.sp
\fI/proc/profile\fP
.RS 4
لقطة ثنائية لذاكرة التشكيلة الوسيطة.
.RE
.sp
\fI/usr/src/linux/System.map\fP
.RS 4
جدول الرموز للنواة.
.RE
.sp
\fI/usr/src/linux/*\fP
.RS 4
البرنامج الذي تُجرى تشكيلته :\-)
.RE
.SH "العلل"
.sp
\fBreadprofile\fP يعمل فقط مع النواة 1.3.x أو الأحدث، لأن \fI/proc/profile\fP تغير في الخطوة من 1.2 إلى 1.3.
.sp
يعمل هذا البرنامج فقط مع نويات ELF. التغيير لنويات a.out بسيط، وتُرك كتمرين لمستخدم a.out.
.sp
لتمكين التشكيلة، يجب إعادة تشغيل النواة، لعدم توفر وحدة تشكيلة، ولن يكون بناؤها سهلاً. لتمكين التشكيلة، يمكنك تحديد \fBprofile\fP=\fI2\fP (أو رقماً آخر) في سطر أوامر النواة. الرقم الذي تحدده هو أس العدد اثنين المستخدم كخطوة للتشكيلة.
.sp
تُعطل التشكيلة عند تثبيط المقاطعات. وهذا يعني أن العديد من تكات التشكيلة تحدث عند إعادة تمكين المقاطعات. احذر من المعلومات المضللة.
.SH "مثال"
.sp
تصفح خبيئة التشكيلة مرتبة حسب تكات الساعة:
.sp
.if n .RS 4
.nf
.fam C
   readprofile | sort \-nr | less
.fam
.fi
.if n .RE
.sp
اطبع أكثر 20 إجراءً حملاً:
.sp
.if n .RS 4
.nf
.fam C
   readprofile | sort \-nr +2 | head \-20
.fam
.fi
.if n .RE
.sp
اطبع تشكيلة نظام الملفات فقط:
.sp
.if n .RS 4
.nf
.fam C
   readprofile | grep _ext2
.fam
.fi
.if n .RE
.sp
انظر إلى جميع معلومات النواة، مع عناوين الذاكرة (RAM):
.sp
.if n .RS 4
.nf
.fam C
   readprofile \-av | less
.fam
.fi
.if n .RE
.sp
تصفح خبيئة تشكيلة \*(Aqمجمدة\*(Aq لنواة غير الحالية:
.sp
.if n .RS 4
.nf
.fam C
   readprofile \-p ~/profile.freeze \-m /zImage.map.gz
.fam
.fi
.if n .RE
.sp
اطلب التشكيلة بتردد 2 كيلو هرتز لكل معالج، وأعد ضبط خبيئة التشكيلة:
.sp
.if n .RS 4
.nf
.fam C
   readprofile \-M 20
.fam
.fi
.if n .RE
.SH "التبليغ عن الأخطاء"
.sp
لتقارير العِلل، استخدم \c
.URL "https://github.com/util\-linux/util\-linux/issues" "مُتتبع المشكلات" "."
.SH "التوفر"
.sp
الأمر \fBreadprofile\fP جزء من حزمة util\-linux التي يمكن تنزيلها من \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "أرشيف نواة لينكس" "."