include_server - Dalam talian dalam Awan

JADUAL:

NAMA

include_server.py - anggaran konservatif bagi kebergantungan termasuk untuk C/C++

SINOPSIS

include_server --pelabuhan INCLUDE_SERVER_PORT [PILIHAN]

DESCRIPTION

include_server.py memulakan proses termasuk pelayan. Proses ini menjawab pertanyaan daripada
distcc(1) pelanggan tentang fail yang hendak dimasukkan dalam kompilasi C/C++. The include_server.py
arahan itu sendiri ditamatkan sebaik sahaja pelayan termasuk telah dihasilkan.

Argumen INCLUDE_SERVER_PORT ialah nama soket yang digunakan untuk semua komunikasi
antara klien distcc dan pelayan termasuk. The distcc-pam(1) perintah bertanggungjawab
untuk mencipta lokasi soket, untuk menghantarnya ke skrip ini, dan untuk menghantarnya kepada semua
distcc melalui pembolehubah persekitaran bernama INCLUDE_SERVER_PORT.

Protokol yang digunakan oleh pelayan include menggunakan pelaksanaan RPC distcc. Setiap distcc
permintaan terdiri daripada (1) direktori semasa dan (2) senarai argumen bagi
arahan kompilasi.

Jika pelayan include dapat memproses permintaan, maka ia menjawab klien distcc dengan
menghantar senarai laluan fail. Laluan fail adalah dari sumber dan pengepala termampat
fail yang didapati perlu untuk penyusunan melalui analisis termasuk. Senarai itu juga
mengandungi pautan simbolik dan juga fail tiruan yang diperlukan untuk pelayan kompilasi
bina replika tepat bahagian-bahagian sistem fail yang diperlukan untuk penyusunan. Dalam
dengan cara ini, fail pengepala yang diperlukan seperti /path/foo.h dimampatkan, dinamakan semula dan disimpan dalam
lokasi sementara, seperti /dev/shm/tmpiAvfGv.include_server-9368-1/path/foo.h.lzo. The
klien distcc akan menghantar fail ini ke pelayan kompilasi, di mana ia akan berada
tidak dimampatkan dan dipasang buat sementara waktu.

Jika pelayan sertakan tidak dapat memproses permintaan, maka ia mengembalikan senarai kosong
kepada pelanggan distcc.

Terdapat dua jenis kegagalan yang berkaitan dengan pelayan termasuk. Pelayan termasuk boleh
gagal untuk mengira termasuk atau gagal dalam cara lain, lihat bahagian TERMASUK SERVER SYMPTOMS.
Juga, penyusunan pada pelayan alih keluar mungkin gagal kerana ketidakcukupan yang dikira
sertakan penutupan, tetapi kemudian berjaya apabila dicuba semula secara tempatan, lihat bahagian DISTCC PERBINCANGAN
SYMPTOMS.

OPTION RINGKASAN

Pilihan berikut difahami oleh include_server.py.

-dPAT, --debug_pattern=PAT
Vektor bit untuk menghidupkan amaran dan nyahpepijat
1 = amaran
2 = mengesan beberapa fungsi
kuasa dua lain: lihat include_server/basics.py.

-e, --e-mel
Hantar e-mel kepada 'distcc-pump-errors' atau jika ditakrifkan, nilai pembolehubah persekitaran
DISTCC_EMAILLOG_WHOM_TO_BLAME, apabila pelayan termasuk menghadapi masalah. Lalainya ialah
untuk tidak menghantar e-mel.

--email_bound NOMBOR
Bilangan maksimum e-mel untuk dihantar (sebagai tambahan kepada e-mel akhir). Lalai: 3.

--tiada-e-mel
Jangan hantar e-mel. Ini adalah lalai.

--path_observation_re=RE
Mengeluarkan mesej amaran apabila nama fail diselesaikan ke laluan sebenar yang dipadankan
oleh RE, yang merupakan ungkapan biasa dalam sintaks Python. Ini berguna untuk mencari
keluar dari mana fail yang disertakan sebenarnya berasal. Gunakan RE="" untuk mencari kesemuanya. Catatan:
amaran mesti didayakan dengan sekurang-kurangnya -d1.

