include_server - क्लाउड में ऑनलाइन

कार्यक्रम:

नाम

include_server.py - C/C++ के लिए निर्भरताएँ शामिल करने का रूढ़िवादी अनुमान

SYNOPSIS

include_server --बंदरगाह INCLUDE_SERVER_PORT [विकल्प]

वर्णन

include_server.py एक सम्मिलित सर्वर प्रक्रिया शुरू करता है। यह प्रक्रिया प्रश्नों का उत्तर देती है
व्याकुल करना(1) ग्राहकों को C/C++ संकलनों में कौन सी फ़ाइलें शामिल करनी हैं इसके बारे में। include_server.py
जैसे ही सम्मिलित सर्वर उत्पन्न हो जाता है, कमांड स्वयं समाप्त हो जाती है।

INCLUDE_SERVER_PORT तर्क सभी संचार के लिए उपयोग किए जाने वाले सॉकेट का नाम है
distcc क्लाइंट और शामिल सर्वर के बीच। distcc-पंप(1) कमांड जिम्मेदार है
सॉकेट स्थान बनाने के लिए, इसे इस स्क्रिप्ट में पास करने के लिए, और इसे सभी को पास करने के लिए
INCLUDE_SERVER_PORT नामक पर्यावरण चर के माध्यम से distcc क्लाइंट।

शामिल सर्वर द्वारा उपयोग किया जाने वाला प्रोटोकॉल distcc के RPC कार्यान्वयन का उपयोग करता है। प्रत्येक जिला
अनुरोध में (1) वर्तमान निर्देशिका और (2) तर्कों की सूची शामिल है
संकलन आदेश.

यदि शामिल सर्वर अनुरोध को संसाधित करने में सक्षम है, तो यह distcc क्लाइंट को उत्तर देता है
फ़ाइलपथों की एक सूची भेजना। फ़ाइलपथ संपीड़ित स्रोत और हेडर के हैं
विश्लेषण के माध्यम से संकलन के लिए आवश्यक पाई गई फ़ाइलें। सूची भी
इसमें प्रतीकात्मक लिंक और यहां तक ​​कि संकलन सर्वर के लिए आवश्यक डमी फ़ाइलें भी शामिल हैं
संकलन के लिए आवश्यक फ़ाइल सिस्टम के हिस्सों की एक सटीक प्रतिकृति बनाएं। में
इस तरह, /path/foo.h जैसी आवश्यक हेडर फ़ाइल को संपीड़ित किया जाता है, उसका नाम बदला जाता है और एक में संग्रहीत किया जाता है
अस्थायी स्थान, जैसे /dev/shm/tmpiAvfGv.include_server-9368-1/path/foo.h.lzo.
distcc क्लाइंट इन फ़ाइलों को एक संकलन सर्वर पर भेज देगा, जहां वे होंगी
असम्पीडित और अस्थायी रूप से लगाया गया।

यदि शामिल सर्वर अनुरोध को संसाधित करने में सक्षम नहीं है, तो यह खाली सूची लौटाता है
distcc क्लाइंट को।

सम्मिलित सर्वर से संबंधित विफलताएँ दो प्रकार की होती हैं। सर्वर शामिल हो सकता है
शामिल की गणना करने में विफल होना या अन्य तरीकों से विफल होना, अनुभाग देखें शामिल सर्वर लक्षण.
साथ ही, गणना की अपर्याप्तता के कारण रिमूव सर्वर पर संकलन विफल हो सकता है
बंद करना शामिल है, लेकिन स्थानीय स्तर पर पुनः प्रयास करने पर सफल होता है, अनुभाग देखें DISTCC विसंगति
लक्षण.

विकल्प सारांश

निम्नलिखित विकल्पों को include_server.py से समझा जाता है।

-dPAT, --डीबग_पैटर्न=पीएटी
चेतावनियाँ और डिबगिंग चालू करने के लिए बिट वेक्टर
1=चेतावनी
2 = कुछ कार्यों का पता लगाएं
दो की अन्य शक्तियाँ: include_server/basics.py देखें।

