अबी-अनुपालन-परीक्षक

कार्यक्रम:

नाम

abi-compliance-checker - साझा C/C++ लाइब्रेरी की ABI संगतता की तुलना करने के लिए उपकरण
संस्करणों

वर्णन

नाम:
एबीआई कंप्लायंस चेकर (अबी-कंप्लायंस-चेकर) a . की पश्चगामी संगतता की जाँच करें
सी/सी++ लाइब्रेरी एपीआई

विवरण:
ABI कंप्लायंस चेकर (ABICC) बैकवर्ड बाइनरी की जाँच के लिए एक उपकरण है और
साझा सी/सी++ लाइब्रेरी की स्रोत-स्तरीय संगतता। टूल हेडर फाइलों की जांच करता है
और पुराने और नए संस्करणों के साझा पुस्तकालय (*.so) और एपीआई में परिवर्तनों का विश्लेषण करते हैं और
ABI (ABI=API+compiler ABI) जो बाइनरी और/या स्रोत-स्तरीय संगतता को तोड़ सकता है:
कॉलिंग स्टैक में परिवर्तन, वी-टेबल परिवर्तन, हटाए गए प्रतीक, नामित फ़ील्ड इत्यादि।
बाइनरी असंगति के परिणामस्वरूप अनुप्रयोगों का क्रैश या गलत व्यवहार हो सकता है
पुस्तकालय के पुराने संस्करण के साथ बनाया गया है यदि वे एक नए पर चलते हैं। स्रोत
असंगति के परिणामस्वरूप नए पुस्तकालय संस्करण के साथ पुनर्संकलन त्रुटियां हो सकती हैं।

उपकरण सॉफ्टवेयर पुस्तकालयों के डेवलपर्स और के अनुरक्षकों के लिए अभिप्रेत है
ऑपरेटिंग सिस्टम जो पश्च संगतता सुनिश्चित करने में रुचि रखते हैं, अर्थात अनुमति दें
पुराने अनुप्रयोगों को चलाने के लिए या नए पुस्तकालय संस्करणों के साथ पुन: संकलित करने के लिए।

साथ ही इस टूल का उपयोग ISV द्वारा नए में एप्लिकेशन पोर्टेबिलिटी की जांच के लिए किया जा सकता है
पुस्तकालय संस्करण। अनुकूलन करते समय पाए गए मुद्दों को ध्यान में रखा जा सकता है
एक नए पुस्तकालय संस्करण के लिए आवेदन।

यह टूल मुफ्त सॉफ्टवेयर है: आप इसे पुनर्वितरित कर सकते हैं और/या इसे संशोधित कर सकते हैं
जीएनयू एलजीपीएल या जीएनयू जीपीएल की शर्तें।

उपयोग:
अबी-अनुपालन-परीक्षक [विकल्प]

उदाहरण:
अबी-अनुपालन-परीक्षक -लिब नाम -पुराना पुराना.एक्सएमएल -नया नया.एक्सएमएल

OLD.xml और NEW.xml एक्सएमएल-डिस्क्रिप्टर हैं:



1.0





/पथ1/से/शीर्षलेख/ /पथ2/से/शीर्षलेख/

...





/path1/to/लाइब्रेरी(ies)/ /path2/to/Library(ies)/

...



जानकारी विकल्प:
-h|-सहायता

इस सहायता को प्रिंट करें।

-i|-जानकारी

पूरी जानकारी प्रिंट करें।

-v|-संस्करण

प्रिंट संस्करण की जानकारी।

-डंपवर्सन

टूल संस्करण (1.99.14) प्रिंट करें और कुछ और न करें।

सामान्य विकल्प:
-l|-lib|-लाइब्रेरी NAME

पुस्तकालय का नाम (संस्करण के बिना)।

-डी 1|-पुराना|-ओ पथ

पहले (पुराने) पुस्तकालय संस्करण का वर्णनकर्ता। यह निम्न में से एक हो सकता है:

1. एक्सएमएल-डिस्क्रिप्टर (VERSION.xml फ़ाइल):



1.0





/पथ1/से/शीर्षलेख/ /पथ2/से/शीर्षलेख/

...





/path1/to/लाइब्रेरी(ies)/ /path2/to/Library(ies)/

...



...