--pid_file FILEPATH
Pid pelayan sertakan ditulis untuk memfailkan FILEPATH. Ini membolehkan skrip
seperti itu distcc-pam untuk meruntuhkan pelayan termasuk.

-ya, --statistik
Cetak maklumat untuk mengkaji tentang termasuk analisis.

--stat_reset_triggers=SENARAI
Siram cache statistik apabila cap waktu mana-mana laluan fail dalam LIST berubah atau
filepath masuk atau keluar dari kewujudan. LIST ialah rentetan dipisahkan bertindih bagi
filepaths, mungkin mengandungi glob ringkas (seperti yang dibenarkan oleh modul glob Python).
Cetak amaran apabila perubahan sedemikian berlaku (jika amaran didayakan). ini
pilihan membenarkan pengecualian terhad kepada andaian biasa distcc-pump sumber itu
fail tidak diubah suai semasa pembinaan.

-t, --masa
Cetak masa berlalu, pengguna dan sistem ke stderr.

--unsafe_absolute_includes
Lakukan prapemprosesan pada pelayan kompilasi walaupun termasuk laluan fail mutlak
dihadapi. Biasanya pelayan-termasuk akan kembali pada prapemprosesan tempatan
jika ia mengesan sebarang termasuk mutlak. Oleh itu, bendera ini berguna untuk mencegah sedemikian
sandaran apabila termasuk mutlak adalah penggera palsu, sama ada kerana mutlak
include dibuang semasa prapemprosesan atau kerana fail yang disertakan secara mutlak
wujud pada pelayan kompilasi.

Lebih tepat lagi, dengan --unsafe_absolute_includes termasuk mutlak diabaikan
tujuan pengumpulan termasuk penutupan. Menggunakan pilihan ini boleh menyebabkan
keputusan yang salah kerana (1) pengepala sebenarnya boleh disertakan pada
pelayan kompilasi dan ia mungkin tidak sama seperti pada klien, (2) termasuk
arahan pengepala tidak dianalisis lebih lanjut.

Pilihan ini berguna untuk menyusun kod yang mempunyai lokasi mutlak berkod keras sedemikian
fail pengepala di dalam arahan bersyarat (cth. "#ifdef") yang menjadikan
termasuk tidak relevan. Lebih tepat lagi, ini termasuk mesti dihapuskan semasa
prapemprosesan untuk konfigurasi sebenar. Kemudian persoalan kewujudan
fail pengepala dipertikaikan dan kompilasi jauh adalah bunyi. Ini selalunya berlaku jika
termasuk tersebut dimaksudkan untuk konfigurasi luar biasa yang berbeza daripada yang sebenar
konfigurasi.

-v, --sahkan
Sahkan bahawa fail dalam penutupan CPP terkandung dalam penutupan yang dikira dengan sertakan
pemproses.

-w, --write_include_closure
Tulis fail .d_approx yang menyenaraikan semua fail disertakan yang dikira mengikut sertakan
pelayan; dengan -x, selain itu tulis fail yang disertakan seperti yang dikira oleh CPP ke a
.d_exact fail.

-x, --analisis_tepat
Gunakan CPP sebaliknya, jangan tinggalkan fail pengepala sistem.

TERMASUK SERVER SYMPTOMS DAN ISU

Mesej dan amaran yang paling mungkin datang daripada pemproses termasuk disenaraikan di bawah.

Pemprosesan Pra tempatan. Termasuk server tidak meliputi: tidak boleh menentukan lalai sistem
termasuk direktori
Untuk menentukan direktori pengepala sistem lalai, pelayan sertakan menjalankan
pengkompil sekali untuk setiap bahasa yang diperlukan semasa sesinya. Mesej ini menunjukkan
bahawa pengkompil yang ditentukan kepada distcc tidak terdapat pada klien.