-e, --ईमेल
'distcc-pump-errors' पर ईमेल भेजें या यदि परिभाषित किया गया है, तो पर्यावरण चर का मान
DISTCC_EMAILLOG_WHOM_TO_BLAME, जब सर्वर में समस्या आती है। डिफ़ॉल्ट है
ईमेल न भेजने के लिए.

--ईमेल_बाउंड नंबर
भेजने के लिए ईमेल की अधिकतम संख्या (अंतिम ईमेल के अतिरिक्त)। डिफ़ॉल्ट: 3.

--कोई ईमेल नहीं
ईमेल न भेजें. यह डिफ़ॉल्ट है.

--path_observation_re=RE
जब भी किसी फ़ाइल नाम का मिलान वास्तविक पथ से किया जाता है तो चेतावनी संदेश जारी करें
आरई द्वारा, जो पायथन सिंटैक्स में एक नियमित अभिव्यक्ति है। यह खोजने के लिए उपयोगी है
पता लगाएं कि शामिल फ़ाइलें वास्तव में कहां से आती हैं। उन सभी को ढूंढने के लिए RE='' का उपयोग करें। टिप्पणी:
चेतावनियाँ कम से कम -d1 के साथ सक्षम होनी चाहिए।

--पिड_फाइल फ़ाइल पथ
शामिल सर्वर का पीआईडी ​​FILEPATH फ़ाइल करने के लिए लिखा गया है। यह एक स्क्रिप्ट की अनुमति देता है
ऐसा एक distcc-पंप सम्मिलित सर्वर को नष्ट करने के लिए।

-एस, --सांख्यिकी
विश्लेषण शामिल करने के बारे में जानने के लिए जानकारी प्रिंट करें।

--stat_reset_triggers=LIST
जब LIST में किसी फ़ाइलपथ का टाइमस्टैम्प बदलता है या तो स्टेट कैश को फ्लश करें
फ़ाइलपथ अस्तित्व के अंदर या बाहर आता है। LIST एक कोलन से अलग की गई स्ट्रिंग है
फ़ाइलपथ, संभवतः सरल ग्लब्स युक्त (जैसा कि पायथन के ग्लोब मॉड्यूल द्वारा अनुमत है)।
जब भी ऐसा परिवर्तन हो तो एक चेतावनी प्रिंट करें (यदि चेतावनियाँ सक्षम हैं)। यह
विकल्प distcc-पंप की सामान्य धारणा के स्रोत तक सीमित अपवादों की अनुमति देता है
निर्माण के दौरान फ़ाइलें संशोधित नहीं की जाती हैं।

-टी, --समय
बीता हुआ प्रिंट, उपयोगकर्ता और सिस्टम का समय stderr पर।

--असुरक्षित_निरपेक्ष_शामिल
संपूर्ण फ़ाइलपथ शामिल होने पर भी संकलन सर्वर पर प्रीप्रोसेसिंग करें
सामना करना पड़ता है. आम तौर पर शामिल-सर्वर स्थानीय प्रीप्रोसेसिंग पर वापस आ जाएगा
यदि यह किसी पूर्ण समावेश का पता लगाता है। अत: यह ध्वज ऐसी रोकथाम के लिए उपयोगी है
जब निरपेक्ष में फ़ॉलबैक शामिल होता है तो गलत अलार्म होता है, या तो निरपेक्ष के कारण
शामिल को प्रीप्रोसेसिंग के दौरान या पूरी तरह से शामिल फ़ाइल के कारण हटा दिया जाता है
संकलन सर्वर पर मौजूद है।

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

यह विकल्प उस कोड को संकलित करने के लिए उपयोगी है जिसमें ऐसे हार्डकोडेड निरपेक्ष स्थान हैं
सशर्त निर्देशों (उदाहरण के लिए "#ifdef") के अंदर हेडर फ़ाइलों की, जो प्रस्तुत करती हैं
अप्रासंगिक शामिल है. अधिक सटीक रूप से, इनमें शामिल हैं को समाप्त किया जाना चाहिए
वास्तविक कॉन्फ़िगरेशन के लिए प्रीप्रोसेसिंग। फिर अस्तित्व का प्रश्न
हेडर फ़ाइल म्यूट है और दूरस्थ संकलन ठीक है। अगर ऐसा अक्सर होता है
ऐसे समावेशन वास्तविक से भिन्न असामान्य कॉन्फ़िगरेशन के लिए होते हैं
विन्यास।

-में, --सत्यापन
सत्यापित करें कि सीपीपी क्लोजर में फ़ाइलें शामिल द्वारा गणना किए गए क्लोजर में समाहित हैं
प्रोसेसर।

-डब्ल्यू, --write_include_closure
एक .d_approx फ़ाइल लिखें जिसमें शामिल द्वारा गणना की गई सभी शामिल फ़ाइलों को सूचीबद्ध किया गया है
सर्वर; -x के साथ, अतिरिक्त रूप से शामिल फ़ाइलों को CPP द्वारा गणना के अनुसार लिखें
.d_exact फ़ाइल.

-एक्स, --सटीक_विश्लेषण
इसके बजाय सीपीपी का उपयोग करें, सिस्टम हेडर फ़ाइलों को न छोड़ें।

शामिल सर्वर लक्षण और मुद्दें

शामिल प्रोसेसर से आने वाले सबसे संभावित संदेश और चेतावनियाँ नीचे सूचीबद्ध हैं।

preprocessing स्थानीय स्तर पर। शामिल करना सर्वर नहीं आवरण: नहीं किया जा सका निर्धारित चूक प्रणाली
शामिल निर्देशिकाओं
डिफ़ॉल्ट सिस्टम हेडर निर्देशिकाओं को निर्धारित करने के लिए, शामिल सर्वर चलाता है
अपने सत्र के दौरान आवश्यक प्रत्येक भाषा के लिए एक बार कंपाइलर। यह संदेश इंगित करता है
कि distcc को निर्दिष्ट कंपाइलर क्लाइंट पर मौजूद नहीं है।

preprocessing स्थानीय स्तर पर। शामिल करना सर्वर नहीं आवरण: प्रति सहिष्णु आउट क्योंकि शामिल सर्वर
खर्च अधिक से ...एस उपयोगकर्ता पहर से निपटने का अनुरोध
असामान्य स्थितियों में, शामिल सर्वर बहुत जटिल मैक्रो का विश्लेषण करने में विफल रहता है
भाव. डिस्टसीसी क्लाइंट सादे डिस्टसीसी मोड का उपयोग करेगा।

चेतावनी: दस्तावेज पथ चाहिए be सापेक्ष लेकिन नहीं है
शामिल सर्वर पूर्ण फ़ाइलपथ को स्वीकार नहीं करता है, जैसे
/usr/include/stdio.h, में निर्देश शामिल हैं, क्योंकि इसकी कोई गारंटी नहीं है
कंपाइलेशन सर्वर मशीन पर यह हेडर वैसा ही होगा जैसा कि कंपाइलेशन सर्वर मशीन पर है
ग्राहक। शामिल सर्वर शामिल बंद होने का विश्लेषण करना छोड़ देता है। जिला
क्लाइंट पंप-मोड का उपयोग नहीं कर सकता.

इस समस्या को हमेशा विश्वसनीय तरीके से दूर करने के लिए, पर्यावरण चर सेट करें
INCLUDE_SERVER_ARGS='--unsafe_absolute_includes' डिस्टसीसी-पंप चालू करते समय
शामिल सर्वर पर --unsafe_absolute_includes विकल्प पास करने के लिए स्क्रिप्ट।

चेतावनी: पूर्ण दस्तावेज पथ ... था अवहेलना करना
--unsafe_absolute_includes उपयोग में है। उसी के तहत यह स्थिति बनती है
परिस्थितियाँ जब "फ़ाइलपथ सापेक्ष होना चाहिए लेकिन नहीं है" जारी किया जाता है, लेकिन इसमें
मामले में शामिल डिस्टसीसी क्लाइंट को उत्तर प्रदान करेगा।

चेतावनी: पथ '/पथ/फ़ाइल' बदला/आया में अस्तित्व/नहीं लंबे समय तक मौजूद
स्टेट रीसेट ट्रिगर्स का उपयोग करते समय ये चेतावनियाँ जारी की जाती हैं। क्योंकि /पथ/फ़ाइल
परिवर्तित, सम्मिलित सर्वर अपना कैश साफ़ करता है; फ़ाइल का नया संस्करण (या
इसकी कमी) शामिल विश्लेषण को अमान्य बना देती है। यह संदेश आमतौर पर हो सकता है
अवहेलना करना; यह बिल्ड सिस्टम द्वारा फ़ाइलों के कुछ हद तक अनिश्चित उपयोग का संकेत देता है।
बिल्ड सिस्टम को ठीक करने की अनुशंसा की जाती है ताकि फ़ाइलें दोबारा न लिखी जाएं।

चेतावनी: के लिए अनुवाद इकाई ... लुकअप of पट्टिका ... संकल्प सेवा मेरे ... किसका वास्तविक पथ is
...
यह चेतावनी --path_observation_re के साथ तब होती है जब एक नया वास्तविक पथ मेल खाता है
स्रोत या हेडर फ़ाइल देखी गई है.

DISTCC विसंगति लक्षण

बिल्ड सिस्टम, distcc और शामिल सर्वर के बीच इंटरैक्शन कुछ हद तक है
जटिल। जब एक distcc कमांड को रिमोट सर्वर से एक असफल संकलन प्राप्त होता है
स्थानीय स्तर पर संकलन का पुन: प्रयास करें। यह अनुभाग विसंगतियों के कारणों पर चर्चा करता है
दूरस्थ और स्थानीय संकलन के बीच। इन्हें डिमोशन संदेश द्वारा चिह्नित किया गया है:

__________चेतावनी: ... पंप-मोड संकलन में विफल रहा है on सर्वर, लेकिन सफल हुए स्थानीय स्तर पर।
__________डिस्ट्रिक्ट-पंप था पदावनत सेवा मेरे सादा मोड। देख la जिला विसंगति लक्षण
अनुभाग in la include_server(1) आदमी इस पृष्ठ पर ज़ूम कई वीडियो ट्यूटोरियल और अन्य साहायक साधन प्रदान करता है।

डिस्टसीसी-पंप स्क्रिप्ट बिल्ड के अंत में यह संदेश जारी करती है। इसका मतलब यह है कि at के लिए
दूरस्थ संकलन के बाद स्थानीय संकलन में कम से कम एक डिस्टसीसी आमंत्रण सफल हुआ
असफल। प्रत्येक जिला मंगलाचरण जिसके लिए ऐसी विसंगति उत्पन्न हुई, वह भी जारी करता है
संदेश जैसे:

चेतावनी: दूरस्थ संकलन of '...' असफल, पुन: प्रयास स्थानीय स्तर पर और मिला a विभिन्न परिणाम।

डिमोशन बाद के distcc आमंत्रणों को सादे distcc मोड का उपयोग करता है। इस प्रकार
निर्माण के शेष भाग के लिए स्थानीय मशीन पर प्रीप्रोसेसिंग होगी। यह
तकनीक बहुत धीमी गति से निर्माण को रोकती है जहां सभी संकलन स्थानीय मशीन पर समाप्त होते हैं
दूर से असफल होने के बाद.

बेशक, यदि दूरस्थ विफलताओं के बाद स्थानीय संकलन विफल हो जाता है, तो distcc
मंगलाचरण स्थानीय संकलन की गैर-शून्य स्थिति के साथ बाहर निकलता है। त्रुटि संदेश
स्थानीय संकलन भी मुद्रित हैं।

डिस्टसीसी-पंप मोड से स्थानीय संकलन के लिए फ़ॉलबैक व्यवहार को सेटिंग द्वारा अक्षम किया जा सकता है
पर्यावरण चर DISTCC_FALLBACK से 1 हो जाता है, जिससे distcc कमांड जल्द ही विफल हो जाता है
चूँकि दूरस्थ संकलन विफल हो गया है। यह सेटिंग डिबगिंग के लिए बहुत उपयोगी है क्यों
दूरस्थ संकलन गलत हो गया, क्योंकि अब सर्वर से आउटपुट प्रिंट हो जाएगा।

आगे हम विसंगतियों के संभावित कारणों पर चर्चा करते हैं।