2. एबीआई डंप द्वारा उत्पन्न -डंप करना विकल्प 3. हेडर और/या साझा के साथ निर्देशिका
पुस्तकालय 4. सिंगल हेडर फाइल

यदि आप 2-4 डिस्क्रिप्टर प्रकारों का उपयोग कर रहे हैं तो आपको संस्करण संख्या निर्दिष्ट करनी चाहिए
साथ में -v1 और -v2 विकल्प भी।

अधिक जानकारी के लिए, कृपया देखें:

http://ispras.linuxbase.org/index.php/Library_Descriptor

-डी 2|-नया|-एन पथ

दूसरे (नए) पुस्तकालय संस्करण का वर्णनकर्ता।

-डंप करना|-डंप-अबी पथ

इनपुट एक्सएमएल डिस्क्रिप्टर के लिए लाइब्रेरी एबीआई डंप बनाएं। आप इसे कहीं भी ट्रांसफर कर सकते हैं
और डिस्क्रिप्टर के बजाय पास करें। साथ ही इसका उपयोग टूल को डिबग करने के लिए भी किया जा सकता है।

ABI डंप के समर्थित संस्करण: 2.0<=V<=3.2

अतिरिक्त विकल्प:
-बाप|-आवेदन पथ

यह विकल्प किसी को उस एप्लिकेशन को निर्दिष्ट करने की अनुमति देता है जिसके लिए जाँच की जानी चाहिए
नए पुस्तकालय संस्करण के लिए पोर्टेबिलिटी।

-स्थैतिक-libs

साझा पुस्तकालयों के बजाय स्थिर पुस्तकालयों की जाँच करें। NS का खंड
एक्सएमएल-डिस्क्रिप्टर को स्थिर पुस्तकालय स्थान को इंगित करना चाहिए।

-जीसीसी-पथ पथ

सामान्य (होस्ट) जीसीसी के बजाय उपयोग करने के लिए क्रॉस जीसीसी कंपाइलर का पथ।

-जीसीसी-उपसर्ग उपसर्ग

जीसीसी टूलचेन उपसर्ग।

-जीसीसी-विकल्प चुनता है

अतिरिक्त संकलक विकल्प।

-सिसरूट डीआईआर

वैकल्पिक रूट निर्देशिका निर्दिष्ट करें। टूल में पथ शामिल करने के लिए खोज करेगा
DIR/usr/include और DIR/usr/lib निर्देशिकाएं।

-v1|-संस्करण1 NUM

डिस्क्रिप्टर के बाहर पहला पुस्तकालय संस्करण निर्दिष्ट करें। इस विकल्प की आवश्यकता है यदि आप
एक वैकल्पिक डिस्क्रिप्टर प्रकार को प्राथमिकता दी है (देखें -डी 1 विकल्प)।

सामान्य स्थिति में आपको इसे एक्सएमएल-डिस्क्रिप्टर में निर्दिष्ट करना चाहिए:



VERSION



-v2|-संस्करण2 NUM

डिस्क्रिप्टर के बाहर दूसरा पुस्तकालय संस्करण निर्दिष्ट करें।

-वनुम NUM

जेनरेट किए गए एबीआई डंप में लाइब्रेरी संस्करण निर्दिष्ट करें। NS का खंड
इस मामले में इनपुट एक्सएमएल डिस्क्रिप्टर को अधिलेखित कर दिया जाएगा।

-s|-सख्त

सभी संगतता चेतावनियों को समस्याओं के रूप में मानें। कई "निम्न" गंभीरता जोड़ें
उपकरण के वापसी मूल्य के लिए समस्याएं।

-हेडर-ओनली

साझा पुस्तकालयों के बिना शीर्षलेख फ़ाइलों की जाँच करें। इसे चलाना आसान है, लेकिन यह एक प्रदान कर सकता है
झूठी सकारात्मकता के साथ कम गुणवत्ता संगतता रिपोर्ट और का पता लगाए बिना
जोड़े/हटाए गए प्रतीक।

वैकल्पिक रूप से आप "कोई नहीं" शब्द लिख सकते हैं में अनुभाग
एक्सएमएल-डिस्क्रिप्टर:



कोई नहीं



-शो-रिटवल

रिपोर्ट में प्रतीक का वापसी प्रकार दिखाएं।

