.\" -*- coding: UTF-8 -*- .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .de IX .. .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .if n .ds AD l .\" .\" Required to disable full justification in groff 1.23.0. .\" ======================================================================== .\" .IX Title "ADDR2LINE 1" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ADDR2LINE 1 "1 مايو 2026" binutils\-2.46.0 "أدوات تطوير جنو" .if n .ad l .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .nh .SH الاسم addr2line \- تحويل العناوين أو رمز+إزاحة إلى أسماء ملفات وأرقام أسطر .SH موجز .IX Header موجز addr2line [\fB\-a\fP|\fB\-\-addresses\fP] [\fB\-b\fP \fIbfdname\fP|\fB\-\-target=\fP\fIbfdname\fP] [\fB\-C\fP|\fB\-\-demangle\fP[=\fIstyle\fP]] [\fB\-r\fP|\fB\-\-no\-recurse\-limit\fP] [\fB\-R\fP|\fB\-\-recurse\-limit\fP] [\fB\-e\fP \fIfilename\fP|\fB\-\-exe=\fP\fIfilename\fP] [\fB\-f\fP|\fB\-\-functions\fP] [\fB\-s\fP|\fB\-\-basename\fP] [\fB\-i\fP|\fB\-\-inlines\fP] [\fB\-p\fP|\fB\-\-pretty\-print\fP] [\fB\-j\fP|\fB\-\-section=\fP\fIname\fP] [\fB\-H\fP|\fB\-\-help\fP] [\fB\-V\fP|\fB\-\-version\fP] [addr addr ...] .SH الوصف .IX Header الوصف \&\fBaddr2line\fP يترجم العناوين أو رمز+إزاحة إلى أسماء ملفات وأرقام أسطر. عند إعطاء عنوان أو رمز+إزاحة في ملف تنفيذي أو إزاحة في مقطع من كائن قابل للنقل، يستخدم معلومات التصحيح لمعرفة اسم الملف ورقم السطر المرتبطين به. .PP يُحدد الملف التنفيذي أو الكائن القابل للنقل المراد استخدامه باستخدام الخيار \fB\-e\fP. الملف المبدئي هو \fIa.out\fP. يُحدد المقطع في الكائن القابل للنقل المراد استخدامه باستخدام الخيار \fB\-j\fP. .PP \&\fBaddr2line\fP له وضعان للتشغيل. .PP في الأول، تُحدد العناوين السداسية عشرية أو رمز+إزاحة في سطر الأوامر، ويعرض \fBaddr2line\fP اسم الملف ورقم السطر لكل عنوان. .PP في الثاني، يقرأ \fBaddr2line\fP العناوين السداسية عشرية أو رمز+إزاحة من المدخل القياسي، ويطبع اسم الملف ورقم السطر لكل عنوان على المخرج القياسي. في هذا الوضع، يمكن استخدام \fBaddr2line\fP في أنبوب لتحويل العناوين المختارة آليًا. .PP تنسيق المخرج هو \fBFILENAME:LINENO\fP. مبدئيًا، يُنشئ كل عنوان إدخال سطرًا واحدًا من المخرج. .PP يمكن لخيارين إنشاء أسطر إضافية قبل كل سطر \&\fBFILENAME:LINENO\fP (بهذا الترتيب). .PP إذا استُخدم الخيار \fB\-a\fP، يُعرض سطر يحتوي على عنوان الإدخال. .PP إذا استُخدم الخيار \fB\-f\fP، يُعرض سطر يحتوي على \&\fBFUNCTIONNAME\fP. هذا هو اسم الدالة التي تحتوي على العنوان. .PP يمكن لخيار واحد إنشاء أسطر إضافية بعد سطر \&\fBFILENAME:LINENO\fP. .PP إذا استُخدم الخيار \fB\-i\fP وكان الكود في العنوان المحدد موجودًا هناك بسبب التضمين الداخلي من قبل المترجم، تُعرض أسطر إضافية بعد ذلك. يُعرض سطر أو سطران إضافيان (إذا استُخدم الخيار \&\fB\-f\fP) لكل دالة مضمنة داخليًا. .PP بدلاً من ذلك، إذا استُخدم الخيار \fB\-p\fP، يُنشئ كل عنوان إدخال سطر مخرج واحد طويل يحتوي على العنوان واسم الدالة واسم الملف ورقم السطر. إذا استُخدم الخيار \&\fB\-i\fP أيضًا، فستُعرض أي دوال مضمنة داخليًا بنفس الطريقة، ولكن في أسطر منفصلة، وتُسبق بالنص \fB(inlined by)\fP. .PP إذا تعذر تحديد اسم الملف أو اسم الدالة، يطبع \&\fBaddr2line\fP علامتي استفهام في مكانهما. إذا تعذر تحديد رقم السطر، يطبع \fBaddr2line\fP 0. .PP عند استخدام رمز+إزاحة، تكون +إزاحة اختيارية، إلا عندما يكون الرمز غامضًا مع رقم سداسي عشري. يمكن أن تكون الرموز المحللة مشوهة أو غير مشوهة، باستثناء الرموز غير المشوهة التي تحتوي على + غير مسموح بها. .SH الخيارات .IX Header الخيارات الصيغتان الطويلة والقصيرة للخيارات، المعروضة هنا كبدائل، متكافئتان. .IP \fB\-a\fP 4 .IX Item \-a .PD 0 .IP \fB\-\-addresses\fP 4 .IX Item \-\-addresses .PD يعرض العنوان قبل اسم الدالة ومعلومات الملف ورقم السطر. يُطبع العنوان ببادئة \fB0x\fP لتحديده بسهولة. .IP "\fB\-b\fP \fIاسم_bfd\fP" 4 .IX Item "\-b bfdname" .PD 0 .IP \fB\-\-target=\fP\fIاسم_bfd\fP 4 .IX Item \-\-target=اسم_bfd .PD يُحدد أن تنسيق كود الكائن لملفات الكائن هو \&\fIbfdname\fP. .IP \fB\-C\fP 4 .IX Item \-C .PD 0 .IP \fB\-\-demangle[=\fP\fIstyle\fP\fB]\fP 4 .IX Item \-\-demangle[=نمط] .PD فك ترميز (\fIdemangle\fP) أسماء الرموز منخفضة المستوى إلى أسماء بمستوى المستخدم. بالإضافة إلى إزالة أي شرطة سفلية بادئة يضعها النظام، فإن هذا يجعل أسماء دوال C++‎ مقروءة. المجمّعات المختلفة لها أنماط ترميز مختلفة. يمكن استخدام وسيط نمط فك الترميز الاختياري لاختيار نمط فك ترميز مناسب لمجمّعك. .IP "\fB\-e\fP \fIاسم_الملف\fP" 4 .IX Item "\-e اسم_الملف" .PD 0 .IP \fB\-\-exe=\fP\fIاسم_الملف\fP 4 .IX Item \-\-exe=اسم_الملف .PD يحدد اسم الملف التنفيذي الذي ينبغي ترجمة العناوين له. الملف المبدئي هو \fIa.out\fP. .IP \fB\-f\fP 4 .IX Item \-f .PD 0 .IP \fB\-\-functions\fP 4 .IX Item \-\-functions .PD يعرض أسماء الدوال بالإضافة إلى معلومات اسم الملف ورقم السطر. .IP \fB\-s\fP 4 .IX Item \-s .PD 0 .IP \fB\-\-basenames\fP 4 .IX Item \-\-basenames .PD يعرض فقط القاعدة من كل اسم ملف. .IP \fB\-i\fP 4 .IX Item \-i .PD 0 .IP \fB\-\-inlines\fP 4 .IX Item \-\-inlines .PD إذا كان العنوان ينتمي إلى دالة تم تضمينها، فستُطبع معلومات المصدر لجميع النطاقات المحيطة رجوعًا إلى أول دالة غير مضمنة. على سبيل المثال، إذا قامت \f(CW\*(C`main\*(C'\fP بتضمين \&\f(CW\*(C`callee1\*(C'\fP التي تضمّن \f(CW\*(C`callee2\*(C'\fP، وكان العنوان من \&\f(CW\*(C`callee2\*(C'\fP، فستُطبع معلومات المصدر لكل من \f(CW\*(C`callee1\*(C'\fP و \f(CW\*(C`main\*(C'\fP). .IP \fB\-j\fP 4 .IX Item \-j .PD 0 .IP \fB\-\-section\fP 4 .IX Item \-\-section .PD يقرأ الإزاحات بالنسبة للقسم المحدد بدلاً من العناوين المطلقة. .IP \fB\-p\fP 4 .IX Item \-p .PD 0 .IP \fB\-\-pretty\-print\fP 4 .IX Item \-\-pretty\-print .PD يجعل المخرجات أكثر ودية للبشر: يُطبع كل موقع في سطر واحد. إذا تم تحديد الخيار \fB\-i\fP، فتُسبق أسطر جميع النطاقات المحيطة بـ \fB(مضمن بواسطة)\fP. .IP \fB\-r\fP 4 .IX Item \-r .PD 0 .IP \fB\-R\fP 4 .IX Item \-R .IP \fB\-\-recurse\-limit\fP 4 .IX Item \-\-recurse\-limit .IP \fB\-\-no\-recurse\-limit\fP 4 .IX Item \-\-no\-recurse\-limit .IP \fB\-\-recursion\-limit\fP 4 .IX Item \-\-recursion\-limit .IP \fB\-\-no\-recursion\-limit\fP 4 .IX Item \-\-no\-recursion\-limit .PD يمكن أو يعطل حداً لمقدار التكرار المنفذ أثناء فك تشويه السلاسل النصية. بما أن تنسيقات تشويه الأسماء تسمح بمستوى غير محدود من التكرار، فمن الممكن إنشاء سلاسل سيؤدي فك تشفيرها إلى استنفاد مساحة المكدس المتاحة على الجهاز المضيف، مما يتسبب في خطأ في الذاكرة. يحاول هذا الحد منع حدوث ذلك عن طريق تقييد التكرار بـ 2048 مستوى من التداخل. .Sp المبدئي هو تفعيل هذا الحد، لكن تعطيله قد يكون ضروريًا من أجل حل (demangle) الأسماء المعقدة حقًا. لاحظ مع ذلك أنه إذا عُطل حد العودية، فإن استنفاد المكدس وارد وأي تقارير عن أخطاء بشأن مثل هذا الحدث ستُرفض. .Sp الخيار \fB\-r\fP هو مرادف للخيار \&\fB\-\-no\-recurse\-limit\fP. الخيار \fB\-R\fP هو مرادف للخيار \fB\-\-recurse\-limit\fP. .Sp لاحظ أن هذا الخيار فعال فقط إذا تم تمكين الخيار \fB\-C\fP أو \&\fB\-\-demangle\fP. .IP \fB@\fP\fIالملف\fP 4 .IX Item @file اقرأ خيارات سطر الأوامر من \fIfile\fP. تُدرج الخيارات المقروءة مكان خيار @\fIfile\fP الأصلي. إذا كان \fIfile\fP غير موجود، أو لا يمكن قراءته، فسيُعامل الخيار حرفيًا ولن يُزال. .Sp تُفصل الخيارات في \fIfile\fP بمسافات فارغة. يمكن تضمين حرف مسافة فارغة في خيار ما عن طريق إحاطة الخيار بالكامل إما بعلامات اقتباس مفردة أو مزدوجة. يمكن تضمين أي حرف (بما في ذلك الشرطة المائلة العكسية) عن طريق سبق الحرف المراد تضمينه بشرطة مائلة عكسية. يمكن لـ \fIfile\fP نفسه أن يحتوي على خيارات @\fIfile\fP إضافية؛ وتُعالج أي خيارات من هذا القبيل بشكل متكرر (recursively). .SH "انظر أيضًا" .IX Header "انظر أيضًا" مدخلات المعلومات لـ \fIbinutils\fP. .SH "حقوق النسخ" .IX Header "حقوق النسخ" حقوق الطبع والنشر (c) لعام 1991\-2026 لمؤسسة البرمجيات الحرة، المحدودة. .PP يُمنح الإذن بنسخ وتوزيع و/أو تعديل هذا المستند بموجب شروط رخصة جنو للوثائق الحرة (GNU Free Documentation License)، الإصدار 1.3 أو أي إصدار لاحق تنشره مؤسسة البرمجيات الحرة؛ مع عدم وجود أقسام ثابتة، وبدون نصوص غلاف أمامي، وبدون نصوص غلاف خلفي. نُسخة من الرخصة مضمنة في القسم المعنون "GNU Free Documentation License". .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .