makepp_scanning - عبر الإنترنت في السحابة

برنامج:

اسم

makepp_scanning - كيف تتضمن اكتشافات makepp الملفات والاعتماديات المخفية الأخرى

الوصف

يمكن لـ Makepp تحديد تبعيات أو أهداف إضافية لأوامر معينة يعرفها
شيئا عن. هذا مهم بشكل خاص لتجميع C / C ++ ، حيث يكون أيضًا
عرضة للخطأ لسرد كل ملفات التضمين يدويًا التي يعتمد عليها ملف مصدر معين.
من خلال النظر إلى أمر الترجمة والملفات المصدر نفسها ، فإن makepp قادر على ذلك
تحديد ملفات الكائن التي تحتاج إلى إعادة بنائها بدقة عندما يتضمن بعضها تغييرات في الملف.

مثال: إعطاء قاعدة

foo.o: # عادةً٪ .o:٪ .c ، للتوضيح فقط
time -p / bin / libtool -bar / usr / bin / cc -c -I somewhere foo.c

يعرف makepp أنه يجب تخطي "time" و "libtool" وأن "cc" هو الأمر الفعلي
ليتم تحليلها هنا. إنها تفهم ذلك foo.c هو ملف الإدخال وبالتالي تبعية لـ
هذه القاعدة. علاوة على ذلك ، سيقوم بفحص هذا الملف بحثًا عن بيانات التضمين ، أيضًا في
دليل في مكان ما، لأنه فهم خيارات الأمر.

في الواقع ، هناك ثلاث خطوات لما يُعرف تاريخيًا باسم المسح:

1. يتم تقسيم إجراء القاعدة إلى أسطر (يتم احتساب سطور المتابعة على أنها واحدة). كل خط
(باستثناء الكتل البنائية و Perl) هو معجميا حلل كواحد أو أكثر من أوامر شل.
يتم التعرف على عمليات إعادة التوجيه كمدخلات أو مخرجات لهذه القاعدة. الكلمة الأولى لكل منهما
يتم البحث عن الأمر (مع جزء الدليل الخاص به ولكن ، إذا لم يتم العثور عليه ، مرة أخرى بدونه) إلى
العثور على محلل لها. تصبح هذه تبعيات اختيارية ، يتم بناؤها إن أمكن ،
ولكن يتم تجاهله إذا لم يتم العثور عليه ، لأن makepp لا يمكنه معرفة أي جزء من الأمر المعقد
في الواقع تشغيل.

يتم تحليل الأوامر الموجودة في الاقتباسات الخلفية ولكن لا يتم تنفيذها. (غالبًا ما يكون التنفيذ مهمًا ،
لكن هذا سيكون تدخلًا كبيرًا من قبل makepp.) إنه أسلوب أفضل لتجنبها.
بدلاً من ذلك ، اطلب من makepp تشغيل الأمر مرة واحدة على الأكثر عن طريق تعيينه بهذه الطريقة الخاصة:

XYZFLAGS ؛ = $ (shell pkg-config --cflags xyz)

يوجد حاليًا فئة ليكسر واحدة فقط تفهم بورن شل. إلى أفضل
التعامل مع C Shell أو "command.com" ، يمكن إنشاء الفئات الفرعية. ومع ذلك ، فإن بناء الجملة هو
مشابه بما يكفي لعدم ضمان ذلك. تواصل معنا إذا كنت تريد المساهمة أيضًا.

2. للأوامر المعروفة المقابلة أمر محلل (يشار إليه أيضًا باسم المحلل اللغوي)
يحلل الخيارات والحجج الهامة. المتاحة موصوفة أدناه.

حتى إذا لم يتم العثور على محلل متخصص ، فإن المحلل العام يجعل الأمر قابلاً للتنفيذ
أحد مدخلات هذه القاعدة. يمكنك تغيير ذلك باستخدام التبعيات - no-path- التنفيذية
خيار القيادة.

3. إذا تعرف المحلل اللغوي على أي ملفات إدخال ، فسيتم إرسالها إلى ملف الماسح الضوئي اختارها
محلل. يجد المزيد من المدخلات من خلال البحث عن "# تضمين" أو عبارات قابلة للمقارنة.

هذه هي الخطوة الأغلى. يتم تخزين جميع النتائج مؤقتًا لتجنب تكرارها
بلا داعى.

إذا اعتقد makepp أنه يقوم بتجميع مصدر C / C ++ ولكن لا يمكنه العثور على محلل ، فسوف يعطي
رسالة تحذير لإعلامك. هذا يعني عادة أنك دفنت أمر المترجم الخاص بك
عميق جدًا في العمل بحيث يتعذر على makepp العثور عليه. على سبيل المثال ، رأيت قواعد مثل هذه:

٪ .o:٪ .c
@ صدى تجميع $ <now؛ obscure_wrapper دول مجلس التعاون الخليجي -c $ <$ (CFLAGS) -o $ @

الكلمات الأولى من الإجراءات هنا هي "echo" و "obscure_wrapper" ، وهما موجودتان
لا توجد موزعات ، لذلك لن يقوم makepp بالبحث عن الملفات المضمنة في هذه الحالة. يمكنك تجاهل
أمر مسبوق بـ:

محلل التسجيل obscure_wrapper تخطي الكلمة

توثق الأقسام التالية الموزعات والماسحات الضوئية المضمنة. في الاسم يمكنك
استخدم "-" بالتبادل مع "_".

الماسحات الضوئية (الموزعون)

يجب اختيار الماسحات الضوئية المختلفة بواسطة محلل أوامر ، والذي يرد بين قوسين:

C / C ++ مجموعة (ج- تجميع ، تجميع دول مجلس التعاون الخليجي)
الماسح الضوئي C / C ++ ، يتعامل مع كلتا اللغتين بشكل غير مبالٍ. في الحقيقة إنه ينظر فقط إلى
عبارات المعالج المسبق ، لذلك يمكن استخدامها لعدد غير قليل من اللغات. المحلل اللغوي أن
التنشيط لديه متغير خاص للعديد من خيارات دول مجلس التعاون الخليجي ، والتي يتم اختيارها إذا كان
يتضمن اسم الأمر السلسلة "gcc" أو g ++. إذا كان المترجمون للغات أخرى مع C
يستخدم المعالج المسبق نفس الخيارات مثل مترجم C (على الأقل "-I") ثم يعمل هذا المحلل اللغوي
غرامة.

يبحث في أمر خيارات "-Idir" التي تحدد مسار التضمين أو خيارات "-Ldir"
تحديد مسار الارتباط. ثم يقوم بفحص أي ملفات مصدر بحثًا عن توجيهات "#include" ، و
يبحث أيضًا في سطر الأوامر لمعرفة ما إذا كان هناك أي ملفات مصدر أو مكتبات مذكورة
التي لم يتم سردها على أنها تبعيات. يتعرف على هؤلاء من خلال امتدادهم.

يعطي هذا الماسح رسالة تحذير إذا كانت الملفات المضمنة مع "#include" file.h "" ليست كذلك
تم العثور عليها ، أو لا يمكن بناؤها بواسطة makepp ، في مسار التضمين ، أو في الدليل الذي يحتوي على
الملف الذي يكون "# include" ing أو in / البيرة / تتضمن. لا يوجد تحذير إذا تم تضمين ملف
مع "# include "غير موجود. يفترض Makepp أنه موجود في بعض الأنظمة
الدليل الذي يعرفه المترجم ، وأن الملفات الموجودة في النظام تتضمن أدلة
لن يتغير.

بالإضافة إلى ذلك ، فإن الملفات بتنسيق / البيرة / تتضمن, / usr / local / include, / usr / X11R6 / تشمل، وأي دولة أخرى
لا يتم فحص الدليل غير القابل للكتابة لمعرفة ما يتضمنه. يفترض Makepp
أن هذه الملفات لن تتغير. (إذا كنت تعمل بجذر ، فإن اختبار قابلية الكتابة هو
تم إجراؤها باستخدام UID و GID للدليل الذي قمت بتشغيل makepp منه. هذا تجميع للغاية
برنامج كمستخدم عادي ثم إجراء "makepp install" لأن الجذر لن يتسبب في المزيد
الدلائل المراد مسحها ضوئيًا.)

هذا ماسح ضوئي بسيط إلى حد ما. سيشعر بالارتباك إذا فعلت أشياء مثل هذه:

#ifdef يشمل_هذا
# تضمين "this.h"
#endif