RSI उपयोगकर्ता बदल a स्रोत or हैडर पट्टिका दौरान la निर्माण।
इससे निश्चित रूप से असंगत परिणाम मिलते हैं।

A स्रोत or हैडर पट्टिका बदल दौरान la निर्माण।
बिल्ड सिस्टम एक फ़ाइल को फिर से लिखता है। लिनक्स कर्नेल 2.6 के लिए, ऐसा होता है
'include/linux/compile.h' और 'include/asm/asm-offsets.h'। यह शर्त तय है
शामिल सर्वर को यह बताकर कि उसे किसी भी स्थिति में अपने कैश को रीसेट करना होगा
फ़ाइलों में परिवर्तन होता है. व्यावहारिक रूप से, यह फ़ाइलों को एक कोलन में एकत्रित करके किया जाता है-
अलग सूची और फिर INCLUDE_SERVER_ARGS कमांड को इस प्रकार सेट करना:

include_server_args='-stat_reset_triggers=include/linux/compile.h:include/asm/asm-
ऑफसेट.एच"

A हैडर पट्टिका is संभावित शामिल है, लेकिन कर देता है नहीं अस्तित्व, और is फिर बाद में शामिल थे.

ऐसा तब होता है जब कुछ हेडर foo.h में एक अन्य हेडर फ़ाइल ट्रिक.h शामिल होती है, लेकिन
ट्रिक.एच फ़ाइल अभी तक उत्पन्न नहीं हुई है और समावेशन को वास्तव में अनदेखा कर दिया गया है
प्रीप्रोसेसिंग निर्देशों के कारण। शामिल सर्वर इसकी जांच करेगा
ट्रिक.एच का अस्तित्व, क्योंकि यह सभी संभावित तरीकों के निर्देशों से अधिक अनुमानित है
वास्तव में मूल्यांकन करें. फ़ाइल ट्रिक.एच अस्तित्व में नहीं है। यदि यह बाद में है
जेनरेट किया गया, और फिर वास्तव में शामिल किया गया, तो शामिल सर्वर झूठा विश्वास करेगा
कि फ़ाइल अभी भी मौजूद नहीं है. इस समस्या का समाधान बनाना है
पहली बार किसी हेडर फ़ाइल को शामिल करने से पहले बिल्ड सिस्टम ट्रिक.एच उत्पन्न करता है
जो ट्रिक.एच का वाक्यात्मक संदर्भ बनाता है

RSI शामिल सर्वर था शुरू साथ में --असुरक्षित_निरपेक्ष_शामिल.
यह एक समस्या है यदि स्थानीय स्तर पर ऐसी हेडर फ़ाइलें हैं जो दूरस्थ रूप से मौजूद नहीं हैं
जिनका वास्तव में उपयोग किया जाता है। ऐसे शामिल अक्सर सशर्त द्वारा संरक्षित होते हैं
ऐसे निर्देश जो मूल्यांकन करते हैं वे वास्तव में केवल विशिष्ट और अक्सर उपयोग किए जाते हैं
असामान्य मंच. यदि आप ऐसे प्लेटफ़ॉर्म के लिए संकलन नहीं कर रहे हैं, तो यह हो सकता है
उपयोग करने के लिए सही --असुरक्षित_निरपेक्ष_शामिल.

RSI शामिल सर्वर है परिकलित la गलतियों को सुधारने शामिल है.
हमें ऐसी किसी स्थिति की जानकारी नहीं है.

बाहर निकलें कोड

include_server.py का निकास कोड आमतौर पर 0 होता है। इसका मतलब है कि include सर्वर शुरू हो गया है
pid_file के अस्तित्व के माध्यम से ठीक से संचार किया जाता है।

वातावरण चर

DISTCC_EMAILLOG_WHOM_TO_BLAME उपयोग किए जाने वाले ईमेल पते में सर्वर स्वचालित शामिल है
ईमेल. डिफ़ॉल्ट 'distcc-pump-errors' है (जो एक ईमेल पता है जो संभवतः होगा
आपके डोमेन में मौजूद नहीं है)।

इसके अतिरिक्त, कंपाइलर का आह्वान अतिरिक्त पर्यावरण चर का उपयोग कर सकता है।

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