-प्रतीक-सूची पथ

यह विकल्प किसी को प्रतीकों की सूची के साथ फ़ाइल निर्दिष्ट करने की अनुमति देता है
सी ++) जिसे चेक किया जाना चाहिए। अन्य प्रतीकों की जाँच नहीं की जाएगी।

-प्रकार-सूची पथ

यह विकल्प किसी को उन प्रकारों की सूची वाली फ़ाइल निर्दिष्ट करने की अनुमति देता है जो होनी चाहिए
जाँच की गई। अन्य प्रकार की जाँच नहीं की जाएगी।

-स्किप-प्रतीक पथ

उन प्रतीकों की सूची जिनकी जाँच नहीं की जानी चाहिए।

-स्किप-प्रकार पथ

उन प्रकारों की सूची जिनकी जाँच नहीं की जानी चाहिए।

-शीर्षक-सूची पथ

हेडर की सूची वाली फ़ाइल, जिसे चेक/डंप किया जाना चाहिए।

-स्किप-हेडर पथ

हेडर फाइलों की सूची वाली फाइल, जिसे चेक नहीं किया जाना चाहिए।

-शीर्षक नाम

केवल इस शीर्षलेख का ABI चेक/डंप करें।

-उपयोग-डंप

पुस्तकालय के दो संस्करणों के लिए डंप बनाएं और डंप की तुलना करें। यह बढ़ना चाहिए
उपकरण का प्रदर्शन और सिस्टम मेमोरी उपयोग को कम करता है।

-नोस्टडिंक

शीर्षलेख फ़ाइलों के लिए GCC मानक सिस्टम निर्देशिकाओं में खोज न करें।

-डंप-सिस्टम नाम -सिसरूट डीआईआर

डीआईआर निर्देशिका में सभी साझा पुस्तकालयों और हेडर फाइलों को ढूंढें, एक्सएमएल बनाएं
वर्णनकर्ता और प्रत्येक पुस्तकालय के लिए एबीआई डंप बनाते हैं। ABI डंप का परिणाम सेट हो सकता है
तुलना (--सीएमपी-सिस्टम) ऑपरेटिंग के दूसरे संस्करण के लिए बनाए गए दूसरे के साथ
संगतता के लिए उनकी जाँच करने के लिए प्रणाली। निर्दिष्ट करना न भूलें
-क्रॉस-जीसीसी विकल्प यदि आपके लक्ष्य प्रणाली को जीसीसी के कुछ विशिष्ट संस्करण की आवश्यकता है
कंपाइलर (होस्ट जीसीसी से अलग)। सिस्टम ABI डंप को उत्पन्न किया जाएगा:

sys_dumps/NAME/ARCH

-डंप-सिस्टम विवरण.एक्सएमएल

पिछले विकल्प के समान लेकिन लक्ष्य प्रणाली के XML डिस्क्रिप्टर को इस रूप में लेता है
इनपुट, जहां आपको इसका वर्णन करना चाहिए:

/* प्राथमिक खंड */



/* सिस्टम का नाम */





/* हेडर फाइलों और/या के पथों की सूची

शीर्षलेख फ़ाइलों वाली निर्देशिका, प्रति पंक्ति एक */





/* साझा पुस्तकालयों के पथों की सूची और/या

साझा पुस्तकालयों के साथ निर्देशिका, प्रति पंक्ति एक */



/* वैकल्पिक अनुभाग */



/* खोजी जाने वाली निर्देशिकाओं की सूची

हेडर फ़ाइलों को स्वचालित रूप से उत्पन्न करने के लिए पथ शामिल करें, प्रति पंक्ति एक */





/* खोजी जाने वाली निर्देशिकाओं की सूची

निर्भरता को हल करने के लिए साझा पुस्तकालयों के लिए, प्रति पंक्ति एक */





/* उपयोग किए गए टूल वाली निर्देशिकाओं की सूची

विश्लेषण के लिए (जीसीसी टूलचेन), प्रति पंक्ति एक */





/* जीसीसी टूलचेन उपसर्ग।

उदाहरण:
आर्म-लिनक्स-ग्नूएबी आर्म-कोई नहीं-सिम्बिएनेल्फ */