لأنه لا يعرف عن شروط المعالج المسبق. هذا عادة غير ضار. هو - هي
قد يتسبب في تصنيف ملفات إضافية إضافية على أنها تبعيات (تسبب أحيانًا ملفات
عمليات إعادة البناء غير الضرورية) ، أو قد يتسبب ذلك في تحذير makepp من أن ملف التضمين لم يكن كذلك
وجد. يمكنك إما تجاهل رسائل التحذير ، أو وضع ملف فارغ "this.h"
هناك لاغلاق makepp.

إذا كان المترجم الخاص بك يحمل اسمًا مضحكًا ، فيمكنك قول أي منهما

محلل التسجيل obscure_c_compiler c-compilation
Register-parser obscure_gcc_alias gcc-compilation

جزءا لا يتجزأ من SQL C / C ++ مجموعة (esql- تجميع)
هذه الأوامر ، التي تأتي مع قواعد البيانات المختلفة ، تُعالج الأقسام الخاصة في
خلاف ذلك C / C ++ - مثل المصادر ، وإنتاج رؤوس ومصادر C / C ++. يؤدي هذا إلى العثور على EXEC SQL
تضمين توجيهات "filename" أو $ INCLUDE "filename".

يتم التعرف على المعالجات الأولية التالية: Altibase APRE * C / C ++ (يفتح) ، CASEMaker DBMaker
(com.dmpcc) ، Firebird / InterBase (gpre) ، IBM DB2 (db2 تجميع مسبق db2 الإعدادية) و Informix
ESQL / C (إسكل) ، إنجرس (com.esqlc) ، ميمر (إسكل)، وحي (بروك) ، PostgreSQL (ecpg) & حديقة منزل
(ساحة). إذا لم يتم التعرف على المعالج الخاص بك ، يمكنك القول

محلل التسجيل obscure_esqlc_preprocessor esql-compilation

ومع ذلك ، سيتعامل هذا فقط مع النمط الشائع لـ Informix وغيره: وسيطات الأوامر
تنتهي بـ ".ec" هي الملفات المراد فحصها ، ويحدد "-I" مسار التضمين و EXEC SQL
تضمين التوجيهات بدون لاحقة احصل على إلحاق ".h".

