الاسم¶

gprof - يعرض بيانات تشكيلة مخطط الاستدعاء

موجز¶

gprof [ -[abcDhilLrsTvwxyz] ] [ -[ABCeEfFJnNOpPqQRStZ][name] ]
[ -I dirs ] [ -d[num] ] [ -k from/to ]
[ -m min-count ] [ -R map_file ] [ -t table-length ]
[ --[no-]annotated-source[=name] ]
[ --[no-]exec-counts[=name] ]
[ --[no-]flat-profile[=name] ] [ --[no-]graph[=name] ]
[ --[no-]time=name] [ --all-lines ] [ --brief ]
[ --debug[=level] ] [ --function-ordering ]
[ --file-ordering map_file ] [ --directory-path=dirs ]
[ --display-unused-functions ] [ --file-format=name ]
[ --file-info ] [ --help ] [ --line ] [ --inline-file-names ]
[ --min-count=n ] [ --no-static ] [ --print-path ]
[ --separate-files ] [ --static-call-graph ] [ --sum ]
[ --table-length=len ] [ --traditional ] [ --version ]
[ --width=n ] [ --ignore-non-functions ]
[ --demangle[=STYLE] ] [ --no-demangle ]
[--external-symbol-table=name]
[ image-file ] [ profile-file ... ]

الوصف¶

"gprof" يُنتج تشكيلة تنفيذ لبرامج C، أو Pascal، أو Fortran77. تُدمج تأثيرات الروتينات المستدعاة في تشكيلة كل مستدعٍ. تُؤخذ بيانات التشكيلة من ملف تشكيلة مخطط الاستدعاء (المبدئي gmon.out) الذي تُنشئه البرامج المجمعة بالخيار -pg لكل من "cc"، و "pc"، و "f77". يربط الخيار -pg أيضًا نسخًا من روتينات المكتبة المجمعة لأغراض التشكيلة. يقرأ "Gprof" ملف الكائن المعطى (المبدئي هو "a.out") ويؤسس العلاقة بين جدول رموزه وتشكيلة مخطط الاستدعاء من gmon.out. إذا حُدد أكثر من ملف تشكيلة واحد، يُظهر خرج "gprof" مجموع معلومات التشكيلة في ملفات التشكيلة المعطاة.

يحسب "Gprof" مقدار الوقت المستغرق في كل روتين. بعد ذلك، تُنشر هذه الأوقات عبر حواف مخطط الاستدعاء. تُكتشف الدورات، وتُجعل الاستدعاءات داخل الدورة تتشارك وقت الدورة.

تتوفر عدة أشكال للمخرجات من التحليل.

تُظهر التشكيلة المسطحة مقدار الوقت الذي قضاه برنامجك في كل دالة، وعدد المرات التي استُدعيت فيها تلك الدالة. إذا كنت تريد ببساطة معرفة الدوال التي تستهلك معظم الدورات، فسيُذكر ذلك بإيجاز هنا.

يُظهر مخطط الاستدعاء، لكل دالة، الدوال التي استدعتها، والدوال الأخرى التي استدعتها هي، وعدد المرات. يوجد أيضًا تقدير لمقدار الوقت الذي قُضي في الروتينات الفرعية لكل دالة. يمكن أن يقترح هذا أماكن قد تحاول فيها استبعاد استدعاءات الدوال التي تستهلك الكثير من الوقت.

قائمة المصدر المشروح هي نسخة من كود مصدر البرنامج، موسومة بعدد المرات التي نُفذ فيها كل سطر من البرنامج.

الخيارات¶

تحدد هذه الخيارات أي شكل من أشكال المخرجات المتعددة يجب أن ينتجها "gprof".

تأخذ العديد من هذه الخيارات symspec اختيارياً لتحديد الدوال التي سيتم تضمينها أو استبعادها. يمكن تحديد هذه الخيارات عدة مرات، مع symspecs مختلفة، لتضمين أو استبعاد مجموعات من الرموز.

تحديد أي من هذه الخيارات يتجاوز المبدئي (-p -q)، والذي يطبع تشكيلة مسطحة وتحليل مخطط استدعاء لجميع الدوال.

"-A[symspec]"

"--annotated-source[=symspec]"

يؤدي الخيار -A إلى قيام "gprof" بطباعة كود مصدر مشروح. إذا حُدد symspec، فسيُطبع الخرج فقط للرموز المطابقة.

"-b"

"--brief"

إذا أعطي الخيار -b، فلن يطبع "gprof" النصوص التوضيحية المسهبة التي تحاول شرح معنى جميع الحقول في الجداول. هذا مفيد إذا كنت تنوي طباعة المخرجات، أو سئمت من رؤية تلك النصوص.

"-B"

يؤدي الخيار -B إلى قيام "gprof" بطباعة تحليل مخطط الاستدعاء.

"-C[symspec]"

"--exec-counts[=symspec]"

يؤدي الخيار -C إلى قيام "gprof" بطباعة إحصاء للدوال وعدد مرات استدعاء كل منها. إذا حُدد symspec، فسيُطبع الإحصاء فقط للرموز المطابقة.

إذا كان ملف بيانات التشكيلة يحتوي على سجلات عدد الكتل البرمجية الأساسية، فإن تحديد الخيار -l، مع -C، سيؤدي إلى إحصاء وعرض أعداد تنفيذ الكتل البرمجية الأساسية.

"-i"

"--file-info"

يؤدي الخيار -i إلى قيام "gprof" بعرض معلومات ملخصة حول ملف (ملفات) بيانات التشكيلة ثم الخروج. يُعرض عدد سجلات المدرج التكراري، ومخطط الاستدعاء، وعدد الكتل البرمجية الأساسية.

"-I dirs"

"--directory-path=dirs"

يحدد الخيار -I قائمة بأدلة البحث للعثور على ملفات المصدر. يمكن أيضًا استخدام متغير البيئة GPROF_PATH لنقل هذه المعلومات. يُستخدم غالباً لمخرجات المصدر المشروح.

"-J[symspec]"

"--no-annotated-source[=symspec]"

يؤدي الخيار -J إلى عدم قيام "gprof" بطباعة كود مصدر مشروح. إذا حُدد symspec، فسيطبع "gprof" المصدر المشروح، ولكنه يستبعد الرموز المطابقة.

"-L"

"--print-path"

عادةً، تُطبع أسماء ملفات المصدر مع حذف مكون المسار. يؤدي الخيار -L إلى قيام "gprof" بطباعة المسار الكامل لأسماء ملفات المصدر، والذي يُحدد من معلومات التنقيح الرمزية في ملف الصورة ويكون نسبياً للدليل الذي استُدعي فيه المجمع.

"-p[symspec]"

"--flat-profile[=symspec]"

يؤدي الخيار -p إلى قيام "gprof" بطباعة تشكيلة مسطحة. إذا حُدد symspec، فسيُطبع التشكيلة المسطحة فقط للرموز المطابقة.

"-P[symspec]"

"--no-flat-profile[=symspec]"

يؤدي الخيار -P إلى قيام "gprof" بمنع طباعة التشكيلة المسطحة. إذا حُدد symspec، فسيطبع "gprof" تشكيلة مسطحة، ولكنه يستبعد الرموز المطابقة.

"-q[symspec]"

"--graph[=symspec]"

يؤدي الخيار -q إلى قيام "gprof" بطباعة تحليل مخطط الاستدعاء. إذا حُدد symspec، فسيُطبع مخطط الاستدعاء فقط للرموز المطابقة وأبنائها.

"-Q[symspec]"

"--no-graph[=symspec]"

يؤدي الخيار -Q إلى قيام "gprof" بمنع طباعة مخطط الاستدعاء. إذا حُدد symspec، فسيطبع "gprof" مخطط استدعاء، ولكنه يستبعد الرموز المطابقة.

"-t"

"--table-length=num"

يؤدي الخيار -t إلى سرد أكثر num أسطر مصدر نشاطًا في كل ملف مصدر عند تمكين تعليق المصدر. المبدئي هو 10.

"-y"

"--separate-files"

يؤثر هذا الخيار على مخرجات المصدر المشروح فقط. عادةً، يطبع "gprof" ملفات المصدر المشروحة إلى الخرج القياسي. إذا حُدد هذا الخيار، فسيتم توليد المصدر المشروح لملف باسم path/filename في الملف filename-ann. إذا كان نظام الملفات الأساسي سيقتطع filename-ann بحيث يكتب فوق filename الأصلي، فسيقوم "gprof" بتوليد المصدر المشروح في الملف filename.ann بدلاً من ذلك (إذا كان لاسم الملف الأصلي امتداد، فسيتم استبدال ذلك الامتداد بـ .ann).

"-Z[symspec]"

"--no-exec-counts[=symspec]"

يؤدي الخيار -Z إلى عدم قيام "gprof" بطباعة إحصاء للدوال وعدد مرات استدعاء كل منها. إذا حُدد symspec، فسيُطبع الإحصاء، ولكن سيتم استبعاد الرموز المطابقة.

"-r"

"--function-ordering"

يؤدي الخيار --function-ordering إلى قيام "gprof" بطباعة ترتيب دوال مقترح للبرنامج بناءً على بيانات التشكيلة. يقترح هذا الخيار ترتيبًا قد يحسن سلوك التصفح (paging)، و tlb، و الخبيئة (cache) للبرنامج على الأنظمة التي تدعم الترتيب العشوائي للدوال في ملف تنفيذي.

التفاصيل الدقيقة لكيفية إجبار الرابط على وضع الدوال في ترتيب معين تعتمد على النظام وهي خارج نطاق هذا الدليل.

"-R map_file"

"--file-ordering map_file"

يؤدي الخيار --file-ordering إلى قيام "gprof" بطباعة ترتيب سطر ربط .o مقترح للبرنامج بناءً على بيانات التشكيلة. يقترح هذا الخيار ترتيبًا قد يحسن سلوك التصفح، و tlb، و الخبيئة للبرنامج على الأنظمة التي لا تدعم الترتيب العشوائي للدوال في ملف تنفيذي.

يُنصح بشدة باستخدام المعامل -a مع هذا الخيار.

المعامل map_file هو مسار لملف يوفر تعيينات اسم الدالة إلى ملف الكائن. تنسيق الملف مشابه لمخرجات برنامج "nm".

        c-parse.o:00000000 T yyparse
        c-parse.o:00000004 C yyerrflag
        c-lang.o:00000000 T maybe_objc_method_name
        c-lang.o:00000000 T print_lang_statistics
        c-lang.o:00000000 T recognize_objc_keyword
        c-decl.o:00000000 T print_lang_identifier
        c-decl.o:00000000 T print_lang_type
        ...
    

لإنشاء map_file باستخدام جنو "nm"، اكتب أمراً مثل "nm --extern-only --defined-only -v --print-file-name program-name".

"-T"

"--traditional"

يؤدي الخيار -T إلى قيام "gprof" بطباعة مخرجاته بأسلوب BSD "التقليدي".

"-w width"

"--width=width"

يضبط عرض خطوط المخرجات إلى width. يُستخدم حالياً فقط عند طباعة فهرس الدوال في أسفل مخطط الاستدعاء.

"-x"

"--all-lines"

يؤثر هذا الخيار على مخرجات المصدر المشروح فقط. مبدئياً، يتم فقط شرح الأسطر في بداية الكتلة البرمجية الأساسية. إذا حُدد هذا الخيار، فسيتم شرح كل سطر في الكتلة الأساسية عن طريق تكرار شرح السطر الأول. هذا السلوك مشابه لـ -a في "tcov".

"--demangle[=style]"

"--no-demangle"

تتحكم هذه الخيارات في ما إذا كان يجب فك تشويه (demangle) أسماء رموز C++ عند طباعة المخرجات. المبدئي هو فك تشويه الرموز. يمكن استخدام الخيار "--no-demangle" لإيقاف فك التشويه. للمجمعات المختلفة أساليب تشويه مختلفة. يمكن استخدام معامل نمط فك التشويه الاختياري لاختيار نمط فك تشويه مناسب لمجمعك.

الملفات¶

"a.out"

قائمة الأسماء ومساحة النص.

"gmon.out"

مخطط الاستدعاء الديناميكي والتشكيلة.

"gmon.sum"

مخطط الاستدعاء الديناميكي والتشكيلة الملخصة.

العلل¶

تُعرض دقة المعاينة، لكنها تظل إحصائية في أحسن الأحوال. نفترض أن الوقت لكل تنفيذ لدالة يمكن التعبير عنه بالوقت الإجمالي للدالة مقسوماً على عدد مرات استدعاء الدالة. وبالتالي فإن الوقت المنشور عبر أقواس مخطط الاستدعاء إلى آباء الدالة يتناسب طردياً مع عدد مرات اجتياز ذلك القوس.

الآباء الذين لم يتم تشكيلهم بأنفسهم سيتم نشر وقت أبنائهم المشكلين إليهم، لكنهم سيظهرون وكأنهم استُدعوا تلقائياً في قائمة مخطط الاستدعاء، ولن يُنشر وقتهم بشكل أكبر. وبالمثل، فإن مقتنصي الإشارات (signal catchers)، على الرغم من تشكيلهم، سيظهرون وكأنهم تلقائيون (وإن كان لأسباب أكثر غموضاً). يجب أن يُنشر وقت أي أبناء مشكلين لمقتنصي الإشارات بشكل صحيح، ما لم يُستدع مقتنص الإشارة أثناء تنفيذ روتين التشكيلة، وفي هذه الحالة يُفقد كل شيء.

يجب أن يستدعي البرنامج المشكل "exit"(2) أو يعود بشكل طبيعي ليتم حفظ معلومات التشكيلة في الملف gmon.out.

انظر أيضًا¶

monitor(3)، و profil(2)، و cc(1)، و prof(1)، ومدخل Info لـ gprof.

"An Execution Profiler for Modular Programs"، بقلم S. Graham، P. Kessler، M. McKusick؛ Software - Practice and Experience، المجلد 13، ص 671-685، 1983.

"gprof: A Call Graph Execution Profiler"، بقلم S. Graham، P. Kessler، M. McKusick؛ Proceedings of the SIGPLAN '82 Symposium on Compiler Construction، SIGPLAN Notices، المجلد 17، العدد 6، ص 120-126، يونيو 1982.

حقوق النسخ¶

حقوق النشر (c) 1988-2025 مؤسسة البرمجيات الحرة، المحدودة.

يُمنح الإذن بنسخ وتوزيع و/أو تعديل هذا المستند بموجب شروط رخصة جنو للوثائق الحرة (GNU Free Documentation License)، الإصدار 1.3 أو أي إصدار لاحق تنشره مؤسسة البرمجيات الحرة؛ مع عدم وجود أقسام ثابتة، وبدون نصوص غلاف أمامي، وبدون نصوص غلاف خلفي. نُسخة من الرخصة مضمنة في القسم المعنون "GNU Free Documentation License".

ترجمة¶

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.