Pemprosesan Pra tempatan. Termasuk server tidak meliputi: Menjamin keluar kerana termasuk server
dibelanjakan lebih daripada ...s pengguna masa mengendalikan meminta
Dalam situasi yang tidak biasa, pelayan termasuk gagal menganalisis makro yang sangat rumit
ungkapan. Pelanggan distcc akan menggunakan mod distcc biasa.

Amaran: Laluan fail kemestian be relatif tetapi tidak
Pelayan termasuk tidak menerima laluan fail mutlak, seperti
/usr/include/stdio.h, dalam sertakan arahan, kerana tiada jaminan bahawa
pengepala ini pada mesin pelayan kompilasi akan sama seperti pada
pelanggan. Pelayan include berhenti menganalisis penutupan include. distcc
pelanggan tidak boleh menggunakan mod pam.

Untuk mengatasi masalah ini dengan cara yang tidak selalu boleh dipercayai, tetapkan pembolehubah persekitaran
INCLUDE_SERVER_ARGS='--unsafe_absolute_includes' apabila menggunakan distcc-pam
skrip untuk menghantar pilihan --unsafe_absolute_includes ke pelayan include.

Amaran: Absolute laluan fail ... adalah DIABAIKAN
--unsafe_absolute_includes sedang digunakan. Keadaan ini berlaku di bawah keadaan yang sama
keadaan seperti apabila "Filepath mesti relatif tetapi tidak" dikeluarkan, tetapi dalam hal ini
kes termasuk akan memberikan jawapan kepada pelanggan distcc.

Amaran: Jalan '/PATH/FAIL' berubah/datang ke dalam kewujudan/tidak lagi wujud
Amaran ini dikeluarkan apabila menggunakan pencetus tetapan semula statistik. Kerana /PATH/FILE
berubah, pelayan include mengosongkan cachenya; versi baharu fail (atau
kekurangannya) menjadikan analisis termasuk tidak sah. Mesej ini biasanya boleh
diabaikan; ia menandakan penggunaan fail yang agak tidak menentu oleh sistem binaan.
Adalah disyorkan untuk membetulkan sistem binaan supaya fail tidak ditulis semula.

Amaran: Untuk terjemahan unit ... pencarian of fail ... diselesaikan kepada ... yang jalan sebenar is
...
Amaran ini berlaku dengan --path_observation_re apabila laluan sebenar baharu sepadan dengan a
fail sumber atau tajuk diperhatikan.

DISTCC PERBINCANGAN SYMPTOMS

Interaksi antara sistem binaan, distcc, dan pelayan termasuk agaknya
kompleks. Apabila arahan distcc menerima kompilasi yang gagal daripada pelayan jauh ia
mencuba semula kompilasi secara setempat. Bahagian ini membincangkan punca percanggahan
antara kompilasi jauh dan tempatan. Ini dibenderakan oleh mesej penurunan pangkat:

__________Amaran: ... mod pam kompilasi gagal on pelayan, tetapi berjaya tempatan.
__________Distcc-pam adalah diturunkan pangkat kepada kosong mod. Lihat yang Distcc Percanggahan Gejala
seksyen in yang include_server(1) lelaki .

Skrip distcc-pump mengeluarkan mesej ini pada penghujung binaan. Ini bermakna bahawa untuk di
sekurang-kurangnya satu invocation distcc kompilasi tempatan berjaya selepas kompilasi jauh
gagal. Setiap invokasi distcc yang mana percanggahan tersebut berlaku seterusnya turut mengeluarkan a
mesej seperti:

Amaran: jauh kompilasi of '...' gagal, dicuba semula dalam negara and mendapat a berbeza hasilnya.

Turun pangkat menjadikan seruan distcc berikutnya menggunakan mod distcc biasa. Justeru
prapemprosesan akan berlaku pada mesin tempatan untuk baki binaan. ini
teknik menghalang binaan yang sangat perlahan di mana semua kompilasi berakhir pada mesin tempatan
selepas gagal dari jauh.

Sudah tentu, jika kompilasi tempatan gagal selepas kegagalan jauh, maka distcc
panggilan keluar dengan status bukan sifar kompilasi tempatan. Mesej ralat
dicetak juga adalah kompilasi tempatan.

Tingkah laku sandaran untuk mod distcc-pump kepada kompilasi setempat boleh dilumpuhkan dengan menetapkan
pembolehubah persekitaran DISTCC_FALLBACK kepada 1, yang menjadikan arahan distcc gagal secepat mungkin
kerana kompilasi jauh telah gagal. Tetapan ini sangat berguna untuk menyahpepijat mengapa
kompilasi jauh menjadi salah, kerana sekarang output dari pelayan akan dicetak.

Seterusnya kita membincangkan kemungkinan punca percanggahan.

. pengguna berubah a sumber or header fail semasa yang membina.
Ini menghasilkan keputusan yang tidak konsisten sudah tentu.

A sumber or header fail berubah semasa yang membina.
Sistem binaan menulis semula fail. Untuk kernel Linux 2.6, ini berlaku untuk
'include/linux/compile.h' dan 'include/asm/asm-offsets.h'. Keadaan ini telah ditetapkan
dengan memberitahu pelayan sertakan bahawa ia mesti menetapkan semula cachenya apabila terdapat sebarang statistik
daripada fail berubah. Secara praktikal, ini dilakukan dengan mengumpulkan fail dalam kolon-
senarai dipisahkan dan kemudian tetapkan perintah INCLUDE_SERVER_ARGS seperti dalam:

include_server_args="--stat_reset_triggers=include/linux/compile.h:include/asm/asm-
offsets.h"

A header fail is berpotensi termasuk, tetapi tidak tidak ada, and is kemudian kemudian dimasukkan.

Ini berlaku apabila beberapa pengepala foo.h menyertakan fail pengepala lain trick.h, tetapi
fail trick.h belum lagi dijana dan kemasukan sebenarnya diabaikan
kerana arahan prapemprosesan. Pelayan termasuk akan menyiasat untuk
kewujudan trick.h, kerana ia lebih menghampiri semua arahan cara yang mungkin
sebenarnya menilai. Trik fail.h ditentukan untuk tidak wujud. Kalau nanti
dihasilkan, dan kemudian benar-benar disertakan, maka pelayan sertakan akan salah percaya
bahawa fail itu masih tidak wujud. Penyelesaian kepada masalah ini adalah dengan membuat
bina sistem menjana trick.h sebelum kali pertama mana-mana fail pengepala disertakan
yang membuat rujukan sintaksis kepada muslihat.h

. termasuk server adalah bermula bersama --unsafe_absolute_includes.
Ini adalah masalah jika terdapat fail pengepala secara setempat yang tidak wujud dari jauh dan
yang sebenarnya digunakan. Termasuk sedemikian sering dilindungi oleh bersyarat
arahan yang menilai supaya sebenarnya digunakan pada khusus dan kerap sahaja
platform yang tidak biasa. Jika anda tidak menyusun untuk platform sedemikian, maka ia mungkin
betul untuk digunakan --unsafe_absolute_include.

. termasuk server mempunyai dikira yang salah merangkumi.
Kami tidak tahu keadaan sedemikian.

EXIT KOD

Kod keluar include_server.py biasanya 0. Bahawa pelayan include telah dimulakan
dikomunikasikan dengan betul melalui kewujudan pid_file.

PERSEKITARAN PELBAGAI

DISTCC_EMAILLOG_WHOM_TO_BLAME Alamat e-mel untuk digunakan untuk memasukkan pelayan automatik
e-mel. Lalai ialah 'distcc-pump-errors' (iaitu alamat e-mel yang mungkin akan
tidak wujud dalam domain anda).

Selain itu, permohonan pengkompil boleh menggunakan pembolehubah persekitaran tambahan.

Gunakan include_server dalam talian menggunakan perkhidmatan onworks.net