جرعة كبيرة (جرعة كبيرة)
Swig (غلاف مبسط ومولد واجهة ، http://www.swig.org/) هو برنامج
يحول ملف رأس C / C ++ إلى وظائف الغلاف اللازمة لجعل التعليمات البرمجية الخاصة بك قابلة للاستدعاء
من مجموعة متنوعة من اللغات الأخرى ، مثل Perl و Python و Tcl و C # و Ruby و OCaml و
ربما البعض الآخر الذي لا أعرف عنه.

يفهم Makepp ويوزع سطر أوامر swig ، ويبحث عن خيارات "-I" و "-l".
يعرف أيضًا كيفية فحص ملفات تعريف واجهة swig (.i الملفات) تبحث عن ملفات
٪ include و٪ import وأيضًا "#include" إذا كان "-includeall" ساري المفعول.

إذا كان ل swig الخاص بك اسم مضحك ، يمكنك أن تقول

المحلل اللغوي التسجيل obscure_swig_alias swig

فيرا و فيريلوج (vcs_compilation)
إذا قمت بتصميم الأجهزة ، فسيكون هذا مفيدًا.

جاهل مغلفة (تخطي الكلمة ، صدَفَة)
يتعرف Makepp على كلمات الأوامر التالية وغيرها الكثير ويتخطىها
بشكل مناسب في بحثه عن الماسح الصحيح: "condor_compile" ، "distcc" ،
"ignore_error" ، "libtool" ، "noecho" "تنقية".

يوجد متغير لهذا الذي يجد الأوامر المتداخلة في "sh -c" command1 ؛
command2 '".

إذا كان لديك المزيد من هذه الأوامر ، يمكنك القول

أمر Register-parser تخطي الكلمة

ليبتول

Libtool هو نظام تجميع ذكي للغاية يبسط بشكل كبير عملية المشاركة
المكتبات عن طريق إخفاء جميع التفاصيل المعتمدة على النظام بعيدًا في نص برمجي. الوحيد
الصعوبة هي أن الملفات الثنائية للمكتبة لا يتم تخزينها فعليًا في نفس الدليل
كملف الإخراج - ينشئ libtool دليلًا فرعيًا ، ".libs" ، والذي يحتوي على ملحق
ملفات حقيقية. هذه ليست مشكلة في العادة ، ولكن على ميكيب أن يعرف أين هو الحقيقي
الثنائيات هي إذا كان سيتم ربطها من مستودع. في الوقت الحالي ، مكتبات libtool
(ملفات ".la") غير مرتبطة بالمستودعات ؛ يتم إعادة بنائها دائمًا إذا لزم الأمر.
أيضًا ، makepp في الوقت الحالي غير قادر على استخدام معلومات التبعية المخزنة
داخل ملف ".la" نفسه. نأمل أن يتغير هذا قريبًا.

قمع ال تفحص (لا يوجد)
في بعض الأحيان قد لا ترغب في تحليل قاعدة أو أمر معين. يمكنك إيقاف
التحليل وبالتالي المسح باستخدام

المحلل اللغوي للتسجيل لا شيء

المتعلقة OPTIONS

مسح سريع و المسح الذكية
تؤثر خيارات القاعدة ": quickscan" و ": smartscan" ، إن أمكن ، على طريقة الملفات
يتم فحصها.

في وضع ": quickscan" (الافتراضي) ، يُفترض أن جميع التوجيهات المتضمنة نشطة. هذا يسمح
لإجراء مسح ضوئي فعال للغاية.

في وضع ": smartscan" ، تتم محاولة تفسير وحدات الماكرو والتعبيرات بحيث
يتم تجاهل توجيهات التضمين غير النشطة. على سبيل المثال ، الملف القابل للتنفيذ الذي تم إنتاجه بواسطة
يجب تجميع برنامج C التالي ليس للاعتماد على foo.h:

#إذا 0
# تضمين "foo.h"
#endif
int main () {return 0؛ }

CUSTOM الماسحات الضوئية

يمكنك تحديد المحلل اللغوي الخاص بك إما في خيار قاعدة مثل ": parser foo" ، أو باستخدام
عبارات "register_parser" أو "register_command_parser".

في كلتا الحالتين ، كما هو موضح في "register_parser" ، يجب عليك هناك بشكل مباشر أو غير مباشر
(عبر فئة) حدد وظيفة تنشئ كائن محلل. هذا الكائن عادة
قم بإنشاء كائن ماسح ضوئي للملفات ، وقم بإطعامه بنتائجه من سطر الأوامر
خيارات. سيستدعي هذان الكائنان طرق "إضافة _ * _ التبعية" للمحلل
إعادة توجيه المعلومات إلى "Mpp :: Lexer :: add _ * _ التبعية" الأكثر تعقيدًا إلى حد ما
وظائف المرافق.

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

"undef"
معلومات الفحص غير قابلة للتخزين المؤقت ويجب إعادة حسابها في المرة القادمة التي يكون فيها هدف القاعدة
يحتاج إلى بنائه.

"p_none أو p_skip_word" أو "p_shell"
هذه في الواقع ثوابت رقمية ، والتي تطلب من المعجم أن يقوم بعمل هذه الثوابت
موزعي زائف.

أي مرجع ، على سبيل المثال "\ 1"
هذا يكافئ إرجاع كائن محلل للقاعدة "Mpp :: CommandParser"
class ، والتي ستجعل الأمر قابلاً للتنفيذ فقط في حد ذاته تبعية.

في معظم الحالات ، يجب أن تقوم الكائنات من النوع "Mpp :: CommandParser" بإنشاء كائن واحد على الأقل
من نوع "Mpp :: Scanner". الفئة الأساسية "Mpp :: Scanner" تهتم بالتمييز
بين quickscan و smartscan. لاحظ أن سلوك "Mpp :: Scanner" يمكن تمييزه بشكل ملحوظ
متأثرًا بهذا التمييز ، لكن يجب أن يكون ذلك شفافًا للفئة المشتقة إذا كانت كذلك
حسن التشكيل. يجب اختبار فئات "Mpp :: Scanner" المشتقة الجديدة في كلا الوضعين.

إذا قمت بكتابة فئة "Mpp :: Scanner" الخاصة بك ، فيجب عليك أيضًا أن تبني قرار إعادة المسح
على معلومات البناء "RESCAN". يتم تعيين هذا عن طريق "makeppreplay" بعد توقيع الملفات بدون
يتم المسح. لذلك على الرغم من أن التوقيعات متسقة ، لا يزال من الضروري إعادة الفحص. لو
يستخدم "Mpp :: Scanner" طريقة "scan_file1" الموروثة ، ربما تكون بخير.

لمزيد من التفاصيل ، راجع وثائق الفصل المعني. للحصول على أمثلة ، انظر
"Mpp :: CommandParser :: Gcc" و "Mpp :: CommandParser :: Vcs". انظر إلى وظائف "p_" في
MP / Subs.pm التي يتم تسميتها باسم "مصنع" عند تحميلها.

Caching الماسح الضوئي info
إذا كانت جميع الآثار الجانبية المهمة للماسح الضوئي قد تأثرت من خلال استدعاءات للطرق
من الفئة الأساسية "Mpp :: CommandParser" ، ثم يمكن تخزين هذه الآثار الجانبية مؤقتًا في الإنشاء
info ، بحيث يمكن تشغيلها من خلال استدعاء لاحق لـ makepp بدون
القيام بكل أعمال المسح المكلفة. يمكن أن يوفر هذا قدرًا كبيرًا من الوقت ، خاصة في ملفات
وضع smartscan.

إذا كان للماسح آثار جانبية مهمة أخرى ، فيجب أن يطلق على كائن "القاعدة"
طريقة mark_scaninfo_uncacheable. خلاف ذلك ، تم استرداد معلومات الماسح الضوئي من البناء
قد تكون المعلومات غير دقيقة ، مما قد يتسبب في أن تكون نتيجة البناء غير صحيحة. هذه الطريقة
يتم استدعاؤها تلقائيًا عندما لا تُرجع قيمة من تجزئة المحللون٪ كائنًا من النوع
"Mpp :: CommandParser" ، أو عند تحديد المحلل اللغوي بخيار قاعدة و "p_ *"
لا يُرجع الروتين كائنًا من النوع "Mpp :: CommandParser".

يتم إبطال معلومات المسح المخزنة مؤقتًا باستخدام معايير مشابهة لتلك المستخدمة لتحديد متى
الهدف قديم. وبالمثل ، يمكن استرجاعها من مستودع باستخدام
معايير مماثلة لتلك المستخدمة لتحديد متى يمكن ربط هدف من أ
مستودع.

يمكنك إجبار makepp على تجاهل معلومات الماسح الضوئي المخزنة مؤقتًا باستخدام الخيار "--force-rescan".
يكون هذا مفيدًا عندما يكون الماسح الضوئي المعطل قد تسبب في تخزين معلومات الماسح الضوئي غير الصحيحة مؤقتًا.

Ad خاص الماسح الضوئي
غالبًا ما يكون لديك ملف واحد أو عدد قليل من الملفات التي تحتوي على معلومات التبعية. لم تكن
تريد كتابة هذا في ملف makefile بشكل متكرر (حيث يؤدي التكرار لاحقًا إلى
التناقضات عند نسيان أحد التحديثات). لكنك أيضًا لا تريد كتابة ملف
MPP :: الماسح الضوئي؟ كحل بديل ، يمكنك إنشاء ملف تضمين سريعًا. على سبيل المثال
كيو تي لديها .qrc الملفات التي يمكن أن تبدو مثل:



abc
xyz


إذا التزمت بالتخطيط أعلاه ، يمكنك تحويل الخطوط ذات الصلة إلى makepp
تضمين الملف ، والذي يتم إنشاؤه تلقائيًا من خلال تضمينه.

٪ .qrc.makepp:٪ .qrc
& grep 's! \ n! $ (الجذعية) .cc :! || س! * ! ! && س! \ن!!' $ (إدخال) -o $ (إخراج)

include $ (wildcard * .qrc) # .makepp يتم إلحاقها تلقائيًا

يتم تقديم العديد من المتغيرات في كتاب الطبخ. العيب هو أن تبدأ
بناء أثناء قراءة makefile. لذلك لن يكون خيار الأمر --loop مفيدًا جدًا
في التكرار الأول.

استخدم makepp_scanning عبر الإنترنت باستخدام خدمات onworks.net