Attachment 61165 Details for Bug 93364 – doc/cs/distcc.xml - by domi

doc/cs/distcc.xml - by domi

distcc.xml (text/plain), 12.72 KB, created by Jan Kundrát (RETIRED) on 2005-06-13 14:06:46 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Jan Kundrát (RETIRED)

Created: 2005-06-13 14:06:46 UTC

Size: 12.72 KB

patch

obsolete

><?xml version='1.0' encoding="UTF-8"?>
><!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
>
>
><guide link="/doc/cs/distcc.xml" lang="cs">
>
><title>Distcc v&nbsp;Gentoo</title>
>
><author title="Autor">
>  <mail link="lisa@gentoo.org">Lisa Seelye</mail>
></author>
>
><author title="Editor">
>  <mail link="vapier@gentoo.org">Mike Frysinger</mail>
></author>
>
><author title="Editor">
>  <mail link="erwin@gentoo.org">Erwin</mail>
></author>
>
><author title="Editor">
>  <mail link="swift@gentoo.org">Sven Vermeulen</mail>
></author>
>
><author title="Editor">
>  <mail link="pylon@gentoo.org">Lars Weiler</mail>
></author>
>
><author title="Korektor">
>  <mail link="blubber@gentoo.org">Tiemo Kieft</mail>
></author>
>
><author title="PÅekladatel">
>  <mail link="mirek.dvorak@email.cz">Mirek DvoÅÃ¡k</mail>
></author>
>
><author title="PÅekladatel">
>  <mail link="jkt@flaska.net">Jan KundrÃ¡t</mail>
></author>
>
>
><abstract>
>Tento dokument mÃ¡ bÃ½t nÃ¡vodem, jak pouÅ¾Ãt distcc v Gentoo.
></abstract>
>
>
>
><license/>
>
><version>1.11</version>
><date>2005-03-25</date>
>
><chapter>
><title>Ãvod</title>
><section>
><title>Co je distcc?</title>
><body>
>
><p>
>Distcc je program, kterÃ½ rozloÅ¾Ã kompilaci mezi nÄkolik strojÅ¯ v&nbsp;sÃti.
>SklÃ¡dÃ¡ se ze serveru, <c>distccd</c>, a klientskÃ© ÄÃ¡sti, programu <c>distcc</c>.
>Distcc umÃ transparentnÄ pracovat s&nbsp;<uri
>link="http://ccache.samba.org">ccache</uri> i Portage, jen s&nbsp;minimem ÃºsilÃ.
></p>
>
></body>
></section>
><section>
><title>PouÅ¾itÃ distcc pÅi instalaci systÃ©mu</title>
><body>
>
><p>
>Pokud plÃ¡nujete pouÅ¾Ãt distcc pÅi instalaci Gentoo, pÅeÄtÄte si prosÃm sekci
><uri link="#bootstrapping">pouÅ¾itÃ distcc pro bootstrap systÃ©mu</uri>.
></p>
>
></body>
></section>
></chapter>
>
><chapter>
><title>NastavenÃ</title>
><section>
><title>ZÃ¡vislosti</title>
><body>
>
><p>
>Abyste mohli pouÅ¾Ãvat distcc, musÃ mÃt vÅ¡echny stroje v&nbsp;sÃti stejnou verzi
>GCC. MÅ¯Å¾ete mÃchat 3.3.x (kde je x rozdÃlnÃ©), ale <b>nelze</b> smÄÅ¡ovat 3.3.x a
>3.2.x, protoÅ¾e ve&nbsp;vÃ½slednÃ½ch programech by byly chyby.
></p>
>
></body>
></section>
><section>
><title>Instalace distcc</title>
><body>
>
><p>
>Je tu nÄkolik vÄcÃ, na kterÃ© byste si pÅed instalacÃ distcc mÄli dÃ¡t pozor.
></p>
>
><p>
>Distcc je dodÃ¡vÃ¡no s&nbsp;grafickou nadstavbou, kterÃ¡ monitoruje, jakÃ© ÄÃ¡sti
>kÃ³du, vÃ¡Å¡ stroj posÃlÃ¡ ke&nbsp;kompilaci ven. Pokud pouÅ¾ÃvÃ¡te GNOME, tak
>pÅidejte "gnome" do promÄnnÃ© USE (v&nbsp;make.conf). NepouÅ¾ÃvÃ¡te-li jej a
>pÅesto chcete monitor pouÅ¾Ãvat, nastavte USE promÄnnou "gtk".
></p>
>
><pre caption="Instalace distcc">
># <i>emerge distcc</i>
></pre>
>
></body>
></section>
><section>
><title>NastavenÃ Portage</title>
><body>
>
><p>
>NastavenÃ Portage je jednoduchÃ©. StaÄÃ udÄlat nÃ¡sledujÃcÃ kroky na kaÅ¾dÃ©m
>systÃ©mu, kterÃ½ se zÃºÄastnÃ distribuovanÃ© kompilace:
></p>
>
><pre caption="Integrace distcc a Portage">
># <i>emerge distcc</i>
># <i>nano -w /etc/make.conf</i>
><comment>(Zadej N podle svÃ© situace)</comment>
><comment>(Obvykle poÄet vÅ¡ech  CPU + 1)</comment>
>MAKEOPTS="-jN"
><comment>(PÅidejte distcc do promÄnnÃ© FEATURES)</comment>
>FEATURES="distcc" (pozn. pÅekladatele (distcc ccache â¦))
></pre>
>
></body>
></section>
><section>
><title>ZadÃ¡nÃ zÃºÄastÅujÃcÃch se strojÅ¯</title>
><body>
>
><p>
>PouÅ¾ijte pÅÃkaz <c>distcc-config</c> k&nbsp;vytvoÅenÃ seznamu ÃºÄastnÃcÃch se
>strojÅ¯. PÅÃklad konfigurace:
></p>
>
><pre caption="PÅÃklady definice seznamu strojÅ¯">
>192.168.0.1          192.168.0.2                       192.168.0.3
>192.168.0.1/2        192.168.0.2                       192.168.0.3/10
>192.168.0.1:4000/2   192.168.0.2/1                     192.168.0.3:3632/4
>@192.168.0.1         @192.168.0.2:/usr/bin/distccd     192.168.0.3
><comment>(Existuje jeÅ¡tÄ nÄkolik dalÅ¡Ãch metod, jak definovat seznam strojÅ¯;
>detaily viz manuÃ¡lovÃ¡ strÃ¡nka distcc.)</comment>
></pre>
>
><p>
>ZdÃ¡ se to komplikovanÃ©, ale ve vÄtÅ¡inÄ pÅÃpadÅ¯ budou fungovat varianty pÅÃkladÅ¯
>z&nbsp;prvnÃ nebo druhÃ© ÅÃ¡dky.
></p>
>
><ul>
>  <li>1. ÅÃ¡dka jsou jen stroje oddÄlenÃ© mezerou</li>
>  <li>
>    2. ÅÃ¡dka udÃ¡vÃ¡ maximÃ¡lnÃ mnoÅ¾stvÃ ÃºkolÅ¯, kterÃ© lze (v&nbsp;jednom okamÅ¾iku)
>    jednomu stroji poslat, pomocÃ definovÃ¡nÃ ÄÃsla <c>/N</c>
>  </li>
></ul>
>
><p>
>I kdyÅ¾ vÄtÅ¡ina lidÃ 3. a 4. ÅÃ¡dku nepouÅ¾ije, dovolujeme si VÃ¡s tÃmto <uri
>link="http://distcc.samba.org/man/distcc_1.html">nasmÄrovat na
>dokumentaci distcc</uri>, kde je moÅ¾nost zÃskat dalÅ¡Ã informace.
></p>
>
><p>
>NapÅ. pouÅ¾itÃ prvnÃ ÅÃ¡dky z&nbsp;pÅedchozÃho pÅÃkladu:
></p>
>
><pre caption="UkÃ¡zkovÃ½ pÅÃkaz nastavenÃ seznamu strojÅ¯">
># <i>/usr/bin/distcc-config --set-hosts "192.168.0.1 192.168.0.2
>192.168.0.3"</i>
></pre>
>
><p>
>Editujte podle potÅeby <path>/etc/conf.d/distccd</path> a ujistÄte se, Å¾e
>pouÅ¾ÃvÃ¡te <c>--allow</c> k&nbsp;umoÅ¾nÄnÃ pÅÃstupu jen povolenÃ½m strojÅ¯m.
>K&nbsp;dalÅ¡Ãmu zvÃ½Å¡enÃ bezpeÄnosti mÅ¯Å¾ete pouÅ¾Ãt direktivu <c>--listen</c>,
>kterÃ¡ distcc dÃ©monu ÅÃkÃ¡, na kterÃ½ch IP adresÃ¡ch mÃ¡ naslouchat (uÅ¾iteÄnÃ© pro
>systÃ©my s&nbsp;vÃce IP adresami). DalÅ¡Ã informace o zabezpeÄenÃ distcc najdete
>na strÃ¡nce <uri link="http://distcc.samba.org/security.html">Distcc Security
>Design</uri>.
></p>
>
><p>
>NynÃ spusÅ¥te distcc dÃ©mona na vÅ¡ech ÃºÄastnÃcÃch se strojÃch:
></p>
>
><pre caption="SpuÅ¡tÄnÃdistcc dÃ©mona">
><comment>(PÅidÃ¡nÃ distccd do runlevelu default)</comment>
># <i>rc-update add distccd default</i>
><comment>(SpuÅ¡tÄnÃ distcc dÃ©mona)</comment>
># <i>/etc/init.d/distccd start</i>
></pre>
>
></body>
></section>
><section>
><title>NastavenÃ spoluprÃ¡ce distcc s&nbsp;Automake</title>
><body>
>
><p>
>V&nbsp;nÄkterÃ½ch pÅÃpadech je to jednoduÅ¡Å¡Ã neÅ¾ nastavenÃ Portage. MusÃte jen
>zmÄnit promÄnnou <c>PATH</c> tak, aby obsahovala
><path>/usr/lib/distcc/bin</path> pÅed adresÃ¡Åem obsahujÃcÃm <c>gcc</c>
>(<path>/usr/bin</path>).MÃ¡ to vÅ¡ak hÃ¡Äek - pouÅ¾ÃvÃ¡te-li ccache, musÃte distcc
>dÃ¡t do promÄnnÃ© path aÅ¾ za ccache:
></p>
>
><pre caption="NastavenÃ cesty">
># <i>export PATH="/usr/lib/ccache/bin:/usr/lib/distcc/bin:${PATH}"</i>
></pre>
>
><p>
>NynÃ jiÅ¾ jen mÃsto <c>make</c> volejte <c>make -jN</c> (kde N je celÃ© ÄÃslo).
>Hodnota N zÃ¡leÅ¾Ã na VaÅ¡Ã sÃti a strojÃch, kterÃ© ke kompilaci pouÅ¾ÃvÃ¡te. JÃ¡
>pouÅ¾ÃvÃ¡m duÃ¡lnÃ P3 K6-2/400, kterÃ½ kompiluje vÅ¡echno pro mÅ¯j desktop ( 1200MHz
>Athlon Thunderbird) a pouÅ¾ÃvÃ¡m -j5. VyzkouÅ¡ejte si vlastnÃ nastavenÃ, pÅi
>kterÃ©m bude vÃ½kon nejvyÅ¡Å¡Ã.</p>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Cross-kompilace</title>
><section>
><title>PoznÃ¡mky k&nbsp;meziplatformovÃ© kompilaci</title>
><body>
>
><p>
>Cross-kompilace znamenÃ¡ vytvÃ¡ÅenÃ programÅ¯ pro jednu architekturu pomocÃ stroje
>jinÃ© architektury. JednoduÅ¡e mÅ¯Å¾ete pouÅ¾Ãt Athlon (i686) k&nbsp;vÃ½robÄ
>programu pro K6-2 (i586) nebo pouÅ¾Ãt SPARC k vÃ½robÄ programu pro PPC.
></p>
>
></body>
></section>
><section>
><title>Ãvod do cross-kompilace</title>
><body>
>
><p>
>JestliÅ¾e chcete cross-kompilaci vyzkouÅ¡et, mÄli byste se podÃvat na <uri 
>link="http://dev.gentoo.org/~vapier/CROSS-COMPILE-HOWTO">The Cross Compile 
>HOWTO</uri>; crossdev je zastaralÃ½.
></p>
>
></body>
></section>
></chapter>
>
><chapter id="bootstrapping">
><title>PouÅ¾itÃ distcc bÄhem bootstrapu systÃ©mu</title>
><section>
><title>Krok 1: konfigurace Portage</title>
><body>
>
><p>
>Nabootujte vÃ¡Å¡ stroj pomocÃ LiveCD Gentoo Linuxu a postupujte podle <uri 
>link="/doc/en/handbook/handbook-x86.xml?part=1">instalaÄnÃch instrukcÃ</uri> 
>aÅ¾ k&nbsp;bootsrappingu. Pak nakonfigurujte Portage, aby pouÅ¾Ãval distcc:
></p>
>
><pre caption="PÅedbÄÅ¾nÃ© nastavenÃ">
># <i>nano -w /etc/make.conf</i>
><comment>(PÅidejte distcc do promÄnnÃ© FEATURES)</comment>
>FEATURES="distcc"
><comment>(ZmÄÅte MAKEOPTS tak, aby obsahovalo -jN, kde N nechÅ¥
>odpovÃdÃ¡ vaÅ¡Ã sÃti a strojÅ¯m (N je celÃ© ÄÃslo))</comment>
>MAKEOPTS="-jN"
></pre>
>
><pre caption="NastavenÃ promÄnnÃ© path">
># <i>export PATH="/usr/lib/ccache/bin:/usr/lib/distcc/bin:${PATH}"</i>
></pre>
>
></body>
></section>
><section>
><title>Krok 2: instalace distcc</title>
><body>
>
><p>
>PÅed instalacÃ distcc musÃte pÅidat uÅ¾ivatele distcc do
><path>/etc/passwd</path>:
></p>
>
><pre caption="ZaloÅ¾enÃ uÅ¾ivatele distcc">
># <i>echo "distcc:x:240:2:distccd:/dev/null:/bin/false" &gt;&gt; /etc/passwd</i>
></pre>
>
><impo>
>Je dÅ¯leÅ¾itÃ© poznamenat, Å¾e pÅidat uÅ¾ivatele tÃmto zpÅ¯sobem je velmi Å¡patnÃ©.
>Ale jinak to v tÃ©to fÃ¡zi nejde, chybÃ totiÅ¾ program <c>useradd</c>, kterÃ½
>normÃ¡lnÄ pro pÅidÃ¡vÃ¡nÃ uÅ¾ivatelÅ¯ pouÅ¾ÃvÃ¡me.
></impo>
>
><p>
>Instalace distcc:
></p>
>
><pre caption="Instalace distcc na novÃ©m stroji">
># <i>USE='-*' emerge --nodeps sys-devel/distcc</i>
></pre>
>
></body>
></section>
><section>
><title>Krok 3: nastavenÃ distcc</title>
><body>
>
><p>
>K&nbsp;nastavenÃ distcc spusÅ¥te <c>distcc-config --install</c>:
></p>
>
><pre caption="DokonÄenÃ nastavenÃ distcc">
><comment>(NahraÄte host1, host2, ...  IP adresami ÃºÄastnÃcÃch se strojÅ¯)</comment>
># <i>/usr/bin/distcc-config --set-hosts "localhost host1 host2 host3 ..."</i>
><comment>PÅÃklad: <i>/usr/bin/distcc-config --set-hosts "localhost 192.168.0.4 192.168.0.6"</i></comment>
></pre>  
>
><p>
>Distcc je teÄ pÅipraven pro bootstrap! MÅ¯Å¾ete pokraÄovat v instalaci a ÅÃdit se
>normÃ¡lnÃ instalaÄnÃ pÅÃruÄkou a <e>nezapomeÅte</e> znovu nainstalovat distcc po
><c>emerge system</c>. To zajistÃ konzistenci vÅ¡ech zÃ¡vislostÃ.
></p>
>
><note>
>BÄhem bootstrapu a <c>emerge system</c> se mÅ¯Å¾e stÃ¡t, Å¾e distcc nebude pouÅ¾ito.
>To je nutnÃ©, protoÅ¾e nÄkterÃ© ebuildy s distcc neumÃ sprÃ¡vnÄ spolupracovat, takÅ¾e
>jej schvÃ¡lnÄ zakazujÃ.
></note>
>
></body>
></section>
></chapter>
>
><chapter>
><title>ProblÃ©my</title>
><section>
><title>Mozilla a Xfree</title>
><body>
>
><p>
>BÄhem instalace nÄkterÃ½ch balÃÄkÅ¯ si moÅ¾nÃ¡ vÅ¡imnete, Å¾e nÄkterÃ© z&nbsp;nich
>distcc nepouÅ¾ÃvajÃ, nejsou kompilovÃ¡ny paralelnÄ. Je to tÃm, Å¾e vÃ½vojÃ¡Åi ebuildÅ¯
>Mozilly a Xfree tuto funkci zakÃ¡zali, neboÅ¥ se o nÃ vÃ, Å¾e zpÅ¯sobuje problÃ©my.
></p>
>
><p>
>ObÄas distcc zpÅ¯sobÃ pÃ¡d kompilace. KdyÅ¾ se vÃ¡m to stane,
><uri link="http://bugs.gentoo.org">oznamte</uri>, prosÃm, chybu, uvÃtÃ¡me to.
></p>
>
></body>
></section>
><section>
><title>SpoleÄnÃ© pouÅ¾itÃ strojÅ¯ s&nbsp;hardened-gcc a normÃ¡lnÃm hardened-gcc nebude
>fungovat</title>
><body>
>
><p>
>S&nbsp;takhle dlouhÃ½m titulkem je jakÃ©koli vysvÄtlovÃ¡nÃ skoro zbyteÄnÃ©. ZkrÃ¡tka
>jestliÅ¾e plÃ¡nujete pouÅ¾itÃ distcc zÃ¡roveÅ na strojÃch, kterÃ© majÃ <uri
>link="/proj/en/hardened/etdyn-ssp.xml">PaX/hardened-gcc</uri> a dalÅ¡Ãch, kterÃ©
>jej nemajÃ, doÄkÃ¡te se problÃ©mÅ¯.
></p>
>
><p>
>ÅeÅ¡enÃ vyÅ¾aduje jistÃ½ trik; na stroji s&nbsp; PaX/hardened-gcc potÅebujete
>spustit <c>hardened-gcc -R</c> nebo v&nbsp;jÃ¡dÅe povolit ochrany PaX a spustit
><c>emerge hardened-gcc</c>. ObojÃ nenÃ Å¡patnÃ½ nÃ¡pad, protoÅ¾e vÄtÅ¡ina ochran
>poskytovanÃ½ch tÄmito balÃÄky je uÅ¾ivatelsky transparentnÃ.
></p>
>
></body>
></section>
><section>
><title>SpoleÄnÃ© pouÅ¾itÃ rÅ¯znÃ½ch verzÃ GCC</title>
><body>
>
><p>
>Pokud mÃ¡te na svÃ½ch strojÃch rÅ¯znÃ© verze GCC, budete mÃt divnÃ© potÃÅ¾e.
>ÅeÅ¡enÃm je pouÅ¾itÃ stejnÃ½ch verzÃ GCC na vÅ¡ech strojÃch.
></p>
>
><p>
>PoslednÃ verze Portage pouÅ¾ÃvajÃ pÅi kompilaci <c>${CHOST}-gcc</c> mÃsto
><c>gcc</c>. To znamenÃ¡, Å¾e pÅi kombinaci i686 s jinÃ½mi stroji (i386, i586)
>budete mÃt problÃ©my. Mohlo by pomoci <c>export CC='gcc' CXX='c++'</c> nebo toto
>zadat do <path>/etc/make.conf</path>, ale chce to otestovat. KdyÅ¾ se vÃ¡m to
>povede, poÅ¡lete mi, prosÃm zprÃ¡vu (<mail link="lisa@gentoo.org">Lisa
>Seelye</mail>).
></p>
>
></body>
></section>
></chapter>
>
><chapter>
><title>NÄco navÃc k&nbsp;distcc</title>
><section>
><title>Distcc monitory</title>
><body>
>
><p>
>Distcc je dodÃ¡vÃ¡n se dvÄma monitory. PrvnÃ, textovÄ orientovanÃ½, se jmenuje
><c>distccmon-text</c>. Jeho prvnÃ spuÅ¡tÄnÃ mÅ¯Å¾e bÃ½t trochu matoucÃ, ale
>ve&nbsp;skuteÄnosti je jeho pouÅ¾ÃvÃ¡nÃ jednoduchÃ©. KdyÅ¾ jej spustÃte bez
>parametrÅ¯, probÄhne jen jedenkrÃ¡t. Ale kdyÅ¾ mu dÃ¡te jako parametr ÄÃslo, bude
>zobrazovat informace kaÅ¾dÃ½ch N sekund kde N je parametr, kterÃ½ jste mu pÅedali.
></p>
>
><p>
>DruhÃ½ monitor je moÅ¾nÃ© pouÅ¾Ãvat jen se zapnutou podporou <c>gtk</c> nebo
><c>gnome</c> v <c>USE</c> promÄnnÃ©, je totiÅ¾ zaloÅ¾en na podpoÅe GTK+, bÄÅ¾Ã
>v&nbsp;prostÅedÃ X a je velmi roztomilÃ½.
></p>
>
><pre caption="SpouÅ¡tÄnÃ monitorÅ¯">
># <i>distccmon-text N</i>
><comment>(nebo)</comment>
># <i>distccmon-gnome</i>
><comment>Ke sledovÃ¡nÃ vyuÅ¾itÃ distcc Portagem, mÅ¯Å¾ete pouÅ¾Ãt:</comment>
># <i>DISTCC_DIR="/var/tmp/portage/.distcc/" distccmon-text N</i>
><comment>(nebo)</comment>
># <i>DISTCC_DIR="/var/tmp/portage/.distcc/" distccmon-gnome</i>
></pre>
>
><impo>
>Pokud je adresÃ¡Å distcc nÄkde jinde, musÃte odpovÃdajÃcÃm zpÅ¯sobem zmÄnit
>promÄnnou DISTCC_DIR.
></impo>
>
></body>
></section>
></chapter>
></guide>

Actions: View

Attachments on bug 93364: 59403 | 59417 | 60474 | 60929 | 60931 | 61061 | 61165