/* अतिरिक्त जीसीसी विकल्प, प्रति पंक्ति एक */



-सिसइन्फो डीआईआर

इस विकल्प के साथ प्रयोग किया जाना चाहिए -डंप-सिस्टम ऑपरेटिंग के एबीआई को डंप करने का विकल्प
सिस्टम और डंपिंग प्रक्रिया को कॉन्फ़िगर करें। आप पैकेज में एक नमूना पा सकते हैं:

मॉड्यूल/लक्ष्य/{यूनिक्स, सिम्बियन, विंडोज़}

-सीएमपी-सिस्टम -डी 1 sys_dumps/NAME1/ARCH -डी 2 sys_dumps/NAME2/ARCH

दो सिस्टम ABI डंप की तुलना करें। प्रत्येक पुस्तकालय के लिए संगतता रिपोर्ट बनाएं और
सभी जाँचे गए पुस्तकालयों के लिए परीक्षण परिणामों के सारांश सहित सामान्य HTML रिपोर्ट।
रिपोर्ट तैयार की जाएगी:

sys_compat_reports/NAME1_to_NAME2/ARCH

-libs-सूची पथ

पुस्तकालयों की सूची वाली फ़ाइल, जिसे द्वारा डंप किया जाना चाहिए -डंप-सिस्टम विकल्प
या द्वारा जाँच की जानी चाहिए -सीएमपी-सिस्टम विकल्प.

-ext|-विस्तारित

यदि आपकी लाइब्रेरी A को अन्य लाइब्रेरी B द्वारा उपयोग किया जाना है और आप इसे नियंत्रित करना चाहते हैं
बी के एबीआई, तो आपको इस विकल्प को सक्षम करना चाहिए। टूल परिवर्तनों की जांच करेगा
सभी डेटा प्रकारों में, भले ही वे पुस्तकालय में किसी भी फ़ंक्शन द्वारा उपयोग नहीं किए जाते हैं ए। ऐसे
डेटा प्रकार ए लाइब्रेरी एबीआई का हिस्सा नहीं हैं, लेकिन बी के एबीआई का हिस्सा हो सकते हैं
पुस्तकालय।

संक्षिप्त योजना है:

ऐप सी (टूटा हुआ) -> lib बी (टूटा हुआ एबीआई) -> lib ए (स्थिर एबीआई)

-q|-शांत

सभी संदेशों को stdout और stderr के बजाय फ़ाइल में प्रिंट करें। डिफ़ॉल्ट पथ (हो सकता है
द्वारा बदला गया -लॉग-पथ विकल्प):

लॉग/रन.लॉग

-स्टडआउट

प्रिंट विश्लेषण परिणाम (संगतता रिपोर्ट और एबीआई डंप) के बजाय स्टडआउट करने के लिए
एक फ़ाइल बनाना। यह डेटा को अन्य कार्यक्रमों में पाइप करने की अनुमति देगा।

-रिपोर्ट-प्रारूप FMT

संगतता रिपोर्ट का प्रारूप बदलें। प्रारूप:

एचटीएम - एचटीएमएल प्रारूप (डिफ़ॉल्ट) एक्सएमएल - एक्सएमएल प्रारूप

-डंप-प्रारूप FMT

एबीआई डंप का प्रारूप बदलें। प्रारूप:

पर्ल - डेटा :: डम्पर प्रारूप (डिफ़ॉल्ट) एक्सएमएल - एक्सएमएल प्रारूप

-एक्सएमएल

इसके लिए उपनाम: --रिपोर्ट-प्रारूप=एक्सएमएल or --डंप प्रारूप=एक्सएमएल

-लंग लैंग

पुस्तकालय भाषा (सी या सी ++) सेट करें। यदि टूल नहीं कर सकता है तो आप इस विकल्प का उपयोग कर सकते हैं
एक भाषा का स्वतः पता लगाएं। यह विकल्प सी-लाइब्रेरी हेडर की जाँच के लिए उपयोगी हो सकता है
(--लैंग=C) में --हेडर-केवल or --विस्तारित मोड।

—करना मेहराब

लाइब्रेरी आर्किटेक्चर सेट करें (x86, x86_64, ia64, arm, ppc32, ppc64, s390, ect।)। NS
विकल्प उपयोगी है यदि उपकरण इनपुट के सही आर्किटेक्चर का पता नहीं लगा सकता है
वस्तुओं।

-बाइनरी|-बिन|-अबी

केवल "बाइनरी" संगतता समस्याएं दिखाएं। रिपोर्ट जनरेट करें:

compat_reports/LIB_NAME/V1_to_V2/abi_compat_report.html

स्रोत|-src|-एपी

केवल "स्रोत" संगतता समस्याएं दिखाएं। रिपोर्ट जनरेट करें:

compat_reports/LIB_NAME/V1_to_V2/src_compat_report.html

-सीमा प्रभावित सीमा

बदले गए विवरण के तहत सूचीबद्ध प्रभावित प्रतीकों की अधिकतम संख्या
रिपोर्ट में टाइप करें।

अन्य विकल्प:
-परीक्षण

आंतरिक परीक्षण चलाएँ। एक नमूना पुस्तकालय के दो बाइनरी असंगत संस्करण बनाएं और
उन्हें संगतता के लिए जाँचने के लिए उपकरण चलाएँ। यह विकल्प किसी को यह जांचने की अनुमति देता है कि क्या
उपकरण वर्तमान परिवेश में सही ढंग से काम करता है।

-टेस्ट-डंप

ABI डंप बनाने, पढ़ने और तुलना करने की क्षमता का परीक्षण करें।

-डीबग

डिबगिंग मोड। स्क्रीन पर डिबग जानकारी प्रिंट करें। मध्यवर्ती विश्लेषण चरणों को बचाएं
डीबग निर्देशिका में:

डीबग/LIB_NAME/संस्करण/

उपयोग करने पर भी विचार करें --गंदी जगह उपकरण डिबगिंग के लिए विकल्प।

-सीपीपी-संगत

यदि आपकी हेडर फाइलें सी भाषा में लिखी गई हैं और जी++ द्वारा संकलित की जा सकती हैं
कंपाइलर (अर्थात C++ कीवर्ड का उपयोग न करें), तो आप इस बारे में टूल को बता सकते हैं और
विश्लेषण को गति दें।

-सीपीपी-असंगत

इस विकल्प को सेट करें यदि इनपुट C शीर्षलेख फ़ाइलें C++ कीवर्ड का उपयोग करती हैं।

-p|-परम्स पथ

फ़ंक्शन पैरामीटर नामों के साथ फ़ाइल का पथ। इसका उपयोग रिपोर्ट में सुधार के लिए किया जा सकता है
देखें कि क्या लाइब्रेरी हेडर फाइलों में कोई पैरामीटर नाम नहीं है। फाइल प्रारूप:

func1;param1;param2;param3 ... func2;param1;param2;param3 ...

...

-रेलपथ पथ

लाइब्रेरी को डंप करने के लिए उपयोग किए गए XML-डिस्क्रिप्टर में {RELPATH} मैक्रोज़ को PATH से बदलें
एबीआई (देखें -डंप करना विकल्प)।

-रेलपथ1 पथ

पहले XML-डिस्क्रिप्टर में {RELPATH} मैक्रोज़ को PATH में बदलें (-डी 1).

-रेलपथ2 पथ

दूसरे XML-डिस्क्रिप्टर में {RELPATH} मैक्रोज़ को PATH में बदलें (-डी 2).

-डंप-पथ पथ

एक *.abi.tar.gz या *.abi फ़ाइल पथ निर्दिष्ट करें जहाँ ABI डंप जनरेट करना है। चूक जाना:

abi_dumps/LIB_NAME/LIB_NAME_VERSION.abi.tar.gz

-सॉर्ट

ABI डंप में डेटा सॉर्ट करना सक्षम करें।

-रिपोर्ट-पथ पथ

संगतता रिपोर्ट का पथ। चूक जाना:

compat_reports/LIB_NAME/V1_to_V2/compat_report.html

-बिन-रिपोर्ट-पथ पथ

"बाइनरी" संगतता रिपोर्ट का पथ। चूक जाना:

compat_reports/LIB_NAME/V1_to_V2/abi_compat_report.html

-src-रिपोर्ट-पथ पथ

"स्रोत" संगतता रिपोर्ट का पथ। चूक जाना:

compat_reports/LIB_NAME/V1_to_V2/src_compat_report.html

-लॉग-पथ पथ

सभी संदेशों के लिए लॉग पथ। चूक जाना:

लॉग्स/LIB_NAME/VERSION/log.txt

-लॉग1-पथ पथ

पुस्तकालय के पहले संस्करण के लिए लॉग पथ। चूक जाना:

लॉग/LIB_NAME/V1/log.txt

-लॉग2-पथ पथ

पुस्तकालय के दूसरे संस्करण के लिए लॉग पथ। चूक जाना:

लॉग/LIB_NAME/V2/log.txt

-लॉगिंग-मोड मोड

लॉगिंग मोड बदलें। मोड:

w - पुराने लॉग को अधिलेखित करें (डिफ़ॉल्ट) a - पुराने लॉग को जोड़ें n - कोई लॉग न लिखें

-सूची प्रभावित

HTML संगतता के साथ असंगत प्रतीकों की सूची के साथ फ़ाइल उत्पन्न करें
रिपोर्ट good। C++ प्रतीकों को हटाने के लिए GNU binutils से 'c++filt @file' कमांड का उपयोग करें
उत्पन्न फ़ाइल। डिफ़ॉल्ट नाम:

अबी_प्रभावित.txt src_प्रभावित.txt

घटक नाम

HTML रिपोर्ट के शीर्षक और सारांश में घटक का नाम. चूक जाना:

पुस्तकालय

-शीर्षक नाम

रिपोर्ट शीर्षक में लाइब्रेरी का नाम बदलकर NAME करें। डिफ़ॉल्ट रूप से प्रदर्शित किया जाएगा a
द्वारा निर्दिष्ट नाम -l विकल्प.

-अतिरिक्त जानकारी डीआईआर

डीआईआर को अतिरिक्त जानकारी डंप करें।

-अतिरिक्त-डंप

अनुवाद इकाई से सभी प्रतीकों वाले विस्तारित एबीआई डंप बनाएं।

फोर्स

यदि उपकरण काम नहीं करता है तो इस विकल्प का उपयोग करने का प्रयास करें।

-सहनशीलता LEVEL

इनपुट हेडर फ़ाइलों को सफलतापूर्वक संकलित करने के लिए अनुमानों का एक सेट लागू करें। आप ऐसा कर सकते हैं
कई सहिष्णुता स्तरों को एक स्ट्रिंग में जोड़कर सक्षम करें (उदाहरण के लिए 13, 124,
आदि।)। स्तर:

1 - गैर-लिनक्स शीर्षलेख छोड़ें (उदा. win32_*.h, आदि) 2 - आंतरिक शीर्षलेख छोड़ें (उदा.
*_p.h, impl/*.h, आदि) 3 - गैर-लिनक्स शीर्षलेखों को शामिल करने वाले शीर्षलेखों को छोड़ें 4 - छोड़ें
दूसरों द्वारा शामिल शीर्षलेख

सहनशील

उच्चतम सहनशीलता स्तर [1234] सक्षम करें।

-जाँच

ABI डंप की पूर्णता की जाँच करें।

-शीघ्र

त्वरित विश्लेषण। कुछ टेम्पलेट उदाहरणों की जांच अक्षम करें।

-छोड़ें-आंतरिक-प्रतीक प्रतिरूप

पैटर्न से मेल खाने वाले प्रतीकों की जांच न करें।

-छोड़ें-आंतरिक-प्रकार प्रतिरूप

पैटर्न से मेल खाने वाले प्रकारों की जांच न करें।

रिपोर्ट GOOD:
संगतता रिपोर्ट तैयार की जाएगी:

compat_reports/LIB_NAME/V1_to_V2/compat_report.html

लॉग को जेनरेट किया जाएगा:

लॉग्स/LIB_NAME/V1/log.txt लॉग्स/LIB_NAME/V2/log.txt

बाहर निकलें कोड:
0 - संगत। उपकरण बिना किसी त्रुटि के चला गया है। गैर-शून्य - असंगत या
उपकरण त्रुटियों के साथ चला है।

अधिक इंफॉर्मेशन:
http://lvc.github.io/abi-compliance-checker/

onworks.net सेवाओं का उपयोग करके ऑनलाइन abi-compliance-checker का उपयोग करें