Subversion Repositories svn LFS-FR

Compare Revisions

Ignore whitespace Rev 534 → Rev 558

/tags/tBLFS-6_0/blfs/server/mail/courier.xml
0,0 → 1,955
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY courier-download-http "http://prdownloads.sourceforge.net/courier/courier-&courier-version;.tar.bz2">
<!ENTITY courier-download-ftp " ">
<!ENTITY courier-md5sum "639bb3b236914e3b86f287ce3f55264e">
<!ENTITY courier-size "4.3 MB">
<!ENTITY courier-buildsize "102 MB">
<!ENTITY courier-time "2.62 SBU">
]>
 
<sect1 id="courier" xreflabel="Courier-&courier-version;">
<sect1info>
<othername>$LastChangedBy: igor $</othername>
<date>$Date: 2005-07-29 07:17:28 $</date>
</sect1info>
<?dbhtml filename="courier.html"?>
<title>Courier-&courier-version;</title>
<indexterm zone="courier">
<primary sortas="a-Courier">Courier MTA</primary></indexterm>
 
<sect2>
<title>Introduction à <application>Courier</application></title>
 
<para>Le paquetage <application>Courier</application> contient un agent de
transport de mail (<acronym>MTA</acronym>). Il est utile pour envoyer des
courriers électroniques à d'autres utilisateurs de votre machine hôte. Il
peut aussi être configuré pour fonctionner comme un serveur de courriers
électroniques central pour votre domaine ou comme un agent de relai de
courriers électroniques. Le paquetage <application>Courier</application>
contient aussi une interface web, <acronym>IMAP</acronym>,
<acronym>IMAP</acronym>-<acronym>SSL</acronym>, <acronym>POP</acronym>3, et
<acronym>POP</acronym>3-<acronym>SSL</acronym>.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;:
<ulink url="&courier-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;:
<ulink url="&courier-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &courier-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&courier-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&courier-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&courier-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Dépendances de <application>Courier</application></title>
<sect4><title>Requis</title>
<para><xref linkend="gdbm"/></para>
</sect4>
 
<sect4><title>Optionnel</title>
<para><xref linkend="mysql"/> ou <xref linkend="postgresql"/>,
<xref linkend="Linux_PAM"/>,
<xref linkend="openssl"/>,
<xref linkend="fam"/>,
<xref linkend="openldap"/>,
<xref linkend="apache"/>,
<xref linkend="ispell"/> or <xref linkend="aspell"/>,
<xref linkend="gnupg"/>,
<xref linkend="expect"/>,
<xref linkend="gs"/> ou <xref linkend="espgs"/>,
<ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink> et
<ulink url="http://alpha.greenie.net/mgetty/">Mgetty+Sendfax</ulink></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>Courier</application></title>
<note><para>L'archive tar de <application>Courier</application> doit être
extraite par un utilisateur non privilégié, sinon le script configure
échouera.</para></note>
<para>Avant de compiler les programmes, vous devez créer l'utilisateur et le
groupe courier, qui doivent être présent lors de l'exécution du script
d'installation. En tant qu'utilisateur root, ajoutez l'utilisateur et le groupe
courier avec les commandes suivantes&nbsp;:</para>
 
<screen><userinput role="root"><command>groupadd courier &amp;&amp;
useradd -c 'Courier Mail Server' -d /dev/null \
-g courier -s /bin/false courier</command></userinput></screen>
 
<para>Le script d'installation utilise aussi l'utilisateur bin. Si vous avez
déjà un utilisateur nommé bin, cette étape peut être ignorée en toute sécurité.
</para>
 
<screen><userinput role="root"><command>useradd -c 'bin' -d /dev/null -g bin -u 1 bin</command></userinput></screen>
 
<para><application>Courierfilter</application> requiert le répertoire
<filename class="directory">/var/run/courier</filename> pour stocker tous les
fichiers pid et verrous de <application>Courier</application>.
<filename class="directory">/var/lock/subsys</filename> doit aussi exister pour
que le verrou principal de <application>Courier</application>. Exécutez les
commandes suivantes pour créer ces répertoires&nbsp;:</para>
 
<screen><userinput role="root"><command>install -d /var/run/courier -o courier -g courier -m755 &amp;&amp;
install -d /var/lock/subsys -o root -g root -m755</command></userinput></screen>
 
<para>Construisez <application>Courier</application> en tant qu'utilisateur non
privilégié avec les commandes suivantes&nbsp;:</para>
 
<screen><userinput><command>./configure --prefix=/usr --libexecdir=/usr/lib/courier \
--datadir=/usr/share/courier --sysconfdir=/etc/courier \
--localstatedir=/var/lib/courier --with-piddir=/var/run/courier \
--with-paranoid-smtpext --disable-autorenamesent \
--enable-workarounds-for-imap-client-bugs --with-db=gdbm &amp;&amp;
make</command></userinput></screen>
 
<para>De nouveau, devenez l'utilisateur root et installez
<application>Courier</application> avec les commandes suivantes&nbsp;:</para>
 
<screen><userinput role="root"><command>make install &amp;&amp;
make install-configure</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Explications des commandes</title>
 
<para><parameter>--libexecdir=/usr/lib/courier</parameter>&nbsp;: spécifie
le répertoire contenant les programmes et bibliothèques ne pouvant pas être
exécutés directement à partir de la ligne de commande.</para>
 
<para><parameter>--datadir=/usr/share/courier</parameter>&nbsp;: spécifie le
répertoire où plusieurs scripts shell, scripts <application>Perl</application>,
et fichiers de données seront installés.</para>
 
<para><parameter>--localstatedir=/var/spool/courier</parameter>&nbsp;: spécifie
le répertoire qui contiendra la queue des courriers électroniques et d'autres
données temporaires.</para>
 
<para><parameter>--with-piddir=/var/run/courier</parameter>&nbsp;: spécifie le
répertoire où les fichiers <filename>PID</filename> de
<application>Courier</application> sont stockés lorsque
<application>Courier</application> est active.</para>
 
<para><option>--with-paranoid-smtpext</option>&nbsp;: soyez paranoïaque lors du
choix des extensions <acronym>ESMTP</acronym> spécifiques à Courier. Le serveur
de courriers électroniques <application>Courier</application> définit et
implémente certaines extensions <acronym>ESMTP</acronym> expérimentales&nbsp;:
XVERP et XEXDATA. Des problèmes pourraient survenir au cas où quelqu'un utilise
le même nom pour implémenter d'autres extensions. Si cette option est spécifiée,
le serveur <acronym>ESMTP</acronym> de <application>Courier</application> vous
avertira aussi d'une fonctionnalité <acronym>ESMTP</acronym> appelée
XCOURIEREXTENSIONS et ne reonnaîtra plus aucune des extensions spécifiques à
Courier tant que le serveur distant de courriers électroniques ne supporte pas cette
fonctionnalité <acronym>ESMTP</acronym>.</para>
 
<para><option>--disable-autorenamesent</option>&nbsp;: ne pas renommer le dossier
des courriers envoyés chaque mois. Cette option peut aussi être contrôlée par
la variable d'environnement <envar>SQWEBMAIL_AUTORENAMESENT</envar>.</para>
 
<para><option>--enable-workarounds-for-imap-client-bugs</option>&nbsp;: il existe
plusieurs bogues confirmés dans quelques clients <acronym>IMAP</acronym> qui
n'implémentent pas proprement le protocole <acronym>IMAP</acronym>4rev1. Cette
option active certains contournements pour les clients <acronym>IMAP</acronym>
bogués. NOTE&nbsp;: <command>make check</command> échouera si cette option est
utilisée. Vous devez d'abord configurer sans cette option et, si tous les tests
post-configuration réussissent, relancez configure avec cette option et recompilez.</para>
 
<para><parameter>--with-db=gdbm</parameter>&nbsp;:
<application>Courier</application> requiert soit la bibliothèque de bases de
données <application><acronym>GDBM</acronym></application> soit
<application>DB</application>.
<application><acronym>GDBM</acronym></application> est utilisé si les deux sont
présentes. Cette option force la sélection de <application>GDBM</application> car
courier est actuellement cassé lorsqu'il est utilisé avec
<application>DB</application>.</para>
 
<!-- # Note - Courier will build fine with <xref linkend="db"/>, but all
the database files will not be created correctly -->
 
<para><parameter>--with-ispell=/usr/bin/aspell</parameter>&nbsp;:
Le serveur webmail de <application>Courier</application> a une fonction de
vérification d'orthographe si <command>configure</command> trouve
<application>ispell</application> ou si vous avez indiqué explicitement
l'emplacement d'<application>aspell</application>.</para>
 
<para><parameter>--enable-mimetypes=<replaceable>[emplacement du fichier
mime.types]</replaceable></parameter>&nbsp;: utilisez cette option si vous
récupérez une erreur vous indiquant que le fichier
<filename>mime.types</filename> est introuvable.</para>
</sect2>
 
<sect2 id="etc-courier-star">
<title>Configurer <application>Courier</application></title>
<indexterm zone="courier etc-courier-star">
<primary sortas="e-etc-courier-star">/etc/courier/*</primary></indexterm>
 
<sect3><title>Fichiers de configuration</title>
<para><filename>/etc/courier/*</filename></para>
</sect3>
 
<sect3><title>Informations de configuration</title>
 
<para>Toujours en tant que root, vous devez créer les fichiers suivants avec le
contenu spécifié.</para>
 
<para><filename>/etc/courier/defaultdomain</filename></para>
 
<screen><userinput role="root"><command>cat &gt; /etc/courier/defaultdomain &lt;&lt; "EOF"</command>
<replaceable>[votredomaine]</replaceable>
<command>EOF</command></userinput></screen>
 
<para><filename>/etc/courier/me</filename></para>
 
<screen><userinput role="root"><command>cat &gt; /etc/courier/me &lt;&lt; "EOF"</command>
<replaceable>[nomserveur.votredomaine]</replaceable>
<command>EOF</command></userinput></screen>
 
<para><filename>/etc/courier/locals</filename></para>
 
<screen><userinput role="root"><command>cat &gt; /etc/courier/locals &lt;&lt; "EOF"</command>
localhost
<replaceable>[votredomaine]</replaceable>
<command>EOF</command></userinput></screen>
 
<para><filename>/etc/courier/esmtpacceptmailfor.dir/system</filename></para>
 
<screen><userinput role="root"><command>cat &gt; /etc/courier/esmtpacceptmailfor.dir/system &lt;&lt; "EOF"</command>
localhost
<replaceable>[votredomaine]</replaceable>
<command>EOF</command></userinput></screen>
 
<para>Vous aurez aussi besoin de modifier le fichier
<filename>/etc/courier/aliases/system</filename> et de changer l'entrée
suivante.</para>
 
<screen><userinput>postmaster: <replaceable>[your administrator email]</replaceable></userinput></screen>
 
<para>Si vous voulez dénier l'accès d'envoi de courriers à certains hôtes, vous
aurez besoin d'éditer le fichier
<filename>/etc/courier/smtpaccess/default</filename>.</para>
 
<para>Si vous souhaitez gérer les courriers électroniques pour des domaines non
locaux incluant des domaines virtuels, vous devez les ajouter à
<filename>/etc/courier/hosteddomains</filename>. Ce fichier devrait exister que
vous ayez ou non besoin d'une liste de domaines gérés&nbsp;:</para>
 
<screen><userinput role="root"><command>touch /etc/courier/hosteddomains</command></userinput></screen>
 
<para>Une fois que les étapes ci-dessus sont terminées, vous aurez besoin
d'exécuter les commandes suivantes&nbsp;:</para>
 
<screen><userinput role="root"><command>makesmtpaccess &amp;&amp;
makehosteddomains &amp;&amp;
makealiases</command></userinput></screen>
 
<para>POur chaque utilisateur, vous devez créer un répertoire
<filename class="directory">Maildir</filename>&nbsp;:</para>
 
<screen><userinput role="root"><command>cd /home/<replaceable>[username]</replaceable> &amp;&amp;
maildirmake Maildir &amp;&amp;
chown <replaceable>[username]</replaceable>.<replaceable>[username]</replaceable> Maildir -R</command></userinput></screen>
 
<para>Si vous souhaitez utiliser <acronym>SSL</acronym> avec
<application>Courier</application>, vous devez obtenir des certificats et les
stocker dans <filename>/usr/share/courier</filename>. Vous pouvez créer en option
des certificats de tests, signés par vous-même, avec les commandes suivantes&nbsp;:
</para>
 
<screen><userinput role="root"><command>mkesmtpdcert &amp;&amp;
mkimapdcert &amp;&amp;
mkpop3dcert</command></userinput></screen>
 
<para>Tous les fichiers de configuration de <application>Courier</application>
résident dans le répertoire <filename class="directory">/etc/courier/</filename>.
Pour chaque service <acronym>SMTP</acronym>, <acronym>POP3</acronym> et
<acronym>IMAP</acronym>, vous aurez un fichier de configuration standard, et un
fichier de configuration pour <acronym>SSL</acronym>. Pour chaque service que
vous souhaitez utiliser, vous devez modifier le fichier de configuration et
changer la variable <replaceable>[DAEMON]</replaceable>START en la passant de
'NO' à 'YES'. Par exemple, pour utiliser <acronym>SMTP</acronym> avec
<acronym>SSL</acronym>, vous devrez modifier
<filename>/etc/courier/esmtpd-ssl</filename> et indiquer 'YES' comme valeur de
'ESMTPDSSLSTART'. Faites les mêmes modifications pour chaque service que vous
souhaitez utiliser avec <application>Courier</application>.</para>
 
<para>Si vous souhaitez utiliser <acronym>LDAP</acronym>, un fichier de
configuration <acronym>LDAP</acronym> devra être créé&nbsp;:</para>
 
<screen><userinput role="root"><command>echo "LDAPALIASDSTART=YES" > /etc/courier/ldapaliasd</command></userinput></screen>
 
<para>De façon similaire, si vous souhaitez utiliser le webmail, vous devez créer
le fichier de configuration du webmail&nbsp;::</para>
 
<screen><userinput role="root"><command>echo "WEBMAILDSTART=YES" > /etc/courier/webmaild</command></userinput></screen>
 
<para>Vous devez aussi copier le fichier <filename>webmail</filename> compris
dans <filename>/usr/lib/courier/courier/webmail</filename> dans le répertoire
<filename class='directory'>cgi-bin</filename> de votre serveur
<application>Apache</application>.</para>
 
<screen><userinput role="root"><command>cp -a /usr/lib/courier/courier/webmail/webmail /srv/www/cgi-bin</command></userinput></screen>
 
<para>Vous devez ensuite copier les images dans un sous-répertoire de votre
répertoire <filename class='directory'>htdocs</filename>. Le répertoire doit
se nommer <filename class='directory'>webmail</filename> ou vous devrez le
spécifier lors de la phase configure avec
<parameter>--enable-imageurl=<replaceable>[URL]</replaceable></parameter>.</para>
 
<screen><userinput role="root"><command>cp -a /usr/share/courier/sqwebmail/images /srv/www/htdocs/webmail</command></userinput></screen>
 
<para>Si vous souhaitez utiliser l'outil webadmin, vous devez copier le fichier
<filename>webadmin</filename> se trouvant dans
<filename class="directory">/usr/lib/courier/courier/webmail</filename> dans le
répertoire <filename class="directory">cgi-bin</filename> de votre serveur
<application>Apache</application>.</para>
 
<screen><userinput role="root"><command>cp -a /usr/lib/courier/courier/webmail/webadmin /srv/www/cgi-bin</command></userinput></screen>
 
<para>Vous avez aussi besoin de placer le mot de passe dans le fichier
<filename>/etc/courier/webadmin/password</filename>&nbsp;:</para>
 
<screen><userinput role="root"><command>cat &gt; /etc/courier/webadmin/password &lt;&lt; "EOF"</command>
<replaceable>[password]</replaceable>
<command>EOF</command></userinput></screen>
 
<para>Si vous n'avez pas besoin d'utiliser <acronym>SSL</acronym> sur votre
serveur <application>Apache</application>, vous aurez aussi besoin d'ajouter
<filename>/etc/courier/webadmin/unsecureok</filename>, pour être capable
d'utiliser votre outil d'administration web.</para>
 
<screen><userinput role="root"><command>touch /etc/courier/webadmin/unsecureok</command></userinput></screen>
 
<para>Si vous utilisez <application>Linux-PAM</application> sur votre système,
vous aurez besoin de créer les fichiers de configuration
<acronym>PAM</acronym>&nbsp;:</para>
 
<screen><userinput role="root"><command>cat &gt; /etc/pam.d/esmtp &lt;&lt; "EOF"</command>
# Début /etc/pam.d/esmtp
 
auth required pam_unix.so try_first_pass
account required pam_unix.so
session required pam_unix.so
 
# Fin /etc/pam.d/esmtp
<command>EOF
cat &gt; /etc/pam.d/pop3 &lt;&lt; "EOF"</command>
# Début /etc/pam.d/pop3
 
auth required pam_unix.so try_first_pass
account required pam_unix.so
session required pam_unix.so
 
# Fin /etc/pam.d/pop3
<command>EOF
cat &gt; /etc/pam.d/imap &lt;&lt; "EOF"</command>
# Début /etc/pam.d/imap
 
auth required pam_unix.so try_first_pass
account required pam_unix.so
session required pam_unix.so
 
# Fin /etc/pam.d/imap
<command>EOF
cat &gt; /etc/pam.d/webmail &lt;&lt; "EOF"</command>
# Début /etc/pam.d/webmail
 
auth required pam_unix.so try_first_pass
account required pam_unix.so
session required pam_unix.so
 
# Fin /etc/pam.d/webmail
<command>EOF</command></userinput></screen>
 
<para id="courier-init">Enfin, si vous souhaitez lancer le serveur
<application>Courier</application> au démarrage, installez le script de
démarrage <filename>/etc/rc.d/init.d/courier</filename> inclus dans le paquetage
<xref linkend="intro-important-bootscripts"/>.</para>
<indexterm zone="courier courier-init">
<primary sortas="f-courier-init">courier</primary></indexterm>
 
<screen><userinput role="root"><command>make install-courier</command></userinput></screen>
 
</sect3>
 
<!-- Begin virtual user setup * To be removed once added to the hint. -->
 
<sect3>
 
<title>Configurer pour des utilisateurs virtuels</title>
 
<para>Ces instructions configurent <application>Courier</application> pour
rechercher les utilisateurs virtuels dans une base de données
<application>MySQL</application>. Commencez pa faire les modifications suivantes
dans <filename>/etc/courier/authmysqlrc</filename>&nbsp;:</para>
 
<screen><userinput>MYSQL_SERVER localhost
MYSQL_USERNAME courier
MYSQL_PASSWORD <replaceable>[your choice]</replaceable>
MYSQL_SOCKET /var/run/mysql/mysql.sock
MYSQL_PORT 3306
MYSQL_DATABASE courier_mail
MYSQL_USER_TABLE users
MYSQL_CLEAR_PWFIELD clear
DEFAULT DOMAIN <replaceable>[your domain]</replaceable>
MYSQL_QUOTA_FIELD quota</userinput></screen>
 
<para>Connectez-vous à <application>MySQL</application>&nbsp;:</para>
 
<screen><userinput role="root"><command>mysql -p</command></userinput></screen>
 
<para>Créez la base de données <filename>courier_mail</filename> et configurez
la table users&nbsp;:</para>
 
<screen><userinput role="root"><command>CREATE DATABASE courier_mail;
USE courier_mail
CREATE TABLE users (
id char(128) DEFAULT '' NOT NULL,
crypt char(128) DEFAULT '' NOT NULL,
clear char(128) DEFAULT '' NOT NULL,
name char(128) DEFAULT '' NOT NULL,
uid int(10) unsigned DEFAULT '65534' NOT NULL,
gid int(10) unsigned DEFAULT '65534' NOT NULL,
home char(255) DEFAULT '' NOT NULL,
quota char(255) DEFAULT '' NOT NULL,
KEY id (id(128))
);</command></userinput></screen>
 
<para>Donnez tous les droits à l'utilisateur courier créé précédemment&nbsp;:</para>
 
<screen><userinput role="root"><command>GRANT ALL PRIVILEGES ON *.* TO courier@localhost \
IDENTIFIED BY '<replaceable>[password]</replaceable>' WITH GRANT OPTION;
QUIT</command></userinput></screen>
 
<para>Créez un utilisateur et un groupe virtuels, nommés mailman&nbsp;:</para>
<screen><userinput role="root"><command>groupadd -g 9000 vmailman &amp;&amp;
useradd -c 'Virtual Mailman' -g vmailman -m -k /dev/null -u 9000 vmailman</command></userinput></screen>
 
<para>Créez un répertoire mail pour un nouvel utilisateur virtuel&nbsp;:</para>
 
<screen><userinput role="root"><command>cd /home/vmailman &amp;&amp;
mkdir <replaceable>[utilisateur_virtuel]</replaceable> &amp;&amp;
cd <replaceable>[utilisateur_virtuel]</replaceable> &amp;&amp;
maildirmake Maildir &amp;&amp;
chown vmailman.vmailman Maildir -R</command></userinput></screen>
 
<para>Maintenant, connectez-vous à la base de données <application>MySQL</application>
avec l'utilisateur courier&nbsp;:</para>
 
<screen><userinput role="root"><command>mysql -u courier -p</command></userinput></screen>
 
<para>Pour ajouter l'utilisateur virtuel, vous devez saisir au moins une version
du mot de passe, soit en texte clair soit en crypté.</para>
 
<para>Ajoutez le premier utilisateur virtuel avec les commandes suivantes&nbsp;:</para>
 
<screen><userinput role="root"><command>USE courier_mail
INSERT INTO users VALUES (
'<replaceable>[utilisateur_virtuel]</replaceable>@<replaceable>[domaine.com]</replaceable>,
'<replaceable>[mot de passe crypté ou blanc]</replaceable>',
'<replaceable>[mot de passe en clair ou blanc]</replaceable>',
'<replaceable>[nom de l'utilisateur]</replaceable>',
9000,
9000,
'<replaceable>[emplacement du Maildir]</replaceable>',
'<replaceable>[quota en octets]</replaceable>
);
QUIT</command></userinput></screen>
 
<para>Par exemple&nbsp;:</para>
 
<screen><userinput role="root"><command>INSERT INTO users VALUES (
'blfsuser@linuxfromscratch.org',
'',
'password',
'BLFS User',
9000,
9000,
'/home/vmailman/blfsuser',
''
);</command></userinput></screen>
 
</sect3>
 
<!-- End of Virtual user setup -->
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<segmentedlist>
<segtitle>Programmes installés</segtitle>
<segtitle>Répertoires installés</segtitle>
<seglistitem>
<seg>addcr, authenumerate, cancelmsg, courier, courier-config,
courieresmtpd, courierfilter, courierlogger, couriermlm, couriertcpd,
couriertls, deliverquota, dotforward, esmtpd, esmtpd-msa, esmtpd-ssl,
filterctl, imapd, imapd-ssl, lockmail, mailbot, maildiracl, maildirkw,
maildirmake, maildrop, mailq, makeacceptmailfor, makealiases, makedat,
makehosteddomains, makemime, makepercentrelay, makesmtpaccess,
makesmtpaccess-msa, makeuserdb, makeuucpneighbors, mimegpg,
mkesmtpdcert, mkimapdcert, mkpop3dcert, pop3d, pop3d-ssl, preline,
pw2userdb, reformail, reformime, rmail, sendmail, sharedindexinstall,
sharedindexsplit, showconfig, showmodules, testmxlookup, userdb,
userdbpw, vchkpw2userdb, webgpg, webmaild</seg>
 
<seg>/etc/courier, /usr/lib/courier, /usr/share/courier, /var/lib/courier,
/var/lock/subsys, /var/run/courier and /var/spool/courier</seg>
 
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Descriptions courtes</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="cancelmsg">
<term><command>cancelmsg</command></term>
<listitem><para>supprime un message à partir de la queue des courriers.</para>
<indexterm zone="courier cancelmsg">
<primary sortas="b-cancelmsg">cancelmsg</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="courier-prog">
<term><command>courier</command></term>
<listitem><para>est une commande d'administration utilisée pour contrôler le
moteur <application>Courier</application>.</para>
<indexterm zone="courier courier-prog">
<primary sortas="b-courier">courier</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="courierfax">
<term><command>courierfax</command></term>
<listitem><para>envoit les courriers électroniques par fax.</para>
<indexterm zone="courier courierfax">
<primary sortas="b-courierfax">courierfax</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="courierfilter">
<term><command>courierfilter</command></term>
<listitem><para>démarre et arrête tous mes filtres de courriers électroniques
installés par <command>filterctl</command>.</para>
<indexterm zone="courier courierfilter">
<primary sortas="b-courierfilter">courierfilter</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="courierldapaliasd">
<term><command>courierldapaliasd</command></term>
<listitem><para>supporte les alias d'adresses de courrier électronique en
utilisant un carnet d'adresses LDAP.</para>
<indexterm zone="courier courierldapaliasd">
<primary sortas="b-courierldapaliasd">courierldapaliasd</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="courierlogger">
<term><command>courierlogger</command></term>
<listitem><para>capture les messages d'erreur provenant des applications
<application>Courier</application> et les renvoit au démon des traces du système.
</para>
<indexterm zone="courier courierlogger">
<primary sortas="b-courierlogger">courierlogger</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="couriermlm">
<term><command>couriermlm</command></term>
<listitem><para>initialise, maintient et gère des listes de diffusion.</para>
<indexterm zone="courier couriermlm">
<primary sortas="b-couriermlm">couriermlm</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="courierperlfilter">
<term><command>courierperlfilter</command></term>
<listitem><para>est un filtre écrit en
<application>Perl</application>.</para>
<indexterm zone="courier courierperlfilter">
<primary sortas="b-courierperlfilter">courierperlfilter</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="courierpop3d">
<term><command>courierpop3d</command></term>
<listitem><para>est un serveur <acronym>POP</acronym>3 de
<application>Courier</application>.</para>
<indexterm zone="courier courierpop3d">
<primary sortas="b-courierpop3d">courierpop3d</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="courierpop3login">
<term><command>courierpop3login</command></term>
<listitem><para>lit l'identifiant et le mot de passe <acronym>POP</acronym>3 de
l'utilisateur et les passe aux modules d'authentification.</para>
<indexterm zone="courier courierpop3login">
<primary sortas="b-courierpop3login">courierpop3login</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="couriertcpd">
<term><command>couriertcpd</command></term>
<listitem><para>accepte les connexions réseau entrantes, et exécute d'autres
programmes <application>Courier</application> après avoir établi chaque connexion
réseau.</para>
<indexterm zone="courier couriertcpd">
<primary sortas="b-couriertcpd">couriertcpd</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="couriertls">
<term><command>couriertls</command></term>
<listitem><para>est utilisé par les applications pour crypter une connexion
réseau utilisant <acronym>SSL</acronym>/<acronym>TLS</acronym>.</para>
<indexterm zone="courier couriertls">
<primary sortas="b-couriertls">couriertls</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="dotforward">
<term><command>dotforward</command></term>
<listitem><para>est un module de compatibilité qui lit les instructions de
renvoi dans <filename>$HOME/.forward</filename>.</para>
<indexterm zone="courier dotforward">
<primary sortas="b-dotforward">dotforward</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="dupfilter">
<term><command>dupfilter</command></term>
<listitem><para>est un filtre <quote>threadé</quote> qui essaie de bloquer les
spams en tentant de détecter les copies multiples du même message, qui sont
rejetées.</para>
<indexterm zone="courier dupfilter">
<primary sortas="b-dupfilter">dupfilter</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="esmtpd">
<term><command>esmtpd</command></term>
<listitem><para>est un script de contrôle pour courieresmtpd.</para>
<indexterm zone="courier esmtpd">
<primary sortas="b-esmtpd">esmtpd</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="esmtpd-msa">
<term><command>esmtpd-msa</command></term>
<listitem><para>est un script de contrôle pour courieresmtpd, mais ajoute le
port 587 pour la soumission de messages avec le protocole
<acronym>MSA</acronym>.</para>
<indexterm zone="courier esmtpd-msa">
<primary sortas="b-esmtpd-msa">esmtpd-msa</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="filterctl">
<term><command>filterctl</command></term>
<listitem><para>installe ou désintalle les filtres globaux de courriers
électroniques.</para>
<indexterm zone="courier filterctl">
<primary sortas="b-filterctl">filterctl</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="imapd">
<term><command>imapd</command></term>
<listitem><para>est le serveur
<application>Courier</application>-<acronym>IMAP</acronym>.</para>
<indexterm zone="courier imapd">
<primary sortas="b-imapd">imapd</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="lockmail">
<term><command>lockmail</command></term>
<listitem><para>est un outil d'aide pour verrouiller les fichiers mailbox.</para>
<indexterm zone="courier lockmail">
<primary sortas="b-lockmail">lockmail</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="mailbot">
<term><command>mailbot</command></term>
<listitem><para>est un outil de réponse automatique comprenant les types
<acronym>MIME</acronym>.</para>
<indexterm zone="courier mailbot">
<primary sortas="b-mailbot">mailbot</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="maildiracl">
<term><command>maildiracl</command></term>
<listitem><para>gère les listes de contrôle d'accès.</para>
<indexterm zone="courier maildiracl">
<primary sortas="b-maildiracl">maildiracl</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="maildirkw">
<term><command>maildirkw</command></term>
<listitem><para>modifie les mots clés des messages
<application>Courier</application>-<acronym>IMAP</acronym> compatibles
maildir.</para>
<indexterm zone="courier maildirkw">
<primary sortas="b-maildirkw">maildirkw</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="maildirmake">
<term><command>maildirmake</command></term>
<listitem><para>crée des répertoires maildirs.</para>
<indexterm zone="courier maildirmake">
<primary sortas="b-maildirmake">maildirmake</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="maildrop">
<term><command>maildrop</command></term>
<listitem><para>est un MDA local de remplacement, incluant un langage de filtre
de courriers électroniques.</para>
<indexterm zone="courier maildrop">
<primary sortas="b-maildrop">maildrop</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="mailq-courier">
<term><command>mailq</command></term>
<listitem><para>affiche une liste de tous les messages qui n'ont pas encore été
délivrés.</para>
<indexterm zone="courier mailq-courier">
<primary sortas="b-mailq">mailq</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="makeacceptmailfor">
<term><command>makeacceptmailfor</command></term>
<listitem><para>construit une liste des domaines d'où nous acceptons des courriers
élecroniques, à partir du répertoire
<filename class="directory">/etc/courier/esmtpacceptmailfor.dir</filename>.</para>
<indexterm zone="courier makeacceptmailfor">
<primary sortas="b-makeacceptmailfor">makeacceptmailfor</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="makealiases">
<term><command>makealiases</command></term>
<listitem><para>construit une base de données d'alias à partir d'un ou plusieurs
fichiers texte.</para>
<indexterm zone="courier makealiases">
<primary sortas="b-makealiases">makealiases</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="makedat">
<term><command>makedat</command></term>
<listitem><para>est un outil pour créer des fichiers <application>GDBM</application>
ou <application>DB</application> à partir de fichiers textes.</para>
<indexterm zone="courier makedat">
<primary sortas="b-makedat">makedat</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="makehosteddomains">
<term><command>makehosteddomains</command></term>
<listitem><para>reconstruit le contenu de la base de données hosteddomains à
partir du contenu de <filename>/tools/etc/courier/hosteddomains</filename>.</para>
<indexterm zone="courier makehosteddomains">
<primary sortas="b-makehosteddomains">makehosteddomains</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="makemime">
<term><command>makemime</command></term>
<listitem><para>crée des messages formatés <acronym>MIME</acronym> à partir d'un
ou plusieurs fichiers.</para>
<indexterm zone="courier makemime">
<primary sortas="b-makemime">makemime</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="makepercentrelay">
<term><command>makepercentrelay</command></term>
<listitem><para>construit une liste de domaines reliés à partir du répertoire
<filename class="directory">percentrelay.dir</filename>.</para>
<indexterm zone="courier makepercentrelay">
<primary sortas="b-makepercentrelay">makepercentrelay</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="makesmtpaccess">
<term><command>makesmtpaccess</command></term>
<listitem><para>construit des fichiers d'accès au serveur <acronym>ESMTP</acronym>
à partir du répertoire <filename class="directory">/etc/courier/smtpaccess</filename>.
</para>
<indexterm zone="courier makesmtpaccess">
<primary sortas="b-makesmtpaccess">makesmtpaccess</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="makesmtpaccess-msa">
<term><command>makesmtpaccess-msa</command></term>
<listitem><para>construit des fichiers d'accès au serveur <acronym>ESMTP</acronym>
à partir du répertoire <filename class="directory">/etc/courier/smtpaccess</filename>.
Cette liste esmtp est pour le protocole <acronym>MSA</acronym>.</para>
<indexterm zone="courier makesmtpaccess-msa">
<primary sortas="b-makesmtpaccess-msa">makesmtpaccess-msa</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="makeuserdb">
<term><command>makeuserdb</command></term>
<listitem><para>construit une base de données utilisateur/mot de passe à partir
du contenu de <filename class="directory">/tools/etc/courier/userdb</filename>.</para>
<indexterm zone="courier makeuserdb">
<primary sortas="b-makeuserdb">makeuserdb</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="mimegpg">
<term><command>mimegpg</command></term>
<listitem><para>signe, crypte et décrypte des messages électroniques formatés
avec <acronym>MIME</acronym> en utilisant <application>GnuPG</application>.</para>
<indexterm zone="courier mimegpg">
<primary sortas="b-mimegpg">mimegpg</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="mkesmtpdcert">
<term><command>mkesmtpdcert</command></term>
<listitem><para>crée un certificat sécurisé <acronym>SMTP</acronym> pour tests.
</para>
<indexterm zone="courier mkesmtpdcert">
<primary sortas="b-mkesmtpdcert">mkesmtpdcert</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="mkimapdcert">
<term><command>mkimapdcert</command></term>
<listitem><para>crée un certificat sécurisé <acronym>IMAP</acronym> pour tests.
</para>
<indexterm zone="courier mkimapdcert">
<primary sortas="b-mkimapdcert">mkimapdcert</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="mkpop3dcert">
<term><command>mkpop3dcert</command></term>
<listitem><para>crée un certificat sécurisé <acronym>POP3</acronym> pour tests.
</para>
<indexterm zone="courier mkpop3dcert">
<primary sortas="b-mkpop3dcert">mkpop3dcert</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="pop3d">
<term><command>pop3d</command></term>
<listitem><para>est un script d'emballage pour que <command>couriertcpd</command>
démarre et arrête le service <acronym>POP3</acronym>.</para>
<indexterm zone="courier pop3d">
<primary sortas="b-pop3d">pop3d</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="pop3d-ssl">
<term><command>pop3d-ssl</command></term>
<listitem><para>est un script d'emballage pour que <command>couriertcpd</command>
démarre et arrête le service <acronym>POP3</acronym> sur <acronym>SSL</acronym>.</para>
<indexterm zone="courier pop3d-ssl">
<primary sortas="b-pop3d-ssl">pop3d-ssl</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="preline">
<term><command>preline</command></term>
<listitem><para>ajoute des en-têtes propriétaires <filename>mbox</filename> aux
messages électroniques.</para>
<indexterm zone="courier preline">
<primary sortas="b-preline">preline</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="reformail">
<term><command>reformail</command></term>
<listitem><para>lit un message sur l'entrée standard, le reformate d'une certaine
façon et écrit le message sur la sortie standard.</para>
<indexterm zone="courier reformail">
<primary sortas="b-reformail">reformail</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="reformime">
<term><command>reformime</command></term>
<listitem><para>est un outil pour reformater les messages <acronym>MIME</acronym>.
</para>
<indexterm zone="courier reformime">
<primary sortas="b-reformime">reformime</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="sendmail-courier">
<term><command>sendmail</command></term>
<listitem><para>lit un courrier électronique et délivre le message à ses
destinataires.</para>
<indexterm zone="courier sendmail-courier">
<primary sortas="b-sendmail">sendmail</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="submit">
<term><command>submit</command></term>
<listitem><para>soumet des messages à <application>Courier</application> pour
traitement.</para>
<indexterm zone="courier submit">
<primary sortas="b-submit">submit</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="testmxlookup">
<term><command>testmxlookup</command></term>
<listitem><para>liste les noms et adresses <acronym>IP</acronym> des relais de
courriers électroniques pour recevoir des courriers du domaine.</para>
<indexterm zone="courier testmxlookup">
<primary sortas="b-testmxlookup">testmxlookup</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="userdb">
<term><command>userdb</command></term>
<listitem><para>est un script pour manipuler individuellement les entrées dans
<filename>/tools/etc/courier/userdb</filename>.</para>
<indexterm zone="courier userdb">
<primary sortas="b-userdb">userdb</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="userdbpw">
<term><command>userdbpw</command></term>
<listitem><para>lit une simple ligne de texte sur l'entrée standard, la crypte
et affiche le résultat crypté sur la sortie standard.</para>
<indexterm zone="courier userdbpw">
<primary sortas="b-userdbpw">userdbpw</primary></indexterm>
</listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/server/mail/exim.xml
0,0 → 1,434
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY exim-download-http "http://www.exim.org/ftp/exim4/exim-&exim-version;.tar.bz2">
<!ENTITY exim-download-ftp "ftp://ftp.exim.org/pub/exim/exim4/exim-&exim-version;.tar.bz2">
<!ENTITY exim-md5sum "f8f646d4920660cb5579becd9265a3bf">
<!ENTITY exim-size "1.4 MB">
<!ENTITY exim-buildsize "14.9 MB">
<!ENTITY exim-time "0.14 SBU">
]>
 
<sect1 id="exim" xreflabel="Exim-&exim-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-16 06:11:49 $</date>
</sect1info>
<?dbhtml filename="exim.html"?>
<title><application>Exim</application>-&exim-version;</title>
<indexterm zone="exim">
<primary sortas="a-Exim">Exim</primary></indexterm>
 
<sect2>
<title>Introduction to <application>Exim</application></title>
 
<para>The <application>Exim</application> package contains a Mail Transport
Agent written by the University of Cambridge, released under the
<acronym>GNU</acronym> Public License.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&exim-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&exim-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum:
&exim-md5sum;</para></listitem>
<listitem><para>Download size:
&exim-size;</para></listitem>
<listitem><para>Estimated disk space required:
&exim-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&exim-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Additional downloads</title>
<itemizedlist spacing="compact">
<listitem><para>Required patch for Berkeley DB: <ulink
url="&patch-root;/exim-&exim-version;-db43-1.patch"/></para>
</listitem></itemizedlist>
</sect3>
 
<sect3><title><application>Exim</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="db"/> or
<xref linkend="gdbm"/> or
<ulink url="http://sourceforge.net/projects/tdb">TDB</ulink></para>
</sect4>
 
<sect4><title>Optional</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="openldap"/>,
<xref linkend="openssl"/> or
<ulink url="http://www.gnu.org/software/gnutls/">GnuTLS</ulink>,
<xref linkend="cyrus-sasl"/>,
<xref linkend="mysql"/>,
<xref linkend="postgresql"/>,
<xref linkend="tcpwrappers"/> and
<xref linkend="Linux_PAM"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>Exim</application></title>
 
<para>Before building <application>Exim</application>, as the root user you
should create the group and user exim which will run the
<command>exim</command> daemon:</para>
 
<screen><userinput><command>groupadd exim &amp;&amp;
useradd -d /dev/null -c "Exim Daemon" -g exim -s /bin/false exim</command></userinput></screen>
 
<para>If you have <application>Berkeley <acronym>DB</acronym></application>
installed, apply the following patch:</para>
 
<screen><userinput><command>patch -Np1 -i ../exim-&exim-version;-db43-1.patch</command></userinput></screen>
 
<para>Install <application>Exim</application> with the following
commands:</para>
 
<screen><userinput><command>sed -e 's,^BIN_DIR.*$,BIN_DIRECTORY=/usr/sbin,' src/EDITME | \
sed -e 's,^CONF.*$,CONFIGURE_FILE=/etc/exim.conf,' | \
sed -e 's,^EXIM_USER.*$,EXIM_USER=exim,' | \
sed -e 's,^EXIM_MONITOR,#EXIM_MONITOR,' > Local/Makefile &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install &amp;&amp;
install -v -m644 doc/exim.8 /usr/share/man/man8 &amp;&amp;
install -v -d -m755 /usr/share/doc/exim-&exim-version; &amp;&amp;
install -v -m644 doc/* /usr/share/doc/exim-&exim-version; &amp;&amp;
ln -sv exim /usr/sbin/sendmail</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>sed -e ... > Local/Makefile</command>: Most of
<application>Exim</application>'s configuration options are compiled in using
the directives in <filename>Local/Makefile</filename> which is created from
the <filename>src/EDITME</filename> file. This command specifies the minimum
set of options. Descriptions for the options are listed below.</para>
 
<para><parameter>BIN_DIRECTORY=/usr/sbin</parameter>: This installs all of
<application>Exim</application>'s binaries and scripts in
<filename class='directory'>/usr/sbin</filename>.</para>
 
<para><parameter>CONFIGURE_FILE=/etc/exim.conf</parameter>: This installs
<application>Exim</application>'s main configuration file in
<filename class='directory'>/etc</filename>.</para>
 
<para><parameter>EXIM_USER=exim</parameter>: This tells
<application>Exim</application> that after the daemon no longer needs root
privileges, the process hands off the daemon to the exim user.</para>
 
<para><parameter>#EXIM_MONITOR</parameter>: This defers building the
<application>Exim</application> monitor program, as it requires
<application>X</application> Window System support, by commenting out the
<parameter>EXIM_MONITOR</parameter> line in the <filename>Makefile</filename>.
If you wish to build the monitor program, omit this <command>sed</command>
command and issue the following command before building the package (modify
<filename>Local/eximon.conf</filename>, if necessary):
<command>cp exim_monitor/EDITME Local/eximon.conf</command>.</para>
 
<para><command>ln -s exim /usr/sbin/sendmail</command>: Creates a link to
<command>sendmail</command> for applications which need it.
<application>Exim</application> will accept most
<application>Sendmail</application> command-line options.</para>
 
</sect2>
 
<sect2>
<title>Adding additional functionality</title>
 
<para>To utilize some or all of the dependency packages, you'll need to modify
<filename>Local/Makefile</filename> to include the appropriate directives and
parameters to link additional libraries before you build
<application>Exim</application>. <filename>Local/Makefile</filename> is
heavily commented with instructions on how to do this. Listed below is
additional information to help you link these dependency packages.</para>
 
<para>To use a backend database other than <application>Berkelely
DB</application>, see the instructions at <ulink
url="http://www.exim.org/exim-html-4.40/doc/html/spec_4.html#SECT4.3"/>.</para>
 
<para>For <acronym>SSL</acronym> functionality, see the instructions at <ulink
url="http://www.exim.org/exim-html-4.40/doc/html/spec_4.html#SECT4.6"/> and
<ulink
url="http://www.exim.org/exim-html-4.40/doc/html/spec_37.html#CHAP37"/>.</para>
 
<para>For <application>tcpwrappers</application> functionality, see the
instructions at <ulink
url="http://www.exim.org/exim-html-4.40/doc/html/spec_4.html#SECT4.7"/>.</para>
 
<para>For information about adding authentication mechanisms to the
build, see the instructions at <ulink
url="http://www.exim.org/exim-html-4.40/doc/html/spec_34.html#SECT34.4"/> For
specific information about using <application>Cyrus-SASL</application>, see
section 10 of the <filename>doc/NewStuff</filename> file located in the source
tree.</para>
 
<para>For information about linking <application>Linux-PAM</application>, see
the instuctions at <ulink
url="http://www.exim.org/exim-html-4.40/doc/html/spec_11.html#IX935"/>.</para>
 
<para>For information about linking database engine libraries used for
<application>Exim</application> name lookups, see the instuctions at <ulink
url="http://www.exim.org/exim-html-4.40/doc/html/spec_9.html#CHAP9"/>.</para>
 
<para>If you wish to add <application>Readline</application> support to
<application>Exim</application> when invoked in <quote>test expansion</quote>
(-bv) mode, see the information in section 8 of the
<filename>doc/NewStuff</filename> file located in the source tree.</para>
 
<para>You may wish to modify the default configuration and send log files to
syslog instead of the default
<filename class='directory'>/var/spool/exim/log</filename> directory. See the
information at <ulink
url="http://www.exim.org/exim-html-4.40/doc/html/spec_45.html#CHAP45"/>.</para>
 
</sect2>
 
<sect2>
<title>Configuring Exim</title>
 
<sect3 id="exim-config"><title>Config files</title>
 
<para><filename>/etc/exim.conf</filename> and
<filename>/etc/aliases</filename></para>
<indexterm zone="exim exim-config">
<primary sortas="e-etc-exim.conf">/etc/exim.conf</primary></indexterm>
<indexterm zone="exim exim-config">
<primary sortas="e-etc-aliases">/etc/aliases</primary></indexterm>
 
</sect3>
 
<sect3><title>Configuration Information</title>
 
<para>A default (nothing but comments) <filename>/etc/aliases</filename> file
is installed during the package installation if this file did not exist on
your system. Create the necessary aliases and start the
<application>Exim</application> daemon using the following commands:</para>
 
<screen><userinput><command>cat &gt;&gt; /etc/aliases &lt;&lt; "EOF"</command>
postmaster: root
MAILER-DAEMON: root
<command>EOF
exim -v -bi &amp;&amp;
/usr/sbin/exim -bd -q15m</command></userinput></screen>
 
<note><para>To protect an existing <filename>/etc/aliases</filename> file,
the command above appends these aliases to it. This file should be checked and
duplicate aliases removed, if present.</para></note>
 
<para>The <command>/usr/sbin/exim -bd -q15m</command> command starts the
<application>Exim</application> daemon with a 15 minute interval in processing
the mail queue. Adjust this parameter to suit your desires.</para>
 
<para id="exim-init">To automate the running of <command>exim</command> at
startup, install the <filename>/etc/rc.d/init.d/exim</filename> init script
included in the <xref linkend="intro-important-bootscripts"/> package.</para>
<indexterm zone="exim exim-init">
<primary sortas="f-exim">exim</primary></indexterm>
 
<screen><userinput><command>make install-exim</command></userinput></screen>
 
<para>The bootscript also starts the <application>Exim</application> daemon
and dispatches a queue runner process every 15 minutes. Modify the
<parameter>-q<replaceable>[time interval]</replaceable></parameter> parameter
in <filename>/etc/rc.d/init.d/exim</filename>, if necessary for your
installation.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
 
<seglistitem>
<seg>exicyclog, exigrep, exim, exim-4.43-2, exim_checkaccess, exim_dbmbuild,
exim_dumpdb, exim_fixdb, exim_lock, exim_tidydb, eximstats, exinext, exipick,
exiqgrep, exiqsumm, exiwhat and optionally, eximon and eximon.bin</seg>
<seg>None</seg>
<seg>/usr/share/doc/exim-&exim-version; and /var/spool/exim</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="exicyclog">
<term><command>exicyclog</command></term>
<listitem><para>cycles <application>Exim</application> log files.</para>
<indexterm zone="exim exicyclog">
<primary sortas="b-exicyclog">exicyclog</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exigrep">
<term><command>exigrep</command></term>
<listitem><para>searches <application>Exim</application> log files.</para>
<indexterm zone="exim exigrep">
<primary sortas="b-exigrep">exigrep</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exim-prog">
<term><command>exim</command></term>
<listitem><para>is a symlink to the <command>exim-4.43-2</command>
<acronym>MTA</acronym> daemon.</para>
<indexterm zone="exim exim-prog">
<primary sortas="g-exim">exim</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exim-4.43-2">
<term><command>exim-4.43-2</command></term>
<listitem><para>is the <application>Exim</application> mail transport
agent daemon.</para>
<indexterm zone="exim exim-4.43-2">
<primary sortas="b-exim-4.43-2">exim-4.43-2</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exim_checkaccess">
<term><command>exim_checkaccess</command></term>
<listitem><para>states whether a given recipient address from a given host is
acceptable or not.</para>
<indexterm zone="exim exim_checkaccess">
<primary sortas="b-exim_checkaccess">exim_checkaccess</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exim_dbmbuild">
<term><command>exim_dbmbuild</command></term>
<listitem><para> creates and rebuilds <application>Exim</application>
databases.</para>
<indexterm zone="exim exim_dbmbuild">
<primary sortas="b-exim_dbmbuild">exim_dbmbuild</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exim_dumpdb">
<term><command>exim_dumpdb</command></term>
<listitem><para> writes the contents of <application>Exim</application>
databases to the standard output.</para>
<indexterm zone="exim exim_dumpdb">
<primary sortas="b-exim_dumpdb">exim_dumpdb</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exim_fixdb">
<term><command>exim_fixdb</command></term>
<listitem><para>modifies data in <application>Exim</application>
databases.</para>
<indexterm zone="exim exim_fixdb">
<primary sortas="b-exim_fixdb">exim_fixdb</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exim_lock">
<term><command>exim_lock</command></term>
<listitem><para>locks a mailbox file.</para>
<indexterm zone="exim exim_lock">
<primary sortas="b-exim_lock">exim_lock</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exim_tidydb">
<term><command>exim_tidydb</command></term>
<listitem><para>removes old records from <application>Exim</application>
databases.</para>
<indexterm zone="exim exim_tidydb">
<primary sortas="b-exim_tidydb">exim_tidydb</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="eximstats">
<term><command>eximstats</command></term>
<listitem><para>generates mail statistics from <application>Exim</application>
log files.</para>
<indexterm zone="exim eximstats">
<primary sortas="b-eximstats">eximstats</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exinext">
<term><command>exinext</command></term>
<listitem><para>queries remote host retry times.</para>
<indexterm zone="exim exinext">
<primary sortas="b-exinext">exinext</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exipick">
<term><command>exipick</command></term>
<listitem><para>selects messages based on various criteria.</para>
<indexterm zone="exim exipick">
<primary sortas="b-exipick">exipick</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exiqgrep">
<term><command>exiqgrep</command></term>
<listitem><para>is a utility for selective queue listing.</para>
<indexterm zone="exim exiqgrep">
<primary sortas="b-exiqgrep">exiqgrep</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exiqsumm">
<term><command>exiqsumm</command></term>
<listitem><para>produces a summary of the messages in the mail queue.</para>
<indexterm zone="exim exiqsumm">
<primary sortas="b-exiqsumm">exiqsumm</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="exiwhat">
<term><command>exiwhat</command></term>
<listitem><para>queries running <application>Exim</application>
processes.</para>
<indexterm zone="exim exiwhat">
<primary sortas="b-exiwhat">exiwhat</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="eximon">
<term><command>eximon</command></term>
<listitem><para>is a start-up shell script for <command>eximon.bin</command>
used to set the required environment variables before running the
program.</para>
<indexterm zone="exim eximon">
<primary sortas="b-eximon">eximon</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="eximon.bin">
<term><command>eximon.bin</command></term>
<listitem><para>is a monitor program which displays current information in an
<application>X</application> window, and also contains a menu interface to
<application>Exim</application>'s command line administration options.</para>
<indexterm zone="exim eximon.bin">
<primary sortas="b-eximon.bin">eximon.bin</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/server/mail/mail.xml
0,0 → 1,26
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
 
<chapter id="server-mail">
<?dbhtml filename="mail.html"?>
<title>Logiciels serveur de courier</title>
 
<para>Les <acronym>MTA</acronym> sont des programmes transportant le mail d'une
machine à une autre. Le <acronym>MTA</acronym> traditionnel est
<command>Sendmail</command>. Néanmoins, il existe plusieurs autres choix.</para>
 
<para>Avec les serveurs <acronym>SMTP</acronym>, il y a un serveur
<acronym>POP</acronym> (qpopper) et un serveur <acronym>IMAP</acronym>
(Courier-<acronym>IMAP</acronym>).</para>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="postfix.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sendmail.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="exim.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="qpopper.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="courier.xml"/>
 
</chapter>
/tags/tBLFS-6_0/blfs/server/mail/qpopper.xml
0,0 → 1,158
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY qpopper-download-http "http://ftp.uni-koeln.de/mail/qpopper&qpopper-version;.tar.gz">
<!ENTITY qpopper-download-ftp "ftp://ftp.qualcomm.com/eudora/servers/unix/popper/qpopper&qpopper-version;.tar.gz">
<!ENTITY qpopper-md5sum "e00853280c9e899711f0b0239d3d8f86">
<!ENTITY qpopper-size "2,2&nbsp;Mo">
<!ENTITY qpopper-buildsize "9,0&nbsp;Mo">
<!ENTITY qpopper-time "0,13&nbsp;SBU">
]>
 
<sect1 id="qpopper" xreflabel="Qpopper-&qpopper-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-16 06:11:49 $</date>
</sect1info>
<?dbhtml filename="qpopper.html"?>
<title>Qpopper-&qpopper-version;</title>
<indexterm zone="qpopper">
<primary sortas="a-Qpopper">Qpopper</primary></indexterm>
 
<sect2>
<title>Introduction à <application>Qpopper</application></title>
 
<para>Le paquetage <application>Qpopper</application> contient un serveur de
courrier électronique <acronym>POP</acronym>3.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;:
<ulink url="&qpopper-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;:
<ulink url="&qpopper-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &qpopper-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&qpopper-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&qpopper-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&qpopper-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Dépendances de <application>Qpopper</application></title>
<sect4><title>Requis</title>
<para><ulink url="../server/mail.html">MTA</ulink></para>
</sect4>
 
<sect4><title>Optionnel</title>
<para><xref linkend="openssl"/>,
<xref linkend="gdbm"/>,
<xref linkend="Linux_PAM"/>, et
<xref linkend="mitkrb"/> ou <xref linkend="heimdal"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>Qpopper</application></title>
 
<para>Installez <application>Qpopper</application> avec les commandes
suivantes&nbsp;:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
 
<para>Maintenant, en tant qu'utilisateur root&nbsp;:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Configurer <application>Qpopper</application></title>
 
<sect3 id="qpopper-config"><title>Informations de configuration</title>
 
<para>Mettez à jour le fichier de configuraton de <application>Syslog</application>
et forcez le démon <command>syslogd</command> à relire le nouveau fichier pour que
les événements de <application>Qpopper</application> soient tracés&nbsp;:</para>
<indexterm zone="qpopper qpopper-config">
<primary sortas="e-etc-syslog.conf">/etc/syslog.conf</primary></indexterm>
 
<screen><userinput><command>echo "local0.notice;local0.debug /var/log/POP.log" &gt;&gt; \
/etc/syslog.conf &amp;&amp;
killall -HUP syslogd</command></userinput></screen>
 
<para>Si vous utilisez <command>inetd</command>, la commande suivante ajoutera
l'entrée <application>Qpopper</application> dans
<filename>/etc/inetd.conf</filename>&nbsp;:</para>
<indexterm zone="qpopper qpopper-config">
<primary sortas="e-etc-inetd.conf">/etc/inetd.conf</primary></indexterm>
 
<screen><userinput><command>echo "pop3 stream tcp nowait root /usr/sbin/popper popper" &gt;&gt; \
/etc/inetd.conf &amp;&amp;
killall inetd || inetd</command></userinput></screen>
 
<para>Lancez un <command>killall -HUP inetd</command> pour relire le fichier
<filename>inetd.conf</filename> modifié.</para>
 
<para>Si vous utilisez <command>xinetd</command>, la commande suivante ajoutera
l'entrée <application>Qpopper</application> dans
<filename>/etc/xinetd.conf</filename>&nbsp;:</para>
<indexterm zone="qpopper qpopper-config">
<primary sortas="e-etc-xinetd.conf">/etc/xinetd.conf</primary></indexterm>
 
<screen><userinput><command>cat &gt;&gt; /etc/xinetd.conf &lt;&lt; "EOF"</command>
service pop3
{
port = 110
socket_type = stream
protocol = tcp
wait = no
user = root
server = /usr/sbin/popper
}
<command>EOF</command></userinput></screen>
 
<para>Lancez un <command>killall -HUP xinetd</command> pour relire le fichier
<filename>xinetd.conf</filename> modifié.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<segmentedlist>
<segtitle>Programme installé</segtitle>
<segtitle>Bibliothèques installées</segtitle>
<segtitle>Répertoires installés</segtitle>
 
<seglistitem>
<seg>popper</seg>
<seg>None</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Descriptions courtes</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="popper-qpopper">
<term><command>popper</command></term>
<listitem><para>est le démon pour le protocole <acronym>POP</acronym>3.</para>
<indexterm zone="qpopper popper-qpopper">
<primary sortas="b-popper">popper</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/server/mail/postfix.xml
0,0 → 1,587
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY postfix-download-http "http://www.mirrorspace.org/postfix/official/postfix-&postfix-version;.tar.gz">
<!ENTITY postfix-download-ftp "ftp://ftp.porcupine.org/mirrors/postfix-release/official/postfix-&postfix-version;.tar.gz">
<!ENTITY postfix-md5sum "bcaa4aac80595d04c60c72844203a04d">
<!ENTITY postfix-size "1.9 MB">
<!ENTITY postfix-buildsize "81 MB">
<!ENTITY postfix-time "0.29 SBU">
]>
 
<sect1 id="postfix" xreflabel="Postfix-&postfix-version;">
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-16 06:11:49 $</date>
</sect1info>
<?dbhtml filename="postfix.html"?>
<title>Postfix-&postfix-version;</title>
<indexterm zone="postfix">
<primary sortas="a-Postfix">Postfix</primary></indexterm>
 
<sect2>
<title>Introduction to Postfix</title>
 
<para>The <application>Postfix</application> package contains a Mail
Transport Agent (<acronym>MTA</acronym>). This is useful for sending email
to other users of your host machine. It can also be configured to be a
central mail server for your domain, a mail relay agent or simply a mail
delivery agent to your local Internet Service Provider
(<acronym>ISP</acronym>).</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&postfix-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&postfix-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &postfix-md5sum;</para></listitem>
<listitem><para>Download size: &postfix-size;</para></listitem>
<listitem><para>Estimated disk space required:
&postfix-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&postfix-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>Postfix</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="db"/></para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="pcre"/>,
<xref linkend="mysql"/>,
<xref linkend="postgresql"/>,
<xref linkend="openldap"/>,
<xref linkend="openssl"/> and
<xref linkend="cyrus-sasl"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>Postfix</application></title>
 
<sect3><title>Configuring the build</title>
 
<para>The <application>Postfix</application> source tree does not contain a
<filename>configure</filename> script, rather the makefile in the
top-level directory contains a <parameter>makefiles</parameter> target that
regenerates all the other makefiles in the build tree. If you wish to
use additional software such as a database back-end for virtual users, or
<acronym>TLS</acronym>/<acronym>SSL</acronym> authentication, you will
need to regenerate the makefiles using one or more of the appropriate
<envar>CCARGS</envar> and <envar>AUXLIBS</envar> settings listed below.</para>
 
<para>Here is an example that combines the
<acronym>TLS</acronym>/<acronym>SSL</acronym> and
<application>Cyrus-SASL</application> arguments:</para>
 
<screen><userinput><command>make makefiles \
CCARGS="-DHAS_SSL -DUSE_SASL_AUTH -I/usr/include/openssl -I/usr/include/sasl" \
AUXLIBS="-L/usr/lib -R/usr/lib -lssl -lcrypto -lsasl2"</command></userinput></screen>
 
<sect4><title>SSL/TLS authentication</title>
<para>To use <acronym>SSL</acronym>/<acronym>TLS</acronym>
authentication with <application>Postfix</application>, you will first
need to apply a patch availible from
<ulink url="ftp://ftp.aet.tu-cottbus.de/pub/postfix_tls/pfixtls-0.8.18-2.1.3-0.9.7d.tar.gz"/>.
Unzip the patch tarball, and apply it with the following commands:</para>
 
<screen><userinput><command>patch -p1 &lt; ../pfixtls-0.8.18-2.1.3-0.9.7d/pfixtls.diff</command></userinput></screen>
 
<para>You will need to pass the following values to the
<command>make makefiles</command> command:</para>
 
<screen><userinput>CCARGS="-DHAS_SSL -I/usr/include/openssl" \
AUXLIBS="-L/usr/lib -lssl -lcrypto"</userinput></screen>
 
<para>To use <acronym>SSL</acronym> or <acronym>TLS</acronym> you will
also need <xref linkend="cyrus-sasl"/>.</para>
</sect4>
 
<sect4><title>Cyrus-SASL</title>
<para>To use <application>Cyrus-SASL</application> with
<application>Postfix</application>, use the following arguments:</para>
 
<screen><userinput>CCARGS="-DUSE_SASL_AUTH -I/usr/include/sasl" \
AUXLIBS="-L/usr/lib -R/usr/lib -lsasl2"</userinput></screen>
</sect4>
 
<sect4><title>OpenLDAP</title>
<para>To use <application>OpenLDAP</application> with
<application>Postfix</application>, use the following arguments:</para>
 
<screen><userinput>CCARGS="-I/usr/include -DHAS_LDAP" \
AUXLIBS="-L/usr/lib -lldap -llber"</userinput></screen>
</sect4>
 
<sect4><title>MySQL</title>
<para>To use <application>MySQL</application> with
<application>Postfix</application>, use the following arguments:</para>
 
<screen><userinput>CCARGS="-DHAS_MYSQL -I/usr/include/mysql" \
AUXLIBS="-L/usr/lib -lmysqlclient -lz -lm"</userinput></screen>
</sect4>
 
<sect4><title>PostgreSQL</title>
<para>To use <application>PostgreSQL</application> with
<application>Postfix</application>, use the following arguments:</para>
 
<screen><userinput>CCARGS="-DHAS_PGSQL -I/usr/include/postgresql" \
AUXLIBS="-L/usr/lib -lpq -lz -lm"</userinput></screen>
</sect4>
 
</sect3>
 
<sect3><title>Installing Postfix</title>
 
<para>Before you compile the program, you need to create users and groups that
will be expected to be in place when the install script executes. Add the
users and groups with the following commands:</para>
 
<screen><userinput><command>groupadd postfix &amp;&amp;
groupadd postdrop &amp;&amp;
groupadd -g 65534 nogroup &amp;&amp;
useradd -c postfix -d /dev/null -g postfix -s /bin/false postfix &amp;&amp;
useradd -c nobody -d /home -g nogroup -s /bin/bash -u 65534 nobody &amp;&amp;
chown postfix:postfix /var/mail</command></userinput></screen>
 
<para>Install <application>Postfix</application> by running the
following commands:</para>
 
<screen><userinput><command>make &amp;&amp;
sh postfix-install daemon_directory=/usr/sbin \
manpage_directory=/usr/share/man \
sample_directory=/usr/share/doc/postfix \
-non-interactive</command></userinput></screen>
 
<para>The final installation step is to install the program's documentation with
the following commands:</para>
 
<screen><userinput><command>install -d /usr/share/doc/postfix &amp;&amp;
cp -rf html/* /usr/share/doc/postfix</command></userinput></screen>
</sect3></sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>sh postfix-install ... -non-interactive</command> : This keeps
the install script from asking any questions, thereby accepting default
destination directories in all but the three cases explicitly mentioned.</para>
 
<para><command>make makefiles</command> : This command rebuilds the
makefiles throughout the source tree to use the options contained in the
<envar>CCARGS</envar> and <envar>AUXLIBS</envar> variables.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>Postfix</application></title>
 
<sect3 id="postfix-config"><title>Config files</title>
<para><filename>/etc/aliases</filename>,
<filename>/etc/postfix/main.cf</filename> and
<filename>/etc/postfix/master.cf</filename></para>
<indexterm zone="postfix postfix-config">
<primary sortas="e-etc-aliases">/etc/aliases</primary></indexterm>
<indexterm zone="postfix postfix-config">
<primary sortas="e-etc-postfix-star">/etc/postfix/*</primary></indexterm>
</sect3>
 
<sect3><title>Configuration Information</title>
 
<screen><userinput><command>cat &gt;&gt; /etc/aliases &lt;&lt; "EOF"</command>
# Begin /etc/aliases
 
MAILER-DAEMON: postmaster
postmaster: root
 
root: LOGIN
# End /etc/aliases
<command>EOF</command></userinput></screen>
 
<note><para>To protect an existing <filename>/etc/aliases</filename> file, the
above command appends these aliases to it if it exists. This file should be
checked and duplicate aliases removed, if present.</para></note>
 
<para>The <filename>/etc/aliases</filename> file that was just created or
appended, the <filename>main.cf</filename> and the
<filename>master.cf</filename> must be personalized for your system. The
<filename>aliases</filename> file needs your non-root login identity so mail
addressed to root can be forwarded to you at the user level. The
<filename>main.cf</filename> file needs your fully qualified hostname. All of
these edits can be done with <command>sed</command> commands entered into the
console with appropriate substitutions of your non-root login name for
<replaceable>[user]</replaceable> and your fully qualified hostname for
<replaceable>[localhost.localdomain]</replaceable>. You will find the
<filename>main.cf</filename> file is self documenting, so load it into your
editor to make the changes you need for your situation.</para>
 
<screen><userinput><command>sed -i "s/LOGIN/<replaceable>[user]</replaceable>/" /etc/aliases &amp;&amp;
sed -i "s/#myhostname = host.domain.tld/myhostname = \
<replaceable>[localhost.localdomain]</replaceable>/" /etc/postfix/main.cf &amp;&amp;
/usr/bin/newaliases &amp;&amp;
/usr/sbin/postfix start</command></userinput></screen></sect3>
 
<sect3 id="postfix-init"><title>Postfix init.d script</title>
 
<para>To automate the running of Postfix at startup, install the
<filename>/etc/rc.d/init.d/postfix</filename> init script included in the
<xref linkend="intro-important-bootscripts"/> package.</para>
<indexterm zone="postfix postfix-init"> <primary
sortas="f-postfix">postfix</primary></indexterm>
 
<screen><userinput><command>make install-postfix</command></userinput></screen>
 
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
 
<seglistitem>
<seg>bounce, cleanup, error, flush, lmtp, local, mailq, master,
newaliases, nqmgr, oqmgr, pickup, pipe, postalias, postcat, postconf,
postdrop, postfix, postkick, postlock, postlog, postmap, postqueue,
postsuper, proxymap, qmgr, qmqpd, sendmail, showq, smtp, smtpd, spawn,
trivial-rewrite, verify, and virtual</seg>
<seg>None</seg>
<seg>/etc/postfix and /usr/share/doc/postfix</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="bounce">
<term><command>bounce</command></term>
<listitem><para>A daemon that maintains per-message log files with
non-delivery status information.</para>
<indexterm zone="postfix bounce">
<primary sortas="b-bounce">bounce</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="cleanup">
<term><command>cleanup</command></term>
<listitem><para>A daemon that processes inbound mail, inserts it into the
incoming mail queue, and informs the queue manager of its arrival.</para>
<indexterm zone="postfix cleanup">
<primary sortas="b-cleanup">cleanup</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="error">
<term><command>error</command></term>
<listitem><para>A deamon that processes non-delivery requests from the
queue manager.</para>
<indexterm zone="postfix error">
<primary sortas="b-error">error</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="flush">
<term><command>flush</command></term>
<listitem><para>A daemon that maintains a record of deferred mail by
destination.</para>
<indexterm zone="postfix flush">
<primary sortas="b-flush">flush</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="lmtp">
<term><command>lmtp</command></term>
<listitem><para>A daemon that processes message delivery requests from the
queue manager.</para>
<indexterm zone="postfix lmtp">
<primary sortas="b-lmtp">lmtp</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="local">
<term><command>local</command></term>
<listitem><para>A daemon that processes delivery requests from the queue
manager to deliver mail to local recipients.</para>
<indexterm zone="postfix local">
<primary sortas="b-local">local</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="mailq">
<term><command>mailq</command></term>
<listitem><para>A symlink to <filename>sendmail</filename>.</para>
<indexterm zone="postfix mailq">
<primary sortas="b-mailq">mailq</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="master">
<term><command>master</command></term>
<listitem><para>The resident process that runs
<application>Postfix</application> daemons on demand.</para>
<indexterm zone="postfix master">
<primary sortas="b-master">master</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="newaliases">
<term><command>newaliases</command></term>
<listitem><para>A symlink to <filename>sendmail</filename>.</para>
<indexterm zone="postfix newaliases">
<primary sortas="b-newaliases">newaliases</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="nqmgr">
<term><command>nqmgr</command></term>
<listitem><para>A daemon that awaits the arrival of incoming mail and
arranges for its delivery.</para>
<indexterm zone="postfix nqmgr">
<primary sortas="b-nqmgr">nqmgr</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="oqmgr">
<term><command>oqmgr</command></term>
<listitem><para>The old style queue manager. This will be removed
soon.</para>
<indexterm zone="postfix oqmgr">
<primary sortas="b-oqmgr">oqmgr</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="pickup">
<term><command>pickup</command></term>
<listitem><para>A daemon that waits for hints that new mail has been
dropped into the maildrop directory, and feeds it into the
<application>cleanup</application> daemon.</para>
<indexterm zone="postfix pickup">
<primary sortas="b-pickup">pickup</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="pipe">
<term><command>pipe</command></term>
<listitem><para>A daemon that processes requests from the queue
manager to deliver messages to external commands.</para>
<indexterm zone="postfix pipe">
<primary sortas="b-pipe">pipe</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="postalias">
<term><command>postalias</command></term>
<listitem><para>Creates or queries one or more
<application>Postfix</application> alias databases, or updates an
existing one.</para>
<indexterm zone="postfix postalias">
<primary sortas="b-postalias">postalias</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="postcat">
<term><command>postcat</command></term>
<listitem><para>Prints the contents of the
<application>named</application> files in human readable format.</para>
<indexterm zone="postfix postcat">
<primary sortas="b-postcat">postcat</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="postconf">
<term><command>postconf</command></term>
<listitem><para>Displays or changes the value of
<application>Postfix</application> configuration parameters.</para>
<indexterm zone="postfix postconf">
<primary sortas="b-postconf">postconf</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="postdrop">
<term><command>postdrop</command></term>
<listitem><para>Creates a file in the maildrop directory and copies
it's standard input to the file.</para>
<indexterm zone="postfix postdrop">
<primary sortas="b-postdrop">postdrop</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="postfix-bin">
<term><command>postfix</command></term>
<listitem><para>Controls the operation of the
<application>Postfix</application> mail system.</para>
<indexterm zone="postfix postfix-bin">
<primary sortas="b-postfix">postfix</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="postkick">
<term><command>postkick</command></term>
<listitem><para>Sends requests to the specified service over a
local transport channel.</para>
<indexterm zone="postfix postkick">
<primary sortas="b-postkick">postkick</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="postlock">
<term><command>postlock</command></term>
<listitem><para>Locks a mail folder for exclusive use, and executes
commands passed to it.</para>
<indexterm zone="postfix postlock">
<primary sortas="b-postlock">postlock</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="postlog">
<term><command>postlog</command></term>
<listitem><para>A <application>Postfix</application>-compatible logging
interface for use in, for example, shell scripts.</para>
<indexterm zone="postfix postlog">
<primary sortas="b-postlog">postlog</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="postmap">
<term><command>postmap</command></term>
<listitem><para>Creates or queries one or more Postfix lookup
tables, or updates an existing one.</para>
<indexterm zone="postfix postmap">
<primary sortas="b-postmap">postmap</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="postqueue">
<term><command>postqueue</command></term>
<listitem><para>The <application>Postfix</application> user interface for
queue management.</para>
<indexterm zone="postfix postqueue">
<primary sortas="b-postqueue">postqueue</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="postsuper">
<term><command>postsuper</command></term>
<listitem><para>The <application>Postfix</application> user interface for
superuser queue management.</para>
<indexterm zone="postfix postsuper">
<primary sortas="b-postsuper">postsuper</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="proxymap">
<term><command>proxymap</command></term>
<listitem><para>Provides read-only table lookup services to other
<application>Postfix</application> processes.</para>
<indexterm zone="postfix proxymap">
<primary sortas="b-proxymap">proxymap</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="qmgr">
<term><command>qmgr</command></term>
<listitem><para>A daemon that awaits the arrival of incoming mail and
arranges for its delivery.</para>
<indexterm zone="postfix qmgr">
<primary sortas="b-qmgr">qmgr</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="qmqpd">
<term><command>qmqpd</command></term>
<listitem><para>A daemon that receives one message per connection, and
pipes it through the <application>cleanup</application> daemon, and
places it into the incoming queue.</para>
<indexterm zone="postfix qmqpd">
<primary sortas="b-qmqpd">qmqpd</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="sendmail-postfix">
<term><command>sendmail</command></term>
<listitem><para>The <application>Postfix</application> to
<application>Sendmail</application> compatibility interface.</para>
<indexterm zone="postfix sendmail-postfix">
<primary sortas="b-sendmail">sendmail</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="showq">
<term><command>showq</command></term>
<listitem><para>A daemon that reports the Postfix mail queue status.</para>
<indexterm zone="postfix showq">
<primary sortas="b-showq">showq</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="smtp">
<term><command>smtp</command></term>
<listitem><para>Looks up a list of mail exchanger addresses for the
destination host, sorts the list by preference, and connects to
each listed address until it finds a server that responds.</para>
<indexterm zone="postfix smtp">
<primary sortas="b-smtp">smtp</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="smtpd">
<term><command>smtpd</command></term>
<listitem><para>Accepts network connection requests and performs zero
or more SMTP transactions per connection.</para>
<indexterm zone="postfix smtpd">
<primary sortas="b-smtpd">smtpd</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="spawn">
<term><command>spawn</command></term>
<listitem><para>Listens on a port as specified in the
<application>Postfix</application> <filename>master.cf</filename> file
and spawns an external command whenever a connection is established.</para>
<indexterm zone="postfix spawn">
<primary sortas="b-spawn">spawn</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="trivial-rewrite">
<term><command>trivial-rewrite</command></term>
<listitem><para>A daemon that rewrites addresses to standard form.</para>
<indexterm zone="postfix trivial-rewrite">
<primary sortas="b-trivial-rewrite">trivial-rewrite</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="verify">
<term><command>verify</command></term>
<listitem><para>Maintains a record of what recipient addresses are known
to be deliverable or undeliverable.</para>
<indexterm zone="postfix verify">
<primary sortas="b-verify">verify</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="virtual">
<term><command>virtual</command></term>
<listitem><para>Delivers mail to virtual user's mail directories.</para>
<indexterm zone="postfix virtual">
<primary sortas="b-virtual">virtual</primary></indexterm>
</listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/server/mail/sendmail.xml
0,0 → 1,337
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY sendmail-download-ftp "ftp://ftp.sendmail.org/pub/sendmail/sendmail.&sendmail-version;.tar.gz">
<!ENTITY sendmail-download-http "http://www.sendmail.org/ftp/sendmail.&sendmail-version;.tar.gz">
<!ENTITY sendmail-md5sum "2809fbf9c8b067947b650d0128928d05">
<!ENTITY sendmail-size "1.9 MB">
<!ENTITY sendmail-buildsize "18.8 MB">
<!ENTITY sendmail-time "0.38 SBU">
]>
 
<sect1 id="sendmail" xreflabel="Sendmail-&sendmail-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-16 06:11:49 $</date>
</sect1info>
<?dbhtml filename="sendmail.html"?>
<title>Sendmail-&sendmail-version;</title>
<indexterm zone="sendmail">
<primary sortas="a-Sendmail">Sendmail</primary></indexterm>
 
<sect2>
<title>Introduction to <application>Sendmail</application></title>
 
<para>The <application>Sendmail</application> package contains a Mail
Transport Agent (<acronym>MTA</acronym>).</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&sendmail-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&sendmail-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &sendmail-md5sum;</para></listitem>
<listitem><para>Download size: &sendmail-size;</para></listitem>
<listitem><para>Estimated disk space required:
&sendmail-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&sendmail-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>Sendmail</application> dependencies</title>
 
<sect4><title>Required</title>
<para><xref linkend="db"/> and <xref linkend="procmail"/></para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="openssl"/>,
<xref linkend="openldap"/>,
<xref linkend="tcpwrappers"/>,
<xref linkend="pcre"/>,
<xref linkend="cyrus-sasl"/>,
<ulink url="http://www-dev.cites.uiuc.edu/ph/nph/">nph</ulink>, and
<xref linkend="gs"/> or <xref linkend="espgs"/> (for creating
<acronym>PDF</acronym> documentation)</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>Sendmail</application></title>
 
<para>Before building <application>Sendmail</application>, create the users,
groups and directories that <application>Sendmail</application> requires
with the following commands issued as the root user:</para>
 
<screen><userinput role='root'><command>groupadd smmsp &amp;&amp;
groupadd mail &amp;&amp;
useradd -c "Sendmail Daemon" -g smmsp -G mail smmsp &amp;&amp;
chmod 1777 /var/mail &amp;&amp;
mkdir /var/spool/mqueue</command></userinput></screen>
 
<para><emphasis>Note:</emphasis> See the source tree
<filename>sendmail/README</filename> file for information on linking optional
packages into the build. Use the example below, which adds support for
<application>tcpwrappers</application>, <acronym>SASL</acronym>,
Start<acronym>TLS</acronym>
(<application>Open<acronym>SSL</acronym></application>) and
<application>Open<acronym>LDAP</acronym></application>, as a starting point.
Of course, modify it to suit your particular needs.</para>
 
<screen><userinput><command>cat &gt;&gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>
APPENDDEF(`confENVDEF',`-DSTARTTLS -DTCPWRAPPERS -DSASL -DLDAPMAP')
APPENDDEF(`confLIBS', `-lssl -lcrypto -lwrap -lsasl2 -lldap -llber')
APPENDDEF(`confINCDIRS', `-I/usr/include/sasl')
<command>EOF</command></userinput></screen>
 
<para>Install <application>Sendmail</application> with the following
commands:</para>
 
<screen><userinput><command>cat &gt;&gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>
define(`confMANGRP',`root')
define(`confMANOWN',`root')
define(`confSBINGRP',`root')
define(`confUBINGRP',`root')
define(`confUBINOWN',`root')
<command>EOF
cd sendmail &amp;&amp;
sh Build &amp;&amp;
cd ../cf/cf &amp;&amp;
cp generic-linux.mc sendmail.mc &amp;&amp;
sh Build sendmail.cf</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>install -v -d -m755 /etc/mail &amp;&amp;
sh Build install-cf &amp;&amp;
cd ../../ &amp;&amp;
sh Build install &amp;&amp;
cp -v -R cf/* /etc/mail &amp;&amp;
cp -v cf/cf/{submit,sendmail}.mc /etc/mail &amp;&amp;
for manpage in sendmail editmap mailstats makemap praliases smrsh
do
install -v -m444 $manpage/$manpage.8 /usr/share/man/man8
done &amp;&amp;
install -v -m444 sendmail/aliases.5 /usr/share/man/man5 &amp;&amp;
install -v -m444 sendmail/mailq.1 /usr/share/man/man1 &amp;&amp;
install -v -m444 sendmail/newaliases.1 /usr/share/man/man1 &amp;&amp;
install -v -m444 vacation/vacation.1 /usr/share/man/man1</command></userinput></screen>
 
<para>Install the <application>Sendmail</application> Installation and
Operations Guide with the following commands:</para>
 
<screen><userinput><command>cd doc/op &amp;&amp;
sed -i -e 's/groff/GROFF_NO_SGR=1 groff/' Makefile &amp;&amp;
make op.txt op.pdf</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>install -v -d -m755 /usr/share/doc/sendmail-&sendmail-version; &amp;&amp;
install -v -m644 op.ps op.txt op.pdf \
/usr/share/doc/sendmail-&sendmail-version; &amp;&amp;
cd ../../</command></userinput></screen>
 
<para><emphasis>Note:</emphasis> remove <filename>op.pdf</filename> from the
<command>make</command> and <command>install</command> commands if you don't
have <application>Ghostscript</application> installed.</para>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>cat &gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>:
This creates a configuration file changing some of the default settings.</para>
 
<para><command>sh Build; sh Build sendmail.cf; sh Build install-cf;
sh Build install</command>: <application>Sendmail</application> uses an
<application>m4</application> based build script to create the various
<filename>Makefile</filename>'s. These commands build and install the
package.</para>
 
<para><command>for manpage in...;do...;done; install ...</command>: The man
pages are installed already formatted and <command>man</command> displays them
somewhat garbled. These commands replace the formatted pages with
pages <command>man</command> can display properly.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>Sendmail</application></title>
 
<sect3 id="sendmail-config"><title>Config files</title>
<para><filename>/etc/mail/*</filename></para>
<indexterm zone="sendmail sendmail-config">
<primary sortas="e-etc-mail">/etc/mail/*</primary></indexterm>
</sect3>
 
<sect3><title>Configuration information</title>
 
<para>Create the <filename>/etc/mail/local-host-names</filename> and
<filename>/etc/mail/aliases</filename> files using the following
commands as the root user:</para>
 
<screen><userinput role='root'><command>echo $(hostname) > /etc/mail/local-host-names
cat &gt; /etc/mail/aliases &lt;&lt; "EOF"</command>
postmaster: root
MAILER-DAEMON: root
 
<command>EOF
newaliases -v</command></userinput></screen>
 
<para><application>Sendmail</application>'s primary configuration file,
<filename>/etc/mail/sendmail.cf</filename>, is complex and not meant to be
directly edited. The recommended method to make changes is to modify
<filename>/etc/mail/sendmail.mc</filename>, and various
<application>m4</application> files, then run the <command>m4</command>
macro processor from within <filename class='directory'>/etc/mail</filename>
as follows:</para>
 
<screen><userinput><command>m4 m4/cf.m4 sendmail.mc > sendmail.cf</command></userinput></screen>
 
<para>A full explanation of the files to modify, and the available parameters
can be found in <filename>/etc/mail/README</filename>.</para>
 
<para id="sendmail-init">To automate the running of
<application>Sendmail</application> at startup, install the
<filename>/etc/rc.d/init.d/sendmail</filename> init script included in the
<xref linkend="intro-important-bootscripts"/> package.</para>
<indexterm zone="sendmail sendmail-init">
<primary sortas="f-sendmail-init">sendmail</primary></indexterm>
 
<screen><userinput role='root'><command>make install-sendmail</command></userinput></screen>
 
<note><para>The -qNm option to <command>sendmail</command>, where N is number
of minutes, controls how often <application>Sendmail</application> will process
the mail queue. A default of 5 minutes is used in the init script. Individual
workstation users may want to set this as low as 1 minute, large installations
handling more mail may want to set it higher.</para></note>
 
</sect3>
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>editmap, hoststat, mailstats, mailq, makemap, newaliases, praliases,
purgestat, sendmail, smrsh and vacation</seg>
<seg>None</seg>
<seg>/etc/mail and /usr/share/doc/sendmail-&sendmail-version;</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="editmap">
<term><command>editmap</command></term>
<listitem><para>queries and edits <application>Sendmail</application> map
files.</para>
<indexterm zone="sendmail editmap">
<primary sortas="b-editmap">editmap</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="hoststat">
<term><command>hoststat</command></term>
<listitem><para>prints <application>Sendmail</application>'s persistent host
status.</para>
<indexterm zone="sendmail hoststat">
<primary sortas="b-hoststat">hoststat</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="mailstats">
<term><command>mailstats</command></term>
<listitem><para>displays <application>Sendmail</application> statistics.</para>
<indexterm zone="sendmail mailstats">
<primary sortas="b-mailstats">mailstats</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="mailq-sendmail">
<term><command>mailq</command></term>
<listitem><para>prints a summary of outbound mail messages waiting for
delivery.</para>
<indexterm zone="sendmail mailq-sendmail">
<primary sortas="b-mailq">mailq</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="makemap">
<term><command>makemap</command></term>
<listitem><para>creates <application>Sendmail</application> map files.</para>
<indexterm zone="sendmail makemap">
<primary sortas="b-makemap">makemap</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="newaliases-sendmail">
<term><command>newaliases</command></term>
<listitem><para>rebuilds <filename>/etc/mail/aliases.db</filename> from the
contents of <filename>/etc/mail/aliases</filename>.</para>
<indexterm zone="sendmail newaliases-sendmail">
<primary sortas="b-newaliases">newaliases</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="praliases">
<term><command>praliases</command></term>
<listitem><para>displays current <application>Sendmail</application>
aliases.</para>
<indexterm zone="sendmail praliases">
<primary sortas="b-praliases">praliases</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="purgestat">
<term><command>purgestat</command></term>
<listitem><para> causes <application>Sendmail</application> to clear (purge)
all its host-status information.</para>
<indexterm zone="sendmail purgestat">
<primary sortas="b-purgestat">purgestat</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="sendmail-prog-sendmail">
<term><command>sendmail</command></term>
<listitem><para>is the <application>Sendmail</application> mail transport
agent.</para>
<indexterm zone="sendmail sendmail-prog-sendmail">
<primary sortas="b-sendmail">sendmail</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="smrsh">
<term><command>smrsh</command></term>
<listitem><para>is a restricted shell for
<application>Sendmail</application>.</para>
<indexterm zone="sendmail smrsh">
<primary sortas="b-smrsh">smrsh</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="vacation-sendmail">
<term><command>vacation</command></term>
<listitem><para>is an email auto responder.</para>
<indexterm zone="sendmail vacation-sendmail">
<primary sortas="b-vacation">vacation</primary></indexterm>
</listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/server/other/other.xml
0,0 → 1,30
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
 
<chapter id="server-other">
<?dbhtml filename="other.html"?>
<title>Autres logiciels serveurs</title>
 
<para>Ici vous trouverez plusieurs façons de partager votre machine avec le
reste du monde ou avec votre réseau local. Avant d'installer tout package dans
ce chapitre, vous aurez besoin de vous assurer de bien comprendre ce que fait le
package et comment le configurer correctement. Il pourrait aussi être utile pour
apprendre les conséquences d'une configuration incorrecte de façon à analyser
les risques.</para>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bind.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="cvsserver.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="svnserver.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcp.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="leafnode.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="openssh.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="rsync.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="openldap.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="samba3.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xinetd.xml"/>
 
</chapter>
/tags/tBLFS-6_0/blfs/server/other/cvsserver.xml
0,0 → 1,176
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
]>
 
<sect1 id="cvsserver" xreflabel="Running a CVS Server">
<sect1info>
<othername>$LastChangedBy: igor $</othername>
<date>$Date: 2005-06-16 06:11:50 $</date>
</sect1info>
<?dbhtml filename="cvsserver.html"?>
<title>Administrer un serveur CVS</title>
 
<sect2>
<title>Administrer un serveur <acronym>CVS</acronym></title>
 
<para>Cette section décrira comment configurer, administrer et sécuriser un
serveur <acronym>CVS</acronym>.</para>
 
<sect3><title>Dépendances du <application>serveur CVS</application></title>
<sect4><title>Requis</title>
<para><xref linkend="cvs"/> et <xref linkend="openssh"/></para></sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Configurer un serveur <acronym>CVS</acronym>.</title>
 
<para>Un serveur <acronym>CVS</acronym> sera configuré en utilisant OpenSSH comme
méthode d'accès distant. Les autres méthodes d'accès, incluant :pserver: et
:server: ne seront pas utilisées pour les accès en écriture sur le dépôt
<acronym>CVS</acronym>. La méthode :pserver: envoit les mots de passe en texte
clair sur le réseau et la méthode :server: n'est pas acceptée dans tous les ports
<acronym>CVS</acronym>. Des instructions pour un accès anonyme, en lecture seule,
du <acronym>CVS</acronym> utilisant :pserver: est disponible à la fin de cette
section.</para>
 
<para>La configuration du serveur <acronym>CVS</acronym> se fait en quatre
étapes&nbsp;:</para>
 
<sect3><title>1. Créez un dépôt.</title>
<para>Créez un nouveau dépôt <acronym>CVS</acronym> avec les commandes
suivantes&nbsp;:</para>
<screen><userinput><command>mkdir /srv/cvsroot &amp;&amp;
chmod 1777 /srv/cvsroot &amp;&amp;
export CVSROOT=/srv/cvsroot &amp;&amp;
cvs init</command></userinput></screen></sect3>
 
<sect3><title>2. Importez le code source dans le dépôt.</title>
<para>Importez un module source dans le dépôt en suivant les commandes suivantes,
lancées à partir d'un compte utilisateur sur la même machine que le dépôt
<acronym>CVS</acronym>&nbsp;:</para>
 
<screen><userinput><command>cd <replaceable>[sourcedir]</replaceable> &amp;&amp;
cvs import -m "<replaceable>[repository test]</replaceable>" <replaceable>[cvstest]</replaceable> <replaceable>[vendortag]</replaceable> <replaceable>[releasetag]</replaceable></command></userinput></screen></sect3>
 
<sect3><title>3. Vérifiez l'accès local au dépôt.</title>
<para>Testez l'accès au dépôt <acronym>CVS</acronym> à partir du même compte
utilisateur avec la commande suivante&nbsp;:</para>
 
<screen><userinput><command>cvs co cvstest</command></userinput></screen></sect3>
 
<sect3><title>4. Vérifiez l'accès distant au dépôt.</title>
<para>Testez l'accès au dépôt <acronym>CVS</acronym> à partir d'une machine
distante en utilisant un compte utilisateur qui a un accès
<command>ssh</command> au serveur <acronym>CVS</acronym> avec les commandes
suivantes&nbsp;:</para>
<note><para>Remplacez <replaceable>[nomserveur]</replaceable> avec l'adresse
<acronym>IP</acronym> ou le nom de l'hôte de la machine contenant le dépôt
<acronym>CVS</acronym>. Le mot de passe shell de l'utilisateur vous sera démandé
avant que la récupération du <acronym>CVS</acronym> ne se poursuive.</para></note>
 
 
<screen><userinput><command>export CVS_RSH=/usr/bin/ssh &amp;&amp;
cvs -d:ext:<replaceable>[nomserveur]</replaceable>:/srv/cvsroot co cvstest</command></userinput></screen></sect3>
</sect2>
<sect2>
<title>Configurer <acronym>CVS</acronym> pour un accès anonyme en lecture seule.</title>
 
<para><acronym>CVS</acronym> peut être configuré pour accepter un accès anonyme
en lecture seule en utilisant la méthode :pserver: et en se connectant en tant
que root après avoir exécuté les commandes suivantes&nbsp;:</para>
 
<screen><userinput><command>(grep anonymous /etc/passwd || useradd anonymous -s /bin/false) &amp;&amp;
echo anonymous: &gt; /srv/cvsroot/CVSROOT/passwd &amp;&amp;
echo anonymous &gt; /srv/cvsroot/CVSROOT/readers</command></userinput></screen>
 
<para>Si vous utilisez <command>inetd</command>, la commande suivante ajoutera
l'entrée dans <filename>/etc/inetd.conf</filename>&nbsp;:</para>
 
<screen><userinput><command>echo "2401 stream tcp nowait root /usr/bin/cvs cvs -f \
--allow-root=/srv/cvsroot pserver" &gt;&gt; /etc/inetd.conf</command></userinput></screen>
 
<para>Lancez un <command>killall -HUP inetd</command> pour relire le fichier
<filename>inetd.conf</filename> modifié.</para>
 
<para>Si vous utilisez <command>xinetd</command>, la commande suivante ajoutera
l'entrée pserver dans <filename>/etc/xinetd.conf</filename>&nbsp;:</para>
 
<screen><userinput><command>cat &gt;&gt; /etc/xinetd.conf &lt;&lt; "EOF"</command>
service cvspserver
{
port = 2401
socket_type = stream
protocol = tcp
wait = no
user = root
passenv = PATH
server = /usr/bin/cvs
server_args = -f --allow-root=/srv/cvsroot pserver
}
<command>EOF</command></userinput></screen>
<para>Lancez un <command>/etc/rc.d/init.d/xinetd reload</command> pour relire
le fichier <filename>xinetd.conf</filename> modifié.</para>
 
<para>Tester l'accès anonyme vers le nouveau dépôt requiert un compte sur une
autre machine pouvant atteindre le serveur <acronym>CVS</acronym> via le réseau.
Aucun compte sur le dépôt <acronym>CVS</acronym> n'est nécessaire. Pour tester
l'accès anonyme au dépôt <acronym>CVS</acronym>, connectez-vous sur une autre
machine en tant qu'utilisateur non privilégié et exécutez la commande
suivante&nbsp;:
</para>
 
<screen><userinput><command>cvs -d:pserver:anonymous@<replaceable>[nomserveur]</replaceable>:/srv/cvsroot co cvstest</command></userinput></screen>
<note><para>Replace <replaceable>[nomserveur]</replaceable> with the
<acronym>IP</acronym> address or hostname of the
<acronym>CVS</acronym> server.</para></note>
 
</sect2>
 
<sect2>
<title>Explications des commandes</title>
 
<para><command>mkdir /srv/cvsroot</command>&nbsp;: crée le répertoire du dépôt
<acronym>CVS</acronym>.</para>
 
<para><command>chmod 1777 /srv/cvsroot</command>&nbsp;: configure les droits
stiky bit pour <envar>CVSROOT</envar>.</para>
 
<para><command>export CVSROOT=/srv/cvsroot</command>&nbsp;: spécifie le nouveau
<envar>CVSROOT</envar> pour toutes les commandes <command>cvs</command>.</para>
 
<para><command>cvs init</command>&nbsp;: initialise le nouveau dépôt
<acronym>CVS</acronym>.</para>
 
<para><command>cvs import -m "repository test" cvstest vendortag
releasetag</command>&nbsp;: tous les modules de code source doivent être importés
dans le dépôt <acronym>CVS</acronym> avant utilisation, avec la commande
<command>cvs import</command>. Le commutateur <userinput>-m</userinput>
spécifie une description pour le nouveau module. Le paramètre "cvstest" est le
nom utilisé pour le module dans toutes les commandes <command>cvs</command> qui
suivent. Les paramètres "vendortag" et "releasetag" sont utilisés pour mieux
identifier chaque module <acronym>CVS</acronym> et sont nécessaires qu'ils soient
utilisés ou non.</para>
 
<para><command>(grep anonymous /etc/passwd || useradd anonymous -s
/bin/false)</command>&nbsp;: vérifie l'existence d'un utilisateur anonymous et
le crée s'il n'en trouve pas.</para>
 
<para><command>echo anonymous: &gt; /srv/cvsroot/CVSROOT/passwd
</command>&nbsp;: ajoute l'utilisateur anonymous au fichier des mots de passe
de <acronym>CVS</acronym>, qui est plus utilisé dans tout le reste de cette
configuration.</para>
 
<para><command>echo anonymous &gt; /srv/cvsroot/CVSROOT/readers</command>&nbsp;:
ajoute l'utilisateur anonymous dans le fichier des lecteurs
<acronym>CVS</acronym>, qui est une liste des utilisateurs ayant un accès au
dépôt en lecture seule.</para>
 
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/server/other/openldap.xml
0,0 → 1,331
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY openldap-download-http "http://gd.tuwien.ac.at/infosys/network/OpenLDAP/openldap-release/openldap-&openldap-version;.tgz">
<!ENTITY openldap-download-ftp "ftp://ftp.openldap.org/pub/OpenLDAP/openldap-release/openldap-&openldap-version;.tgz">
<!ENTITY openldap-md5sum "bd45020a47061ea1c1e14e2f6204a0f9">
<!ENTITY openldap-size "2,5&nbsp;Mo">
<!ENTITY openldap-buildsize "67&nbsp;Mo">
<!ENTITY openldap-time "6,42&nbsp;SBU">
]>
 
<sect1 id="openldap" xreflabel="OpenLDAP-&openldap-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-16 06:11:50 $</date>
</sect1info>
<?dbhtml filename="openldap.html"?>
<title><application>Open<acronym>LDAP</acronym></application>-&openldap-version;
</title>
 
<sect2>
<title>Introduction à <application>Open<acronym>LDAP</acronym></application>
</title>
 
<para>Le paquetage <application>Open<acronym>LDAP</acronym></application>
fournit une implémentation libre de <acronym>LDAP</acronym> (acronyme de
<foreignphrase>Lightweight Directory Access Protocol</foreignphrase>.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;:
<ulink url="&openldap-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;:
<ulink url="&openldap-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &openldap-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&openldap-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&openldap-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&openldap-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Dépendances de <application>Open<acronym>LDAP</acronym></application></title>
<sect4><title>Requis</title>
<para><xref linkend="db"/></para>
</sect4>
 
<sect4><title>Recommandé</title>
<para><xref linkend="cyrus-sasl"/> et <xref linkend="openssl"/></para>
</sect4>
 
<sect4><title>Optionnel</title>
<para><xref linkend="tcpwrappers"/>,
<xref linkend="gdbm"/>,
<ulink url="http://www.gnu.org/software/pth/">GNU Pth</ulink>, et
<xref linkend="heimdal"/> ou
<xref linkend="mitkrb"/></para>
</sect4>
 
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>Open<acronym>LDAP</acronym></application>
</title>
 
<para>Installez <application>Open<acronym>LDAP</acronym></application> en
lançant les commandes suivantes&nbsp;:</para>
 
<screen><userinput><command>./configure --prefix=/usr --libexecdir=/usr/sbin \
--sysconfdir=/etc --localstatedir=/srv/ldap \
--enable-ldbm --disable-debug &amp;&amp;
make depend &amp;&amp;
make &amp;&amp;
make test &amp;&amp;
make install &amp;&amp;
chmod 755 /usr/lib/libl*-2.2.so.7.0.13</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Explications des commandes</title>
 
<para><parameter>--libexecdir=/usr/sbin</parameter>&nbsp;: installe les
exécutables du serveur dans <filename class="directory">/usr/sbin</filename>
au lieu de <filename class="directory">/usr/libexec</filename>.</para>
 
<para><parameter>--sysconfdir=/etc</parameter>&nbsp;: configure le répertoire
du fichier de configuration pour éviter sa valeur par défaut,
<filename class="directory">/usr/etc</filename>.</para>
 
<para><parameter>--localstatedir=/srv/ldap</parameter>&nbsp;: configure le
répertoire de la base de donnée <acronym>LDAP</acronym>, des traces de réplication
et des données variables en exécution.</para>
 
<para><parameter>--enable-ldbm</parameter>&nbsp;: construit <command>slapd</command>
en utilisant comme base de données principale soit
<application>Berkeley DB</application> soit
<application><acronym>GNU</acronym> Database Manager</application>.</para>
 
<para><parameter>--disable-debug</parameter>&nbsp;: désactive le code de
débogage.</para>
 
<para><command>make test</command>&nbsp;: valide la construction du paquetage.
Si vous avez activé <application>tcp_wrappers</application>, assurez-vous
d'ajouter 127.0.0.1 sur la ligne <parameter>slapd</parameter> dans le fichier
<filename>/etc/hosts.allow</filename> si vous avez un fichier
<filename>/etc/hosts.deny</filename> restrictif.</para>
 
<para><command>chmod 755 /usr/lib/libl*-2.2.so.7.0.10</command>&nbsp;: cette
commande ajoute le bit d'exécution aux bibliothèques partagées.</para>
 
</sect2>
 
<sect2>
<title>Configurer <application>Open<acronym>LDAP</acronym></application>
</title>
 
<sect3><title>Fichiers de configuration</title>
<para><filename>/etc/openldap/*</filename></para>
</sect3>
 
<sect3><title>Informations de configuration</title>
<para>Configurer les serveurs <command>slapd</command> et <command>slurpd</command>
peut être complexe. Sécuriser le répertoire <acronym>LDAP</acronym>, spécialement
si vous stockez des données non publiques comme des bases de données de mots de
passe, peut aussi être un défi. Vous aurez besoin de modifier les fichiers
<filename>/etc/openldap/slapd.conf</filename> et
<filename>/etc/openldap/ldap.conf</filename> pour configurer
<application>Open<acronym>LDAP</acronym></application> selon vos besoins
particuliers.</para>
 
<para>Les ressources pour vous aider avec des thèmes comme le choix d'un
répertoire, la configuration, les définitions du serveur et de la base de
données, les paramètrages de contrôle d'accès, exécuter avec un utilisateur
autre que root et configurer un environnement <command>chroot</command>
incluent&nbsp;:
</para>
 
<itemizedlist spacing='compact'>
<listitem><para>la page man de <command>slapd</command></para></listitem>
<listitem><para>la page man de <filename>slapd.conf</filename></para></listitem>
<listitem><para>le <ulink
url="http://www.openldap.org/doc/admin22/">Guide de l'administrateur
d'OpenLDAP 2.2</ulink></para></listitem>
<listitem><para>les documents situés sur
<ulink url="http://www.openldap.org/pub/"/></para></listitem>
</itemizedlist></sect3>
 
<sect3><title>Utiliser <application>GDBM</application></title>
<para>Pour utiliser <application>GDBM</application> comme moteur de bases de
données, l'entrée <quote>database</quote> dans
<filename>/etc/openldap/slapd.conf</filename> doit être changée de
<quote>bdb</quote> à <quote>ldbm</quote>. Vous pouvez utiliser les deux en
créant une section base de données supplémentaire dans
<filename>/etc/openldap/slapd.conf</filename>.
</para></sect3>
 
<sect3><title>Répertoire d'adresses <application>Mozilla</application></title>
<para>Par défaut, le support de acronym>LDAP</acronym>v2 est désactivé dans le
fichier <filename>slapd.conf</filename>. Une fois que la base de données est
correctement configurée et que <application>Mozilla</application> est configuré
pour utiliser le répertoire, vous devez ajouter <option>allow bind_v2</option>
au fichier <filename>slapd.conf</filename>.</para></sect3>
 
<sect3><title>Script de démarrage</title>
<para>Pour automatiser le lancement du serveur <acronym>LDAP</acronym> lors du
démarrage du système, installez le script de démarrage
<filename>/etc/rc.d/init.d/openldap</filename> inclus dans le paquetage
<xref linkend="intro-important-bootscripts"/> en utilisant la commande
suivante&nbsp;:</para>
 
<screen><userinput><command>make install-openldap1</command></userinput></screen>
 
<para><emphasis>Note&nbsp;:</emphasis> le script de démarrage que vous venez
d'installer lance seulement le démon <command>slapd</command>. Si vous souhaitez
aussi lancer le démon <command>slurpd</command> au démarrage, installez une
version modifiée du script en utilisant cette commande&nbsp;:</para>
 
<screen><userinput><command>make install-openldap2</command></userinput></screen>
 
<note><para>Le script de démarrage lance les démons sans paramètres. Vous aurez
besoin de modifier le script pour inclure les paramètres nécessaires à votre
configuration spécifique. Voir les pages man de <command>slapd</command> et
<command>slurpd</command> pour des informations sur les paramètres.</para></note>
</sect3>
 
<sect3><title>Tester la configuration</title>
<para>Exécutez le serveur <acronym>LDAP</acronym> en utilisant le script de
démarrage&nbsp;:</para>
 
<screen><userinput><command>/etc/rc.d/init.d/openldap start</command></userinput></screen>
 
<para>Vérifiez l'accès au serveur <acronym>LDAP</acronym> avec la commande
suivante&nbsp;:</para>
 
<screen><userinput><command>ldapsearch -x -b '' -s base '(objectclass=*)' namingContexts</command></userinput></screen>
 
<para>Le résultat attendu est&nbsp;:</para>
<screen><computeroutput># extended LDIF
#
# LDAPv3
# base &lt;&gt; with scope base
# filter: (objectclass=*)
# requesting: namingContexts
#
 
#
dn:
namingContexts: dc=my-domain,dc=com
 
# search result
search: 2
result: 0 Success
 
# numResponses: 2
# numEntries: 1</computeroutput></screen>
 
</sect3>
</sect2>
 
<sect2>
<title>Contenu</title>
 
<para>Le paquetage Open<acronym>LDAP</acronym> contient
<command>ldapadd</command>,
<command>ldapcompare</command>,
<command>ldapdelete</command>,
<command>ldapmodify</command>,
<command>ldapmodrdn</command>,
<command>ldappasswd</command>,
<command>ldapsearch</command>,
<command>ldapwhoami</command>,
<command>slapadd</command>,
<command>slapcat</command>,
<command>slapd</command>,
<command>slapdn</command>,
<command>slapindex</command>,
<command>slappasswd</command>,
<command>slaptest</command>,
<command>slurpd</command>,
<filename class="libraryfile">liblber</filename> et les bibliothèques
<filename class="libraryfile">libldap</filename>.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>ldapadd</title>
<para><command>ldapadd</command> ouvre une connexion avec un serveur
<acronym>LDAP</acronym>, établie un lien et ajoute des entrées.</para></sect3>
 
<sect3><title>ldapcompare</title>
<para><command>ldapcompare</command> ouvre une connexion avec un serveur
<acronym>LDAP</acronym>, établie un lien et réalise une comparaison en utilisant
les paramètres spécifiés.</para></sect3>
 
<sect3><title>ldapdelete</title>
<para><command>ldapdelete</command> ouvre une connexion avec un serveur
<acronym>LDAP</acronym>, établie un lien et supprime une ou plusieurs entrées.</para>
</sect3>
 
<sect3><title>ldapmodify</title>
<para><command>ldapmodify</command> ouvre une connexion avec un serveur
<acronym>LDAP</acronym>, établie un lien et modifie des entrées.</para></sect3>
 
<sect3><title>ldapmodrdn</title>
<para><command>ldapmodrdn</command> ouvre une connexion avec un serveur
<acronym>LDAP</acronym>, établie un lien et modifie le
<acronym>RDN</acronym> d'entrées.</para></sect3>
 
<sect3><title>ldappasswd</title>
<para><command>ldappasswd</command> est un outil pour configurer le mot de passe
d'un utilisateur <acronym>LDAP</acronym>.</para></sect3>
 
<sect3><title>ldapsearch</title>
<para><command>ldapsearch</command> ouvre une connexion avec un serveur
<acronym>LDAP</acronym>, établie un lien et réalise une recherche en utilisant
les paramètres spécifiés.</para></sect3>
 
<sect3><title>ldapwhoami</title>
<para><command>ldapwhoami</command> ouvre une connexion avec un serveur
<acronym>LDAP</acronym>, établie un lien et affiche les informations whoami.</para>
</sect3>
 
<sect3><title>slapadd</title>
<para><command>slapadd</command> est utilisé pour ajouter des entrées spécifiées
dans le format d'échange <acronym>LDAP</acronym> (<acronym>LDIF</acronym>)
dans la base de données <acronym>LDAP</acronym>.</para></sect3>
 
<sect3><title>slapcat</title>
<para><command>slapcat</command> est utilisé pour générer une sortie
<acronym>LDIF</acronym> du <acronym>LDAP</acronym>, basée sur le contenu
d'une base de données slapd.</para></sect3>
 
<sect3><title>slapd</title>
<para><command>slapd</command> est le serveur autonome <acronym>LDAP</acronym>.
</para></sect3>
 
<sect3><title>slapdn</title>
<para><command>slapdn</command> vérifie une liste de <acronym>DN</acronym>
représentés par des chaîne basées sur la syntaxe du schéma.</para></sect3>
 
<sect3><title>slapindex</title>
<para><command>slapindex</command> est utilisé pour regénérer les indices slapd
suivant le contenu actuel d'une base de données.</para></sect3>
 
<sect3><title>slappasswd</title>
<para><command>slappasswd</command> est un outil pour mot de passe avec
Open<acronym>LDAP</acronym>.</para></sect3>
 
<sect3><title>slaptest</title>
<para><command>slaptest</command> vérifie la cohérence du fichier
<filename>slapd.conf</filename>.</para></sect3>
 
<sect3><title>slurpd</title>
<para><command>slurpd</command> est le serveur de réplication autonome
<acronym>LDAP</acronym>.</para></sect3>
 
<sect3><title>liblber et libldap</title>
<para>Ces bibliothèques supportent les programmes <acronym>LDAP</acronym> et
fournissent des fonctionnalités aux autres programmes interagissant avec
<acronym>LDAP</acronym>.</para></sect3>
 
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/server/other/samba3.xml
0,0 → 1,648
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY samba3-download-http "http://us1.samba.org/samba/ftp/samba-&samba3-version;.tar.gz">
<!ENTITY samba3-download-ftp "ftp://ftp.samba.org/pub/samba/samba-&samba3-version;.tar.gz">
<!ENTITY samba3-md5sum "217e489646a474b4fb69d5802c14bc6e">
<!ENTITY samba3-size "15.3 MB">
<!ENTITY samba3-buildsize "143 MB">
<!ENTITY samba3-time "2.12 SBU">
]>
 
<sect1 id="samba3" xreflabel="Samba-&samba3-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-16 06:11:50 $</date>
</sect1info>
<?dbhtml filename="samba3.html"?>
<title>Samba-&samba3-version;</title>
<indexterm zone="samba3">
<primary sortas="a-Samba">Samba</primary></indexterm>
 
<sect2>
<title>Introduction to <application>Samba</application></title>
 
<para>The <application>Samba</application> package provides file and print
services to <acronym>SMB</acronym>/<acronym>CIFS</acronym> clients and
Windows networking to Linux clients. <application>Samba</application> can also
be configured as a Windows NT 4.0 Domain Controller replacement
(with caveats working with NT <acronym>PDC</acronym>'s and
<acronym>BDC</acronym>'s), a file/print server acting as a member of a
Windows NT 4.0 or Active Directory domain and a NetBIOS (rfc1001/1002)
nameserver (which amongst other things provides
<acronym>LAN</acronym> browsing support).</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&samba3-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&samba3-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum:
&samba3-md5sum;</para></listitem>
<listitem><para>Download size:
&samba3-size;</para></listitem>
<listitem><para>Estimated disk space required:
&samba3-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&samba3-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3>
<title><application>Samba</application> dependencies</title>
<sect4>
<title>Optional</title>
<para><xref linkend="popt"/>,
<xref linkend="Linux_PAM"/>,
<xref linkend="openldap"/>,
<xref linkend="cups"/>,
<xref linkend="heimdal"/> or <xref linkend="mitkrb"/>,
<xref linkend="libxml2"/>,
<xref linkend="mysql"/> or <xref linkend="postgresql"/>,
<xref linkend="python"/>,
<xref linkend="xinetd"/>,
<ulink url="http://valgrind.kde.org/">Valgrind</ulink> and
<xref linkend="stunnel"/> (used to encrypt access to SWAT)</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>Samba</application></title>
 
<para>Install <application>Samba</application> by running the following
commands:</para>
 
<screen><userinput><command>cd source &amp;&amp;
install -d /var/cache/samba &amp;&amp;
./configure \
--prefix=/usr \
--sysconfdir=/etc \
--localstatedir=/var \
--with-piddir=/var/run \
--with-fhs \
--with-smbmount &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install &amp;&amp;
mv /usr/lib/samba/libsmbclient.so /usr/lib &amp;&amp;
ln -sf ../libsmbclient.so /usr/lib/samba &amp;&amp;
chmod 644 /usr/include/libsmbclient.h \
/usr/lib/samba/libsmbclient.a &amp;&amp;
install -m755 nsswitch/libnss_win{s,bind}.so /lib &amp;&amp;
ln -sf libnss_winbind.so /lib/libnss_winbind.so.2 &amp;&amp;
ln -sf libnss_wins.so /lib/libnss_wins.so.2 &amp;&amp;
cp ../examples/smb.conf.default /etc/samba &amp;&amp;
install -m644 ../docs/*.pdf /usr/share/samba &amp;&amp;
if [ -f nsswitch/pam_winbind.so ]; then
install -m755 nsswitch/pam_winbind.so /lib/security
fi</command></userinput></screen>
 
<note><para>You may want to run <command>configure</command> with the
<parameter>--help</parameter> parameter. There may be other parameters
needed to take advantage of the optional dependencies.</para></note>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>install -d /var/cache/samba</command>: This directory is
needed for proper operation of the <command>smbd</command> and
<command>nmbd</command> daemons.</para>
 
<para><parameter>--sysconfdir=/etc</parameter>: Sets the configuration
file directory to avoid the default of
<filename class="directory">/usr/etc</filename>.</para>
 
<para><parameter>--localstatedir=/var</parameter>: Sets the variable
data directory to avoid the default of
<filename class="directory">/usr/var</filename>.</para>
 
<para><option>--with-fhs</option>: Assigns all other file paths in a manner
compliant with the Filesystem Hierarchy Standard
(<acronym>FHS</acronym>).</para>
 
<para><option>--with-smbmount</option>: Orders the creation of an extra
binary for use by the <command>mount</command> command so that mounting remote
<acronym>SMB</acronym> (Windows) shares becomes no more complex than mounting
remote <acronym>NFS</acronym> shares.</para>
 
<para><option>--with-pam</option>: Use this parameter to link
<application>Linux-<acronym>PAM</acronym></application> into the build. This
also builds the <filename class='libraryfile'>pam_winbind.so</filename>
<application><acronym>PAM</acronym></application> module. You can find
instructions on how to configure and use the module by running
<command>man winbindd</command>.</para>
 
<para><command>mv /usr/lib/samba/libsmbclient.so ...; ln -sf
../libsmbclient.so ...</command>: The
<filename class='libraryfile'>libsmbclient.so</filename> library is needed
by other packages. This command moves it to a location where other packages
can find it.</para>
 
<para><command>install -m755 nsswitch/libnss_win{s,bind}.so /lib</command>:
The nss libraries are not installed by default. If you intend to use
winbindd for domain auth, and/or <acronym>WINS</acronym> name resolution,
you need these libraries.</para>
 
<para><command>ln -sf libnss_winbind.so /lib/libnss_winbind.so.2</command>
and <command>ln -sf libnss_wins.so /lib/libnss_wins.so.2</command>:
These symlinks are required by glibc to use the nss libraries.</para>
 
<para><command>cp ../examples/smb.conf.default /etc/samba</command>:
This copies a default <filename>smb.conf </filename>into
<filename>/etc/samba</filename>. This sample configuration will not
work unless edited for your site, and renamed
<filename>smb.conf</filename>.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>Samba</application></title>
 
<sect3 id="samba3-config"><title>Config files</title>
<para>/etc/samba/smb.conf</para>
<indexterm zone="samba3 samba3-config">
<primary sortas="e-etc-samba-smb.conf">/etc/samba/smb.conf</primary>
</indexterm>
</sect3>
 
<sect3><title>Configuration overview and available documentation</title>
 
<para>Due to the complexity and the many various uses for
<application>Samba</application>, complete configuration is well beyond the
scope of the <acronym>BLFS</acronym> book. Advanced configurations including
setting up Primary and Backup Domain Controllers are advanced topics and
cannot be adequately covered in <acronym>BLFS</acronym> (it should be noted,
however, that a <application>Samba</application> <acronym>BDC</acronym> cannot
be used as a fallback for a
<application>Windows</application> <acronym>PDC</acronym>, and conversely, a
<application>Windows</application> <acronym>BDC</acronym> cannot be used as a
fallback for a <application>Samba</application> <acronym>PDC</acronym>). Many
complete books have been written on these topics alone.</para>
 
<para>There is quite a bit of documentation available which covers many of
these advanced configurations. Point your web browser to the links below to
view some of the documentation included with the
<application>Samba</application> package:</para>
 
<itemizedlist spacing='compact'>
<listitem><para>Using Samba, 2nd Edition; a popular book published by O'Reilly
<ulink url="file:///usr/share/samba/swat/using_samba/toc.html"/></para>
</listitem>
 
<listitem><para>The Official Samba HOWTO and Reference Guide <ulink
url="file:///usr/share/samba/swat/help/Samba-HOWTO-Collection/index.html"/>
</para>
</listitem>
 
<listitem><para>Samba-3 by Example
<ulink url="file:///usr/share/samba/swat/help/Samba-Guide/index.html"/></para>
</listitem>
 
<listitem><para>The Samba-3 man Pages
<ulink url="file:///usr/share/samba/swat/help/samba.7.html"/></para>
</listitem>
</itemizedlist>
</sect3>
 
<sect3 id="samba3-swat-config"><title>Configuring SWAT</title>
 
<para>The built in <acronym>SWAT</acronym>
(<application>Samba</application> Web Administration Tool) utility can be used
for basic configuration of the <application>Samba</application> installation,
but because it may be inconvenient, undesireable or perhaps even impossible
to gain access to the console, BLFS recommends setting up access to
<acronym>SWAT</acronym> using <application>Stunnel</application>.</para>
<indexterm zone="samba3 samba3-swat-config">
<primary sortas="g-SWAT">SWAT</primary></indexterm>
 
<para>First you must add entries to <filename>/etc/services</filename> and
modify the <command>inetd</command>/<command>xinetd</command>
configuration.</para>
<indexterm zone="samba3 samba3-swat-config">
<primary sortas="e-etc-services">/etc/services</primary></indexterm>
<indexterm zone="samba3 samba3-swat-config">
<primary sortas="e-etc-inetd.conf">/etc/inetd.conf</primary></indexterm>
<indexterm zone="samba3 samba3-swat-config">
<primary sortas="e-etc-xinetd.conf">/etc/xinetd.conf</primary></indexterm>
 
<para>Add swat and swat_tunnel entries to
<filename>/etc/services</filename> with the following commands issued as the
root user:</para>
 
<screen><userinput role='root'><command>echo "swat 901/tcp" &gt;&gt; /etc/services &amp;&amp;
echo "swat_tunnel 902/tcp" &gt;&gt; /etc/services</command></userinput></screen>
 
<para>If <command>inetd</command> is used, the following command will add the
swat_tunnel entry to <filename>/etc/inetd.conf</filename> (as user root):</para>
 
<screen><userinput role='root'><command>echo "swat_tunnel stream tcp nowait.400 root /usr/sbin/swat swat" \
&gt;&gt; /etc/inetd.conf</command></userinput></screen>
<para>Issue a <command>killall -HUP inetd</command> to reread the
changed <filename>inetd.conf</filename> file.</para>
 
<para>If <command>xinetd</command> is used, the following command issued as
the root user will add the swat_tunnel entry to
<filename>/etc/xinetd.conf</filename> (you may need to modify or remove the
<quote>only_from</quote> line to include the desired host[s]):</para>
 
<screen><userinput role='root'><command>cat &gt;&gt; /etc/xinetd.conf &lt;&lt; "EOF"</command>
service swat_tunnel
{
port = 902
socket_type = stream
wait = no
only_from = 127.0.0.1
user = root
server = /usr/sbin/swat
log_on_failure += USERID
}
<command>EOF</command></userinput></screen>
 
<para>Issue a <command>killall -HUP xinetd</command> to reread the
changed <filename>xinetd.conf</filename> file.</para>
 
<para>Next, you must add an entry for the swat service to the
<filename>/etc/stunnel/stunnel.conf</filename> file (as user root):</para>
<indexterm zone="samba3 samba3-swat-config"><primary
sortas="e-etc-stunnel-stunnel.conf">/etc/stunnel/stunnel.conf</primary>
</indexterm>
 
<screen><userinput role='root'><command>cat &gt;&gt; /etc/stunnel/stunnel.conf &lt;&lt; "EOF"</command>
[swat]
accept = 901
connect = 902
 
<command>EOF</command></userinput></screen>
 
<para>Restart the <command>stunnel</command> daemon using the following
command as the root user:</para>
 
<screen><userinput role='root'><command>/etc/rc.d/init.d/stunnel restart</command></userinput></screen>
 
<para><acronym>SWAT</acronym> can be launched by pointing your web browser to
<userinput>https://<replaceable>[CA_DN_field]</replaceable>:901</userinput>.
Substitute the hostname listed in the <acronym>DN</acronym> field of the
<acronym>CA</acronym> certificate used with
<application>Stunnel</application> for
<replaceable>[CA_DN_field]</replaceable>.</para>
 
<note><para>If you linked
<application>Linux-<acronym>PAM</acronym></application> into the
<application>Samba</application> build, you'll need to create an
<filename>/etc/pam.d/samba</filename> file.</para></note>
<indexterm zone="samba3 samba3-swat-config"><primary
sortas="e-etc-pam.d-samba">/etc/pam.d/samba</primary>
</indexterm>
</sect3>
 
<sect3><title>Printing to <acronym>SMB</acronym> clients</title>
 
<para>If you use <application><acronym>CUPS</acronym></application> for print
services, and you wish to print to a printer attached to an
<acronym>SMB</acronym> client, you need to create an <acronym>SMB</acronym>
backend device. To create the device, issue the following command as the
root user:</para>
 
<screen><userinput><command>ln -sf /usr/bin/smbspool /usr/lib/cups/backend/smb</command></userinput></screen>
</sect3>
 
<sect3 id="samba3-init"><title>Installing bootscripts</title>
 
<para>For your convenience, boot scripts have been provided for
<application>Samba</application>. There are two included in the
<xref linkend="intro-important-bootscripts"/> package. The first,
<filename>samba</filename>, will start the <command>smbd</command> and
<command>nmbd</command> daemons needed to provide
<acronym>SMB</acronym>/<acronym>CIFS</acronym> services. The second
script, <filename>winbind</filename>, starts the <command>winbindd</command>
daemon, used for providing Windows domain services to Linux clients.</para>
<indexterm zone="samba3 samba3-init">
<primary sortas="f-samba">samba</primary></indexterm>
<indexterm zone="samba3 samba3-init">
<primary sortas="f-winbind">winbind</primary></indexterm>
 
<para>Install the <filename>samba</filename> script with the following
command issued as the root user:</para>
 
<screen><userinput role='root'><command>make install-samba</command></userinput></screen>
 
<para>If you also need the <filename>winbind</filename> script:</para>
 
<screen><userinput role='root'><command>make install-winbind</command></userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
 
<seglistitem>
<seg>findsmb, mount.smbfs, net, nmbd, nmblookup, ntlm_auth, pdbedit, profiles,
rpcclient, smbcacls, smbclient, smbcontrol, smbcquotas, smbd, smbmnt,
smbmount, smbpasswd, smbspool, smbstatus, smbtar, smbtree, smbumount, swat,
tdbbackup, tdbdump, tdbtool, testparm, testprns, wbinfo and winbindd</seg>
<seg>libnss_winbind.so, libnss_wins.so, libsmbclient.[so,a], the
pam_winbind.so <acronym>PAM</acronym> library and assorted character set,
filesystem and support modules.</seg>
<seg>/etc/samba, /usr/lib/samba, /usr/share/samba, /var/cache/samba and
/var/lib/samba</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="findsmb">
<term><command>findsmb</command></term>
<listitem><para>lists information about machines that respond to
<acronym>SMB</acronym> name queries on a subnet.</para>
<indexterm zone="samba3 findsmb">
<primary sortas="b-findsmb">findsmb</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="mount.smbfs">
<term><command>mount.smbfs</command></term>
<listitem><para>is a symlink to <command>mountsmb</command> which provides
<command>/bin/mount</command> with a way to mount remote Windows (or
<application>Samba</application>) fileshares.</para>
<indexterm zone="samba3 mount.smbfs">
<primary sortas="b-mount.smbfs">mount.smbfs</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="net">
<term><command>net</command></term>
<listitem><para>is a tool for administration of
<application>Samba</application> and remote <acronym>CIFS</acronym> servers,
similar to the <command>net</command> utility for
<acronym>DOS</acronym>/Windows.</para>
<indexterm zone="samba3 net">
<primary sortas="b-net">net</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="nmbd">
<term><command>nmbd</command></term>
<listitem><para>is the <application>Samba</application>
Net<acronym>BIOS</acronym> name server.</para>
<indexterm zone="samba3 nmbd">
<primary sortas="b-nmbd">nmbd</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="nmblookup">
<term><command>nmblookup</command></term>
<listitem><para>is used to query Net<acronym>BIOS</acronym> names and map
them to <acronym>IP</acronym> addresses.</para>
<indexterm zone="samba3 nmblookup">
<primary sortas="b-nmblookup">nmblookup</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="ntlm_auth">
<term><command>ntlm_auth</command></term>
<listitem><para>is a tool to allow external access to Winbind's
<acronym>NTLM</acronym> authentication function.</para>
<indexterm zone="samba3 ntlm_auth">
<primary sortas="b-ntlm_auth">ntlm_auth</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="pdbedit">
<term><command>pdbedit</command></term>
<listitem><para>is a tool used to manage the <acronym>SAM</acronym>
database.</para>
<indexterm zone="samba3 pdbedit">
<primary sortas="b-pdbedit">pdbedit</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="profiles">
<term><command>profiles</command></term>
<listitem><para>is a utility that reports and changes <acronym>SID</acronym>s
in Windows registry files. It currently only supports Windows NT.</para>
<indexterm zone="samba3 profiles">
<primary sortas="b-profiles">profiles</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="rpcclient">
<term><command>rpcclient</command></term>
<listitem><para>is used to execute MS-<acronym>RPC</acronym> client side
functions.</para>
<indexterm zone="samba3 rpcclient">
<primary sortas="b-rpcclient">rpcclient</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="smbcacls">
<term><command>smbcacls</command></term>
<listitem><para>is used to manipulate Windows NT access control lists.</para>
<indexterm zone="samba3 smbcacls">
<primary sortas="b-smbcacls">smbcacls</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="smbclient">
<term><command>smbclient</command></term>
<listitem><para>is a <acronym>SMB</acronym>/<acronym>CIFS</acronym> access
utility, similar to <acronym>FTP</acronym>.</para>
<indexterm zone="samba3 smbclient">
<primary sortas="b-smbclient">smbclient</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="smbcontrol">
<term><command>smbcontrol</command></term>
<listitem><para>is used to control running <command>smbd</command>,
<command>nmbd</command> and <command>winbindd</command> daemons.</para>
<indexterm zone="samba3 smbcontrol">
<primary sortas="b-smbcontrol">smbcontrol</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="smbcquotas">
<term><command>smbcquotas</command></term>
<listitem><para>is used to manipulate Windows NT quotas on
<acronym>SMB</acronym> file shares.</para>
<indexterm zone="samba3 smbcquotas">
<primary sortas="b-smbcquotas">smbcquotas</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="smbd">
<term><command>smbd</command></term>
<listitem><para>is the main <application>Samba</application> daemon which
provides <acronym>SMB</acronym>/<acronym>CIFS</acronym> services to
clients.</para>
<indexterm zone="samba3 smbd">
<primary sortas="b-smbd">smbd</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="smbmnt">
<term><command>smbmnt</command></term>
<listitem><para>is a helper application used by the
<command>smbmount</command> program to do the actual mounting of
<acronym>SMB</acronym> shares. It can be installed setuid root if you want
normal users to be able to mount their <acronym>SMB</acronym> shares.</para>
<indexterm zone="samba3 smbmnt">
<primary sortas="b-smbmnt">smbmnt</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="smbmount">
<term><command>smbmount</command></term>
<listitem><para>is usually invoked as <command>mount.smbfs</command> by the
<command>mount</command> command when using the
<parameter>-t smbfs</parameter> option, mounts a Linux <acronym>SMB</acronym>
filesystem.</para>
<indexterm zone="samba3 smbmount">
<primary sortas="b-smbmount">smbmount</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="smbpasswd">
<term><command>smbpasswd</command></term>
<listitem><para>changes a user's <application>Samba</application>
password.</para>
<indexterm zone="samba3 smbpasswd">
<primary sortas="b-smbpasswd">smbpasswd</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="smbspool">
<term><command>smbspool</command></term>
<listitem><para>sends a print job to an <acronym>SMB</acronym> printer.</para>
<indexterm zone="samba3 smbspool">
<primary sortas="b-smbspool">smbspool</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="smbstatus">
<term><command>smbstatus</command></term>
<listitem><para>reports current <application>Samba</application>
connections.</para>
<indexterm zone="samba3 smbstatus">
<primary sortas="b-smbstatus">smbstatus</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="smbtar">
<term><command>smbtar</command></term>
<listitem><para>is a shell script used for backing up
<acronym>SMB</acronym>/<acronym>CIFS</acronym> shares directly to Linux tape
drives or a file.</para>
<indexterm zone="samba3 smbtar">
<primary sortas="b-smbtar">smbtar</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="smbtree">
<term><command>smbtree</command></term>
<listitem><para>is a text-based <acronym>SMB</acronym> network browser.</para>
<indexterm zone="samba3 smbtree">
<primary sortas="b-smbtree">smbtree</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="smbumount">
<term><command>smbumount</command></term>
<listitem><para>is used by normal users to unmount <acronym>SMB</acronym>
filesystems, provided that it is setuid root.</para>
<indexterm zone="samba3 smbumount">
<primary sortas="b-smbumount">smbumount</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="swat">
<term><command>swat</command></term>
<listitem><para>is the <application>Samba</application> Web Administration
Tool.</para>
<indexterm zone="samba3 swat">
<primary sortas="b-swat">swat</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="tdbbackup">
<term><command>tdbbackup</command></term>
<listitem><para>is a tool for backing up or validating the integrity of
<application>Samba</application> <filename>.tdb</filename> files.</para>
<indexterm zone="samba3 tdbbackup">
<primary sortas="b-tdbbackup">tdbbackup</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="tdbdump">
<term><command>tdbdump</command></term>
<listitem><para> is a tool used to print the contents of a
<application>Samba</application> <filename>.tdb</filename> file.</para>
<indexterm zone="samba3 tdbdump">
<primary sortas="b-tdbdump">tdbdump</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="tdbtool">
<term><command>tdbtool</command></term>
<listitem><para>is a tool which allows simple database manipulation from the
command line.</para>
<indexterm zone="samba3 tdbtool">
<primary sortas="b-tdbtool">tdbtool</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="testparm">
<term><command>testparm</command></term>
<listitem><para>checks an <filename>smb.conf</filename> file for proper
syntax.</para>
<indexterm zone="samba3 testparm">
<primary sortas="b-testparm">testparm</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="testprns">
<term><command>testprns</command></term>
<listitem><para>tests printer names.</para>
<indexterm zone="samba3 testprns">
<primary sortas="b-testprns">testprns</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="wbinfo">
<term><command>wbinfo</command></term>
<listitem><para>queries a running <command>winbindd</command> daemon.</para>
<indexterm zone="samba3 wbinfo">
<primary sortas="b-wbinfo">wbinfo</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="winbindd">
<term><command>winbindd</command></term>
<listitem><para>resolves names from Windows NT servers.</para>
<indexterm zone="samba3 winbindd">
<primary sortas="b-winbindd">winbindd</primary>
</indexterm></listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/server/other/xinetd.xml
0,0 → 1,142
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY xinetd-download-http "http://www.xinetd.org/xinetd-&xinetd-version;.tar.gz">
<!ENTITY xinetd-download-ftp " ">
<!ENTITY xinetd-md5sum "4295b5fe12350f09b5892b363348ac8b">
<!ENTITY xinetd-size "291 KB">
<!ENTITY xinetd-buildsize "3.91 MB">
<!ENTITY xinetd-time "0.09 SBU">
]>
 
<sect1 id="xinetd" xreflabel="xinetd-&xinetd-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-16 06:11:50 $</date>
</sect1info>
<?dbhtml filename="xinetd.html"?>
<title>xinetd-&xinetd-version;</title>
 
<sect2>
<title>Introduction à <application>xinetd</application></title>
 
<para><application>xinetd</application> est le démon étendu de services Internet
(<foreignphrase>eXtended InterNET services Daemon</foreignphrase>), un remplacement
sécurisé de <command>inetd</command>.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;:
<ulink url="&xinetd-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;:
<ulink url="&xinetd-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &xinetd-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&xinetd-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&xinetd-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&xinetd-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Dépendances de <application>xinetd</application></title>
<sect4><title>Optionnel</title>
<para><xref linkend="tcpwrappers"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>xinetd</application></title>
 
<para>Installez <application>xinetd</application> en lançant les commandes
suivantes&nbsp;:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Configurer <application>xinetd</application></title>
 
<sect3><title>Fichiers de configuration</title>
<para><filename>/etc/xinetd.conf</filename></para>
</sect3>
 
<sect3><title>Informations de configuration</title>
 
<para>Assurez-vous que le chemin de tous les démons est <filename
class="directory">/usr/sbin</filename>, plutôt que le chemin par défaut
<filename class="directory">/usr/etc</filename>, et installez le fichier de
configuration de <application>xinetd</application> en lançant la commande
suivante&nbsp;:</para>
 
<screen><userinput><command>sed -e 's/etc/sbin/g' xinetd/sample.conf &gt; /etc/xinetd.conf</command>
</userinput></screen>
 
<para>Le format de <filename>/etc/xinetd.conf</filename> est documenté dans la
page man de xinetd.conf. Plus d'informations sont disponibles sur
<ulink url="http://www.xinetd.org"/>.</para>
 
<para>Installez le script de démarrage de <filename>/etc/rc.d/init.d/xinetd</filename>
inclus dans le paquetage <xref linkend="intro-important-bootscripts"/>.</para>
 
<screen><userinput><command>make install-xinetd</command></userinput></screen>
 
<para>Maintenant, utilisez le nouveau script de démarrage
<command>xinetd</command>&nbsp;:</para>
 
<screen><userinput><command>/etc/rc.d/init.d/xinetd start</command></userinput></screen>
 
<para>Vérifier le fichier <filename>/var/log/daemon.log</filename> devrait se
révéler assez amusant. Ce fichier pourrait contenir des entrées similaires à ce
qui suit&nbsp;:</para>
 
<screen><userinput>Aug 22 21:40:21 dps10 xinetd[2696]: Server /usr/sbin/in.rlogind is not
executable [line=29]
Aug 22 21:40:21 dps10 xinetd[2696]: Error parsing attribute server -
DISABLING SERVICE [line=29]
Aug 22 21:40:21 dps10 xinetd[2696]: Server /usr/sbin/in.rshd is not
executable [line=42]</userinput></screen>
 
<para>Ces erreurs sont dûes au fait que la plupart des serveurs que
<command>xinetd</command> essaie de contrôler ne sont pas encore
installés.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<para>Le paquetage <application>xinetd</application> contient
<command>xinetd</command>,
<command>itox</command> et
<command>xconv.pl</command>.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>xinetd</title>
<para><command>xinetd</command> est le démon de services Internet.</para></sect3>
 
<sect3><title>itox</title>
<para><command>itox</command> est un outil utilisé pour convertir des fichiers
<filename>inetd.conf</filename> au format
<filename>xinetd.conf</filename>.</para></sect3>
 
<sect3><title>xconv.pl</title>
<para><command>xconv.pl</command> est un script <application>Perl</application>
utilisé pour convertir les fichiers <filename>inetd.conf</filename> au format
<filename>xinetd.conf</filename>, de façon similaire à
<command>itox</command>.</para></sect3>
 
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/server/other/bind.xml
0,0 → 1,538
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY bind-download-http "http://gd.tuwien.ac.at/infosys/servers/isc/bind9/&bind-version;/bind-&bind-version;.tar.gz">
<!ENTITY bind-download-ftp "ftp://ftp.isc.org/isc/bind9/&bind-version;/bind-&bind-version;.tar.gz">
<!ENTITY bind-md5sum "fdb42fff7e345372ac52a4493b77b694">
<!ENTITY bind-size "4.6 MB">
<!ENTITY bind-buildsize "87 MB">
<!ENTITY bind-time "1.87 SBU (additional 4.14 SBU to run the complete test suite)">
]>
 
<sect1 id="bind" xreflabel="BIND-&bind-version;p1">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-16 06:11:50 $</date>
</sect1info>
<?dbhtml filename="bind.html"?>
<title><acronym>BIND</acronym>-&bind-version;p1</title>
<indexterm zone="bind">
<primary sortas="a-BIND">BIND</primary>
</indexterm>
 
<sect2>
<title>Introduction to
<application><acronym>BIND</acronym></application></title>
 
<para>The <application><acronym>BIND</acronym></application> package
provides a <acronym>DNS</acronym> server and client utilities. If you
are only interested in the utilities, refer to the
<xref linkend="bind-utils"/>.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&bind-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&bind-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum:
&bind-md5sum;</para></listitem>
<listitem><para>Download size:
&bind-size;</para></listitem>
<listitem><para>Estimated disk space required:
&bind-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&bind-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para><ulink
url="ftp://ftp.isc.org/isc/bind9/9.3.0/&bind-version;-patch1"/></para>
</listitem>
</itemizedlist>
</sect3>
 
<sect3><title><application><acronym>BIND</acronym></application>
dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="openssl"/></para>
</sect4>
 
<sect4><title>Optional (to run the full test suite)</title>
<para><xref linkend="net-tools"/> (for <command>ifconfig</command>) and
<xref linkend="perl-modules"/>: Net-DNS</para>
</sect4>
 
<sect4><title>Optional (to [re]build documentation)</title>
<para><xref linkend="openjade"/>,
<xref linkend="jadetex"/>,
<xref linkend="docbook-dsssl"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of
<application><acronym>BIND</acronym></application></title>
 
<para>Install <application><acronym>BIND</acronym></application> by
running the following commands:</para>
 
<screen><userinput><command>patch -Np1 -i ../&bind-version;-patch1 &amp;&amp;
sed -i -e "s/dsssl-stylesheets/&amp;-1.78/g" configure &amp;&amp;
./configure --prefix=/usr --sysconfdir=/etc \
--enable-threads --with-libtool &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install &amp;&amp;
chmod 755 \
/usr/lib/{lib{bind9,isc{,cc,cfg},lwres}.so.?.?.?,libdns.so.20.0.0} &amp;&amp;
mv /usr/share/man/man8/named.conf.5 /usr/share/man/man5 &amp;&amp;
cd doc &amp;&amp;
install -d -m755 /usr/share/doc/bind-9.3.0/{arm,draft,misc,rfc} &amp;&amp;
install -m644 arm/*.html \
/usr/share/doc/bind-9.3.0/arm &amp;&amp;
install -m644 draft/*.txt \
/usr/share/doc/bind-9.3.0/draft &amp;&amp;
install -m644 rfc/* \
/usr/share/doc/bind-9.3.0/rfc &amp;&amp;
install -m644 \
misc/{dnssec,ipv6,migrat*,options,rfc-compliance,roadmap,sdb} \
/usr/share/doc/bind-9.3.0/misc</command></userinput></screen>
 
<para>In order to run the complete test suite before installing the
package, you need to set up some dummy interfaces (requires
<command>ifconfig</command>). Issue the following commands to run the
complete suite of tests (you will have to be the root user to issue the
<command>ifconfig</command> commands):</para>
 
<screen><userinput role='root'><command>bin/tests/system/ifconfig.sh up &amp;&amp;
make check &gt;check.log 2&gt;&amp;1 &amp;&amp;
bin/tests/system/ifconfig.sh down</command></userinput></screen>
 
<para>If desired, issue the following command to ensure all 145 tests ran
successfully:</para>
 
<screen><userinput><command>grep "R:PASS" check.log | wc -l</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>patch -Np1 -i ../&bind-version;-patch1</command>: There's a
vulnerability in the <acronym>DNS</acronym><acronym>SEC</acronym> code. See
<ulink url="http://www.kb.cert.org/vuls/id/938617"/>. The patch fixes the
bug.</para>
 
<para><command>sed -i -e ... configure</command>: This command forces
<command>configure</command> to look for the <acronym>DSSSL</acronym>
stylesheets in the standard <acronym>BLFS</acronym> location.</para>
 
<para><parameter>--sysconfdir=/etc</parameter>: This parameter forces
<application><acronym>BIND</acronym></application> to look for configuration
files in <filename class='directory'>/etc</filename> instead of
<filename class='directory'>/usr/etc</filename>.</para>
 
<para><parameter>--enable-threads</parameter>: This parameter enables
multi-threading capability.</para>
 
<para><parameter>--with-libtool</parameter>: This parameter forces the
building of dynamic libraries and links the installed binaries to these
libraries.</para>
 
<para><command>cd doc; install ...</command>: These commands install the
additional package documentation. Optionally, omit any or all of these
commands.</para>
 
</sect2>
 
<sect2>
<title>Configuring
<application><acronym>BIND</acronym></application></title>
 
<sect3 id="bind-config"><title>Config files</title>
<para><filename>named.conf</filename>,
<filename>root.hints</filename>,
<filename>127.0.0</filename>,
<filename>rndc.conf</filename> and
<filename>resolv.conf</filename></para>
<indexterm zone="bind bind-config">
<primary sortas="e-etc-named.conf">/etc/named.conf</primary></indexterm>
<indexterm zone="bind bind-config">
<primary sortas="e-etc-rndc.conf">/etc/rndc.conf</primary></indexterm>
<indexterm zone="bind bind-config">
<primary sortas="e-etc-resolv.conf">/etc/resolv.conf</primary></indexterm>
<indexterm zone="bind bind-config">
<primary sortas="e-etc-namedb-root.hints">/etc/namedb/root.hints</primary>
</indexterm>
<indexterm zone="bind bind-config">
<primary sortas="e-etc-namedb-pz-127.0.0.0">/etc/namedb/pz/127.0.0.0</primary>
</indexterm>
</sect3>
 
<sect3><title>Configuration Information</title>
 
<para><application><acronym>BIND</acronym></application> will be configured
to run in a <command>chroot</command> jail as an unprivileged user (named).
This configuration is more secure in that a <acronym>DNS</acronym> compromise
can only affect a few files in the named user's <envar>HOME</envar>
directory.</para>
 
<para>Create the unprivileged user and group named:</para>
 
<screen><userinput role='root'><command>groupadd named &amp;&amp;
useradd -m -c "BIND Owner" -g named -s /bin/false named</command></userinput></screen>
 
<para>Set up some files, directories and devices needed by
<application><acronym>BIND</acronym></application>:</para>
 
<screen><userinput role='root'><command>cd /home/named &amp;&amp;
mkdir -p dev etc/namedb/slave var/run &amp;&amp;
mknod /home/named/dev/null c 1 3 &amp;&amp;
mknod /home/named/dev/random c 1 8 &amp;&amp;
chmod 666 /home/named/dev/{null,random} &amp;&amp;
mkdir /home/named/etc/namedb/pz &amp;&amp;
cp /etc/localtime /home/named/etc</command></userinput></screen>
 
<para>Then, generate a key for use in the <filename>named.conf</filename>
and <filename>rdnc.conf</filename> files using the
<command>rndc-confgen</command> command:</para>
 
<screen><userinput role='root'><command>rndc-confgen -b 512 | grep -m 1 "secret" | cut -d '"' -f 2</command></userinput></screen>
 
<para>Create the <filename>named.conf</filename> file from which named
will read the location of zone files, root name servers and secure
<acronym>DNS</acronym> keys:</para>
 
<screen><userinput role='root'><command>cat &gt; /home/named/etc/named.conf &lt;&lt; "EOF"</command>
options {
directory "/etc/namedb";
pid-file "/var/run/named.pid";
statistics-file "/var/run/named.stats";
};
controls {
inet 127.0.0.1 allow { localhost; } keys { rndc_key; };
};
key "rndc_key" {
algorithm hmac-md5;
secret "<replaceable>[Insert secret from rndc-confgen's output here]</replaceable>";
};
zone "." {
type hint;
file "root.hints";
};
zone "0.0.127.in-addr.arpa" {
type master;
file "pz/127.0.0";
};
 
// Bind 9 now logs by default through syslog (except debug).
// These are the default logging rules.
 
logging {
category default { default_syslog; default_debug; };
category unmatched { null; };
 
channel default_syslog {
syslog daemon; // send to syslog's daemon
// facility
severity info; // only send priority info
// and higher
};
 
channel default_debug {
file "named.run"; // write to named.run in
// the working directory
// Note: stderr is used instead
// of "named.run"
// if the server is started
// with the '-f' option.
severity dynamic; // log at the server's
// current debug level
};
 
channel default_stderr {
stderr; // writes to stderr
severity info; // only send priority info
// and higher
};
 
channel null {
null; // toss anything sent to
// this channel
};
};
 
 
 
<command>EOF</command></userinput></screen>
 
<para>Create the <filename>rndc.conf</filename> file with the following
commands:</para>
 
<screen><userinput role='root'><command>cat &gt; /etc/rndc.conf &lt;&lt; "EOF"</command>
key rndc_key {
algorithm "hmac-md5";
secret
"<replaceable>[Insert secret from rndc-confgen's output here]</replaceable>";
};
options {
default-server localhost;
default-key rndc_key;
};
<command>EOF</command></userinput></screen>
 
<para>The <filename>rndc.conf</filename> file contains information for
controlling named operations with the <command>rndc</command>
utility.</para>
 
<para>Create a zone file with the following contents:</para>
 
<screen><userinput role='root'><command>cat &gt; /home/named/etc/namedb/pz/127.0.0 &lt;&lt; "EOF"</command>
$TTL 3D
@ IN SOA ns.local.domain. hostmaster.local.domain. (
1 ; Serial
8H ; Refresh
2H ; Retry
4W ; Expire
1D) ; Minimum TTL
NS ns.local.domain.
1 PTR localhost.
<command>EOF</command></userinput></screen>
 
<para>Create the <filename>root.hints</filename> file with the following
commands:</para>
 
<note><para>Caution must be used to ensure there are no leading spaces in this
file.</para></note>
 
<screen><userinput><command>cat &gt; /home/named/etc/namedb/root.hints &lt;&lt; "EOF"</command>
. 6D IN NS A.ROOT-SERVERS.NET.
. 6D IN NS B.ROOT-SERVERS.NET.
. 6D IN NS C.ROOT-SERVERS.NET.
. 6D IN NS D.ROOT-SERVERS.NET.
. 6D IN NS E.ROOT-SERVERS.NET.
. 6D IN NS F.ROOT-SERVERS.NET.
. 6D IN NS G.ROOT-SERVERS.NET.
. 6D IN NS H.ROOT-SERVERS.NET.
. 6D IN NS I.ROOT-SERVERS.NET.
. 6D IN NS J.ROOT-SERVERS.NET.
. 6D IN NS K.ROOT-SERVERS.NET.
. 6D IN NS L.ROOT-SERVERS.NET.
. 6D IN NS M.ROOT-SERVERS.NET.
A.ROOT-SERVERS.NET. 6D IN A 198.41.0.4
B.ROOT-SERVERS.NET. 6D IN A 192.228.79.201
C.ROOT-SERVERS.NET. 6D IN A 192.33.4.12
D.ROOT-SERVERS.NET. 6D IN A 128.8.10.90
E.ROOT-SERVERS.NET. 6D IN A 192.203.230.10
F.ROOT-SERVERS.NET. 6D IN A 192.5.5.241
G.ROOT-SERVERS.NET. 6D IN A 192.112.36.4
H.ROOT-SERVERS.NET. 6D IN A 128.63.2.53
I.ROOT-SERVERS.NET. 6D IN A 192.36.148.17
J.ROOT-SERVERS.NET. 6D IN A 192.58.128.30
K.ROOT-SERVERS.NET. 6D IN A 193.0.14.129
L.ROOT-SERVERS.NET. 6D IN A 198.32.64.12
M.ROOT-SERVERS.NET. 6D IN A 202.12.27.33
<command>EOF</command></userinput></screen>
 
<para>The <filename>root.hints</filename> file is a list of root name servers.
This file must be updated periodically with the <command>dig</command>
utility. A current copy of root.hints can be obtained from
<ulink url="ftp://rs.internic.net/domain/named.root" />. Consult the
<ulink url="http://www.bind9.net/Bv9ARM.html"><application>
<acronym>BIND</acronym></application> 9 Administrator Reference Manual</ulink>
for details.</para>
 
<para>Create or modify <filename>resolv.conf</filename> to use the new
name server with the following commands:</para>
 
<note><para>Replace <replaceable>[yourdomain.com]</replaceable> with your own
valid domain name.</para></note>
 
<screen><userinput role='root'><command>cp /etc/resolv.conf /etc/resolv.conf.bak &amp;&amp;
cat &gt; /etc/resolv.conf &lt;&lt; "EOF"</command>
search <replaceable>[yourdomain.com]</replaceable>
nameserver 127.0.0.1
<command>EOF</command></userinput></screen>
 
<para>Set permissions on the <command>chroot</command> jail with the
following command:</para>
 
<screen><userinput role='root'><command>chown -R named.named /home/named</command></userinput></screen>
 
<para id="bind-init">To start the <acronym>DNS</acronym> server at boot, install the
<filename>/etc/rc.d/init.d/bind</filename> init script included in the
<xref linkend="intro-important-bootscripts"/> package.</para>
<indexterm zone="bind bind-init">
<primary sortas="f-bind">bind</primary></indexterm>
 
<screen><userinput role='root'><command>make install-bind</command></userinput></screen>
 
<para>Now start <application><acronym>BIND</acronym></application> with
the new boot script:</para>
 
<screen><userinput role='root'><command>/etc/rc.d/init.d/bind start</command></userinput></screen>
 
</sect3>
 
<sect3><title>Testing <application><acronym>BIND</acronym></application></title>
 
<para>Test out the new
<application><acronym>BIND</acronym></application> 9 installation. First
query the local host address with <command>dig</command>:</para>
 
<screen><userinput><command>dig -x 127.0.0.1</command></userinput></screen>
 
<para>Now try an external name lookup, taking note of the speed
difference in repeated lookups due to the caching. Run the
<command>dig</command> command twice on the same address:</para>
 
<screen><userinput><command>dig www.linuxfromscratch.org &amp;&amp;
dig www.linuxfromscratch.org</command></userinput></screen>
 
<para>You can see almost instantaneous results with the named caching lookups.
Consult the <application><acronym>BIND</acronym></application> Administrator
Reference Manual located at
<filename>doc/arm/Bv9ARM.html</filename> in the package source tree, for
further configuration options.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
 
<seglistitem>
<seg>dig, dnssec-keygen, dnssec-signzone, host, isc-config.sh, lwresd,
named, named-checkconf, named-checkzone, nslookup, nsupdate, rndc and
rndc-confgen</seg>
<seg>libbind9.[so,a], libdns.[so,a], libisc.[so,a], libisccc.[so,a],
libisccfg.[so,a] and liblwres.[so,a]</seg>
<seg>/home/named, /usr/include/bind9, /usr/include/dns, /usr/include/dst,
/usr/include/isc, /usr/include/isccc, /usr/include/isccfg, /usr/include/lwres
and /usr/share/doc/bind-&bind-version;</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="dig">
<term><command>dig</command></term>
<listitem><para>interrogates <acronym>DNS</acronym> servers.</para>
<indexterm zone="bind dig">
<primary sortas="b-dig">dig</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="dnssec-keygen">
<term><command>dnssec-keygen</command></term>
<listitem><para>is a key generator for secure <acronym>DNS</acronym>.</para>
<indexterm zone="bind dnssec-keygen">
<primary sortas="b-dnssec-keygen">dnssec-keygen</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="dnssec-signzone">
<term><command>dnssec-signzone</command></term>
<listitem><para>generates signed versions of zone files.</para>
<indexterm zone="bind dnssec-signzone">
<primary sortas="b-dnssec-signzone">dnssec-signzone</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="host">
<term><command>host</command></term>
<listitem><para>is a utility for <acronym>DNS</acronym> lookups.</para>
<indexterm zone="bind host">
<primary sortas="b-host">host</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="lwresd">
<term><command>lwresd</command></term>
<listitem><para>is a caching-only name server for local process use.</para>
<indexterm zone="bind lwresd">
<primary sortas="b-lwresd">lwresd</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="named">
<term><command>named</command></term>
<listitem><para>is the name server daemon.</para>
<indexterm zone="bind named">
<primary sortas="b-named">named</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="named-checkconf">
<term><command>named-checkconf</command></term>
<listitem><para>checks the syntax of <filename>named.conf</filename>
files.</para>
<indexterm zone="bind named-checkconf">
<primary sortas="b-named-checkconf">named-checkconf</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="named-checkzone">
<term><command>named-checkzone</command></term>
<listitem><para>checks zone file validity.</para>
<indexterm zone="bind named-checkzone">
<primary sortas="b-named-checkzone">named-checkzone</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="nslookup">
<term><command>nslookup</command></term>
<listitem><para>is a program used to query Internet domain nameservers.</para>
<indexterm zone="bind nslookup">
<primary sortas="b-nslookup">nslookup</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="nsupdate">
<term><command>nsupdate</command></term>
<listitem><para>is used to submit <acronym>DNS</acronym> update
requests.</para>
<indexterm zone="bind nsupdate">
<primary sortas="b-nsupdate">nsupdate</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="rndc">
<term><command>rndc</command></term>
<listitem><para>controls the operation of
<application><acronym>BIND</acronym></application>.</para>
<indexterm zone="bind rndc">
<primary sortas="b-rndc">rndc</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="rndc-confgen">
<term><command>rndc-confgen</command></term>
<listitem><para>generates <filename>rndc.conf</filename> files.</para>
<indexterm zone="bind rndc-confgen">
<primary sortas="b-rndc-confgen">rndc-confgen</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/server/other/svnserver.xml
0,0 → 1,242
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
 
<sect1 id="svnserver" xreflabel="Running a Subversion Server">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-16 06:11:50 $</date>
</sect1info>
<?dbhtml filename="svnserver.html"?>
<title>Administrer un serveur Subversion</title>
 
<sect2>
<title>Administrer un serveur Subversion</title>
<para>Cette section décrira comment configurer, administrer et sécuriser un
serveur <application>Subversion</application>.</para>
 
<sect3><title>Dépendances de <application>Subversion server</application></title>
<sect4><title>Requis</title>
<para><xref linkend="subversion"/> et <xref linkend="openssh"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Configurer un serveur <application>Subversion</application>.</title>
 
<para>Les instructions suivantes installeront un serveur
<application>Subversion</application>, qui sera configuré pour utiliser
<application>OpenSSH</application> comme moyen d'accès distant sécurisé, avec
<command>svnserve</command> pour un accès anonyme.</para>
 
<para>La configuration du serveur <application>Subversion</application> consiste
aux étapes suiavntes&nbsp;:</para>
 
<sect3><title>1. Configuration des utilisateurs, groupes et droits</title>
<para>Vous aurez besoin d'être l'utilisateur root pour la première partie de la
configuration. Créez l'utilisateur et le groupe svn avec les commandes
suivantes&nbsp;:</para>
 
<screen><userinput><command>groupadd svn &amp;&amp;
useradd -c "SVN Owner" -d /home/svn -m -g svn -s /bin/false svn</command></userinput></screen>
 
<para>Si vous planifiez d'avoir plusieurs dépôts, vous devriez avoir un groupe
dédié pour chaque dépôt pour faciliter l'administration. Créez le groupe svntest
pour le dépôt test et ajoutez l'utilisateur svn à ce groupe avec les commandes
suivantes&nbsp;:</para>
 
<screen><userinput><command>groupadd svntest &amp;&amp;
usermod -G svntest svn</command></userinput></screen>
 
<para>De plus, vous pourriez configurer un <command>umask 002</command> en
travaillant sur un dépôt pour que tous les nouveaux fichiers soient modifiables
par le propriétaire et le groupe. Ceci est rendu nécessaire par la création
d'un script d'emballage pour <command>svn</command> et
<command>svnserve</command>&nbsp;:</para>
 
<screen><userinput><command>mv /usr/bin/svn /usr/bin/svn.orig &amp;&amp;
mv /usr/bin/svnserve /usr/bin/svnserve.orig &amp;&amp;
cat &gt;&gt; /usr/bin/svn &lt;&lt; "EOF"</command>
#!/bin/sh
umask 002
/usr/bin/svn.orig "$@"
<command>EOF
cat &gt;&gt; /usr/bin/svnserve &lt;&lt; "EOF"</command>
#!/bin/sh
umask 002
/usr/bin/svnserve.orig "$@"
<command>EOF
chmod 0755 /usr/bin/svn{,serve}</command></userinput></screen>
 
<note><para>Si vous utilisez <application>Apache</application> pour travailler
avec le dépôt sur <acronym>HTTP</acronym>, même pour un accès anonyme, vous
devez emballer <command>/usr/sbin/httpd</command> dans un script similaire.
</para></note>
 
</sect3>
 
<sect3><title>2. Créez un dépôt <application>Subversion</application>.</title>
 
<para>Avec subversion-1.1.0 et ultérieur, un nouveau type de stockage de données
pour le dépôt est disponible, <acronym>FSFS</acronym>. C'est un compromis pour
la rapidité du nouveau serveur, néanmoins, le dépôt peut maintenant être placé
sur un montage réseau et toute corruption ne requiert pas un administrateur
pour récupérer le dépôt. Pour plus d'informations et de comparaisons entre
<acronym>FSFS</acronym> et <acronym>BDB</acronym>, merci de lire
<ulink url="http://svnbook.red-bean.com/svnbook-1.1/ch05.html#svn-ch-5-sect-1.2.A"/>.
En option, vous pouvez passer <parameter>bdb</parameter> à la place de
<parameter>fsfs</parameter> dans la commande suivante pour créer un stockage de
données BerkelyDB.</para>
 
<para>Créez un nouveau dépôt <application>Subversion</application> avec les
commandes suivantes&nbsp;:</para>
 
<screen><userinput><command>install -d -m0755 /srv &amp;&amp;
install -d -m0755 -o svn -g svn /srv/svn/repositories &amp;&amp;
svnadmin create --fs-type fsfs /srv/svn/repositories/svntest</command></userinput></screen>
 
<para>Maintenant que le dépôt est créé, nous avons besoin de le remplir avec
quelque chose d'utile. Vous aurez besoin d'avoir une configuration de répertoires
prédéfinis de la façon que vous pensez que votre dépôt doit avoir l'air. Par
exemple, voici une configuration simple de BLFS en exemple avec une racine
<filename>svntest/</filename>. Vous aurez besoin de configurer une hiérarchie
de répertoires similaire à ce qui suit&nbsp;:</para>
 
<screen> svntest/ # Le nom du dépôt
trunk/ # Contient le source
BOOK/
bootscripts/
edguide/
patches/
scripts/
branches/ # Nécessaire pour les branches supplémentaires
tags/ # Nécessaire pour les points de version</screen>
 
<para>Une fois que vous avez créé votre hiérarchie de répertoires comme indiquée
ci-dessus, vous êtes prêt pour l'import initial&nbsp;:</para>
 
<screen><userinput><command>svn import -m "Initial import." \
<replaceable>[/path/to/source/tree]</replaceable> \
file:///srv/svn/repositories/svntest</command></userinput></screen>
 
<para>Maintenant, continuez en modifiant les informations sur le propriétaire
et le groupe sur le dépôt, et ajoutez votre utilisateur habituel aux groupes
svn et svntest&nbsp;:</para>
 
<screen><userinput><command>chown -R svn:svntest /srv/svn/repositories/svntest &amp;&amp;
chmod -R g+w /srv/svn/repositories/svntest &amp;&amp;
chmod g+s /srv/svn/repositories/svntest/db &amp;&amp;
usermod -G svn,svntest,<replaceable>[insert existing groups]</replaceable> <replaceable>[username]</replaceable></command></userinput></screen>
 
<para>svntest est le groupe affecté au dépôt svntest. Comem mentionné plus tôt,
ceci facilite l'administration de plusieurs dépôts lors de l'utilisation
d'<application>OpenSSH</application> pour l'authentification. En allant plus
loin, vous aurez besoin d'ajouter votre utilisateur habituel, et peut-être
d'autres utilisateurs si vous souhaitez qu'ils aient accès en écriture au dépôt,
aux groupes svn et svntest.</para>
 
<para>De plus, vous noterez que le répertoire <filename>db</filename> du nouveau
dépôt dispose du bit SGID. Au cas où la raison n'en serait pas claire
immédiatement, lors de l'utilisation d'une méthode d'authentification externe
(comme <command>ssh</command>), le <quote>sticky bit</quote> est configuré de
façon à ce que tous les nouveaux fichiers soient la propriété de l'utilisateur
qui les a créés mais aussi pour qu'ils aient comme groupe svntest. Toute personne
du groupe svntest peut créer des fichiers mais donne toujours le droit d'écriture
de groupe à ces fichiers. Ceci évite de verrouiller d'autres utilisateurs à
partir du dépôt.</para>
 
<para>Maintenant, continuez en retournant à votre compte utilisateur normal et
jetez un &oelig;il à votre nouveau dépôt en utilisant
<command>svnlook</command>&nbsp;:</para>
 
<screen><userinput><command>svnlook tree /srv/svn/repositories/svntest/</command></userinput></screen>
 
<note><para>Vous pourriez avoir besoin de vous déconnecter puis de vous reconnecter
pour rafraichir votre appartenance aux groupes. '<command>su
<replaceable>[nomutilisateur]</replaceable></command>' devrait aussi contourner
ce problème.</para></note>
 
</sect3>
 
<sect3><title>3. Configurer le serveur</title>
 
<para>Comme mentionné précédemment, ces instructions configureront le serveur
pour utiliser seulement <command>ssh</command> lors des accès en écriture au
dépôt et pour fournir un accès anonyme en utilisant <command>svnserve</command>.
Il existe d'autres moyens de fournir un accès au dépôt. Ces configurations
supplémentaires sont mieux expliquées sur
<ulink url="http://svnbook.red-bean.com/"/>.</para>
 
<para>La configuration de l'accès doit se faire pour chaque dépôt. Créez le
fichier <filename>svnserve.conf</filename> pour le dépôt svntest en utilisant
les commandes suivantes&nbsp;:</para>
 
<screen><userinput><command>cp /srv/svn/repositories/svntest/conf/svnserve.conf \
/srv/svn/repositories/svntest/conf/svnserve.conf.default &amp;&amp;
cat &gt; /srv/svn/repositories/svntest/conf/svnserve.conf &lt;&lt; "EOF"</command>
[general]
anon-access = read
auth-access = write
<command>EOF</command></userinput></screen>
 
<para>Il n'y a pas grand chose dans le fichier de configuration. Vous remarquerez
que seule la section générale est requise. Jetez un &oelig;il au fichier
<filename>svnserve.conf.default</filename> pour des informations sur
l'utilisation de la méthode d'authentification intégrée,
<command>svnserve</command>.</para>
 
</sect3>
 
<sect3><title>4. Exécuter le serveur</title>
 
<para>Il existe plusieurs façons de démarrer <command>svnserve</command>. La
façon la plus commune est de le lancer comme un processus
<command>inetd</command> ou <command>xinetd</command>. Autrement, vous pouvez
utiliser un script de démarrage pour lancer le serveur au démarrage de la
machine.</para>
 
<note><para>Si vous ne souhaitez pas fournir d'accès anonyme aux dépôts svn ou
si vous ne souhaitez pas utiliser l'authentification intégrée à
<command>svnserve</command>, vous n'avez pas besoin d'exécuter
<command>svnserve</command>.</para></note>
 
<para>Si vous utilisez <command>inetd</command>, ajoutez une ligne à
<filename>/etc/inetd.conf</filename> en utilisant les commandes suivantes&nbsp;:</para>
 
<screen><userinput><command>cat &gt;&gt; /etc/inetd.conf &lt;&lt; "EOF"</command>
svn stream tcp nowait svn /usr/bin/svnserve svnserve -i
<command>EOF</command></userinput></screen>
 
<para>Si vous utilisez <command>xinetd</command>, ajoutez les lignes suivantes
dans votre fichier <filename>/etc/xinetd.conf</filename>&nbsp;:</para>
 
<screen><userinput><command>cat &gt;&gt; /etc/xinetd.conf &lt;&lt; "EOF"</command>
service svn
{
port = 3690
socket_type = stream
protocol = tcp
wait = no
user = svn
server = /usr/bin/svnserve
server_args = -i -r /srv/svn/repositories
}
<command>EOF</command></userinput></screen>
 
<para>Enfin, si vous souhaitez simplement exécuter le serveur au démarrage,
installez le script de démarrage svn inclus dans le paquetage
<xref linkend="intro-important-bootscripts"/>.</para>
 
<screen><userinput><command>make install-svn</command></userinput></screen>
 
</sect3>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/server/other/leafnode.xml
0,0 → 1,274
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY leafnode-download-http "http://prdownloads.sourceforge.net/leafnode/leafnode-&leafnode-version;.rel.tar.bz2">
<!ENTITY leafnode-download-ftp "ftp://ftp.gwdg.de/pub/linux/mirrors/sunsite/system/news/transport/leafnode-&leafnode-version;.rel.tar.bz2">
<!ENTITY leafnode-md5sum "1d8d27673780ba49fcb69883c2cabdec">
<!ENTITY leafnode-size "385&nbsp;Ko">
<!ENTITY leafnode-buildsize "6,3&nbsp;Mo">
<!ENTITY leafnode-time "0,10&nbsp;SBU">
]>
 
<sect1 id="leafnode" xreflabel="Leafnode-&leafnode-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-16 06:11:50 $</date>
</sect1info>
<?dbhtml filename="leafnode.html"?>
<title>Leafnode-&leafnode-version;</title>
<indexterm zone="leafnode">
<primary sortas="a-Leafnode">Leafnode</primary></indexterm>
 
<sect2>
<title>Introduction à <application>Leafnode</application></title>
 
<para><application>Leafnode</application> est un serveur <acronym>NNTP</acronym>
conçu pour les petits sites fournissant un spooler USENET local.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;:
<ulink url="&leafnode-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;:
<ulink url="&leafnode-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &leafnode-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&leafnode-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&leafnode-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&leafnode-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Dépendances de <application>Leafnode</application></title>
<sect4><title>Requis</title>
<para><xref linkend="pcre"/> et <xref linkend="tcpwrappers"/></para>
</sect4>
 
<sect4><title>Recommandé</title>
<para><xref linkend="xinetd"/> et <xref linkend="fcron"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>Leafnode</application></title>
 
<para>Créez le groupe et l'utilisateur news, s'ils ne sont pas déjà
présents&nbsp;:</para>
 
<screen><userinput><command>groupadd news &amp;&amp;
useradd -c "Leafnode News Server" -d /var/spool/news -g news news</command></userinput></screen>
 
<para>Installez <application>Leafnode</application> en lançant les commandes
suivantes&nbsp;:</para>
 
<screen><userinput><command>./configure --prefix=/usr \
--localstatedir=/var --sysconfdir=/etc/leafnode \
--with-lockfile=/var/lock/leafnode/fetchnews.lck &amp;&amp;
make</command></userinput></screen>
 
<para>Maintenant, en tant qu'utilisateur root&nbsp;:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Explications des commandes d'installation</title>
 
<para><parameter>--localstatedir=/var</parameter>&nbsp;: modifie le répertoire
spool, étant <filename class="directory">/usr/var</filename> par défaut.</para>
 
<para><parameter>--sysconfdir=/etc/leafnode</parameter>&nbsp;:
<application>Leafnode</application> lit les données de configuration à partir
d'un fichier nommé <filename>config</filename> qui sera créé dans
<filename class="directory">/etc/leafnode</filename> pour éviter tout conflit
potentiel avec d'autres paquetages.</para>
 
<para><command>make update</command>&nbsp;: lancez cette commande si vous faites
une mise à jour à partir d'une très vieille version de
<application>Leafnode</application>.</para>
 
</sect2>
 
<sect2>
<title>Configurer <application>Leafnode</application></title>
 
<sect3 id="leafnode-config"><title>Fichiers de configuration</title>
<para><filename>/etc/leafnode/config</filename>,
<filename>/etc/nntpserver</filename>,
<filename>/etc/xinetd.conf</filename> ou
<filename>/etc/inetd.conf</filename> et
<filename>/etc/sysconfig/createfiles</filename></para>
<indexterm zone="leafnode leafnode-config">
<primary sortas="e-etc-leafnode-config">/etc/leafnode/config</primary>
</indexterm>
<indexterm zone="leafnode leafnode-config">
<primary sortas="e-etc-nntpserver">/etc/nntpserver</primary></indexterm>
<indexterm zone="leafnode leafnode-config">
<primary sortas="e-etc-xinetd.conf">/etc/xinetd.conf</primary></indexterm>
<indexterm zone="leafnode leafnode-config">
<primary sortas="e-etc-inetd.conf">/etc/inetd.conf</primary></indexterm>
<indexterm zone="leafnode leafnode-config"><primary
sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
</indexterm>
</sect3>
 
<sect3><title>Commandes de configuration</title>
 
<para>Le fichier <filename>/etc/leafnode/config</filename> doit être édité
pour refléter le nom du fournisseur <acronym>NNTP</acronym> en amont. Copiez
le fichier de configuration d'exemple dans <filename>/etc/leafnode/config</filename>
et sauvegardez l'original pour référence&nbsp;:</para>
 
<screen><userinput><command>cp /etc/leafnode/config.example /etc/leafnode/config</command></userinput></screen>
 
<para>Modifiez l'entrée
<screen><userinput>server = </userinput></screen>
pour refléter votre fournisseur de nouvelles.</para>
 
<para>Le fichier <filename>/etc/nntpserver</filename> doit contenir 127.0.0.1
pour empêcher les nouveaux clients de lire à partir du flux en amont. Créez ce
fichier en utilisant la commande suivante&nbsp;:</para>
 
<screen><userinput><command>cat &gt; /etc/nntpserver &lt;&lt; "EOF"</command>
127.0.0.1
 
<command>EOF</command></userinput></screen>
 
<para>Le script <command>/etc/rc.d/init.d/cleanfs</command>, faisant partie du
paquetage des scripts de démarrage <acronym>LFS</acronym>, supprimera le
répertoire <filename class="directory">/var/lock/leafnode</filename> pendant la
séquence de démarrage du système. Installez la ligne suivante dans le fichier
<filename>/etc/sysconfig/createfiles</filename> pour créer de nouveau le
répertoire&nbsp;:</para>
 
<screen><userinput>/var/lock/leafnode dir 2775 news news</userinput></screen>
 
<para><application>Leafnode</application> pourrait être configuré pour utiliser
<command>inetd</command> en ajoutant une entrée dans le fichier
<filename>/etc/inetd.conf</filename> avec la commande&nbsp;:</para>
 
<screen><userinput><command>echo "nntp stream tcp nowait news /usr/sbin/tcpd /usr/sbin/leafnode" \
&gt;&gt; /etc/inetd.conf</command></userinput></screen>
 
<para>Lancez la commande <command>killall -HUP inetd</command> pour relire le
fichier <filename>inetd.conf</filename> modifié.</para>
 
<para>Autrement, <application>Leafnode</application> pourrait être configuré
pour utiliser <command>xinetd</command> en ajoutant une entrée dans le fichier
<filename>/etc/xinetd.conf</filename> avec la commande suivante&nbsp;:</para>
 
<screen><userinput><command>cat &gt;&gt; /etc/xinetd.conf &lt;&lt; "EOF"</command>
service nntp
{
flags = NAMEINARGS NOLIBWRAP
socket_type = stream
protocol = tcp
wait = no
user = news
server = /usr/sbin/tcpd
server_args = /usr/sbin/leafnode
instances = 7
per_source = 3
}
<command>EOF</command></userinput></screen>
 
<para>Lancez la commande a <command>killall -HUP xinetd</command> pour relire
le fichier <filename>xinetd.conf</filename> modifié.</para>
 
<para>Ajoutez des entrées dans le fichier crontab de root ou de l'utilisateur
news pour lancer les commandes <command>fetchnews</command> et
<command>texpire</command> aux intervalles de temps désirés.</para>
 
</sect3>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<segmentedlist>
<segtitle>Programmes installés</segtitle>
<segtitle>Bibliothèques installées</segtitle>
<segtitle>Répertoires installés</segtitle>
 
<seglistitem>
<seg>applyfilter, checkgroups, fetchnews, leafnode, leafnode-version,
newsq et texpire</seg>
<seg>Aucune</seg>
<seg>/etc/leafnode, /var/lock/leafnode et /var/spool/news</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Descriptions courtes</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="applyfilter">
<term><command>applyfilter</command></term>
<listitem><para>filtre les articles des groupes de nouvelles euivant des
expressions rationnelles.</para>
<indexterm zone="leafnode applyfilter">
<primary sortas="b-applyfilter">applyfilter</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="checkgroups">
<term><command>checkgroups</command></term>
<listitem><para>insère des titres de groupes de nouvelles dans la base de
données.</para>
<indexterm zone="leafnode checkgroups">
<primary sortas="b-checkgroups">checkgroups</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="fetchnews">
<term><command>fetchnews</command></term>
<listitem><para>envoie les articles postés et récupère les nouveaux articles
à partir d'un serveur de nouvelles en amont.</para>
<indexterm zone="leafnode fetchnews">
<primary sortas="b-fetchnews">fetchnews</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="leafnode-prog">
<term><command>leafnode</command></term>
<listitem><para>est un démon pour le serveur <acronym>NNTP</acronym>.</para>
<indexterm zone="leafnode leafnode-prog">
<primary sortas="b-leafnode">leafnode</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="leafnode-version">
<term><command>leafnode-version</command></term>
<listitem><para>affiche la version de <application>Leafnode</application>.</para>
<indexterm zone="leafnode leafnode-version">
<primary sortas="b-leafnode-version">leafnode-version</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="newsq">
<term><command>newsq</command></term>
<listitem><para>affiche les articles attendant d'être envoyés en amont.</para>
<indexterm zone="leafnode newsq">
<primary sortas="b-newsq">newsq</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="texpire">
<term><command>texpire</command></term>
<listitem><para>fait expirer les vieux articles et les groupes non lus.</para>
<indexterm zone="leafnode texpire">
<primary sortas="b-texpire">texpire</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/server/other/rsync.xml
0,0 → 1,140
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY rsync-download-http "http://rsync.samba.org/ftp/rsync/rsync-&rsync-version;.tar.gz">
<!ENTITY rsync-download-ftp "ftp://ftp.samba.org/pub/rsync/rsync-&rsync-version;.tar.gz">
<!ENTITY rsyncd-md5sum "2beb30caafa69a01182e71c528fb0393">
<!ENTITY rsyncd-size "583 KB">
<!ENTITY rsync-buildsize "4.8 MB">
<!ENTITY rsyncd-time "0.17 SBU">
]>
 
<sect1 id="rsync" xreflabel="rsync-&rsync-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-16 06:11:50 $</date>
</sect1info>
<?dbhtml filename="rsync.html"?>
<title><application>rsync</application>-&rsync-version;</title>
 
<sect2>
<title>Introduction à <application>rsync</application></title>
 
<para>Le paquetage <application>rsync</application> contient l'outil
<command>rsync</command>. Il est utile pour synchroniser de grosses archives de
fichiers sur un réseau.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;:
<ulink url="&rsync-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;:
<ulink url="&rsync-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &rsyncd-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&rsyncd-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&rsync-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&rsyncd-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Dépendances de <application>rsync</application></title>
<sect4><title>Optionnel</title>
<para><xref linkend="popt"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>rsync</application></title>
 
<para>Pour des raisons de sécurité, lancer le serveur <application>rsync</application>
avec un utilisateur et groupe sans privilège est encouragé. Si vous avez
l'intention de lancer <command>rsync</command> en tant que démon, créez
l'utilisateur et le groupe rsyncd avec les commandes suivantes&nbsp;:</para>
 
<screen><userinput><command>groupadd rsyncd &amp;&amp;
useradd -c "rsyncd Daemon" -d /home/rsync -g rsyncd -s /bin/false rsyncd</command>
</userinput></screen>
 
<para>Installez <application>rsync</application> en lançant les commandes suivantes
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install </command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Configurer <application>rsync</application></title>
 
<sect3><title>Fichiers de configuration</title>
<para><filename>/etc/rsyncd.conf</filename></para>
</sect3>
 
<sect3><title>Informations de configuration</title>
<para>Ceci est une configuration simple de téléchargement uniquement.
Voir la page man de rsyncd man-page pour des options supplémentaires (par
exemple, authentification de l'utilisateur).</para>
 
<screen><userinput><command>cat &gt; /etc/rsyncd.conf &lt;&lt; "EOF"</command>
# Ceci est un fichier basique de configuration de rsync.
# Il exporte un seul module sans authentification de l'utilisateur.
 
motd file = /home/rsync/welcome.msg
use chroot = yes
 
[localhost]
path = /home/rsync
comment = Default rsync module
read only = yes
list = yes
uid = rsyncd
gid = rsyncd
 
<command>EOF</command></userinput></screen>
</sect3>
 
<sect3><title>Script de démarrage de rsyncd</title>
 
<para>Notez que vous voulez lancer le serveur <application>rsync</application>
seulement si vous voulez proposer une archive <application>rsync</application>
sur votre machine locale. Vous n'avez pas besoin de ce script pour exécuter le
client <application>rsync</application>.</para>
 
<para>Installez le script de démarrage <filename>/etc/rc.d/init.d/rsyncd</filename>
inclus dans le paquetage <xref linkend="intro-important-bootscripts"/>.</para>
 
<screen><userinput><command>make install-rsyncd</command></userinput></screen>
 
</sect3>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<para>Le paquetage <application>rsync</application> contient
<command>rsync</command>.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>rsync</title>
<para><application>rsync</application> est un remplacement pour
<command>rcp</command> (et <command>scp</command>) qui a beaucoup plus de
fonctionnalités. Il utilise l'algorithme rsync, fournissant une méthode très
rapide de synchronisation de fichiers distants. Il le fait en envoyant seulement
les différences des fichiers sur le lien, sans réclamer que les deux ensembles
de fichiers soient présents aux deux bouts du lien.</para></sect3>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/server/other/dhcp.xml
0,0 → 1,238
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY dhcp-download-http "http://gd.tuwien.ac.at/infosys/servers/isc/dhcp/dhcp-&dhcp-version;.tar.gz">
<!ENTITY dhcp-download-ftp "ftp://ftp.isc.org/isc/dhcp/dhcp-&dhcp-version;.tar.gz">
<!ENTITY dhcp-md5sum "04800a111521e7442749b2ce883f962b">
<!ENTITY dhcp-size "834&nbsp;Ko">
<!ENTITY dhcp-buildsize "29,7&nbsp;Mo">
<!ENTITY dhcp-time "0,22&nbsp;SBU">
]>
 
<sect1 id="dhcp" xreflabel="DHCP-&dhcp-version;">
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-16 06:11:50 $</date>
</sect1info>
<?dbhtml filename="dhcp.html"?>
<title><acronym>DHCP</acronym>-&dhcp-version;</title>
 
<indexterm zone="dhcp">
<primary sortas="a-dhcp">Dhcp</primary>
</indexterm>
 
<sect2>
<title>Introduction à
<application><acronym>DHCP</acronym></application></title>
 
<para>Le paquetage <application><acronym>DHCP</acronym></application> contient
à la fois les programmes client et serveur pour <acronym>DHCP</acronym>.
<command>dhclient</command> (le client) est utile pour connecter votre ordinateur
à un réseau utilisant <acronym>DHCP</acronym> pour affecter les adresses du
réseau. <command>dhcpd</command> (le serveur) est utile pour affecter les adresses
réseau sur un réseau privé.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;: <ulink url="&dhcp-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;: <ulink url="&dhcp-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &dhcp-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&dhcp-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;: &dhcp-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;: &dhcp-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3>
<title>Dépendances de <application>dhcp</application></title>
 
<sect4>
<title>Requis</title>
<para><xref linkend="net-tools"/> (vous pourriez omettre
<application>net-tools</application> en utilisant le correctif suivant pour
prendre en compte <application>iproute2</application>&nbsp;:
<ulink url="&patch-root;/dhcp-&dhcp-version;-iproute2-2.patch"/>)
</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2 id='dhcp-kernel'>
<title>Installation de
<application><acronym>DHCP</acronym></application></title>
 
<note><para>Vous devez avoir le support du <quote>Packet Socket</quote> (Device
Drivers -&gt; Networking Support -&gt; Networking Options -&gt; Packet Socket)
compilé dans le noyau.</para></note>
 
<indexterm zone="dhcp dhcp-kernel">
<primary sortas="d-dhcp">DHCP</primary>
</indexterm>
 
<para>Installez <application><acronym>DHCP</acronym></application> en lançant
les commandes suivantes&nbsp;:</para>
 
<screen><userinput><command>patch -Np1 -i ../dhcp-&dhcp-version;-iproute2-2.patch &amp;&amp;
./configure &amp;&amp;
make</command></userinput></screen>
 
<para>Maintenant, en tant qu'utilisateur root&nbsp;:</para>
<screen><userinput role='root'><command>make LIBDIR=/usr/lib INCDIR=/usr/include install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Explications des commandes</title>
 
<para><parameter>LIBDIR=/usr/lib INCDIR=/usr/include</parameter>&nbsp;: cette
commande installe la bibliothèque et les fichiers d'inclusion dans
<filename class="directory">/usr</filename> au lieu de
<filename class="directory">/usr/local</filename>.</para>
 
</sect2>
 
<sect2 id='dhcp-config'>
<title>Configurer <application><acronym>DHCP</acronym></application></title>
 
<indexterm zone="dhcp dhcp-config">
<primary sortas="e-etc-dhclient.conf">/etc/dhclient.conf</primary>
</indexterm>
 
<indexterm zone="dhcp dhcp-config">
<primary sortas="e-etc-dhcpd.conf">/etc/dhcpd.conf</primary>
</indexterm>
 
 
<sect3>
<title>Fichiers de configuration</title>
<para><filename>/etc/dhclient.conf</filename></para>
</sect3>
 
<sect3 id='dhcp-init'>
<title>Informations de configuration</title>
 
<para>L'nformation sur la configuration du client <acronym>DHCP</acronym> peut
être trouvée dans <xref linkend="connect-dhcp"/>.</para>
 
<para>Notez que vous avez seulement besoin du serveur <acronym>DHCP</acronym>
si vous voulez utiliser des adresses <acronym>LAN</acronym> sur votre réseau.
Le client <acronym>DHCP</acronym> n'a pas besoin de ce script pour être utilisé.
De plus, notez que ce script est codé pour l'interface <emphasis
role="strong">eth1</emphasis>. Il pourrait donc être nécessaire pour le modifier
suivant la configuration de votre matériel.</para>
 
<para>Installez le script de démarrage <filename>/etc/rc.d/init.d/dhcp</filename>
inclus dans le paquetage <xref linkend="intro-important-bootscripts"/>.</para>
 
<indexterm zone="dhcp dhcp-init">
<primary sortas="f-dhcp">dhcpd</primary>
</indexterm>
 
<screen><userinput><command>make install-dhcp</command></userinput></screen>
 
<para>Le fichier lease doit exister au démarrage. La commande suivante satisfera
ce pré-requis&nbsp;:</para>
 
<screen><userinput><command>touch /var/state/dhcp/dhcpd.leases</command></userinput></screen>
 
<para>Les commandes suivantes créeront un fichier de configuration de base pour
un serveur <acronym>DHCP</acronym>. Il existe plusieurs options que vous pourriez
vouloir ajouter (informations passées au client <acronym>DHCP</acronym>). Elles
sont couvertes dans la page man de <filename>dhcp.conf</filename>.</para>
 
<screen><userinput><command>cat &gt; /etc/dhcpd.conf &lt;&lt; "EOF"</command>
default-lease-time 72000;
max-lease-time 144000;
ddns-update-style ad-hoc;
 
subnet <replaceable>[192.168.5.0]</replaceable> netmask <replaceable>[255.255.255.0]</replaceable> {
range <replaceable>[192.168.5.10] [192.168.5.240]</replaceable>;
option broadcast-address <replaceable>[192.168.5.255]</replaceable>;
option routers <replaceable>[192.168.5.1]</replaceable>;
}
<command>EOF</command></userinput></screen>
 
<para>Toutes les adresses doivent être modifiées pour correspondre à vos
besoins.</para>
 
</sect3>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<segmentedlist>
<segtitle>Programmes installés</segtitle>
<segtitle>Bibliothèques installées</segtitle>
<segtitle>Répertoires installés</segtitle>
<seglistitem>
<seg>dhcpd, dhcrelay, dhclient, dhclient-script, omshell</seg>
<seg>bdhcpctl.a, libomapi.a</seg>
<seg>/var/state/dhcp, /usr/include/omapip, /usr/include/isi-dhcp</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Descriptions courtes</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="dhclient">
<term><command>dhclient</command></term>
<listitem>
<para>est l'implémentation du client <acronym>DHCP</acronym>.</para>
<indexterm zone="dhcp dhclient">
<primary sortas="b-dhclient">dhclient</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="dhcpd">
<term><command>dhcpd</command></term>
<listitem>
<para>implémente le protocole de configuration dynamique de l'hôte
(<foreignphrase>Dynamic Host Configuration Protocol</foreignphrase>
(<acronym>DHCP</acronym>) et les requêtes du protocole
<quote><foreignphrase>Internet Bootstrap</foreignphrase></quote>
(<acronym>BOOTP</acronym>) pour des adresses réseau.</para>
<indexterm zone="dhcp dhcpd">
<primary sortas="b-dhcpd">dhcpd</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="dhcrelay">
<term><command>dhcrelay</command></term>
<listitem>
<para>fournit un moyen d'accepter les requêtes <acronym>DHCP</acronym> et
<acronym>BOOTP</acronym> sur un sous-réseau sans un serveur
<acronym>DHCP</acronym> et les relaie sur un serveur
<acronym>DHCP</acronym> sur un autre sous-réseau.</para>
<indexterm zone="dhcp dhcrelay">
<primary sortas="b-dhcrelay">dhcrelay</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="omshell">
<term><command>omshell</command></term>
<listitem>
<para>fournit une façon interactive de se connecter, de demander et, quelque
fois, de modifier l'état du serveur HDCP ISC via OMAPI, l'API de gestion
des objets.</para>
<indexterm zone="dhcp omshell">
<primary sortas="b-omshell">omshell</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
</sect2>
</sect1>
 
/tags/tBLFS-6_0/blfs/server/other/openssh.xml
0,0 → 1,202
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY openssh-download-http "http://sunsite.ualberta.ca/pub/OpenBSD/OpenSSH/portable/openssh-&openssh-version;.tar.gz">
<!ENTITY openssh-download-ftp "ftp://ftp.openbsd.org/pub/OpenBSD/OpenSSH/portable/openssh-&openssh-version;.tar.gz">
<!ENTITY openssh-md5sum "8e1774d0b52aff08f817f3987442a16e">
<!ENTITY openssh-size "854 KB">
<!ENTITY openssh-buildsize "13.3 MB">
<!ENTITY openssh-time "0.40 SBU">
]>
 
<sect1 id="openssh" xreflabel="OpenSSH-&openssh-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-16 06:11:50 $</date>
</sect1info>
<?dbhtml filename="openssh.html"?>
<title>Open<acronym>SSH</acronym>-&openssh-version;</title>
 
<sect2>
<title>Introduction à
<application>Open<acronym>SSH</acronym></application></title>
 
<para>Le paquetage <application>Open<acronym>SSH</acronym></application> contient
des clients <command>ssh</command> et le démon <command>sshd</command>. Ils sont
utiles pour crypter l'authentification et le trafic qui suit sur un réseau.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;:
<ulink url="&openssh-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;:
<ulink url="&openssh-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &openssh-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&openssh-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&openssh-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&openssh-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Dépendances d'<application>Open<acronym>SSH</acronym></application></title>
<sect4><title>Requis</title>
<para><xref linkend="openssl"/></para>
</sect4>
 
<sect4><title>Optionnel</title>
<para><xref linkend="Linux_PAM"/>,
<xref linkend="tcpwrappers"/>,
X (<xref linkend="xfree86"/> ou <xref linkend="xorg"/>),
<xref linkend="mitkrb"/> ou <xref linkend="heimdal"/>,
<xref linkend="j2sdk"/>,
<xref linkend="net-tools"/> et
<ulink url="http://www.opensc.org/">OpenSC</ulink></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de
<application>Open<acronym>SSH</acronym></application></title>
 
<para><application>Open<acronym>SSH</acronym></application> fonctionne avec deux
processus lors de la connexion entre ordinateurs. Le premier processus est un
processus privilégié et contrôle l'échange des droits si nécessaire. Le second
processus communique avec le réseau. Les étapes supplémentaires d'installation
sont nécessaires pour configurer le bon environnement, grâce aux commandes
suivantes&nbsp;:</para>
 
<screen><userinput><command>mkdir /var/empty &amp;&amp;
chown root:sys /var/empty &amp;&amp;
groupadd sshd &amp;&amp;
useradd -c 'sshd privsep' -d /var/empty -g sshd -s /bin/false sshd</command></userinput></screen>
 
<para><application>OpenSSH</application> est très sensible aux changements dans
les bibliothèques liées d'<application>OpenSSL</application>. Si vous recompilez
<application>OpenSSL</application>, <application>OpenSSH</application> pourrait
échouer au lancement. Une alternative est de lier avec la bibliothèque statique
d'<application>OpenSSL</application>. Pour lier la bibliothèque statique,
exécutez la commande suivante&nbsp;:</para>
 
<screen><userinput><command>sed -i "s:-lcrypto:/usr/lib/libcrypto.a:g" configure</command></userinput></screen>
 
<para>Installez <application>Open<acronym>SSH</acronym></application> en lançant
les commandes suivantes&nbsp;:</para>
 
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc/ssh \
--libexecdir=/usr/sbin --with-md5-passwords &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Explications des commandes</title>
 
<para><parameter>--sysconfdir=/etc/ssh</parameter>&nbsp;: ceci empêche le stockage
des fichiers de configuration dans
<filename class="directory">/usr/etc</filename>.</para>
 
<para><parameter>--with-md5-passwords</parameter>&nbsp;: ceci est requis si vous
effectuez les modifications recommandées par l'astuce shadowpasswd_plus de
<acronym>LFS</acronym> sur votre serveur <acronym>SSH</acronym> lorsque vous
avez installez la suite Shadow Password ou si vous avez accès à un serveur
<acronym>SSH</acronym> qui fournit l'authentification des mots de passe
utilisateur avec un cryptage md5. </para>
 
<para><parameter>--libexecdir=/usr/sbin</parameter>&nbsp;:
<application>Open<acronym>SSH</acronym></application> installe des programmes
appelés par des programmes dans <filename class="directory">/usr/libexec</filename>.
<command>sftp-server</command> est un outil de <command>sshd</command> et
<command>ssh-askpass</command> est un outil de <command>ssh-add</command>
qui est installé comme lien vers <command>X11-ssh-askpass</command>. Ces deux-là
devraient être installés dans <filename class="directory">/usr/sbin</filename>,
et non pas dans <filename class="directory">/usr/libexec</filename>.</para>
 
</sect2>
 
<sect2>
<title>Configurer <application>Open<acronym>SSH</acronym></application></title>
 
<sect3><title>Fichiers de configuration</title>
 
<para><filename>/etc/ssh/ssh_config</filename> et
<filename>/etc/ssh/sshd_config </filename></para>
 
<para>Il n'y a pas de modifications requises sur un de ces fichiers. Néanmoins,
vous pourriez vouloir faire des modifications pour une sécurité appropriée de
votre système. Une modification recommandée est de désactiver la connexion de
l'utilisateur root via ssh. Exécutez la commande suivante pour cela&nbsp;:</para>
 
<screen><userinput><command>echo "PermitRootLogin no" >> /etc/ssh/sshd_config</command></userinput></screen>
 
<para>Des informations de configuration supplémentaires sont disponibles dans
les pages man de <command>sshd</command>, <command>ssh</command> et
<command>ssh-agent</command></para>.
</sect3>
 
<sect3><title>Script de démarrage sshd</title>
 
<para>Pour exécuter le serveur <acronym>SSH</acronym> au démarrage du système,
installez le script de démarrage <filename>/etc/rc.d/init.d/sshd</filename>
inclus dans le paquetage <xref linkend="intro-important-bootscripts"/>.</para>
 
<screen><userinput><command>make install-sshd</command></userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<para>Le paquetage <application>Open<acronym>SSH</acronym></application>
contient <command>ssh</command>, <command>sshd</command>,
<command>ssh-agent</command>, <command>ssh-add</command>,
<command>sftp</command>, <command>scp</command>,
<command>ssh-keygen</command>, <command>sftp-server</command> et
<command>ssh-keyscan</command>.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>ssh</title>
<para>Le programme client de base, style
<command>rlogin</command>/<command>rsh</command>.</para></sect3>
 
<sect3><title>sshd</title>
<para>Le démon qui attend les demandes de connexions <command>ssh</command>.
</para></sect3>
 
<sect3><title>ssh-agent</title>
<para>Un agent d'authentification qui peut sotcker les clés privées.</para></sect3>
 
<sect3><title>ssh-add</title>
<para>Outil pour ajouter des clés à <command>ssh-agent</command>.</para></sect3>
 
<sect3><title>sftp</title>
<para>Programme style <acronym>FTP</acronym> mais fonctionnant avec les
protocoles <acronym>SSH</acronym>1 et <acronym>SSH</acronym>2.</para></sect3>
 
<sect3><title>scp</title>
<para>Programme de copie de fichiers agissant comme <command>rcp</command>.</para></sect3>
 
<sect3><title>ssh-keygen</title>
<para>Outil de génération de clés.</para></sect3>
 
<sect3><title>sftp-server</title>
<para>Sous-système du serveur <acronym>SFTP</acronym>.</para></sect3>
 
<sect3><title>ssh-keyscan</title>
<para>Outil pour récupérer les clés publiques des hôtes à partir de certains
hôtes.</para></sect3>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/server/server.xml
0,0 → 1,15
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
 
<part id="server" xreflabel="Server Networking">
<?dbhtml filename="server.html" dir="server"?>
<title>Serveurs réseau</title>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mail/mail.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="other/other.xml"/>
 
</part>
/tags/tBLFS-6_0/blfs/x/installing/installing.xml
0,0 → 1,18
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
 
<chapter id="x-installing">
<?dbhtml filename="installing.html" ?>
<title>Environnement X Window</title>
 
<para>Ce chapitre contient un environnement graphique pour l'utilisateur.</para>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xorg.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xfree86.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x-setup.xml"/>
 
</chapter>
/tags/tBLFS-6_0/blfs/x/installing/x-setup.xml
0,0 → 1,347
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
 
<sect1 id="x-setup">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="xfree86-setup.html"?>
<title>X Window System Components</title>
 
<sect2 id='dri'>
<title>Checking Direct Rendering Infrastructure (<acronym>DRI</acronym>)
Installation</title>
 
<indexterm zone="x-setup dri">
<primary sortas="g-DRI">DRI</primary>
</indexterm>
 
<para><acronym>DRI</acronym> is a framework for allowing software to access
graphics hardware in a safe and efficient manner. It is installed in
<application>X</application> by default if you have a supported video card.
To check if <acronym>DRI</acronym> is installed properly, check the log file
<filename>/var/log/XFree86.0.log</filename> or
<filename>/var/log/Xorg.0.log</filename> for statements like:</para>
 
<screen>(II) R128(0): Direct rendering enabled</screen>
 
<para>From an <command>xterm</command>, run <command>glxinfo</command> and
look for the phrase:</para>
 
<screen><computeroutput>direct rendering: Yes</computeroutput></screen>
 
<para>You can also run the test program <command>glxgears</command>.
This program brings up a window with three gears turning. The
<command>xterm</command> will display how many frames were drawn every
five seconds, so this is a reasonable benchmark. The window is scalable, and
the frames drawn per second is highly dependent on the size of
the window.</para>
 
<indexterm zone="x-setup dri">
<primary sortas="b-glxgears">glxgears</primary>
</indexterm>
 
<indexterm zone="x-setup dri">
<primary sortas="b-glxinfo">glxinfo</primary>
</indexterm>
 
<para>For troubleshooting problems, check the <acronym>DRI</acronym> Users
Guide at
<ulink url="http://dri.sourceforge.net/doc/DRIuserguide.html"/>.</para>
 
</sect2>
 
<!-- ================================================== -->
 
<sect2 id='fonts'>
<title>Adding <application>TrueType</application> fonts to
<application>X</application></title>
 
<para><application>TrueType</application> font support is built into
<application>X</application>. The following items need to
be completed to make the fonts available. Each item is described in
detail after the list.</para>
 
<indexterm zone="x-setup fonts">
<primary sortas="g-truetype">TrueType</primary>
</indexterm>
 
<itemizedlist>
<listitem><para>Establish a directory for the fonts and move any
<application>TrueType</application> fonts you want into that directory.
Ensure that any fonts you install are world readable. Incorrect
permissions on fonts have been known to cause problems with some
<application>X</application> applications.</para></listitem>
 
<listitem><para>Download the fonts.</para></listitem>
 
<listitem><para>Create the <filename>fonts.scale</filename> and
<filename>fonts.dir</filename> files in the
<application>TrueType</application> font
directory.</para></listitem>
 
<listitem><para>Ensure the <application>TrueType</application> module is
loaded in the <filename>XF86Config</filename> or
<filename>xorg.conf</filename>.</para></listitem>
 
<listitem><para>Ensure the <parameter>FontPath</parameter> in
<filename>XF86Config</filename> or <filename>xorg.conf</filename> contains the
<application>TrueType</application> font directory.</para></listitem>
 
<listitem><para>Update the font cache files</para></listitem>
</itemizedlist>
 
<indexterm zone="x-setup fonts">
<primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary>
</indexterm>
 
<indexterm zone="x-setup fonts">
<primary sortas="e-etc-X11-XF86Config">/etc/X11/XF86Config</primary>
</indexterm>
 
<sect3><title>Establish a <application>TrueType</application> font
directory</title>
 
<para>The build of <application>X</application> as given above automatically
creates a <application>TrueType</application> font directory:
<filename class="directory">/usr/X11R6/lib/X11/fonts/TTF</filename>. This
directory already has some <application>TrueType</application> fonts and is
set up correctly. If this directory is satisfactory, copy any other
<application>TrueType</application> fonts you want into that directory. If
not, create a new directory, preferably in the
<filename class="directory">/usr/X11R6/lib/X11/fonts/</filename> directory and
put your <application>TrueType</application> fonts there.</para>
</sect3>
 
<sect3><title>Download the fonts</title>
 
<para>There are two known high quality free font resources:
<ulink url="ftp://ftp.gnu.org/savannah/files/freefont/"/> and
<ulink url="http://corefonts.sourceforge.net/"/>. Copy the fonts (files with
the <filename>.ttf</filename> suffix) to the directory you've just
created.</para>
</sect3>
 
<sect3 id="fonts-scale-dir"><title>Create <filename>fonts.scale</filename> and
<filename>fonts.dir</filename></title>
<indexterm zone="x-setup fonts-scale-dir">
<primary sortas="g-fonts.scale">fonts.scale</primary>
</indexterm>
<indexterm zone="x-setup fonts-scale-dir">
<primary sortas="g-fonts.dir">fonts.dir</primary>
</indexterm>
 
<para>Now change to the directory where you have your
<application>TrueType</application> fonts and run:
<screen><userinput><command>mkfontscale &amp;&amp;
mkfontdir</command></userinput></screen></para>
<indexterm zone="x-setup fonts-scale-dir">
<primary sortas="b-mkfontscale">mkfontscale</primary>
</indexterm>
<indexterm zone="x-setup fonts-scale-dir">
<primary sortas="b-mkfontdir">mkfontdir</primary>
</indexterm>
</sect3>
 
<sect3><title>Ensure <application>TrueType</application> is loaded in
<filename>XF86Config</filename> or <filename>xorg.conf</filename></title>
<para>The "Module" section should look like:
<screen>Section "Module"
...
Load "freetype"
...
EndSection</screen></para>
</sect3>
 
<sect3><title>Ensure the <parameter>FontPath</parameter> in
<filename>XF86Config</filename> or <filename>xorg.conf</filename> points to the
<application>TrueType</application> font directory</title>
<para>The "Files" section should look like:
<screen>Section "Files"
...
FontPath "/usr/X11R6/lib/X11/fonts/<replaceable>[TrueTypeDir]</replaceable>/"
...
EndSection</screen></para>
</sect3>
 
<sect3><title>Update the font cache files</title>
 
<para>Ensure you have the following directory entries in
<filename>/etc/fonts/local.conf</filename>, inside the fontconfig
tags:</para>
 
<indexterm zone="x-setup fonts">
<primary sortas="e-etc-fonts-local.conf">/etc/fonts/local.conf</primary>
</indexterm>
 
<screen><userinput><command>sed -i -e '/^&lt;\/fontconfig&gt;/i\
&lt;dir&gt;/usr/X11R6/lib/X11/fonts/TTF&lt;/dir&gt;\
&lt;dir&gt;/usr/X11R6/lib/X11/fonts/Type1&lt;/dir&gt;' /etc/fonts/local.conf</command></userinput></screen>
 
<para>The <command>fc-cache</command> program will automatically search
the above directories and all subdirectories for needed fonts.</para>
<para>Finally, to update all the font cache files, run</para>
 
<screen><userinput><command>fc-cache</command></userinput></screen>
 
<indexterm zone="x-setup fonts">
<primary sortas="b-fc-cache">fc-cache</primary>
</indexterm>
 
<para><application>X</application> will now be able to use
<application>TrueType</application> fonts when it is restarted.
You can check to see if the new fonts are available with the
<command>xlsfonts</command> or <command>xfontsel</command>
program.</para>
 
<note><para>You should rerun <command>mkfontscale</command> and
<command>mkfontdir</command> any time you add or delete
<application>TrueType</application> fonts.
You should also rerun <command>fc-cache</command> each time
you add or remove any fonts.</para></note>
 
</sect3>
</sect2>
 
<!-- ================================================== -->
<sect2>
<title>Setting up keyboards</title>
<para>In this version of <application>X</application>, non-Latin
keyboard layouts do not include Latin configurations as was previous
practice. To set up a keyboard for Latin and non-Latin input,
change the XkbLayout keyboard driver option in the InputDevice section
of the <filename>XF86Config</filename> or <filename>xorg.conf</filename> file.
For example:</para>
 
<screen> Section "InputDevice"
Identifier "Keyboard0"
Driver "Keyboard"
Option "XkbModel" "pc105"
Option "XkbLayout" "en_US,ru"
Option "XkbOptions" "grp:switch,grp:alt_shift_toggle,grp_led:scroll"
EndSection</screen>
 
<para>In this example, you can use the Alt-Shift combination to switch
between keyboard layouts and use the Scroll Lock <acronym>LED</acronym> to
indicate when the second layout is active.</para>
</sect2>
 
<!-- ================================================== -->
<sect2>
<title>Setting up fonts</title>
 
<para>Users using character sets other than <acronym>ISO</acronym>-8859-1 have
to make a few adjustments to their font settings in order to make sure that
fonts with the correct encoding are used for "fixed", "variable", "10x20" and
similar aliases:</para>
<para>For Cyrillic alphabet, it is sufficient to put the following line
into the top of the "Files" section in <filename>XF86Config</filename>
or <filename>xorg.conf</filename> because this directory already contains
the needed bitmap fonts and their aliases:</para>
 
<screen>FontPath "/usr/X11R6/lib/X11/fonts/cyrillic/"</screen>
 
<para>For ISO-8859-<replaceable>[X]</replaceable> based locales, use the
following command instead:</para>
 
<screen><userinput><command>sed -i 's,iso8859-1\( \|$\),iso8859-<replaceable>[X]</replaceable>\1,g' \
/usr/X11R6/lib/X11/fonts/{75dpi,100dpi,misc}/fonts.alias</command></userinput></screen>
 
</sect2>
 
<!-- ================================================== -->
<sect2 id='xdm'>
<title>Setting up XDM</title>
<para><command>xdm</command> provides a graphical logon capability and is
normally set up in <filename>/etc/inittab</filename>. Most of the information
you need to customize <command>xdm</command> is found in its man page. To
execute <command>xdm</command> during bootup, change the initdefault level to 5
and add the following lines to <filename>/etc/inittab</filename>:</para>
 
<indexterm zone="x-setup xdm">
<primary sortas="b-xdm">xdm</primary>
</indexterm>
 
<para><screen><userinput># Run xdm as a separate service
x:5:respawn:/usr/X11R6/bin/xdm -nodaemon</userinput></screen></para>
 
<para>If Linux-PAM is installed on your system, you should
create a PAM entry for xdm by duplicating the login entry
using the following command:</para>
 
<para><screen><userinput>cp /etc/pam.d/login /etc/pam.d/xdm</userinput></screen></para>
<indexterm zone="x-setup xdm">
<primary sortas="e-etc-pam.d/xdm">/etc/pam.d/xdm</primary>
</indexterm>
 
</sect2>
 
<!-- ================================================== -->
<sect2 id='x-resources'>
<title>Using <application>X</application> Resources</title>
<para>There are many options that can be set in
<application>X</application> and <application>X</application> clients via
resources. Typically resources are set in the
<filename>~/.Xresources</filename> file.</para>
 
<para>The layout of the <filename>~/.Xresources</filename> file consists
of a list of specifications in the form of</para>
 
<indexterm zone="x-setup x-resources">
<primary sortas="e-AA.xresources">~/.Xresources</primary>
</indexterm>
 
<screen>object.subobject[.subobject...].attribute: value</screen>
 
<para>Components of a resource specification are linked together
by either <emphasis>tight</emphasis>, represented by a dot (.),
or <emphasis>loose</emphasis>, represented by an asterisk (*), bindings.
A tight binding indicates that the components on either side of the dot must
be directly next to each other as defined in a specific implementation. An
asterisk is a wildcard character that means that any number of levels in
a defined hierarchy can be between the components.
For example, X offers two special cursors: redglass and whiteglass. To
use one of these resources, you need to add the following line:</para>
 
<screen>Xcursor.theme: whiteglass</screen>
 
<para>However, you can specify the background for all clients with:</para>
 
<screen>*background: blue</screen>
 
<para>More specific resource variables will override less specific names.</para>
 
<para>Resource definitions can be found in the man pages for each
respective client.</para>
 
<para>In order to load your resources, the <command>xrdb</command> program
must be called with the appropriate parameters. Typically, the first time
resources are loaded, you use:</para>
 
<screen><userinput><command>xrdb -load &lt;filename&gt;</command></userinput></screen>
 
<para>To add resources to <application>X</application>'s database in memory,
use:</para>
 
<screen><userinput><command>xrdb -merge &lt;filename&gt;</command></userinput></screen>
 
<para>The <command>xrdb</command> instruction is usually placed in
<filename>~/.xinitrc</filename> or <filename>~/.xsession</filename>.
To get more information, see the xrdb man page.</para>
 
<indexterm zone="x-setup x-resources">
<primary sortas="b-xrdb">xrdb</primary>
</indexterm>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/x/installing/xfree86.xml
0,0 → 1,748
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY xfree86-download-http "http://gnu.kookel.org/ftp/XFree86/4.4.0/source/">
<!ENTITY xfree86-download-ftp "ftp://ftp.xfree86.org/pub/XFree86/4.4.0/source/">
<!ENTITY xfree86-md5sum "ftp://ftp.xfree86.org/pub/XFree86/4.4.0/source/SUMS.md5sum">
<!ENTITY xfree86-size "52 MB">
<!ENTITY xfree86-buildsize "775 MB">
<!ENTITY xfree86-time "11.6 SBU">
]>
 
<sect1 id="xfree86" xreflabel="XFree86-&xfree86-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
 
<?dbhtml filename="xfree86.html" ?>
<title>XFree86-&xfree86-version;</title>
 
<indexterm zone="xfree86">
<primary sortas="a-xfree86">XFree86</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application>XFree86</application></title>
 
<para><application>XFree86</application> is a freely redistributable
open-source implementation of the <application>X</application> Window System.
<application>XFree86</application> provides a client/server interface between
display hardware (the mouse, keyboard, and video displays) and the desktop
environment, while also providing both the windowing infrastructure and a
standardized application interface (<acronym>API</acronym>).</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&xfree86-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&xfree86-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sums: <ulink url="&xfree86-md5sum;"/></para></listitem>
<listitem><para>Download size: &xfree86-size;</para></listitem>
<listitem><para>Estimated disk space required: &xfree86-buildsize;</para></listitem>
<listitem><para>Estimated build time: &xfree86-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3>
<title>Additional downloads</title>
 
<itemizedlist spacing='compact'>
<listitem>
<para>Security patch: <ulink
url="http://www.x.org/pub/X11R6.8.0/patches/xorg-CAN-2004-0687-0688.patch"/></para>
</listitem>
</itemizedlist></sect3>
 
<sect3>
<title><application>XFree86</application> dependencies</title>
 
<sect4>
<title>Required</title>
<para><xref linkend="libpng"/></para>
</sect4>
 
<sect4>
<title>Optional</title>
<para><xref linkend="Linux_PAM"/>; the
following packages are included in the <application>XFree86</application>
package, however they are updated more often than the
<application>XFree86</application> package and are highly recommended:
<xref linkend="expat"/>, <xref linkend="freetype2"/>,
<xref linkend="fontconfig"/>.
</para>
 
<note><para>If you choose not to install <application>expat</application>,
<application>FreeType2</application>, and <application>Fontconfig</application>,
the <filename>host.def</filename> file below will have to be modified to
instruct <application>XFree86</application> to build them.</para>
</note>
</sect4>
 
</sect3>
 
<sect3>
<title>Download Instructions</title>
 
<para>There are several files that need to be fetched from the download location:</para>
 
<itemizedlist spacing='compact'>
<listitem><para><filename>XFree86-4.4.0-src-1.tgz</filename></para></listitem>
<listitem><para><filename>XFree86-4.4.0-src-2.tgz</filename></para></listitem>
<listitem><para><filename>XFree86-4.4.0-src-3.tgz</filename></para></listitem>
<listitem><para><filename>XFree86-4.4.0-src-4.tgz</filename></para></listitem>
<listitem><para><filename>XFree86-4.4.0-src-5.tgz</filename></para></listitem>
<listitem><para><filename>XFree86-4.4.0-src-6.tgz</filename></para></listitem>
<listitem><para><filename>XFree86-4.4.0-src-7.tgz</filename></para></listitem>
</itemizedlist>
 
<para>The first three packages are the <application>XFree86</application>
programs, the fourth and fifth are fonts, the sixth is normal documentation,
and the seventh is hardcopy documentation. There are also two packages
<filename>doctools-1.3.1.tgz</filename>, which contain programs to regenerate
hardcopy documentation, and <filename>utils-1.1.0.tgz</filename>, which contain
<application><acronym>GNU</acronym> <acronym>TAR</acronym></application>
and <application>zlib</application> which are already installed on an
<acronym>LFS</acronym> system.
</para>
 
<para>To check your downloads for integrity, download the
<filename>SUMS.md5sum</filename> file. Then:
</para>
 
<screen><userinput><command>md5sum -c SUMS.md5sum</command></userinput></screen>
 
<para>The only errors you should see are for <filename>README</filename>,
<filename>doctools-1.3.1.tgz</filename>, <filename>utils-1.1.0.tgz</filename>
and <filename>XFree86-xtest-4.0.x.tar.bz2</filename> files if you did not
download them.
</para>
 
<!--
<para>The fixes subdirectory also has a <filename>SUMS.md5sum</filename>. Note that
this is the same filename as the sums for the main sources, so you need to rename the
file if you download it. Otherwise, you can just look at it and use it to
check against the patch files:</para>
<screen><userinput><command>md5sum 4.3.0-4.3.0.1.diff.gz</command></userinput>
<userinput><command>md5sum fontfile.diff</command></userinput></screen>
 
<para>After unpacking the <filename>X430src-?.tgz</filename> files and uncompressing the
diff file, change to the <filename class="directory">xc</filename> directory and run:</para>
 
<screen><userinput><command>patch -Np1 -i ../4.3.0-4.3.0.1.diff</command></userinput>
<userinput><command>pushd lib/font/fontfile/</command></userinput>
<userinput><command>patch -N -i ../../../../fontfile.diff</command></userinput>
<userinput><command>popd</command></userinput></screen>
-->
 
</sect3>
</sect2>
 
<sect2>
<title>Installation of <application>XFree86</application></title>
 
<sect3 id='xfree86-kernel'>
<title>Kernel Compilation Settings</title>
 
<para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is
recommended that you compile <acronym>MTRR</acronym> (Memory Type Range
Registers) support into the kernel. The kernel can map Cyrix and AMD
<acronym>CPU</acronym>s to the <acronym>MTRR</acronym> interface, so selecting
this option is useful for those processors also. This option is found in the
"Processor type and features" menu. It can increase performance of image write
operations 2.5 times or more on <acronym>PCI</acronym> or
<acronym>AGP</acronym> video cards.
</para>
 
<indexterm zone="xfree86 xfree86-kernel">
<primary sortas="d-xfree86">XFree86</primary>
</indexterm>
 
<para>In the "Character Devices" section, enable <acronym>AGP</acronym> Support
and select the chipset support on your motherboard. If you do not know the
chipset, you may select all the chip types at the expense of extra kernel size.
You can usually determine your motherboard's chipset by running the command
<command>lspci</command>, a program from the <xref linkend="pciutils"/> package.
</para>
 
<para>In the "Character Devices" section, <emphasis>disable</emphasis> Direct
Rendering Manager unless you have a Direct Rendering Infrastructure
(<acronym>DRI</acronym>) supported video card. A complete list of
<acronym>DRI</acronym> supported video cards can be found at
<ulink url="http://dri.sourceforge.net" /> in the Status section. Currently,
supported cards include those from 3dfx (Voodoo, Banshee), 3Dlabs,
ATI (Rage Pro, Rage 128, Radeon 7X00, Radeon 2), Intel (i810, i815), and
Matrox (G200, G400, G450).
</para>
 
<para>Additionally NVidia provides their own closed source binary drivers,
which do not make use of <acronym>DRI</acronym>. If you intend to use these
drivers, do not enable <acronym>DRI</acronym>.
</para>
 
<para>If you made any changes to the kernel configuration, recompile and
install the new kernel.
</para>
 
<note><para>If you build <application>XFree86</application> in a
<command>chroot</command> environment, make sure the kernel version of the base
system and the target system are the same.
</para></note>
 
</sect3>
 
<sect3>
<title>Creating <filename>host.def</filename></title>
 
<para>Although <application>XFree86</application> will compile without a
<filename>host.def</filename> file, the following file is recommended for
customizing the installation. Start from the
<filename class="directory">xc</filename> directory.
</para>
 
<note><para>The <filename>host.def</filename> file is a
<application>C</application> file, not the usual configuration file. If you
make any changes, be sure the comment characters (<userinput>/*</userinput>
and <userinput>*/</userinput>) are balanced. Most of the entries in the file
below are commented out with the default settings shown.
</para></note>
 
<screen><userinput><command>cat &gt; config/cf/host.def &lt;&lt; "EOF"</command>
/* Begin XFree86 host.def file */
 
/* System Related Information. If you read and configure only one
* section then it should be this one. The Intel architecture defaults
* are set for a i686 and higher. Axp is for the Alpha architecture
* and Ppc is for the Power PC. Note that there have been reports that
* the Ppc optimization line causes segmentation faults during build.
* If that happens, try building without the DefaultGcc2PpcOpt line. */
 
/* #define DefaultGcc2i386Opt -O2 -fomit-frame-pointer -march=i686 */
/* #define DefaultGcc2AxpOpt -O2 -mcpu=ev6 */
/* #define DefaultGcc2PpcOpt -O2 -mcpu=750 */
 
/* The following definitions are normally set properly by XFree86's
* scripts. You can uncomment them if you want to make sure. *********/
/* #define HasMTRRSupport YES */ /* Enabled in kernel; */
/* see kernel docs */
/* #define HasMMXSupport NO */ /* Any i586 or above */
/* #define HasKatmaiSupport NO */ /* PIII SSE instructions */
/* #define Has3DNowSupport NO */ /* AMD instructions */
 
 
/* This setting reduces compile time a little by omitting rarely used
* input devices. You can find the complete list in
* config/cf/xfree86.cf *********************************************/
#define XInputDrivers mouse void
 
/* VIDEO DRIVERS ****************************************************/
 
/* If you are sure you only want the drivers for one or a few video
* cards, you can delete the drivers you do not want. ***************/
 
 
#define XF86CardDrivers mga glint nv tga s3 s3virge sis rendition \
neomagic i740 tdfx savage \
cirrus vmware tseng trident chips apm \
GlideDriver fbdev i128 nsc \
ati i810 AgpGartDrivers DevelDrivers ark \
cyrix siliconmotion \
vesa vga \
dummy XF86OSCardDrivers XF86ExtraCardDrivers
 
 
/* USER AND SYSTEM DEFAULT PATHS *************************************/
 
/* These settings set the PATH variables used by xdm. See README for */
/* detailed description and modify the following as per your need. ***/
 
/* #define DefaultSystemPath \
/usr/bin:/bin:/usr/sbin:/sbin:/usr/X11R6/bin */
/* #define DefaultUserPath /usr/bin:/bin:/usr/X11R6/bin */
 
/* FONT SERVER AND LIBRARY SETTINGS **********************************/
 
/* These settings are the defaults **********************************/
 
/* #define BuildFontServer YES */ /*For Ghostscript Print Server*/
/* #define SharedLibFont YES */
/* #define CompressAllFonts YES */
/* #define GzipFontCompression YES */
 
/* These settings ensure we use our libraries ************************/
#define HasFreetype2 YES
#define HasFontconfig YES
#define HasExpat YES
#define HasLibpng YES
#define HasZlib YES
 
/* The font path can be redefined in the XF86Config file *************/
 
/*
#define DefaultFontPath $(FONTDIR)/misc/,$(FONTDIR)/75dpi/,\
$(FONTDIR)/100dpi/,$(FONTDIR)/Type1,$(FONTDIR)/local,\
$(FONTDIR)/TrueType,$(FONTDIR)/CID,$(FONTDIR)/Speedo
*/
 
 
/* INTERNATIONAL FONTS. Change to YES if you need any of them. These
* are the defaults. **************************************************/
 
/* #define BuildCyrillicFonts NO */
/* #define BuildArabicFonts NO */
/* #define BuildISO8859_6Fonts NO */
/* #define BuildGreekFonts NO */
/* #define BuildISO8859_7Fonts NO */
/* #define BuildHebrewFonts NO */
/* #define BuildISO8859_8Fonts NO */
/* #define BuildKOI8_RFonts NO */
/* #define BuildJapaneseFonts NO */
/* #define BuildJISX0201Fonts NO */
/* #define BuildKoreanFonts NO */
/* #define BuildChineseFonts NO */
 
/* DOCUMENTATION SETTINGS ********************************************/
 
/* These setting are the defaults. ***********************************/
 
/* #define BuildLinuxDocHtml NO */ /* X Docs in Html format */
/* #define BuildLinuxDocPS NO */ /* PostScript format */
/* #define BuildAllSpecsDocs NO */ /* Various docs */
/* #define BuildHtmlManPages NO */
 
/* GENERAL SETTINGS: You generally want to leave these alone when
* building X on an LFS system ***************************************/
 
#define GccWarningOptions -pipe /* Speed up compiles */
#define TermcapLibrary -lncurses
#define XprtServer YES /* Needed by realplayer */
#define XnestServer YES
#define XAppLoadDir EtcX11Directory/app-defaults
#define VarLibDir /var/lib
#define XFree86Devel NO
#define FSUseSyslog YES
#define ThreadedX YES
#define HasPam NO
#define SystemManDirectory /usr/share/man /*Instead of /usr/man*/
#define HasLibCrypt YES
#define InstallXinitConfig YES
#define InstallXdmConfig YES
#define ForceNormalLib YES
#define BuildSpecsDocs NO
 
/* End XFree86 host.def file */
<command>EOF</command></userinput></screen>
 
<para>Edit the file for your hardware and desires.</para>
 
</sect3>
 
<sect3>
<title>Build Commands</title>
 
<para>Some vulnerabilities were reported in <filename
class="libraryfile">libXpm</filename>. A remote user may be able to
execute arbitrary code on applications that use <filename
class="libraryfile">libXpm</filename>. The <application>Xorg</application>
team released a patch for their version 6.8.0 but it works for
<application>XFree86</application> as well. Apply the patch:
</para>
 
<screen><userinput><command>patch -Np1 -i ../xorg-CAN-2004-0687-0688.patch</command></userinput></screen>
 
<para>Install <application>XFree86</application> by running the following commands:</para>
 
<screen><userinput><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@/* &amp; */@" \
`grep -lr linux/config.h *` &amp;&amp;
( make WORLDOPTS="" World 2&gt;&amp;1 | \
tee xfree-compile.log &amp;&amp; exit $PIPESTATUS )</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install &amp;&amp;
make install.man &amp;&amp;
ln -sf ../X11R6/bin /usr/bin/X11 &amp;&amp;
ln -sf ../X11R6/lib/X11 /usr/lib/X11 &amp;&amp;
ln -sf ../X11R6/include/X11 /usr/include/X11</command></userinput></screen>
 
</sect3>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@...</command>: The
<application>Linux-Libc-Headers</application> package installed in
<acronym>LFS</acronym> installs a
<filename>/usr/include/linux/config.h</filename> file which is not compatible
with userspace applications. The recommended fix for applications including
this file is to remove it (see <ulink
url="http://ep09.pld-linux.org/~mmazur/linux-libc-headers/doc/FAQ">
linux-libc-headers FAQ</ulink>). The <command>sed</command> uses
<command>grep -lr</command> to replace all occurences. If you desire, just
remove (comment) the line in the appropriate video driver file if you
customized <filename>host.def</filename>.
</para>
 
<para><command>( make WORLDOPTS="" World 2&gt;&amp;1 | tee xfree-compile.log
&amp;&amp; exit $PIPESTATUS )</command>:
This command runs multiple <filename>Makefile</filename>s to completely rebuild
the system. <envar>WORLDOPTS</envar>="" disables the default setting to
continue after encountering an error. <parameter>2&gt;&amp;1</parameter>
redirects error messages to the same location as standard output. The
<command>tee</command> command allows viewing of the output while logging the
results to a file. The parentheses around the command runs the entire comand in
a subshell and finally the <command>exit $PIPESTATUS</command> ensures the
result of the <command>make</command> is returned as the result and not the
result of the <command>tee</command> command.</para>
 
<note><para>When rebuilding <application>XFree86</application>, a separate
command that may be used if only minor changes are made to the sources is
<command>make Everything</command>. This does not automatically remove
generated files and only rebuilds those files or programs that are out
of date.</para></note>
 
<para><screen><command>ln -sf ../X11R6/bin /usr/bin/X11
ln -sf ../X11R6/lib/X11 /usr/lib/X11
ln -sf ../X11R6/include/X11 /usr/include/X11</command></screen>
These commands are present to enable other (broken) packages to build
against <application>XFree86</application>, even though the Filesystem
Hierarchy Standard says: "In general, software must not be installed or
managed via the above symbolic links. They are intended for utilization by
users only."</para>
 
</sect2>
 
<sect2 id='xfree86-config'>
<title>Configuring <application>XFree86</application></title>
 
<para>Edit <filename>/etc/ld.so.conf</filename> and add
<filename class="directory">/usr/X11R6/lib</filename>.
Run: </para>
<screen><userinput><command>ldconfig</command></userinput></screen>
 
<indexterm zone="xfree86 xfree86-config">
<primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
</indexterm>
 
<para>Ensure <filename class="directory">/usr/X11R6/bin</filename>
and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>
are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
environment variables, respectively. Instructions for doing this are
described in the section "<xref linkend='postlfs-config-profile'/>."</para>
 
<indexterm zone="xfree86 xfree86-config">
<primary sortas="e-etc-X11-XF86Config">/etc/X11/XF86Config</primary>
</indexterm>
 
<para>Create the <filename>XF86Config</filename> file with:
<screen><userinput><command>cd ~
XFree86 -configure</command></userinput></screen>
The screen will go black and you may hear some clicking of the monitor. This
command will create a file, <filename>XF86Config.new</filename> in your home
directory.</para>
 
<para>Edit <filename>XF86Config.new</filename> to suit your system. The
details of the file are located in the man page
<command>man XF86Config</command>. Some things you may want to do are:</para>
 
<itemizedlist>
 
<listitem><para>Section "Files". Change the order of the font paths searched.
You may want to put 100dpi fonts ahead of 75dpi fonts if your system normally
comes up closer to 100 dots per inch. You may want to remove some font
directories completely.</para></listitem>
 
<listitem><para>Section "Module". If you are going to install NVidia
drivers, remove the "dri" line.</para></listitem>
<listitem><para>Sections "InputDevice". Specify the
<parameter>Device</parameter> parameter to "/dev/input/mice" and
<parameter>Protocol</parameter> to "auto" to set up your mouse. You may
also want to change the keyboard autorepeat rate by adding
<parameter>Option "Autorepeat" "250 30"</parameter>.</para></listitem>
 
<listitem><para>Section "Monitor". Specify the
<parameter>VertRefresh</parameter> and <parameter>HorizSync</parameter> values
if the system does not automatically detect the monitor and its values.</para>
</listitem>
 
<listitem><para>Section "Device". You may want to set some of the options
available for your selected video driver. A description of the driver
parameters is in the man page for your driver.</para></listitem>
 
<listitem><para>Section "Screen". Add a DefaultDepth statement such
as: <parameter>DefaultDepth 16</parameter>. In the SubSection for your
default depth, add a modes line such as:
<parameter> Modes "1280x1024" "1024x768"</parameter>. The first mode listed
will normally be the starting resolution.</para></listitem>
 
</itemizedlist>
 
<para>Test the system with:
<screen><userinput><command>XFree86 -xf86config ~/XF86Config.new</command></userinput></screen>
You will only get a gray background with an X-shaped mouse cursor, but it
confirms the system is working. Exit with Control-Alt-Backspace. If the
system does not work, examine <filename>/var/log/XFree86.0.log</filename> to
see what went wrong.</para>
 
<para>Move the configuration file to its final location:</para>
<screen><userinput><command>mv ~/XF86Config.new /etc/X11/XF86Config</command></userinput></screen>
 
<para>Create <filename>.xinitrc</filename>:
<screen><userinput><command>cat &gt; ~/.xinitrc &lt;&lt; "EOF"</command>
# Begin .xinitrc file
xterm -g 80x40+0+0 &amp;
xclock -g 100x100-0+0 &amp;
twm
<command>EOF</command></userinput></screen>
This provides an initial screen with an xterm and a clock that is managed by a
simple window manager, Tab Window Manager. For details of
<command>twm</command>, see the man page.</para>
 
<indexterm zone="xfree86 xfree86-config">
<primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
</indexterm>
 
 
<note>
 
<para>When needed, <application>XFree86</application> creates the directory
<filename>/tmp/.ICE-unix</filename> if it does not exist. If this directory is
not owned by root, <application>XFree86</application> delays startup by a few
seconds and also appends a warning to the logfile. This also affects startup of
other applications. To improve performance, it is advisable to manually create
the directory before <application>XFree86</application> uses it. Add the file
creation to <filename>/etc/sysconfig/createfiles</filename> that is sourced by
the <filename>/etc/rc.d/init.d/cleanfs</filename> startup script.</para>
 
<screen><userinput><command>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"</command>
/tmp/.ICE-unix dir 1777 root root
<command>EOF</command></userinput></screen>
</note>
 
<indexterm zone="xfree86 xfree86-config">
<primary sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
</indexterm>
 
<para>Start <application>X</application> with:
<screen><userinput><command>startx</command></userinput></screen>
to get a basic functional <application>X</application> Window System.</para>
 
<para>At this point, you should check out <xref linkend='x-setup'/>.</para>
 
</sect2>
 
<sect2 id="xfree86-contents" xreflabel="XFree86 Contents and Descriptions">
<title>Contents</title>
 
<para>The <application>XFree86</application> package contains the
<application>X</application> Window System for Linux (and other operating
systems). It includes the <application>X</application> server, fonts,
<command>xterm</command>, a simple window manager (<command>twm</command>),
various utilities, video output drivers, and various input drivers including
the mouse and keyboard.</para>
 
<para><application>XFree86</application> also contains libraries and header
files for development of the <application>X</application> Window System
programs.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<note><para>The following lists are not comprehensive. The
full list of programs is in <filename class="directory">/usr/X11R6/bin</filename>. For
additional information about these programs, see the respective man
page.</para></note>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>XFree86, xf86config, xf86cfg, startx, xinit, twm, xterm, xwininfo,
x11perf, xlsfonts, xvidtune, xload, xcalc, xclock, oclock, xmodmap</seg>
<seg>libGL.so, libGLU.so, libSM.so, libXi.so, libXrender.so, libXt.so, libXfont.so</seg>
<seg>/usr/X11R6/, /etc/X11/</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="XFree86">
<term><command>XFree86</command></term>
<listitem>
<para>is the X11R6 implementation of the <application>X</application> Window System server.</para>
<indexterm zone="xfree86 XFree86">
<primary sortas="b-XFree86">XFree86</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xf86config">
<term><command>xf86config</command></term>
<listitem>
<para>is an interactive program for generating an <filename>XF86Config</filename> file for use with
<application>XFree86</application> <application>X</application> servers.</para>
<indexterm zone="xfree86 xf86config">
<primary sortas="b-xf86config">xf86config</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xf86cfg">
<term><command>xf86cfg</command></term>
<listitem>
<para> is a tool to configure <application>XFree86</application> that can be used to either write the
initial configuration file or make customizations to the current configuration.</para>
<indexterm zone="xfree86 xf86cfg">
<primary sortas="b-xf86cfg">xf86cfg</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="startx">
<term><command>startx</command></term>
<listitem>
<para>is a script to initialize the <application>X</application> session. It
runs <command>xinit</command>.</para>
<indexterm zone="xfree86 startx">
<primary sortas="b-startx">startx</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xinit">
<term><command>xinit</command></term>
<listitem>
<para>is used to start the <application>X</application> Window System server.</para>
<indexterm zone="xfree86 xinit">
<primary sortas="b-xinit">xinit</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="twm">
<term><command>twm</command></term>
<listitem>
<para> (Tab Window Manager) is a window manager included with the
<application>X</application> Window System.</para>
<indexterm zone="xfree86 twm">
<primary sortas="b-twm">twm</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xterm">
<term><command>xterm</command></term>
<listitem>
<para>is a terminal emulator for <application>X</application>.</para>
<indexterm zone="xfree86 xterm">
<primary sortas="b-xterm">xterm</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xwininfo">
<term><command>xwininfo</command></term>
<listitem>
<para> is a window information utility for <application>X</application>.</para>
<indexterm zone="xfree86 xwininfo">
<primary sortas="b-xwininfo">xwininfo</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="x11perf">
<term><command>x11perf</command></term>
<listitem>
<para>is an <application>X</application>11 server performance test program.</para>
<indexterm zone="xfree86 x11perf">
<primary sortas="b-x11perf">x11perf</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xlsfonts">
<term><command>xlsfonts</command></term>
<listitem>
<para>is a program to list fonts available to the <application>X</application> server.</para>
<indexterm zone="xfree86 xlsfonts">
<primary sortas="b-xlsfonts">xlsfonts</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xvidtune">
<term><command>xvidtune</command></term>
<listitem>
<para>is a video mode tuner for <application>XFree86</application>.</para>
<indexterm zone="xfree86 xvidtune">
<primary sortas="b-xvidtune">xvidtune</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xload">
<term><command>xload</command></term>
<listitem>
<para> is a system load average display for <application>X</application>.</para>
<indexterm zone="xfree86 xload">
<primary sortas="b-xload">xload</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xcalc">
<term><command>xcalc</command></term>
<listitem>
<para>is a scientific calculator for <application>X</application>.</para>
<indexterm zone="xfree86 xcalc">
<primary sortas="b-xcalc">xcalc</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xclock">
<term><command>xclock</command></term>
<listitem>
<para>is a clock programs for <application>X</application>.</para>
<indexterm zone="xfree86 xclock">
<primary sortas="b-xclock">xclock</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="oclock">
<term><command>oclock</command></term>
<listitem>
<para>is a clock programs for <application>X</application>.</para>
<indexterm zone="xfree86 oclock">
<primary sortas="b-oclock">oclock</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xmodmap">
<term><command>xmodmap</command></term>
<listitem>
<para>is a utility for modifying keymaps and pointer button mappings in
<application>X</application>.</para>
<indexterm zone="xfree86 xmodmap">
<primary sortas="b-xmodmap">xmodmap</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
</sect2>
</sect1>
/tags/tBLFS-6_0/blfs/x/installing/xorg.xml
0,0 → 1,486
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY xorg-download-http " ">
<!ENTITY xorg-download-ftp "ftp://ftp.opengroup.org/pub/x.org/pub/X11R&xorg-version;/src-single/X11R&xorg-version;-src.tar.bz2">
<!ENTITY xorg-md5sum "8131cd7ea1e4566e6e05c438a93fcfe1">
<!ENTITY xorg-size "43 MB">
<!ENTITY xorg-buildsize "655 MB">
<!ENTITY xorg-time "17.8 SBU">
]>
 
<sect1 id="xorg" xreflabel="X.org-&xorg-version;">
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
 
<?dbhtml filename="xorg.html"?>
<title>Xorg-&xorg-version;</title>
 
<indexterm zone="xorg">
<primary sortas="a-xorg">Xorg</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application>Xorg</application></title>
 
<note><para>There are two packages in <acronym>BLFS</acronym> that implement
the <application>X</application> Window System: <application>Xorg</application>
and <application>XFree86</application>. These packages are quite similar. In
fact, the base system of <application>Xorg</application> is
<application>XFree86</application>-4.4.0RC2. The primary difference as of this
writing is the license provisions of the packages. For someone building a
package for their own use, these issues are not significant. Most large
commercial distributions have decided to use the
<application>Xorg</application> package, but several still use
<application>XFree86</application>.</para>
 
<para>A second reason for the forking of <application>X</application> packages
is the stated goals of the developers. Some developers were unhappy with the
administration and progress of <application>XFree86</application>. X.org's
future plans include significant improvements to the internals of the system
and more frequent releases.</para>
 
<para><application>XFree86</application> continues to be a solid, conservative
application with excellent driver support.</para>
 
<para>Both <application>Xorg</application> and
<application>XFree86</application> can be installed in the same way, but this
section will provide a slightly different and more current variation for
installation.</para>
</note>
 
<para><application>Xorg</application> is a freely redistributable open-source
implementation of the <application>X</application> Window System. This
application provides a client/server interface between display hardware (the
mouse, keyboard, and video displays) and the desktop environment, while also
providing both the windowing infrastructure and a standardized application
interface (<acronym>API</acronym>).</para>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&xorg-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&xorg-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &xorg-md5sum;</para></listitem>
<listitem><para>Download size: &xorg-size;</para></listitem>
<listitem><para>Estimated disk space required: &xorg-buildsize;</para></listitem>
<listitem><para>Estimated build time: &xorg-time;</para></listitem>
</itemizedlist>
</sect3>
<sect3>
<title><application>Xorg</application> Dependencies</title>
<sect4>
<title>Required</title>
<para><xref linkend="libpng"/> and
<xref linkend="fontconfig"/></para>
</sect4>
 
<sect4>
<title>Optional</title>
<para><xref linkend="Linux_PAM"/></para>
</sect4>
 
</sect3>
<sect3><title>Download Instructions</title>
<para>As an alternative to downloading the entire source tree in a single
file, there are several files that need to be fetched from the download
location (directory /pub/x.org/pub/X11R&xorg-version;/src/):</para>
 
<itemizedlist spacing='compact'>
<listitem><para><filename>X11R&xorg-version;-src1.tar.gz</filename></para></listitem>
<listitem><para><filename>X11R&xorg-version;-src2.tar.gz</filename></para></listitem>
<listitem><para><filename>X11R&xorg-version;-src3.tar.gz</filename></para></listitem>
<listitem><para><filename>X11R&xorg-version;-src4.tar.gz</filename></para></listitem>
<listitem><para><filename>X11R&xorg-version;-src5.tar.gz</filename></para></listitem>
<listitem><para><filename>X11R&xorg-version;-src6.tar.gz</filename></para></listitem>
<listitem><para><filename>X11R&xorg-version;-src7.tar.gz</filename></para></listitem>
</itemizedlist>
 
<para>The first package contains the <application>Xorg</application> libraries
and support programs, the second contains standard <application>X</application>
programs, the third contains the <application>X</application> server, the
fourth and fifth are fonts, the sixth is normal documentation, and the seventh
is hardcopy documentation.</para>
<para>To check your file for integrity, download the
<filename>md5sums</filename> file. Then:</para>
<screen><userinput><command>md5sum -c md5sums</command></userinput></screen>
<para>The package (or all seven packages) should give an OK status.</para>
</sect3>
</sect2>
 
<sect2>
<title>Installation of <application>Xorg</application></title>
 
<sect3 id='xorg-kernel'>
<title>Kernel Compilation Settings</title>
 
<indexterm zone="xorg xorg-kernel">
<primary sortas="d-Xorg">Xorg</primary></indexterm>
 
<para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is
recommended that you compile <acronym>MTRR</acronym> (Memory Type Range
Registers) support into the kernel. The kernel can map Cyrix and AMD
<acronym>CPU</acronym>s to the <acronym>MTRR</acronym> interface, so selecting
this option is useful for those processors also. This option is found in the
"Processor type and features" menu. It can increase performance of
image write operations 2.5 times or more on <acronym>PCI</acronym> or
<acronym>AGP</acronym> video cards.
</para>
<para>In the "Character Devices" section, enable <acronym>AGP</acronym> Support
and select the chipset support on your motherboard. If you do not know the
chipset, you may select all the chip types at the expense of extra kernel size.
You can usually determine your motherboard's chipset by running the command
<command>lspci</command>, a program from the <xref linkend="pciutils"/>
package.
</para>
<para>In the "Character Devices" section, <emphasis>disable</emphasis> Direct
Rendering Manager unless you have a Direct Rendering Infrastructure
(<acronym>DRI</acronym>) supported video card. A complete list of
<acronym>DRI</acronym> supported video cards can be found at
<ulink url="http://dri.sourceforge.net" /> in the "Status" section.
Currently, supported cards include those from 3dfx (Voodoo, Banshee), 3Dlabs,
ATI (Rage Pro, Rage 128, Radeon 7X00, Radeon 2), Intel (i810, i815), and
Matrox (G200, G400, G450).
</para>
<para>Additionally NVidia provides their own closed source binary drivers,
which do not make use of <acronym>DRI</acronym>. If you intend to use these
drivers, do not enable <acronym>DRI</acronym>.
</para>
<para>If you made any changes to the kernel configuration, recompile and
install the new kernel.
</para>
<note><para>If you build <application>Xorg</application> in a
<command>chroot</command> environment, make sure the kernel version of the base
system and the target system are the same.</para>
</note>
</sect3>
 
<sect3>
<title>Suppressing Xprint-related modification to <filename class="directory">/etc</filename></title>
 
<para><application>Xorg</application> insists on putting
its boot and profile scripts into the <filename
class="directory">/etc</filename> directory even if specifically told
not to compile anything Xprint server or client related (see
<filename>host.def</filename> below). The following command will
suppress any such modifications:
</para>
 
<screen><userinput><command>sed -i '/^SUBDIRS =/s/ etc$//' programs/Xserver/Xprint/Imakefile</command></userinput></screen>
 
</sect3>
 
<sect3>
<title>Setting Up a Shadow Directory</title>
 
<para>When building <application>Xorg</application>, you should create a shadow
directory of symbolic links for the compiled code. To do that, first make
<command>lndir</command>. Starting from the
<filename class='directory'>xc</filename> directory:
</para>
 
<screen><userinput><command>pushd config/util &amp;&amp;
make -f Makefile.ini lndir</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>cp lndir /usr/bin/</command></userinput></screen>
 
<para>And back as a regular user:</para>
<screen><userinput><command>popd</command></userinput></screen>
 
<para>Now create the shadow tree:</para>
 
<screen><userinput><command>mkdir ../xcbuild &amp;&amp;
cd ../xcbuild &amp;&amp;
lndir ../xc</command></userinput></screen>
</sect3>
 
<sect3>
<title>Creating <filename>host.def</filename></title>
 
<para>The next step is to create the <filename>config/cf/host.def</filename>
file. The documentation for <application>Xorg</application> indicates that the
application will build without a <filename>host.def</filename> file, but
the included libraries for <application>Fontconfig</application> and
<application>FreeType2</application> do not build properly on a base
<acronym>LFS</acronym> system. Therefore, you must specify that these
libraries, as well as others, should be imported from the system.
</para>
 
<note><para><filename>config/cf/host.def</filename> is a C file, not a shell
script. Ensure the comments delimited by <userinput>/*</userinput> ...
<userinput>*/</userinput> are balanced when modifying the file.</para>
</note>
 
<screen><userinput><command>cat &gt; config/cf/host.def &lt;&lt; "EOF"</command>
/* Begin Xorg host.def file */
/* System Related Information. If you read and configure only one
* section then it should be this one. The Intel architecture defaults
* are set for a i686 and higher. Axp is for the Alpha architecture
* and Ppc is for the Power PC. AMD64 is for the Opteron processor.
* Note that there have been reports that the Ppc optimization line
* causes segmentation faults during build. If that happens, try
* building without the DefaultGcc2PpcOpt line. ***********/
/* #define DefaultGcc2i386Opt -O2 -fno-strength-reduce \
-fno-strict-aliasing -march=i686 */
/* #define DefaultGccAMD64Opt -O2 -fno-strength-reduce \
-fno-strict-aliasing */
/* #define DefaultGcc2AxpOpt -O2 -mcpu=ev6 */
/* #define DefaultGcc2PpcOpt -O2 -mcpu=750 */
 
#define HasFreetype2 YES
#define HasFontconfig YES
#define HasExpat YES
#define HasLibpng YES
#define HasZlib YES
 
/*
* Which drivers to build. When building a static server, each of
* these will be included in it. When building the loadable server
* each of these modules will be built.
*
#define XF86CardDrivers mga glint nv tga s3virge sis rendition \
neomagic i740 tdfx savage \
cirrus vmware tseng trident chips apm \
GlideDriver fbdev i128 \
ati AgpGartDrivers DevelDrivers ark \
cyrix siliconmotion vesa vga \
XF86OSCardDrivers XF86ExtraCardDrivers
*/
 
/*
* Select the XInput devices you want by uncommenting this.
*
#define XInputDrivers mouse keyboard acecad calcomp citron \
digitaledge dmc dynapro elographics \
microtouch mutouch penmount spaceorb \
summa wacom void magictouch aiptek
*/
 
/* Most installs will only need this */
 
#define XInputDrivers mouse keyboard
 
/* Disable building Xprint server and clients until we get them figured
* out but build Xprint libraries to allow precompiled binaries such as
* Acrobat Reader to run.
*/
 
#define XprtServer NO
#define BuildXprintClients NO
 
/* End Xorg host.def file */
<command>EOF</command></userinput></screen>
 
<para>There are several other options that you may want to consider. A well
documented example file is <filename>config/cf/xorgsite.def</filename>.
</para>
 
</sect3>
 
<sect3>
<title>Build Commands</title>
 
<para>Install <application>Xorg</application> by running the following commands:</para>
<screen><userinput><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@/* &amp; */@" \
`grep -lr linux/config.h *` &amp;&amp;
( make World 2&gt;&amp;1 | tee xorg-compile.log &amp;&amp; exit $PIPESTATUS )</command></userinput></screen>
 
<para>Again as the root user:</para>
<screen><userinput role='root'><command>make install &amp;&amp;
make install.man &amp;&amp;
ln -sf ../X11R6/bin /usr/bin/X11 &amp;&amp;
ln -sf ../X11R6/lib/X11 /usr/lib/X11 &amp;&amp;
ln -sf ../X11R6/include/X11 /usr/include/X11</command></userinput></screen>
</sect3>
</sect2>
 
<sect2>
<title>Command explanations</title>
<para><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@...</command>:
The <application>Linux-Libc-Headers</application> package installed in
<acronym>LFS</acronym> installs a
<filename>/usr/include/linux/config.h</filename> file which is not compatible
with userspace applications. The recommended fix for applications including
this file is to remove it (see <ulink
url="http://ep09.pld-linux.org/~mmazur/linux-libc-headers/doc/FAQ">
linux-libc-headers FAQ</ulink>). The <command>sed</command> uses
<command>grep -lr</command> to replace all occurences. If you desire, just
remove (comment) the line in the appropriate video driver file if you
customized <filename>host.def</filename>.
</para>
 
<para><command>( make World 2&gt;&amp;1 | tee xorg-compile.log
&amp;&amp; exit $PIPESTATUS )</command>:
This command runs multiple <filename>Makefile</filename>s to completely rebuild
the system. <parameter>2&gt;&amp;1</parameter> redirects error messages
to the same location as standard output. The <command>tee</command> command
allows viewing of the output while logging the results to a file. The
parentheses around the command runs the entire comand in a subshell and finally
the <command>exit $PIPESTATUS</command> ensures the result of the
<command>make</command> is returned as the result and not the result of the
<command>tee</command> command.
</para>
<note><para>When rebuilding <application>Xorg</application>, a separate command
that may be used if only minor changes are made to the sources is
<command>make Everything</command>. This does not automatically remove generated
files and only rebuilds those files or programs that are out of date.</para>
</note>
<para><screen><command>ln -sf ../X11R6/bin /usr/bin/X11
ln -sf ../X11R6/lib/X11 /usr/lib/X11
ln -sf ../X11R6/include/X11 /usr/include/X11</command></screen>
These commands are present to enable other (broken) packages to build against
<application>Xorg</application>, even though the Filesystem Hierarchy Standard
says: "In general, software must not be installed or managed via the above
symbolic links. They are intended for utilization by users only."</para>
</sect2>
 
<sect2 id='xorg-config'>
<title>Configuring Xorg</title>
 
<para>Edit <filename>/etc/ld.so.conf</filename> and add
<filename class="directory">/usr/X11R6/lib</filename>. Run:
</para>
 
<indexterm zone="xorg xorg-config">
<primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
</indexterm>
<screen><userinput><command>ldconfig</command></userinput></screen>
<para>Ensure <filename class="directory">/usr/X11R6/bin</filename>
and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>
are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
environment variables, respectively. Instructions for doing this are
described in the section "<xref linkend='postlfs-config-profile'/>."</para>
<para>Create the <filename>xorg.conf</filename> file with:
<screen><userinput><command>cd ~
Xorg -configure</command></userinput></screen>
The screen will go black and you may hear some clicking of the monitor. This
command will create a file, <filename>xorg.conf.new</filename> in your home
directory.</para>
 
<indexterm zone="xorg xorg-config">
<primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary>
</indexterm>
<para>Edit <filename>xorg.conf.new</filename> to suit your system. The details
of the file are located in the xorg.conf man page. Some
things you may want to do are:</para>
<itemizedlist>
 
<listitem><para>Section "Files". Change the order of the font paths searched.
You may want to put 100dpi fonts ahead of 75dpi fonts if your system normally
comes up closer to 100 dots per inch. You may want to remove some font
directories completely.</para></listitem>
 
<listitem><para>Section "Module". If you are going to install NVidia
drivers, remove the "dri" line.</para></listitem>
<listitem><para>Sections "InputDevice". Specify the
<parameter>Device</parameter> parameter to "/dev/input/mice" and
<parameter>Protocol</parameter> to "auto" to set up your mouse. You may
also want to change the keyboard autorepeat rate by adding
<parameter>Option "Autorepeat" "250 30"</parameter>.</para></listitem>
<listitem><para>Section "Monitor". Specify the
<parameter>VertRefresh</parameter> and <parameter>HorizSync</parameter> values
if the system does not automatically detect the monitor and its values.</para>
</listitem>
<listitem><para>Section "Device". You may want to set some of the options
available for your selected video driver. A description of the driver
parameters is in the man page for your driver.</para></listitem>
<listitem><para>Section "Screen". Add a DefaultDepth statement such as:
<parameter>DefaultDepth 16</parameter>. In the SubSection for your default
depth, add a modes line such as:
<parameter> Modes "1280x1024" "1024x768"</parameter>. The first mode listed
will normally be the starting resolution.</para></listitem>
</itemizedlist>
 
<para>Test the system with:
<screen><userinput><command>X -config ~/xorg.conf.new</command></userinput></screen>
You will only get a gray background with an X-shaped mouse cursor, but it
confirms the system is working. Exit with Control-Alt-Backspace. If the
system does not work, take a look at <filename>/var/log/Xorg.0.log</filename>
to see what went wrong.</para>
<para>Move the configuration file to its final location:</para>
<screen><userinput><command>mv ~/xorg.conf.new /etc/X11/xorg.conf</command></userinput></screen>
<para>Create <filename>.xinitrc</filename>:
<screen><userinput><command>cat &gt; ~/.xinitrc &lt;&lt; "EOF"</command>
# Begin .xinitrc file
xterm -g 80x40+0+0 &amp;
xclock -g 100x100-0+0 &amp;
twm
<command>EOF</command></userinput></screen>
This provides an initial screen with an xterm and a clock that is managed by a
simple window manager, Tab Window Manager. For details of
<command>twm</command>, see the man page.</para>
 
<indexterm zone="xorg xorg-config">
<primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
</indexterm>
<note>
<para>When needed, <application>Xorg</application> creates the directory
<filename>/tmp/.ICE-unix</filename> if it does not exist. If this directory is
not owned by root, <application>Xorg</application> delays startup by a few
seconds and also appends a warning to the logfile. This also affects startup of
other applications. To improve performance, it is advisable to manually create
the directory before <application>Xorg</application> uses it. Add the file
creation to <filename>/etc/sysconfig/createfiles</filename> that is sourced by
the <filename>/etc/rc.d/init.d/cleanfs</filename> startup script.</para>
<screen><userinput role='root'><command>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"</command>
/tmp/.ICE-unix dir 1777 root root
<command>EOF</command></userinput></screen>
</note>
 
<indexterm zone="xorg xorg-config">
<primary sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
</indexterm>
 
<para>Start <application>X</application> with:
<screen><userinput><command>startx</command></userinput></screen>
to get a basic functional <application>X</application> Window System.</para>
 
<para>At this point, you should check out <xref linkend='x-setup'/>.</para>
 
<para>For a list of the package contents and a description of the commands,
see the sections in the <xref linkend='xfree86-contents'/>.</para>
 
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/x/wm/wm.xml
0,0 → 1,57
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
 
<chapter id="x-wm">
<?dbhtml filename="wm.html" ?>
<title>Window Managers</title>
 
<sect1 id="Introduction">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<title>Introduction</title>
 
<para>Window Mangers and Desktop Environments are the primary user
interfaces into the <application>X</application> Window System. A window
manager is a program that controls the appearance of windows and provides the
means by which the user can interact with them. A Desktop Environment
provides a more complete interface to the operating system, and provides a
range of integrated utilities and applications.</para>
 
<para>There are many Window Mangers available. Some of the more well
known ones include <application>fvwm2</application>, <application>Window
Maker</application>, <application>AfterStep</application>,
<application>Enlightenment</application>,
<application>Sawfish</application>,
and <application>Blackbox</application>.</para>
 
<para>The Desktop Environments available for Linux are
<application><acronym>GNOME</acronym></application>,
<application><acronym>KDE</acronym></application>, and
<application>XFce</application>.</para>
 
<para>Choosing a Window Manager or Desktop Environment is highly subjective.
The choice depends on the look and feel of the packages, the resources
(<acronym>RAM</acronym>, disk space) required, and the utilities included.
One web site that provides a very good summary of what is available,
screenshots, and their respective features is
<ulink url="http://www.plig.org/xwinman/">Window Managers for X</ulink>.</para>
 
<para>In this chapter, the installation instructions of several Window
Managers and one lightweight Desktop Environment are presented. Later in the
book, both <application><acronym>KDE</acronym></application> and
<application><acronym>GNOME</acronym></application> have their own
sections.</para>
</sect1>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sawfish.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="fluxbox.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="metacity.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xfce.xml"/>
 
</chapter>
/tags/tBLFS-6_0/blfs/x/wm/sawfish.xml
0,0 → 1,158
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY sawfish-download-http "http://prdownloads.sourceforge.net/sawmill/sawfish-&sawfish-version;.tar.gz">
<!ENTITY sawfish-download-ftp " ">
<!ENTITY sawfish-md5sum "9e5ce5e76c60acecdb1889c1f173295a">
<!ENTITY sawfish-size "1.5 MB">
<!ENTITY sawfish-buildsize "17.5 MB">
<!ENTITY sawfish-time "0.26 SBU">
]>
 
<sect1 id="sawfish" xreflabel="sawfish-&sawfish-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="sawfish.html" ?>
<title>sawfish-&sawfish-version;</title>
<indexterm zone="sawfish"><primary
sortas="a-Sawfish">Sawfish</primary></indexterm>
 
<sect2>
<title>Introduction to <application>sawfish</application></title>
 
<para>The <application>sawfish</application> package contains a window manager.
This is useful for organizing and displaying windows where all window
decorations are configurable and all user-interface policy is controlled
through the extension language.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&sawfish-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&sawfish-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &sawfish-md5sum;</para></listitem>
<listitem><para>Download size: &sawfish-size;</para></listitem>
<listitem><para>Estimated disk space required:
&sawfish-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&sawfish-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>sawfish</application> dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="librep"/>,
<xref linkend="rep-gtk"/>,
<xref linkend="esound"/> and
<xref linkend="gtk2"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>sawfish</application></title>
 
<para>Install <application>sawfish</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --libexec=/usr/sbin --infodir=/usr/share/info \
--disable-themer &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><option>--with-audiofile</option>: This command directs
<application>sawfish</application> to use
<filename class="libraryfile">libaudiofile</filename>
for sound manipulation.</para>
 
<para><option>--with-esd</option>: This command directs <application>
sawfish</application> to use the Enlightened Sound Daemon.</para>
 
<para><option>--disable-themer</option>: This
option prevents building the <application>sawfish</application> themer.
This program was not migrated to <application>GTK-2</application>.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>sawfish</application></title>
 
<sect3 id="sawfish-config"><title>Configuration Information</title>
<indexterm zone="sawfish sawfish-config">
<primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
</indexterm>
<para>Be sure to backup your current <filename>.xinitrc</filename>
before proceeding.</para>
 
<screen><userinput><command>cat &gt;&gt; ~/.xinitrc &lt;&lt; "EOF"</command>
exec sawfish
<command>EOF</command></userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>sawfish, sawfish-client and sawfish-ui</seg>
<seg>None</seg>
<seg>/usr/share/sawfish, /usr/sbin/sawfish and /usr/lib/rep/*/</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="sawfish-prog">
<term><filename>sawfish</filename></term>
<listitem><para>is the extensible window manager using a
<application>Lisp</application>-based scripting language.</para>
<indexterm zone="sawfish sawfish-prog">
<primary sortas="b-sawfish">sawfish</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="sawfish-client">
<term><filename>sawfish-client</filename></term>
<listitem><para>allows you to connect to a window manager process and
evaluate arbitrary <application>Lisp</application> forms.</para>
<indexterm zone="sawfish sawfish-client">
<primary sortas="b-sawfish-client">sawfish-client</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="sawfish-ui">
<term><filename>sawfish-ui</filename></term>
<listitem><para>is the <application>sawfish</application> configurator.</para>
<indexterm zone="sawfish sawfish-ui">
<primary sortas="b-sawfish-ui">sawfish-ui</primary></indexterm>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/x/wm/xfce.xml
0,0 → 1,390
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY xfce-download-http "http://www.us.xfce.org/archive/xfce-&xfce-version;/fat_tarballs/xfce-&xfce-version;-src-bz2.tar.bz2">
<!ENTITY xfce-download-ftp " ">
<!ENTITY xfce-md5sum "8b213c0db2ac25b85a094e5959f5b2c1">
<!ENTITY xfce-size "15 MB">
<!ENTITY xfce-buildsize "215 MB">
<!ENTITY xfce-time "3.24 SBU">
]>
 
<sect1 id="xfce" xreflabel="XFce-&xfce-version;">
<sect1info>
<othername>$LastChangedBy: igor $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
 
<?dbhtml filename="xfce.html" ?>
<title>XFce-&xfce-version;</title>
 
<indexterm zone="xfce">
<primary sortas="a-xfce">XFce</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application>XFce</application></title>
 
<para>The <application>XFce</application> package contains a lightweight
desktop environment.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&xfce-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&xfce-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &xfce-md5sum;</para></listitem>
<listitem><para>Download size: &xfce-size;</para></listitem>
<listitem><para>Estimated disk space required: &xfce-buildsize;</para></listitem>
<listitem><para>Estimated build time: &xfce-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3>
<title><application>XFce</application> dependencies</title>
 
<sect4>
<title>Required</title>
 
<para><xref linkend="gtk2"/> and
<xref linkend="libxml2"/>
</para>
</sect4>
 
<sect4>
<title>Optional</title>
<para><xref linkend="libgtkhtml"/>,
<xref linkend="startup-notification"/>,
<xref linkend="a2ps"/> and
<xref linkend="psutils"/>
</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>XFce</application></title>
 
<para><application>XFce</application> now distributes as a
<acronym>TAR</acronym> ball of base packages and module packages.
For each package, run the following:</para>
 
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
<para>The following packages will install the bare minimum:</para>
 
<itemizedlist spacing='compact'>
<listitem><para>libxfce4util-&xfce-version;</para></listitem>
<listitem><para>dbh-1.0.20</para></listitem>
<listitem><para>libxfcegui4-&xfce-version;</para></listitem>
<listitem><para>libxfce4mcs-&xfce-version;</para></listitem>
<listitem><para>xfce-mcs-manager-&xfce-version;</para></listitem>
<listitem><para>xfwm4-&xfce-version;</para></listitem>
<listitem><para>xfce4-panel-&xfce-version;</para></listitem>
<listitem><para>xfdesktop-&xfce-version;</para></listitem>
<listitem><para>xfce-utils-&xfce-version;</para></listitem>
</itemizedlist>
 
<para>In addition, you may choose to install:</para>
<itemizedlist spacing='compact'>
<listitem><para>gtk-xfce-engine-2.2.5</para></listitem>
<listitem><para>xfcalendar-&xfce-version;</para></listitem>
<listitem><para>xfce-mcs-plugins-&xfce-version;</para></listitem>
<listitem><para>xfce4-appfinder-&xfce-version;</para></listitem>
<listitem><para>xfce4-icon-theme-&xfce-version;</para></listitem>
<listitem><para>xfce4-iconbox-&xfce-version;</para></listitem>
<listitem><para>xfce4-mixer-&xfce-version;</para></listitem>
<listitem><para>xfce4-session-&xfce-version;</para></listitem>
<listitem><para>xfce4-systray-&xfce-version;</para></listitem>
<listitem><para>xfce4-toys-&xfce-version;</para></listitem>
<listitem><para>xfce4-trigger-launcher-&xfce-version;</para></listitem>
<listitem><para>xffm-&xfce-version;</para></listitem>
<listitem><para>xfprint-&xfce-version;</para></listitem>
<listitem><para>xfwm4-themes-&xfce-version;</para></listitem>
</itemizedlist>
 
</sect2>
 
<sect2 id='xfce-config'>
<title>Configuring <application>XFce</application></title>
 
<sect3>
<title>Config files</title>
<para><filename>~/.xinitrc</filename></para>
</sect3>
 
<sect3>
<title>Configuration Information</title>
 
<para>Be sure to backup your current <filename>.xinitrc</filename> before
proceeding.</para>
 
<screen><userinput><command>cat &gt; ~/.xinitrc &lt;&lt; "EOF"</command>
xfce-mcs-manager
xfwm4 --daemon
xftaskbar4 &amp;
xfdesktop &amp;
exec xfce4-panel
<command>EOF</command></userinput></screen>
 
<indexterm zone="xfce xfce-config">
<primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
</indexterm>
 
</sect3>
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>fgr, scramble, startxfce4, xfbook, xfbook4, xfcalendar,
xfce-mcs-manager, xfce-setting-show, xfce4-about,
xfce4-appfinder, xfce4-iconbox, xfce4-kiosk-query,
xfce4-menueditor, xfce4-mixer, xfce4-panel, xfce4-session,
xfce4-session-logout, xfce4-tips, xfdesktop, xfdiff4, xffm,
xffrequent, xffrequent4, xffstab, xffstab4, xfglob4, xfhelp4,
xflock4, xfmime-edit, xfmountdev4, xfrecent, xfrecent4,
xfprint-manager, xfprint4, xfrun4, xfsamba4, xftaskbar4,
xfterm4, xftrash4, xftree4, xfwm4</seg>
<seg id='xfcelibs'>libdbh, libxfce4mcs, libxfce4util, libxfcegui4,
libxffm, libxfsm, libxfprint</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
 
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libdbh">libdbh.so</primary>
</indexterm>
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libxfce4mcs">libxfce4mcs.so</primary>
</indexterm>
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libxfce4util">libxfce4util.so</primary>
</indexterm>
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libxfcegui4">libxfcegui4.so</primary>
</indexterm>
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libxffm">libxffm.so</primary>
</indexterm>
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libxfsm">libxfsm.so</primary>
</indexterm>
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libxfprint">libxfprint.so</primary>
</indexterm>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="fgr">
<term><command>fgr</command></term>
<listitem>
<para>is a file content search engine for <command>xffm</command>.</para>
<indexterm zone="xfce fgr">
<primary sortas="b-fgr">fgr</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfce-mce-manager">
<term><command>xfce-mce-manager</command></term>
<listitem>
<para>is the settings manager for <application>XFce</application>.</para>
<indexterm zone="xfce xfce-mce-manager">
<primary sortas="b-xfce-mce-manager">xfce-mce-manager</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfce4-about">
<term><command>xfce4-about</command></term>
<listitem>
<para>displays the about box.</para>
<indexterm zone="xfce xfce4-about">
<primary sortas="b-xfce4-about">xfce4-about</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfce4-session">
<term><command>xfce4-session</command></term>
<listitem>
<para>starts up the <application>XFce</application> Desktop
Environment.</para>
<indexterm zone="xfce xfce4-session">
<primary sortas="b-xfce4-session">xfce4-session</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfce4-session-logout">
<term><command>xfce4-session-logout</command></term>
<listitem>
<para>logs out from <application>XFce</application>.</para>
<indexterm zone="xfce xfce4-session-logout">
<primary sortas="b-xfce4-session-logout">xfce4-session-logout</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfce-setting-show">
<term><command>xfce-setting-show</command></term>
<listitem>
<para>displays the settings for <application>XFce</application>.</para>
<indexterm zone="xfce xfce-setting-show">
<primary sortas="b-xfce-setting-show">xfce-setting-show</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfce4-panel">
<term><command>xfce4-panel</command></term>
<listitem>
<para>is the panel manager for <application>XFce</application>. It contains
the launcher, clock, mail check, desktop switcher and separator programs.</para>
<indexterm zone="xfce xfce4-panel">
<primary sortas="b-xfce4-panel">xfce4-panel</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfdesktop">
<term><command>xfdesktop</command></term>
<listitem>
<para> is the desktop manager for <application>XFce</application>.</para>
<indexterm zone="xfce xfdesktop">
<primary sortas="b-xfdesktop">xfdesktop</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfhelp4">
<term><command>xfhelp4</command></term>
<listitem>
<para>is script that launches a <acronym>HTML</acronym> browser to
display online documentation.</para>
<indexterm zone="xfce xfhelp4">
<primary sortas="b-xfhelp4">xfhelp4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xflock4">
<term><command>xflock4</command></term>
<listitem>
<para>is a script used to lock the current screen during drag and drop actions.</para>
<indexterm zone="xfce xflock4">
<primary sortas="b-xflock4">xflock4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfmountdev4">
<term><command>xfmountdev4</command></term>
<listitem>
<para>mounts a device on the specified mount point and launches <command>xftree4</command>,
then unmounts the device when <command>xftree4</command> finishes.</para>
<indexterm zone="xfce xfmountdev4">
<primary sortas="b-xfmountdev4">xfmountdev4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfrun4">
<term><command>xfrun4</command></term>
<listitem>
<para>is the program launcher for <application>XFce</application>.</para>
<indexterm zone="xfce xfrun4">
<primary sortas="b-xfrun4">xfrun4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfsamba4">
<term><command>xfsamba4</command></term>
<listitem>
<para> is the <application>Samba</application> front end for <application>XFce</application>.</para>
<indexterm zone="xfce xfsamba4">
<primary sortas="b-xfsamba4">xfsamba4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xftaskbar4">
<term><command>xftaskbar4</command></term>
<listitem>
<para>is the taskbar manager for <application>XFce</application>.</para>
<indexterm zone="xfce xftaskbar4">
<primary sortas="b-xftaskbar4">xftaskbar4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfterm4">
<term><command>xfterm4</command></term>
<listitem>
<para>is a small terminal wrapper to be used as a drag and drop action
for the <application>XFce</application> front panel.</para>
<indexterm zone="xfce xfterm4">
<primary sortas="b-xfterm4">xfterm4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xftrash4">
<term><command>xftrash4</command></term>
<listitem>
<para>is a small script to be used as a drag and drop action for the
<application>XFce</application> front panel.</para>
<indexterm zone="xfce xftrash4">
<primary sortas="b-xftrash4">xftrash4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xftree4">
<term><command>xftree4</command></term>
<listitem>
<para>is the file manager for <application>XFce</application>.</para>
<indexterm zone="xfce xftree4">
<primary sortas="b-xftree4">xftree4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfwm4">
<term><command>xfwm4</command></term>
<listitem>
<para>is an <application>X11</application> window manager for <application>XFce</application>.</para>
<indexterm zone="xfce xfwm4">
<primary sortas="b-xfwm4">xfwm4</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
</sect2>
</sect1>
/tags/tBLFS-6_0/blfs/x/wm/fluxbox.xml
0,0 → 1,186
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY fluxbox-download-http "http://prdownloads.sourceforge.net/fluxbox/fluxbox-&fluxbox-version;.tar.bz2">
<!ENTITY fluxbox-download-ftp " ">
<!ENTITY fluxbox-md5sum "398f4e10d88b47507ea309968340961c">
<!ENTITY fluxbox-size "637 KB">
<!ENTITY fluxbox-buildsize "36.7 MB">
<!ENTITY fluxbox-time "1.28 SBU">
]>
 
<sect1 id="fluxbox" xreflabel="Fluxbox-&fluxbox-version;">
<sect1info>
<othername>$LastChangedBy: larry $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="fluxbox.html" ?>
<title>Fluxbox-&fluxbox-version;</title>
<indexterm zone="fluxbox"><primary
sortas="a-Fluxbox">Fluxbox</primary></indexterm>
 
<sect2>
<title>Introduction to <application>Fluxbox</application></title>
 
<para>The <application>Fluxbox</application> package contains a window manager.
</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&fluxbox-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&fluxbox-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &fluxbox-md5sum;</para></listitem>
<listitem><para>Download size: &fluxbox-size;</para></listitem>
<listitem><para>Estimated disk space required:
&fluxbox-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&fluxbox-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>Fluxbox</application> dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para></sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>Fluxbox</application></title>
 
<para>Install <application>Fluxbox</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Configuring <application>Fluxbox</application></title>
 
<sect3 id="fluxbox-config"><title>Config files</title>
<para><filename>~/.fluxbox/init</filename>,
<filename>~/.fluxbox/keys</filename>,
<filename>~/.fluxbox/menu</filename></para>
<indexterm zone="fluxbox fluxbox-config">
<primary sortas="e-AA.fluxbox-init">~/.fluxbox/init</primary></indexterm>
<indexterm zone="fluxbox fluxbox-config">
<primary sortas="e-AA.fluxbox-keys">~/.fluxbox/keys</primary></indexterm>
<indexterm zone="fluxbox fluxbox-config">
<primary sortas="e-AA.fluxbox-menu">~/.fluxbox/menu</primary></indexterm>
</sect3>
 
<sect3><title>Configuration Information</title>
 
<para>Be sure to backup your current <filename>.xinitrc</filename> before
proceeding.</para>
<indexterm zone="fluxbox fluxbox-config">
<primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
</indexterm>
 
<screen><userinput><command>cat &gt;&gt; ~/.xinitrc &lt;&lt; "EOF"</command>
startfluxbox
<command>EOF</command></userinput></screen>
 
<para>Now create the <application>Fluxbox</application> configuration
files:</para>
 
<screen><userinput><command>mkdir ~/.fluxbox &amp;&amp;
cp /usr/share/fluxbox/init ~/.fluxbox/init &amp;&amp;
cp /usr/share/fluxbox/keys ~/.fluxbox/keys &amp;&amp;
cp /usr/share/fluxbox/menu ~/.fluxbox/menu </command></userinput></screen>
 
<para>Menu Items are added by editing <filename>~/.fluxbox/menu</filename>. The
syntax is explained on the fluxbox man page.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>fluxbox, fbsetbg, bsetroot, fluxbox-generate_menu, startfluxbox, and
fbrun</seg>
<seg>None</seg>
<seg>/usr/share/fluxbox and ~/.fluxbox</seg></seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="fluxbox-prog">
<term><command>fluxbox</command></term>
<listitem><para>is a window manager for <application>X11</application> based
on <application>Blackbox</application> 0.61.0.</para>
<indexterm zone="fluxbox fluxbox-prog">
<primary sortas="b-fluxbox">fluxbox</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="fbsetbg">
<term><command>fbsetbg</command></term>
<listitem><para>is a utility that sets the background image.
It needs <command>display</command>, <command>Esetroot</command>,
<command>wmsetbg</command>, <command>xv</command>,
<command>qiv</command> or <command>xsri</command> to be used.</para>
<indexterm zone="fluxbox fbsetbg">
<primary sortas="b-fbsetbg">fbsetbg</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="bsetroot">
<term><command>bsetroot</command></term>
<listitem><para>is a <application>Blackbox</application>
utility to change root window appearance.</para>
<indexterm zone="fluxbox bsetroot">
<primary sortas="b-bsetroot">bsetroot</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="fluxbox-generate">
<term><command>fluxbox-generate_menu</command></term>
<listitem><para> is a menu maker utility.</para>
<indexterm zone="fluxbox fluxbox-generate">
<primary sortas="b-fluxbox-generate">fluxbox-generate_menu</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="startfluxbox">
<term><command>startfluxbox</command></term>
<listitem><para> is a session startup script that
allows for command executions prior to <command>fluxbox</command>
starting.</para>
<indexterm zone="fluxbox startfluxbox">
<primary sortas="b-startfluxbox">startfluxbox</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="fbrun">
<term><command>fbrun</command></term>
<listitem><para> displays a run dialog window.</para>
<indexterm zone="fluxbox fbrun">
<primary sortas="b-fbrun">fbrun</primary></indexterm>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/x/wm/metacity.xml
0,0 → 1,180
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY metacity-download-http "http://ftp.gnome.org/pub/GNOME/sources/metacity/2.8/metacity-&metacity-version;.tar.bz2">
<!ENTITY metacity-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/metacity/2.8/metacity-&metacity-version;.tar.bz2">
<!ENTITY metacity-md5sum "c49e4b5575503975516159780855e317">
<!ENTITY metacity-size "2.1 MB">
<!ENTITY metacity-buildsize "46.9 MB">
<!ENTITY metacity-time "0.41 SBU">
]>
 
<sect1 id="metacity" xreflabel="Metacity-&metacity-version;">
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="metacity.html" ?>
<title>Metacity-&metacity-version;</title>
 
<indexterm zone="metacity">
<primary sortas="a-metacity">Metacity</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application>Metacity</application></title>
 
<para>The <application>Metacity</application> package contains a window
manager. This is useful for organizing and displaying windows.</para>
 
<sect3>
<title>Package information</title>
 
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&metacity-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&metacity-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &metacity-md5sum;</para></listitem>
<listitem><para>Download size: &metacity-size;</para></listitem>
<listitem><para>Estimated disk space required: &metacity-buildsize;</para></listitem>
<listitem><para>Estimated build time: &metacity-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3>
<title><application>Metacity</application> dependencies</title>
 
<sect4>
<title>Required</title>
 
<para><xref linkend="intltool"/>,
<xref linkend="GConf"/>, and
<xref linkend="gtk2"/>
</para>
</sect4>
 
<sect4>
<title>Optional</title>
<para><xref linkend="startup-notification"/>,
<ulink url="http://freedesktop.org/Software/xlibs">Xrender</ulink>*, and
<ulink url="http://freedesktop.org/Software/xlibs">libXcomposite</ulink>**
</para>
 
<para>* <filename class='libraryfile'>libXrender</filename> is included in a
<acronym>BLFS</acronym> <application>X</application> Window System
installation, but the pkgconfig <filename>.pc</filename> file
<application>Metacity</application> looks for is not installed. Satisfy the
requirement by installing an <filename>xrender.pc</filename> file into
<filename class='directory'>/usr/X11R6/lib/pkgconfig</filename> which can be
installed as:</para>
 
<screen><userinput><command>cat &gt; /usr/X11R6/lib/pkgconfig/xrender.pc &lt;&lt; "EOF"</command>
prefix=/usr/X11R6
exec_prefix=${prefix}
libdir=${exec_prefix}/lib
includedir=${prefix}/include
 
Name: Xrender
Description: X Render Library
Version: 0.8.3
Cflags: -I${includedir} -I/usr/X11R6/include
Libs: -L${libdir} -lXrender -L/usr/X11R6/lib -lX11
<command>EOF</command></userinput></screen>
 
<para>** <application>libXcomposite</application> can optionally be used, but
here's what the <application>Metacity</application> package maintainer
has to say about it in the configure script if the package is found:
<quote>Not building compositing manager by default now, must enable explicitly
to get it. And it doesn't work, so don't bother unless you want to hack on
it...</quote></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>Metacity</application></title>
 
<para>Install <application>Metacity</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --libexecdir=/usr/sbin --sysconfdir=/etc &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><option>--with-gconf-schema-file-dir=/etc/gnome/gconf/schemas</option>:
Use this option if you have the
<application><acronym>GNOME</acronym>-2</application>
<application>GConf</application> package installed.</para>
 
</sect2>
 
<sect2 id='metacity-config'>
<title>Configuring <application>Metacity</application></title>
 
<sect3>
<title>Configuration Information</title>
 
<para>To automatically start the <application>Metacity</application> window
manager when you issue the <command>startx</command> command, append to (or
create) <filename>.xinitrc</filename> using the command below. Ensure you
backup your current <filename>~/.xinitrc</filename> before proceeding.</para>
 
<indexterm zone="metacity metacity-config">
<primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
</indexterm>
 
<screen><userinput><command>cat &gt;&gt; ~/.xinitrc &lt;&lt; "EOF"</command>
xterm &amp;
exec metacity
<command>EOF</command></userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>metacity</seg>
<seg>None</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="metacity-prog">
<term><command>metacity</command></term>
<listitem>
<para>is a window manager used mainly by
<application><acronym>GNOME</acronym></application>.
</para>
<indexterm zone="metacity metacity-prog">
<primary sortas="b-metacity">metacity</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
</sect1>
 
/tags/tBLFS-6_0/blfs/x/lib/gtk+.xml
0,0 → 1,137
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY GTK-download-http "http://gd.tuwien.ac.at/graphics/gimp/gtk/v1.2/gtk+-&GTK-version;.tar.gz">
<!ENTITY GTK-download-ftp "ftp://ftp.gtk.org/pub/gtk/v1.2/gtk+-&GTK-version;.tar.gz">
<!ENTITY GTK-md5sum "4d5cb2fc7fb7830e4af9747a36bfce20">
<!ENTITY GTK-size "2.7 MB">
<!ENTITY GTK-buildsize "54 MB">
<!ENTITY GTK-time "1.96 SBU">
]>
<sect1 id="GTK" xreflabel="GTK+-&GTK-version;">
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="gtk.html" ?>
<title>GTK+-&GTK-version;</title>
 
<indexterm zone="GTK">
<primary sortas="a-GTK">GTK</primary>
</indexterm>
 
 
<sect2>
<title>Introduction to
<application><acronym>GTK</acronym>+</application></title>
 
<para>The <application>GTK+</application> package contains
<application>GTK+</application> Libraries. This is useful for
creating graphical user interfaces for applications.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&GTK-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&GTK-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &GTK-md5sum;</para></listitem>
<listitem><para>Download size: &GTK-size;</para></listitem>
<listitem><para>Estimated disk space required: &GTK-buildsize;</para></listitem>
<listitem><para>Estimated build time: &GTK-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3>
<title><application><acronym>GTK</acronym>+</application> dependencies</title>
 
<sect4>
<title>Required</title>
 
<para><xref linkend="GLib"/>,
<xref linkend="libtiff"/>,
<xref linkend="libjpeg"/>, and
X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)
</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of
<application><acronym>GTK</acronym>+</application></title>
 
<para>Install <application><acronym>GTK</acronym>+</application> by running
the following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><option>--sysconfdir=/etc</option>: This installs the
configuration files into <filename class="directory">/etc</filename>
instead of <filename class="directory">/usr/etc</filename>.</para>
 
<para><parameter>--with-xinput=xfree</parameter>: This configuration
flag is necessary to utilize alternative input devices.</para>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libgtk-1.2, libgdk-1.2</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
 
<varlistentry id="libgtk">
<term><filename class='libraryfile'>libgtk.{so,a}</filename></term>
<listitem>
<para>(GIMP Tool Kit) is a library for creating graphical user interfaces similar to
the Motif "look and feel".</para>
<indexterm zone="GTK libgtk">
<primary sortas="c-libgtk">libgtk.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="libgdk">
<term><filename class='libraryfile'>libgdk.{so,a}</filename></term>
<listitem>
<para>is designed as a wrapper library that lies on top of Xlib. It
performs many common and desired operations for a programmer instead of
the programmer having to explicitly ask for such functionality from
Xlib directly.</para>
<indexterm zone="GTK libgdk">
<primary sortas="c-libgdk">libgdk.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
</sect2>
</sect1>
 
/tags/tBLFS-6_0/blfs/x/lib/gtk+2.xml
0,0 → 1,187
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY gtk2-download-http "http://gd.tuwien.ac.at/graphics/gimp/gtk/v2.6/gtk+-&gtk2-version;.tar.bz2">
<!ENTITY gtk2-download-ftp "ftp://ftp.gtk.org/pub/gtk/v2.6/gtk+-&gtk2-version;.tar.bz2">
<!ENTITY gtk2-md5sum "4749fce7b082b784a71a076aa586dc25">
<!ENTITY gtk2-size "11.2 MB">
<!ENTITY gtk2-buildsize "202 MB">
<!ENTITY gtk2-time "2.87 SBU">
]>
 
<sect1 id="gtk2" xreflabel="GTK+-&gtk2-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
 
<?dbhtml filename="gtk2.html" ?>
<title>GTK+-&gtk2-version;</title>
 
<indexterm zone="gtk2">
<primary sortas="a-gtk2">gtk2</primary>
</indexterm>
 
<sect2>
<title>Introduction to
<application><acronym>GTK</acronym>+</application></title>
 
<para>The <application><acronym>GTK</acronym>+</application> package contains
<application><acronym>GTK</acronym>+</application> Libraries. These are useful
for creating graphical user interfaces for applications.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&gtk2-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&gtk2-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &gtk2-md5sum;</para></listitem>
<listitem><para>Download size: &gtk2-size;</para></listitem>
<listitem><para>Estimated disk space required: &gtk2-buildsize;</para></listitem>
<listitem><para>Estimated build time: &gtk2-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3>
<title><application><acronym>GTK</acronym>+</application> dependencies</title>
<sect4>
<title>Required</title>
<para>
X (<xref linkend="xorg"/> or <xref linkend="xfree86"/>),
<xref linkend="pango"/>, and
<xref linkend="atk"/>
</para>
</sect4>
 
<sect4>
<title>Optional</title>
<para>
<xref linkend="libtiff"/>,
<xref linkend="libjpeg"/>,
<xref linkend="gtk-doc"/>, and
<xref linkend="docbook-utils"/>
</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application><acronym>GTK</acronym>+</application></title>
 
<para>Install <application><acronym>GTK</acronym>+</application> by running
the following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc \
--without-libtiff --without-libjpeg &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><parameter>--sysconfdir=/etc</parameter>: This switch installs the
configuration files into <filename class="directory">/etc</filename>
instead of <filename class="directory">/usr/etc</filename>.</para>
 
<para><parameter>--without-libtiff</parameter>: Omit this switch if you have
<application>libtiff</application> installed.</para>
 
<para><parameter>--without-libjpeg</parameter>: Omit this switch if you have
<application>libjpeg</application> installed.</para>
 
<para><option>--enable-gtk-doc</option>: This switch will rebuild
the <acronym>API</acronym> documentation during the
<command>make</command> command.</para>
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>gdk-pixbuf-csource, gdk-pixbuf-query-loaders, gtk-demo,
gtk-query-immodules-2.0, gtk-update-icon-cache</seg>
<seg>libgdk_pixbuf-2.0.so, libgdk-x11-2.0.so, libgtk-x11-2.0.so,
libgdk_pixbuf_xlib-2.0.so and numerous engine, module and
loader plugins</seg>
<seg>/etc/gtk-2.0, /usr/include/gtk-2.0, /usr/lib/gtk-2.0,
/usr/share/gtk-2.0, /usr/share/gtk-doc/html/[gdk,gdk-pixbuf,gtk],
/usr/share/themes/Default/gtk* and
/usr/share/themes/Emacs/gtk-2.0-key</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="gdk-pixbuf-csource">
<term><command>gdk-pixbuf-csource</command></term>
<listitem>
<para>generates C code containing images, useful for compiling images
directly into programs.</para>
<indexterm zone="gtk2 gdk-pixbuf-csource">
<primary sortas="b-gdk-pixbuf-csource">gdk-pixbuf-csource</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="gdk-pixbuf-query-loaders">
<term><command>gdk-pixbuf-query-loaders</command></term>
<listitem>
<para>collects information about loadable modules for gdk-pixbuf and
writes it to standard output.</para>
<indexterm zone="gtk2 gdk-pixbuf-query-loaders">
<primary sortas="b-gdk-pixbuf-query-loaders">gdk-pixbuf-query-loaders</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="gtk-query-immodules-2.0">
<term><command>gtk-query-immodules-2.0</command></term>
<listitem>
<para> collects information about loadable input method modules for
<application><acronym>GTK</acronym>+</application> and writes it to
standard output.</para>
<indexterm zone="gtk2 gtk-query-immodules-2.0">
<primary sortas="b-gtk-query-immodules-2.0">gtk-query-immodules-2.0</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="gtk-update-icon-cache">
<term><command>gtk-update-icon-cache</command></term>
<listitem>
<para>creates mmap()able cache files for icon themes.</para>
<indexterm zone="gtk2 gtk-update-icon-cache">
<primary sortas="b-gtk-update-icon-cache">gtk-update-icon-cache</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="GTK2libs">
<term>GTK+ Libraries</term>
<listitem>
<para>provide an API to implement graphical user interfaces.</para>
<indexterm zone="gtk2 GTK2libs">
<primary sortas="c-GTK2libs">GTK+ Libraries</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/x/lib/qt.xml
0,0 → 1,306
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY qt-download-http "http://sunsite.rediris.es/mirror/Qt/source/qt-x11-free-&qt-version;.tar.bz2">
<!ENTITY qt-download-ftp "ftp://ftp.trolltech.com/qt/source/qt-x11-free-&qt-version;.tar.bz2">
<!ENTITY qt-md5sum "3e0a0c8429b0a974b39b5f535ddff01c">
<!ENTITY qt-size "14.4 MB">
<!ENTITY qt-buildsize "250 MB">
<!ENTITY qt-time "19.3 SBU (full), 13.4 SBU (sub-tools)">
]>
 
<sect1 id="qt" xreflabel="Qt-&qt-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="qt.html" ?>
<title>Qt-&qt-version;</title>
 
<sect2>
<title>Introduction to <application>Qt</application></title>
 
<para>The <application>Qt</application> package contains a
<application>C++</application> <acronym>GUI</acronym> library. This is useful
for creating graphical applications or executing graphical applications that
are dynamically linked to the <application>Qt</application> library. One of the
major users of <application>Qt</application> is <application>KDE</application>.
</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&qt-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&qt-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 Sum: &qt-md5sum;</para></listitem>
<listitem><para>Download size: &qt-size;</para></listitem>
<listitem><para>Estimated disk space required: &qt-buildsize;</para></listitem>
<listitem><para>Estimated build time: &qt-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>Qt</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="x-installing"/></para>
</sect4>
 
<sect4><title>Recommended</title>
<para><xref linkend="libjpeg"/> and <xref linkend="libmng"/></para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="nas"/>, <xref linkend="cups"/>, <xref linkend="mysql"/>,
<xref linkend="postgresql"/>, <ulink url="http://sqlite.org/">SQLite</ulink>,
<ulink url="http://firebird.sourceforge.net/">Firebird</ulink>
and <ulink url="http://www.unixodbc.org/">unixODBC</ulink></para>
</sect4>
</sect3>
</sect2>
 
<sect2>
<title>Installation of <application>Qt</application></title>
 
<para>There are several ways to install a complicated package such as
<application>Qt</application>. The files are not completely position
independent. Installation procedures execute the program
<command>pkg-config</command> to determine the location of package executables,
libraries, headers, and other files. For <application>Qt</application>,
<command>pkg-config</command> will look for the file
<filename>lib/pkgconfig/qt-mt.pc</filename> which must be modified if
relocating the package. This file is set up correctly by the build process.
</para>
 
<para>The default installation places the files in
<filename class='directory'>/usr/local/qt/</filename>. Many commercial
distributions place the files in the system's
<filename class='directory'>/usr</filename> hierarchy. The package can also be
installed in an arbitrary directory.</para>
 
<para>This section will demonstrate two different methods.</para>
 
<note><para>The build time for <application>Qt</application> is quite long. If
you want to save some time and don't want the tutorials and examples, change
the first make line to:</para>
 
<para><userinput><command>make sub-tools</command></userinput></para>
</note>
 
<sect3>
<title>Method 1 - Installing in the
<filename class='directory'>/usr</filename> hierarchy</title>
<para>The advantage of this method is that no updates to the
<filename>/etc/ld.so.conf</filename> or <filename>/etc/man.conf</filename>
files are required. The package files are distributed within several
subdirectories of the <filename class='directory'>/usr</filename> hierarchy.
This is the method that most commercial distributions use.</para>
 
<screen><userinput><command>sed -i "s:cp -f:install:" mkspecs/linux-g++/qmake.conf &amp;&amp;
bash
export PATH=$PWD/bin:$PATH &amp;&amp;
export LD_LIBRARY_PATH=$PWD/lib:$LD_LIBRARY_PATH &amp;&amp;
./configure -prefix /usr -docdir /usr/share/doc/qt \
-headerdir /usr/include/qt -plugindir /usr/lib/qt/plugins \
-datadir /usr/share/qt -translationdir /usr/share/qt/translations \
-sysconfdir /etc/qt -qt-gif -system-zlib -system-libmng \
-no-exceptions -thread -plugin-imgfmt-png \
-system-libjpeg -system-libpng &amp;&amp;
find -type f -name Makefile | xargs sed -i "s@-Wl,-rpath,/usr/lib@@g" &amp;&amp;
make &amp;&amp;
make install &amp;&amp;
ln -sf libqt-mt.so /usr/lib/libqt.so &amp;&amp;
rm /usr/bin/qmake &amp;&amp;
install -m755 -oroot -groot qmake/qmake /usr/bin &amp;&amp;
cp -r doc/man /usr/share &amp;&amp;
cp -r examples /usr/share/doc/qt &amp;&amp;
exit</command></userinput></screen>
 
</sect3>
 
<sect3>
<title>Method 2 - Installing in <filename class='directory'>/opt</filename></title>
 
<para>This is the method recommended by the <application>Qt</application>
developers. It has the advantage of keeping all the package files consolidated
in a dedicated directory hierarchy. By using this method, an update can be made
without overwriting a previous installation and users can easily revert to a
previous version by changing one symbolic link.</para>
 
<para>The <application>Qt</application> developers use a default location of
<filename class='directory'>/usr/local/qt/</filename>, however this procedure
puts the files in <filename class='directory'>/opt/qt-&qt-version;/</filename>
and then creates a symbolic link to <filename>/opt/qt/</filename>.</para>
 
<screen><userinput><command>bash
export QTDIR=$PWD &amp;&amp;
export LD_LIBRARY_PATH=$PWD/lib:$LD_LIBRARY_PATH &amp;&amp;
export PATH=$PWD/bin:$PATH &amp;&amp;
./configure -prefix /opt/qt-&qt-version; -qt-gif -system-libpng \
-system-libmng -system-zlib -system-libjpeg -no-exceptions \
-thread -plugin-imgfmt-png &amp;&amp;
make &amp;&amp;
make install &amp;&amp;
ln -sfn qt-&qt-version; /opt/qt &amp;&amp;
ln -s libqt-mt.so /opt/qt/lib/libqt.so &amp;&amp;
rm /opt/qt-&qt-version;/bin/qmake &amp;&amp;
install -m755 -oroot -groot qmake/qmake /opt/qt-&qt-version;/bin &amp;&amp;
cp -r doc/man /opt/qt/doc &amp;&amp;
cp -r examples /opt/qt/doc
exit</command></userinput></screen>
 
<note><para>If you pass the
<option>-plugin-sql-<replaceable>[driver]</replaceable></option> switch to the
<command>configure</command> command, you must also pass
<option>-I<replaceable>[/path/to/sql/headers]</replaceable></option> so
<command>make</command> can find the appropriate header files.</para></note>
</sect3>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>sed -i "s:cp -f:install:" mkspecs/linux-g++/qmake.conf</command>:
<command>install</command> is safer than <command>cp</command> when
libraries are in use.</para>
 
<para><command>bash</command>: This command enters a sub-shell to isolate
environment changes.</para>
 
<para><command>export QTDIR=$PWD</command>: This command defines where the root
of the <application>Qt</application> directory is located.</para>
 
<para><command>export LD_LIBRARY_PATH=$PWD/lib:$LD_LIBRARY_PATH</command>: This
command allows the not yet installed <application>Qt</application> libraries to
be used by the not yet installed <application>Qt</application> programs.</para>
 
<para><command>export PATH=$PWD/bin:$PATH</command>: This command
allows the build process to find supporting executables.</para>
 
<para><parameter>-qt-gif</parameter>: This switch adds support for
<filename>gif</filename> files to the libraries.</para>
 
<para><parameter>-system-zlib -system-libpng</parameter>: This switch
forces the build instructions to use the shared libraries that are on your
system instead of creating a custom set of support libraries for these
functions.</para>
 
<para><parameter>-plugin-imgfmt-png</parameter>: This switch enables
<application>libpng</application> to be linked to at runtime.</para>
 
<para><parameter>-no-exceptions</parameter>: This switch disables
the exceptions coding generated by the <application>C++</application> compiler.
</para>
 
<para><parameter>-thread</parameter>: This switch adds
support for multi-threading.</para>
 
<para><command>find -type f -name Makefile | xargs sed -i
"s@-Wl,-rpath,/usr/lib@@g"</command>: This command removes hardcoded run-time
paths. Otherwise, <command>uic</command> always tries to run with
<application>Qt</application> libraries in <filename>/usr/lib</filename>.</para>
 
<para><command>ln -s libqt-mt.so /usr/lib/libqt.so</command>: This command
allows <command>configure</command> scripts to find a working
<application>Qt</application> installation.</para>
 
<para><command>rm .../qmake; install -m755 -oroot -groot qmake/qmake .../bin</command>:
The <command>qmake</command> program is installed incorrectly by
<command>make install</command>. These two commands install the program
correctly.</para>
 
<para><command>cp -r doc/man /usr/share (or /opt/qt/doc)</command>: This command
installs the man pages which are missed by <command>make install</command>.
</para>
 
<para><command>cp -r examples /usr/share/doc/qt (or /opt/qt/doc)</command>:
This command installs the examples which are missed by
<command>make install</command>.</para>
 
<para><command>exit</command>: This command returns to the parent shell
and eliminates environment variables set earlier.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>Qt</application></title>
 
<sect3><title>Configuration Information</title>
<para>If you installed <application>Qt</application> using Method 2, you need
to update some configuration files so that <application>Qt</application> is
correctly found by other packages and system processes.</para>
 
<para>Update the <filename>/etc/ld.so.conf</filename> and
<filename>/etc/man.conf</filename> files:</para>
 
<screen><userinput><command>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; "EOF"
# Begin qt addition to /etc/ld.so.conf
 
/opt/qt/lib
 
# End qt addition
EOF
ldconfig
 
cat &gt;&gt; /etc/man.conf &lt;&lt; "EOF"
# Begin qt addition to man.conf
 
MANPATH /opt/qt/doc/man
 
# End qt addition to man.conf
EOF</command></userinput></screen>
 
<para>Update the <envar>PKG_CONFIG_PATH</envar> environment variable in your
<filename>~/.bash_profile</filename> or <filename>/etc/profile</filename> with
the following:</para>
 
<screen><userinput>PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/qt/lib/pkgconfig</userinput></screen>
 
<para>The <envar>QTDIR</envar> environment variable needs to be set when
building packages that depend on <application>Qt</application>. Add the
following to the <filename>.bash_profile</filename> initialization script for
each user that builds packages using the <application>Qt</application>
libraries. Alternatively, the variable can be set in the system wide
<filename>/etc/profile</filename> file.</para>
 
<screen><userinput>export QTDIR=/opt/qt</userinput></screen>
 
<para>If you want the <application>Qt</application> executables in your shell
search path, update the <envar>PATH</envar> environment variable in your
<filename>~/.bash_profile</filename> or <filename>/etc/profile</filename> to
include <filename class='directory'>/opt/qt/bin</filename>.</para>
 
<para>As with most libraries, there is no explicit configuration to do. After
updating <filename>/etc/ld.so.conf</filename> as explained above, run
<command>/sbin/ldconfig</command> so that <command>ldd</command> can find the
shared libraries.</para>
 
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>Qt</application>/<application>X11</application>
library contains <acronym>API</acronym>s necessary to use
programs based on the <application>Qt</application> <acronym>GUI</acronym>
toolkit.</para>
 
<para>The <application>Qt</application> package contains
<command>assistant</command>,
<command>designer</command>,
<command>linguist</command>,
<command>lrelease</command>,
<command>lupdate</command>,
<command>moc</command>,
<command>qm2ts</command>,
<command>qmake</command>,
<command>qtconfig</command>,
<command>uic</command>, and the
<filename class="libraryfile">libqt-mt</filename> and
<filename class="libraryfile">libqui</filename> libraries.</para>
 
</sect2>
</sect1>
/tags/tBLFS-6_0/blfs/x/lib/shared-mime-info.xml
0,0 → 1,108
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY shared-mime-info-download-http "http://freedesktop.org/software/shared-mime-info/shared-mime-info-&shared-mime-info-version;.tar.gz">
<!ENTITY shared-mime-info-download-ftp "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/shared-mime-info-&shared-mime-info-version;.tar.gz">
<!ENTITY shared-mime-info-md5sum "51793b041edc68717c3f87e26a4bc087">
<!ENTITY shared-mime-info-size "422 KB">
<!ENTITY shared-mime-info-buildsize "4.4 MB">
<!ENTITY shared-mime-info-time "0.03 SBU">
]>
 
<sect1 id="shared-mime-info"
xreflabel="shared-mime-info-&shared-mime-info-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="shared-mime-info.html" ?>
<title>shared-mime-info-&shared-mime-info-version;</title>
 
<sect2>
<title>Introduction to <application>shared-mime-info</application></title>
 
<para>The <application>shared-mime-info</application> package contains a
<acronym>MIME</acronym> database. This allows central updates of
<acronym>MIME</acronym> information for all supporting applications.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&shared-mime-info-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&shared-mime-info-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum:
&shared-mime-info-md5sum;</para></listitem>
<listitem><para>Download size:
&shared-mime-info-size;</para></listitem>
<listitem><para>Estimated disk space required:
&shared-mime-info-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&shared-mime-info-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>shared-mime-info</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="glib2"/>,
<xref linkend="libxml2"/> and
<xref linkend="perl-modules"/>: XML-Parser</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>shared-mime-info</application></title>
 
<para>Install <application>shared-mime-info</application> by running the
following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Configuring <application>shared-mime-info</application></title>
 
<sect3><title>Configuration information</title>
 
<para>Some applications
(including <application><acronym>GNOME</acronym></application>-2) require
a properly set enviroment variable to locate the <acronym>MIME</acronym>
database. Satisfy this requirement by setting the following variable in your
local shell profile, or the system-wide profile:</para>
 
<screen><userinput>XDG_DATA_DIRS=/usr/share
export XDG_DATA_DIRS</userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>shared-mime-info</application> package contains
<command>update-mime-database</command> and
<filename>/usr/share/mime/*</filename>.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>update-mime-database</title>
<para><command>update-mime-database</command> assists in adding
<acronym>MIME</acronym> data to the database.</para></sect3>
 
<sect3><title>MIME Database</title>
<para><filename>/usr/share/mime/*</filename> contains the centralized
<acronym>MIME</acronym> database.</para></sect3>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/x/lib/pango.xml
0,0 → 1,132
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY pango-download-http "http://ftp.gnome.org/pub/GNOME/sources/pango/1.8/pango-&pango-version;.tar.bz2">
<!ENTITY pango-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/pango/1.8/pango-&pango-version;.tar.bz2">
<!ENTITY pango-md5sum "88aa6bf1876766db6864f3b93577887c">
<!ENTITY pango-size "996 KB">
<!ENTITY pango-buildsize "22 MB">
<!ENTITY pango-time "0.56 SBU (includes rebuilding the documentation)">
]>
 
<sect1 id="pango" xreflabel="Pango-&pango-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="pango.html" ?>
<title>Pango-&pango-version;</title>
 
<sect2>
<title>Introduction to <application>Pango</application></title>
 
<para>The <application>Pango</application> package contains the
<filename class="libraryfile">libpango</filename> libraries. These are useful
for the layout and rendering of text.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&pango-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&pango-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &pango-md5sum;</para></listitem>
<listitem><para>Download size: &pango-size;</para></listitem>
<listitem><para>Estimated disk space required:
&pango-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&pango-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>Pango</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="glib2"/></para>
</sect4>
 
<sect4><title>Optional</title>
<para><ulink url="http://freedesktop.org/~fontconfig/release/">Xft</ulink>
(included in <xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="fontconfig"/> and <xref linkend="gtk-doc"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>Pango</application></title>
 
<para>In order for <application>Pango</application> to find
<application>Xft</application>, the <envar>PKG_CONFIG_PATH</envar> must
include <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>.
This is a good time to add it if you haven't already. You can utilize the
example for <filename>X.sh</filename> to create a script for modifying this
variable located in the section <xref linkend="postlfs-config-profile"/>.
</para>
 
<para>Install <application>Pango</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><parameter>--sysconfdir=/etc</parameter>: This switch installs the
configuration files into <filename class="directory">/etc</filename>
instead of <filename class="directory">/usr/etc</filename>.</para>
 
<para><option>--enable-gtk-doc</option>: This switch will rebuild
the <acronym>API</acronym> documentation during the
<command>make</command> command.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>Pango</application></title>
 
<sect3><title>Config files</title>
<para><filename>/etc/pango/pangorc</filename>,
<filename>~/.pangorc</filename> and the file specified in the
environment variable <envar>PANGO_RC_FILE</envar></para>
</sect3>
 
<sect3><title>Configuration Information</title>
<para>The <application>Pango</application> module path is specified by the key
<userinput><parameter>Pango/ModulesPath</parameter></userinput> in the
<application>Pango</application> config database, which is read from the
config files listed above.</para></sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>Pango</application> package contains
<command>pango-querymodules</command>,
<filename class="libraryfile">libpango</filename> libraries and
<application>Pango</application> loadable modules.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>pango-querymodules</title>
<para><command>pango-querymodules</command> is a module registration utility
that collects information about <application>Pango</application> loadable
modules</para></sect3>
 
<sect3><title>Pango libraries</title>
<para><application>Pango</application> libraries contain low level layout
rendering routines, a high level driver for laying out entire blocks of text,
and routines to assist in editing internationalized text.</para></sect3>
 
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/x/lib/hicolor-icon-theme.xml
0,0 → 1,95
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY hicolor-icon-theme-download-http "http://freedesktop.org/software/icon-theme/releases/hicolor-icon-theme-&hicolor-icon-theme-version;.tar.gz">
<!ENTITY hicolor-icon-theme-download-ftp "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/hicolor-icon-theme-&hicolor-icon-theme-version;.tar.gz">
<!ENTITY hicolor-icon-theme-md5sum "947c7f6eb68fd95c7b86e87f853ceaa0">
<!ENTITY hicolor-icon-theme-size "32 KB">
<!ENTITY hicolor-icon-theme-buildsize "1.1 MB">
<!ENTITY hicolor-icon-theme-time "0.01 SBU">
]>
 
<sect1 id="hicolor-icon-theme"
xreflabel="hicolor-icon-theme-&hicolor-icon-theme-version;">
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
 
<?dbhtml filename="hicolor-icon-theme.html" ?>
<title>hicolor-icon-theme-&hicolor-icon-theme-version;</title>
 
<indexterm zone="hicolor-icon-theme">
<primary sortas="a-hicolor-icon-theme">hicolor-icon-theme</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application>hicolor-icon-theme</application></title>
 
<para>The <application>hicolor-icon-theme</application> package contains
a default fallback theme for implementations of the icon theme
specification.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&hicolor-icon-theme-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&hicolor-icon-theme-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &hicolor-icon-theme-md5sum;</para></listitem>
<listitem><para>Download size: &hicolor-icon-theme-size;</para></listitem>
<listitem><para>Estimated disk space required: &hicolor-icon-theme-buildsize;</para></listitem>
<listitem><para>Estimated build time: &hicolor-icon-theme-time;</para></listitem>
</itemizedlist>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>hicolor-icon-theme</application></title>
 
<para>Install <application>hicolor-icon-theme</application> by running the
following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>None</seg>
<seg>/usr/share/icons/hicolor/</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="hicolor-icon-themes">
<term>/usr/share/icons/hicolor/*</term>
<listitem>
<para> contains icon definitions used as defaults.</para>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/x/lib/startup-notification.xml
0,0 → 1,89
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY startup-notification-download-http "http://www.freedesktop.org/software/startup-notification/releases/startup-notification-&startup-notification-version;.tar.gz">
<!ENTITY startup-notification-download-ftp "ftp://ftp.linux.org.uk/pub/linux/GNOME/sources/startup-notification/&startup-notification-version;/startup-notification-&startup-notification-version;.tar.bz2">
<!ENTITY startup-notification-md5sum "9bba52ffe8c096cfeeaf7a1dcd9b943d">
<!ENTITY startup-notification-size "335 KB">
<!ENTITY startup-notification-buildsize "3.3 MB">
<!ENTITY startup-notification-time "0.09 SBU">
]>
 
<sect1 id="startup-notification"
xreflabel="startup-notification-&startup-notification-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="startup-notification.html" ?>
<title>startup-notification-&startup-notification-version;</title>
 
<sect2>
<title>Introduction to <application>startup-notification</application></title>
 
<para>The <application>startup-notification</application> package
contains <filename class="libraryfile">startup-notification</filename>
libraries. These are useful for building a consistent manner to notify
the user through the cursor that the application is loading.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&startup-notification-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&startup-notification-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum:
&startup-notification-md5sum;</para></listitem>
<listitem><para>Download size:
&startup-notification-size;</para></listitem>
<listitem><para>Estimated disk space required:
&startup-notification-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&startup-notification-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>startup-notification</application>
dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>startup-notification</application></title>
 
<para>Install <application>startup-notification</application> by running the
following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>startup-notification</application> package contains
<filename class="libraryfile">libstartup-notification</filename>
libraries.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>startup-notification libraries</title>
<para><filename class="libraryfile">startup-notification</filename> libraries
provide the functions to assist applications in communicating with the cursor
system to provide feedback to the user that the application is
loading.</para></sect3>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/x/lib/lib.xml
0,0 → 1,33
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
 
<chapter id="x-lib">
<?dbhtml filename="lib.html" ?>
<title>X Libraries</title>
 
<para>This chapter does not contain libraries that are required to run
<application>X</application>. It does contain libraries that enhance
<application>X</application>. In some cases the enhancement is as simple as
font support. In others it is as complex as libraries that sit between
<application>X</application> and applications that run on
<application>X</application> whose purpose is to standardize the look and feel
and inter-process communications for different applications. They also assist
programmers by supplying common elements.</para>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="qt.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gtk+.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pango.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="atk.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gtk+2.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="lesstif.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="startup-notification.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="shared-mime-info.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="hicolor-icon-theme.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libxklavier.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="freeglut.xml"/>
 
</chapter>
/tags/tBLFS-6_0/blfs/x/lib/lesstif.xml
0,0 → 1,172
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY lesstif-download-http "http://prdownloads.sourceforge.net/lesstif/lesstif-&lesstif-version;.tar.bz2">
<!ENTITY lesstif-download-ftp " ">
<!ENTITY lesstif-md5sum "20f38a06c863e0c51ca0c862ef039601">
<!ENTITY lesstif-size "2.4 MB">
<!ENTITY lesstif-buildsize "109.9 MB (includes building test suite)">
<!ENTITY lesstif-time "2.94 SBU (includes building test suite)">
]>
 
<sect1 id="lesstif" xreflabel="LessTif-&lesstif-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="lesstif.html" ?>
<title><application>LessTif</application>-&lesstif-version;</title>
 
<sect2>
<title>Introduction to <application>LessTif</application></title>
 
<para>The <application>LessTif</application> package contains an Open
Source version of <application>OSF/Motif(R)</application>.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&lesstif-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&lesstif-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &lesstif-md5sum;</para></listitem>
<listitem><para>Download size: &lesstif-size;</para></listitem>
<listitem><para>Estimated disk space required:
&lesstif-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&lesstif-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>LessTif</application> dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="lynx"/> or <xref linkend="Links"/> and
<ulink url="http://dmalloc.com">Dmalloc</ulink></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>LessTif</application></title>
 
<para>Install <application>LessTif</application> by running the following
commands:</para>
 
<screen><userinput><command>find -name Makefile.in | \
xargs sed -i 's@$(prefix)/LessTif@$(prefix)/share/LessTif@g' &amp;&amp;
./configure --prefix=/usr \
--enable-build-21 \
--disable-debug \
--enable-production \
--disable-build-tests \
--with-xdnd &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>sed -i 's@$(prefix)/LessTif@$(prefix)/share/LessTif@g'</command>:
This moves the location of the non-FHS compliant
<filename class="directory">/usr/LessTif</filename> directory to
<filename class="directory">/usr/share/LessTif</filename>.</para>
 
<para><parameter>--enable-build-21</parameter>: Build the
<application>Motif</application> 2.1 compatible version of the
<application>LessTif</application> libraries.</para>
 
<para><parameter>--disable-debug</parameter>: Do not generate debugging
information.</para>
 
<para><parameter>--enable-production</parameter>: Build the release version
of the <application>LessTif</application> libraries.</para>
 
<para><parameter>--disable-build-tests</parameter>: Do not build the
<filename class="directory">test/</filename> tree (see Testing
<application>LessTif</application>).</para>
 
<para><parameter>--with-xdnd</parameter>: Enable <acronym>XDND</acronym>
<acronym>GNOME</acronym> compatibility support.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>LessTif</application></title>
 
<sect3><title>Configuration Information</title>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
 
</sect3>
 
</sect2>
 
<sect2>
<title>Testing <application>LessTif</application></title>
 
<para>It is advisable to test the installation of
<application>LessTif</application> with the test suite located in
<filename class="directory">lesstif-&lesstif-version;/test</filename>. It is
not required to install any of the resulting binaries to validate the
installation. The following commands executed from the source
directory will suffice:</para>
 
<screen><userinput><command>cd test &amp;&amp;
./configure &amp;&amp;
make</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>LessTif</application> package contains
<command>mxmkmf</command>, <command>mwm</command>,
<command>xmbind</command>, <command>uil</command> and
<application>LessTif</application> libraries.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>mxmkmf</title>
<para><command>mxmkmf</command> is the <application>LessTif</application>
version of <command>xmkmf</command> which creates a
<filename>Makefile</filename> from an <filename>Imakefile</filename></para>
</sect3>
 
<sect3><title>mwm</title>
<para><command>mwm</command> is a window manager that adheres largely to the
<application>Motif</application> <command>mwm</command> specification.</para>
</sect3>
 
<sect3><title>xmbind</title>
<para><command>xmbind</command> configures the virtual key bindings of
<application>LessTif</application> applications</para>
</sect3>
 
<sect3><title>uil</title>
<para><command>uil</command> is a user interface language compiler which
translates a plain text description of the user interface of a
<application>Motif</application> application into a machine-readable form.
</para>
</sect3>
 
<sect3><title>lesstif libraries</title>
<para><application>LessTif</application> libraries are an
<application><acronym>OSF</acronym>/Motif(R)</application> source code
compatible library for the <application>X</application> Window System.</para>
</sect3>
 
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/x/lib/libxklavier.xml
0,0 → 1,78
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY libxklavier-download-http "http://prdownloads.sourceforge.net/gswitchit/libxklavier-&libxklavier-version;.tar.gz">
<!ENTITY libxklavier-download-ftp " ">
<!ENTITY libxklavier-md5sum "1a4c6b95bc74bccaf5a7e394f928a54f">
<!ENTITY libxklavier-size "425 KB">
<!ENTITY libxklavier-buildsize "6.0 MB">
<!ENTITY libxklavier-time "0.11 SBU">
]>
 
<sect1 id="libxklavier" xreflabel="libxklavier-&libxklavier-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="libxklavier.html" ?>
<title>libxklavier-&libxklavier-version;</title>
 
<sect2>
<title>Introduction to <application>libxklavier</application></title>
 
<para>The <application>libxklavier</application> package contains a
utility library for <application>X</application> keyboard.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&libxklavier-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&libxklavier-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &libxklavier-md5sum;</para></listitem>
<listitem><para>Download size: &libxklavier-size;</para></listitem>
<listitem><para>Estimated disk space required:
&libxklavier-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&libxklavier-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>libxklavier</application> dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="pkgconfig"/> and
<xref linkend="libxml2"/></para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="doxygen"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>libxklavier</application></title>
 
<para>Install <application>libxklavier</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>libxklavier</application> package contains
<filename>libxklavier</filename> libraries.</para>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/x/lib/freeglut.xml
0,0 → 1,102
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY freeglut-download-http "http://prdownloads.sourceforge.net/freeglut/freeglut-&freeglut-version;.tar.gz">
<!ENTITY freeglut-download-ftp "ftp://ftp.freestandards.org/pub/lsb/app-battery/packages/freeglut-&freeglut-version;.tar.gz">
<!ENTITY freeglut-md5sum "9439b8745f443131c2dad00bc93dc0ef">
<!ENTITY freeglut-size "379 KB">
<!ENTITY freeglut-buildsize "6.0 MB">
<!ENTITY freeglut-time "0.13 SBU">
]>
 
<sect1 id="freeglut" xreflabel="freeglut-&freeglut-version;">
<sect1info>
<othername>$LastChangedBy: igor $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="freeglut.html"?>
<title>freeglut-&freeglut-version;</title>
 
<indexterm zone="freeglut">
<primary sortas="a-freeglut">freeglut</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application>freeglut</application></title>
 
<para><application>freeglut</application> is intended to be a 100% compatible,
completely opensourced clone of the <acronym>GLUT</acronym> library.
<acronym>GLUT</acronym> is a window system independent toolkit for
writing OpenGL programs, implementing a simple windowing API, which
makes learning about and exploring OpenGL programming very easy.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing="compact">
<listitem><para>Download (HTTP): <ulink url="&freeglut-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&freeglut-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &freeglut-md5sum;</para></listitem>
<listitem><para>Download size: &freeglut-size;</para></listitem>
<listitem><para>Estimated disk space required: &freeglut-buildsize;</para></listitem>
<listitem><para>Estimated build time: &freeglut-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3><title><application>freeglut</application> dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>freeglut</application></title>
 
<para>Install <application>freeglut</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libglut.{so,a}</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="libglut">
<term><filename class='libraryfile'>libglut.{so,a}</filename></term>
<listitem>
<para>contains functions that implement the OpenGL Utility Toolkit.</para>
<indexterm zone="freeglut libglut">
<primary sortas="c-libglut">libglut.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
 
</sect2>
</sect1>
/tags/tBLFS-6_0/blfs/x/lib/atk.xml
0,0 → 1,118
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY atk-download-http "http://ftp.gnome.org/pub/GNOME/sources/atk/1.9/atk-&atk-version;.tar.bz2">
<!ENTITY atk-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/atk/1.9/atk-&atk-version;.tar.bz2">
<!ENTITY atk-md5sum "7f41bd9c6dcd83c8df391dc1805be653">
<!ENTITY atk-size "506 KB">
<!ENTITY atk-buildsize "7.9 MB">
<!ENTITY atk-time "0.11 SBU">
]>
 
<sect1 id="atk" xreflabel="ATK-&atk-version;">
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="atk.html" ?>
<title>ATK-&atk-version;</title>
 
<indexterm zone="atk">
<primary sortas="a-atk">atk</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application><acronym>ATK</acronym></application></title>
 
<para>The <application><acronym>ATK</acronym></application> package contains the
<application><acronym>ATK</acronym></application> libraries. They are useful for
allowing accessibility solutions to be available for all
<application><acronym>GTK</acronym>2</application>
applications.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&atk-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&atk-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &atk-md5sum;</para></listitem>
<listitem><para>Download size: &atk-size;</para></listitem>
<listitem><para>Estimated disk space required: &atk-buildsize;</para></listitem>
<listitem><para>Estimated build time: &atk-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3>
<title><application><acronym>ATK</acronym></application> dependencies</title>
 
<sect4>
<title>Required</title>
<para><xref linkend="glib2"/></para>
</sect4>
 
<sect4>
<title>Optional</title>
<para><xref linkend="gtk-doc"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application><acronym>ATK</acronym></application></title>
 
<para>Install <application><acronym>ATK</acronym></application> by running the following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><option>--enable-gtk-doc</option>: This switch will rebuild
the <acronym>API</acronym> documentation during the
<command>make</command> command.</para>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libatk-1.0.so</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="libatk">
<term><filename class='libraryfile'>atklib-1.0.so</filename></term>
<listitem>
<para>contains functions that are used by assistive technologies in order to
interact with the desktop and applications.</para>
<indexterm zone="atk libatk">
<primary sortas="c-libatk">libatk-1.0.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/x/x.xml
0,0 → 1,16
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
 
<part id="x" xreflabel="X and Window Managers">
<?dbhtml filename="x.html" dir="x"?>
<title>X + Window Managers</title>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="installing/installing.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="lib/lib.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="wm/wm.xml"/>
 
</part>
/tags/tBLFS-6_0/blfs/general/sysutils/apache-ant.xml
0,0 → 1,255
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY apache-ant-download-http "http://www.apache.org/dist/ant/source/apache-ant-&apache-ant-version;-src.tar.bz2">
<!ENTITY apache-ant-download-ftp "ftp://ftp.oregonstate.edu/pub/apache/ant/source/apache-ant-&apache-ant-version;-src.tar.bz2">
<!ENTITY apache-ant-md5sum "83c3adefdbf90bcbc4b804d4c55c0778">
<!ENTITY apache-ant-size "6.2 MB">
<!ENTITY apache-ant-buildsize "90 MB">
<!ENTITY apache-ant-time "0.47 SBU">
]>
 
<sect1 id="apache-ant" xreflabel="Apache Ant-&apache-ant-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-07-29 07:17:28 $</date>
</sect1info>
<?dbhtml filename="apache-ant.html"?>
<title>Apache Ant-&apache-ant-version;</title>
<indexterm zone="apache-ant">
<primary sortas="a-Apache-Ant">Apache Ant</primary></indexterm>
 
<sect2>
<title>Introduction à <application>Apache Ant</application></title>
 
<para>The <application>Apache Ant</application> package is a
<application>Java</application>-based build tool. In theory, it is kind of
like <command>make</command>, but without <command>make</command>'s wrinkles.
Ant is different. Instead of a model where it is extended with shell-based
commands, Ant is extended using <application>Java</application> classes.
Instead of writing shell commands, the configuration files are
<acronym>XML</acronym>-based, calling out a target tree where various tasks
get executed. Each task is run by an object that implements a particular task
interface.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing="compact">
<listitem><para>Téléchargement (HTTP)&nbsp;:
<ulink url="&apache-ant-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;:
<ulink url="&apache-ant-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &apache-ant-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&apache-ant-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&apache-ant-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&apache-ant-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Téléchargements supplémentaires</title>
<itemizedlist spacing="compact">
<listitem><para>Required Patch: <ulink
url="&patch-root;/apache-ant-&apache-ant-version;-blfs_install-1.patch"/></para>
</listitem></itemizedlist>
</sect3>
 
<sect3><title><application>Apache Ant</application> dependencies</title>
<sect4><title>Requis</title>
<para><xref linkend="j2sdk"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>Apache Ant</application></title>
 
<para>Note: you may need additional libraries to satisify the build
requirements of various packages installed using
<application>Apache Ant</application>. Review the table at
<ulink url="http://ant.apache.org/manual/install.html#librarydependencies"/>
for any prerequisite libraries you may need. One such library is the
<application>JUnit</application> testing framework library. Many Ant-installed
packages will use this library to perform the unit tests during the build
process. To install the JUnit library along with the
<application>Apache Ant</application> package, download it from
<ulink url="http://www.junit.org/"/>, unzip the distribution file (requires
<xref linkend="unzip"/>) and copy the <filename>junit.jar</filename> file
into the <filename class='directory'>lib</filename> subdirectory of the
<application>Apache Ant</application> source tree before beginning the
<application>Apache Ant</application> build.</para>
 
<para>Install <application>Apache Ant</application> by running the following
commands:</para>
 
<screen><userinput><command>patch -Np1 -i ../apache-ant-&apache-ant-version;-blfs_install-1.patch</command></userinput></screen>
 
<para>Maintenant, en tant qu'utilisateur root&nbsp;:</para>
 
<screen><userinput role='root'><command>./build.sh -Ddist.dir=/opt/ant-&apache-ant-version; dist &amp;&amp;
ln -sf /etc/ant /opt/ant-&apache-ant-version;/etc &amp;&amp;
ln -sf ant-&apache-ant-version; /opt/ant</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Explications des commandes</title>
 
<para><command>./build.sh -Ddist.dir=/opt/ant-&apache-ant-version;
dist</command>: This command does everything. It builds the package, then
installs the package into
<filename class='directory'>/opt/ant-&apache-ant-version;</filename>.</para>
 
<para><command>ln -sf /etc/ant /opt/ant-&apache-ant-version;/etc</command>:
The patch changes the configuration directory to
<filename class='directory'>/etc/ant</filename> to conform with
<acronym>FHS</acronym> guidelines. This command creates a symlink from the
configuration directory back to the installation directory as the package is
expecting to find the files there.</para>
 
<para><command>ln -sf ant-&apache-ant-version; /opt/ant</command>: This
command is optional, and creates a convenience symlink.</para>
 
</sect2>
 
<sect2>
<title>Configurer <application>Apache Ant</application></title>
 
<sect3 id="apache-ant-config"><title>Fichiers de configuration</title>
<para><filename>/etc/ant/ant.conf</filename>,
<filename>~/.ant/ant.conf</filename> and
<filename>~/.antrc</filename></para>
<indexterm zone="apache-ant apache-ant-config">
<primary sortas="e-AA.ant-ant.conf">~/.ant/ant.conf</primary></indexterm>
<indexterm zone="apache-ant apache-ant-config">
<primary sortas="e-AA.antrc">~/.antrc</primary></indexterm>
<indexterm zone="apache-ant apache-ant-config">
<primary sortas="e-etc-ant-ant.conf">/etc/ant/ant.conf</primary></indexterm>
</sect3>
 
<sect3><title>Informations de configuration</title>
<para>Some packages will require <command>ant</command> to be in the search
path and the <envar>$ANT_HOME</envar> environment variable defined.
Satisfy these requirements by adding the following lines to
<filename>/etc/profile</filename> or to individual user's
<filename>~/.profile</filename> or <filename>~/.bashrc</filename> files:</para>
 
<screen><userinput>export PATH=$PATH:/opt/ant/bin
export ANT_HOME=/opt/ant</userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<segmentedlist>
<segtitle>Programmes installés</segtitle>
<segtitle>Bibliothèques installées</segtitle>
<segtitle>Répertoires installés</segtitle>
 
<seglistitem>
<seg>ant, antRun, antRun.pl, complete-ant-cmd.pl, runant.pl and runant.py</seg>
<seg>ant-*.jar, xercesImpl.jar and xml-apis.jar</seg>
<seg>/etc/ant and /opt/ant-&apache-ant-version;</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Descriptions courtes</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="ant">
<term><command>ant</command></term>
<listitem><para>is a <application>Java</application> based build tool used by
many packages instead of the conventional <command>make</command>
program.</para>
<indexterm zone="apache-ant ant">
<primary sortas="b-ant">ant</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="antRun">
<term><command>antRun</command></term>
<listitem><para>is a support script used to start <command>ant</command>
build scripts in a given directory.</para>
<indexterm zone="apache-ant antRun">
<primary sortas="b-antRun">antRun</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="antRun.pl">
<term><command>antRun.pl</command></term>
<listitem><para>is a <application>Perl</application> script that provides
similar functionality offered by the <command>antRun</command> script.</para>
<indexterm zone="apache-ant antRun.pl">
<primary sortas="b-antRun.pl">antRun.pl</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="complete-ant-cmd.pl">
<term><command>complete-ant-cmd.pl</command></term>
<listitem><para>is a <application>Perl</application> script that allows
<application>Bash</application> to complete an <command>ant</command>
command-line.</para>
<indexterm zone="apache-ant complete-ant-cmd.pl">
<primary sortas="b-complete-ant-cmd.pl">complete-ant-cmd.pl</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="runant.pl">
<term><command>runant.pl</command></term>
<listitem><para>is a <application>Perl</application> wrapper script used to
invoke <command>ant</command>.</para>
<indexterm zone="apache-ant runant.pl">
<primary sortas="b-runant.pl">runant.pl</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="runant.py">
<term><command>runant.py</command></term>
<listitem><para>is a <application>Python</application> wrapper script used to
invoke <command>ant</command>.</para>
<indexterm zone="apache-ant runant.py">
<primary sortas="b-runant.py">runant.py</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="ant-star">
<term><filename class='libraryfile'>ant-*.jar</filename></term>
<listitem><para>files are the <application>Apache Ant</application>
<application>Java</application> class libraries.</para>
<indexterm zone="apache-ant ant-star">
<primary sortas="c-ant-star">ant-*.jar</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="xercesImpl">
<term><filename class='libraryfile'>xercesImpl.jar</filename></term>
<listitem><para>is a <application>Java</application> class library used by
<application>Apache Ant</application> to perform <acronym>XML</acronym>
parsing.</para>
<indexterm zone="apache-ant xercesImpl">
<primary sortas="c-xercesImpl">xercesImpl.jar</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="xml-apis">
<term><filename class='libraryfile'>xml-apis.jar</filename></term>
<listitem><para>contains the <acronym>DOM</acronym>
<application>Java</application> classes required by the
<application>Apache Ant</application> <acronym>XML</acronym> formatter.</para>
<indexterm zone="apache-ant xml-apis">
<primary sortas="c-xml-apis">xml-apis.jar</primary>
</indexterm></listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/general/sysutils/which.xml
0,0 → 1,118
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY which-download-http "http://www.xs4all.nl/~carlo17/which/which-&which-version;.tar.gz">
<!ENTITY which-download-ftp "ftp://ftp.gnu.org/gnu/which/which-&which-version;.tar.gz">
<!ENTITY which-md5sum "830b83af48347a9a3520f561e47cbc9b">
<!ENTITY which-size "123 KB">
<!ENTITY which-buildsize "940 KB">
<!ENTITY which-time "0.03 SBU">
]>
 
<sect1 id="which" xreflabel="which-&which-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-07-29 07:17:28 $</date>
</sect1info>
<?dbhtml filename="which.html"?>
<title><application>which</application>-&which-version; et des alternatives</title>
<indexterm zone="which">
<primary sortas="a-Which">Which</primary></indexterm>
 
<para>La présence ou l'absence du programme <command>which</command> dans le
livre principal, <acronym>LFS</acronym>, est probablement un des problèmes les
plus conflictuels sur les listes de discussion. Cela a résulté en au moins une
guerre de clocher dans le passé. Pour mettre un terme à ceci une fois pour
toutes, deux solutions sont présentées ici pour équiper votre système avec
<command>which</command>. Le choix du <quote><command>which</command></quote>
à installer est vôtre.</para>
 
<para>La première option est d'installer le programme <acronym>GNU</acronym>
<emphasis>which</emphasis>.</para>
 
<sect2>
<title>Introduction à <application>which</application></title>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;: <ulink
url="&which-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;: <ulink
url="&which-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &which-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&which-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&which-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&which-time;</para></listitem></itemizedlist>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>which</application></title>
 
<para>Installez <application>which</application> en exécutant les commandes
suivantes&nbsp;:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
 
<para>Maintenant, en tant qu'utilisateur root&nbsp;:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<segmentedlist>
<segtitle>Programme installé</segtitle>
<segtitle>Bibliothèques installées</segtitle>
<segtitle>Répertoires installés</segtitle>
 
<seglistitem>
<seg>which</seg>
<seg>Aucune</seg>
<seg>Aucun</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Descriptions courtes</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="which-prog">
<term><command>which</command></term>
<listitem><para>affiche le chemin complet des commandes installées dans votre
<envar>PATH</envar>.</para>
<indexterm zone="which which-prog">
<primary sortas="b-which">which</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
<sect2>
<title>Le script 'which'</title>
<para>La seconde option (pour ceux qui ne veulent pas installer le programme)
est de créer un petit script (exécuté en tant qu'utilisateur root)&bsp;:</para>
 
<screen><userinput role='root'><command>cat &gt; /usr/bin/which &lt;&lt; "EOF"</command>
#!/bin/bash
type -pa "$@" | head -n 1 ; exit ${PIPESTATUS[0]}
<command>EOF
chmod 755 /usr/bin/which
chown root:root /usr/bin/which</command></userinput></screen>
 
<para>Ceci fonctionnera bien et est probablement la solution la plus simple
dans la plupart des cas, mais ce n'est pas l'implémentation la plus complète.</para>
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/general/sysutils/zip.xml
0,0 → 1,136
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY zip-download-http "http://www.mirrorservice.org/sites/ftp.info-zip.org/pub/infozip/src/zip231.tar.gz">
<!ENTITY zip-download-ftp "ftp://ftp.info-zip.org/pub/infozip/src/zip231.tar.gz">
<!ENTITY zip-md5sum "6bfc076664416251d7624ab3538d1cb9">
<!ENTITY zip-size "781 KB">
<!ENTITY zip-buildsize "4.1 MB">
<!ENTITY zip-time "0.04 SBU">
]>
 
<sect1 id="zip" xreflabel="Zip-&zip-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-07-29 07:17:28 $</date>
</sect1info>
<?dbhtml filename="zip.html"?>
<title>Zip-&zip-version;</title>
<indexterm zone="zip">
<primary sortas="a-Zip">Zip</primary></indexterm>
 
<sect2>
<title>Introduction à <application>Zip</application></title>
 
<para>Le paquetage <application>Zip</application> contient les outils
<application>Zip</application>. Ils sont utilisés pour compresser des
fichiers dans des archives <filename>ZIP</filename>.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;: <ulink
url="&zip-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;: <ulink
url="&zip-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &zip-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&zip-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&zip-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&zip-time;</para></listitem></itemizedlist>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>Zip</application></title>
 
<para>Installez <application>Zip</application> en exécutant les commandes
suivantes&nbsp;:</para>
 
<screen><userinput><command>make prefix=/usr -f unix/Makefile generic_gcc</command></userinput></screen>
 
<para>Maintenant, en tant qu'utilisateur root&nbsp;:</para>
 
<screen><userinput role='root'><command>make prefix=/usr -f unix/Makefile install &amp;&amp;
install -v -m644 man/zip.1 /usr/share/man/man1</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Explications des commandes</title>
 
<para><command>make prefix=/usr -f unix/Makefile generic_gcc</command>&nbsp;: cette
commande surcharge la variable <varname>prefix</varname> qui est configuré à
<filename class='directory'>/usr/local</filename> dans le fichier
<filename>unix/Makefile</filename> utilisé comme
<command>Makefile</command> et construit les exécutables pour un système Linux.
Les alternatives à 'generic_gcc' peuvent être vues avec la commande
<command>make -f unix/Makefile list</command>.</para>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<segmentedlist>
<segtitle>Programmes installés</segtitle>
<segtitle>Bibliothèques installées</segtitle>
<segtitle>Répertoires installés</segtitle>
 
<seglistitem>
<seg>zip, zipcloak, zipnote, zipsplit</seg>
<seg>Aucune</seg>
<seg>Aucun</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Descriptions courtes</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="zip-prog">
<term><command>zip</command></term>
<listitem><para>compresse des fichiers dans une archive <filename>ZIP</filename>.
</para>
<indexterm zone="zip zip-prog">
<primary sortas="b-zip">zip</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="zipcloak">
<term><command>zipcloak</command></term>
<listitem><para>est désactivé dans cette version de <application>Zip</application>.
Il affichera un message sur la façon de supporter le cryptage en recompilant avec
<filename>zcrypt27.zip</filename>.</para>
<indexterm zone="zip zipcloak">
<primary sortas="b-zipcloak">zipcloak</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="zipnote">
<term><command>zipnote</command></term>
<listitem><para>lit ou écrit des commentaires stockés dans un fichier
<filename>ZIP</filename>.</para>
<indexterm zone="zip zipnote">
<primary sortas="b-zipnote">zipnote</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="zipsplit">
<term><command>zipsplit</command></term>
<listitem><para>est un outil pour diviser des fichiers <filename>ZIP</filename>
en des fichiers plus petits.</para>
<indexterm zone="zip zipsplit">
<primary sortas="b-zipsplit">zipsplit</primary>
</indexterm></listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/general/sysutils/gpm.xml
0,0 → 1,226
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY gpm-download-http " ">
<!ENTITY gpm-download-ftp "ftp://arcana.linux.it/pub/gpm/gpm-&gpm-version;.tar.bz2">
<!ENTITY gpm-md5sum "2c63e827d755527950d9d13fe3d87692">
<!ENTITY gpm-size "556 KB">
<!ENTITY gpm-buildsize "6.7 MB">
<!ENTITY gpm-time "0.09 SBU">
]>
 
<sect1 id="gpm" xreflabel="GPM-&gpm-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-07-29 07:17:28 $</date>
</sect1info>
<?dbhtml filename="gpm.html"?>
<title><acronym>GPM</acronym>-&gpm-version;</title>
<indexterm zone="gpm">
<primary sortas="a-GPM">GPM</primary></indexterm>
 
<sect2>
<title>Introduction à <application><acronym>GPM</acronym></application></title>
 
<para>Le paquetage <application><acronym>GPM</acronym></application> (un demon
à usage général pour la souris) contient un serveur de souris pour la console
et <command>xterm</command>. Il fournit non seulement un support du copier/coller
mais sa bibliothèque est utilisé par de nombreux logiciels comme
<application>Links</application> pour fournir un support de la souris à
l'application. C'est utile pour les bureaux, spécialement en suivant les
instructions de (B)LFS&bsp;; il est souvent plus facile et prête moins à l'erreur
de copier/coller entre deux consoles que de tout saisir manuellement&nbsp;!</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;: <ulink
url="&gpm-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;: <ulink
url="&gpm-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &gpm-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&gpm-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&gpm-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&gpm-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Téléchargements supplémentaires</title>
<itemizedlist spacing='compact'>
<listitem><para>Correctif recommandé&nbsp;: <ulink
url="&patch-root;/gpm-&gpm-version;-segfault-1.patch"/></para></listitem>
<listitem><para>Correctif recommandé&nbsp;: <ulink
url="&patch-root;/gpm-&gpm-version;-silent-1.patch"/></para></listitem>
</itemizedlist>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application><acronym>GPM</acronym></application></title>
 
<para>Installez <application><acronym>GPM</acronym></application> en exécutant
les commandes suivantes&nbsp;:</para>
 
<screen><userinput><command>patch -Np1 -i ../gpm-&gpm-version;-segfault-1.patch &amp;&amp;
patch -Np1 -i ../gpm-&gpm-version;-silent-1.patch &amp;&amp;
LDFLAGS="-lm" ./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make</command></userinput></screen>
 
<para>Maintenant, en tant qu'utilisateur root&nbsp;:</para>
 
<screen><userinput role='root'><command>make install &amp;&amp;
cp conf/gpm-root.conf /etc &amp;&amp;
ldconfig</command></userinput></screen>
</sect2>
 
<sect2>
<title>Explications des commandes</title>
 
<para><command>LDFLAGS="-lm"</command>&nbsp;: la bibliothèque math doit être
liée avec <command>gpm</command> car ceil() est utilisée dans une logique
de déplacement de curseur.</para>
 
<!-- <para><command>ldconfig -n -l </command>: During installation, gpm outputs a
message to run the above command to create the proper library links.</para> -->
 
</sect2>
 
<sect2>
<title>Configurer <application><acronym>GPM</acronym></application></title>
 
<sect3 id="gpm-init"><title>Script de démarrage gpm</title>
<indexterm zone="gpm gpm-init">
<primary sortas="f-gpm-init">gpm</primary></indexterm>
 
<para>Installez le script de démarrage <filename>/etc/rc.d/init.d/gpm</filename>
inclus dans le paquetage <xref linkend="intro-important-bootscripts"/>.</para>
 
<screen><userinput role='root'><command>make install-gpm</command></userinput></screen>
</sect3>
 
<sect3 id="gpm-config"><title>Fichiers de configuration</title>
 
<para><filename>/etc/gpm-root.conf</filename> et
<filename>~/.gpm-root</filename>&nbsp;: les fichiers de configuration par défaut
et par utilisateur de <command>gpm-root</command>.</para>
 
<para><filename>/etc/sysconfig/mouse</filename>&nbsp;: ce fichier contient le
nom de votre périphérique souris et le protocole qu'il utilise. Pour créer ce
fichier, exécutez ce qui suit en tant qu'utilisateur root&nbsp;:</para>
 
<screen><userinput role='root'><command>cat &gt; /etc/sysconfig/mouse &lt;&lt; "EOF"</command>
# Début /etc/sysconfig/mouse
 
MDEVICE="<replaceable>[yourdevice]</replaceable>"
PROTOCOL="<replaceable>[yourprotocol]</replaceable>"
GPMOPTS="<replaceable>[additional options]</replaceable>"
 
# Fin /etc/sysconfig/mouse
<command>EOF</command></userinput></screen>
 
<indexterm zone="gpm gpm-config">
<primary sortas="e-AA.gpm-root">~/.gpm-root</primary></indexterm>
<indexterm zone="gpm gpm-config">
<primary sortas="e-etc-gpm-root.conf">/etc/gpm-root.conf</primary></indexterm>
<indexterm zone="gpm gpm-config">
<primary sortas="e-etc-sysconfig-mouse">/etc/sysconfig/mouse</primary>
</indexterm>
</sect3>
 
<sect3><title>Informations de configuration</title>
 
<para>Voici quelques exemples de valeurs pour configurer <envar>MDEVICE</envar>,
<envar>PROTOCOL</envar> et <envar>GPMOPTS</envar>&nbsp;:</para>
 
<screen><userinput>MDEVICE="/dev/psaux"
PROTOCOL="imps2"
GPMOPTS=""</userinput></screen>
 
<para>Une liste des protocoles connus sont disponibles en exécutant
<command>gpm -t -help</command>. Le paramètre <envar>MDEVICE</envar> dépend du
type de souris que vous avez. Par exemple, <filename>/dev/ttyS0</filename> pour
une souris série (sur Windows, il s'agit de COM1),
<filename>/dev/input/mice</filename> est souvent utilisé pour les souris
<acronym>USB</acronym> et <filename>/dev/psaux</filename> pour les souris PS2 .
<envar>GPMOPTS</envar> est la variable pour toutes les autres options nécessaire
pour votre matériel.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<segmentedlist>
<segtitle>Programmes installés</segtitle>
<seglistitem>
<seg>disable-paste, gpm, gpm-root, hltest, mev et mouse-test</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Descriptions courtes</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="disable-paste">
<term><command>disable-paste</command></term>
<listitem><para>est un mécanisme de sécurité utilisé pour désactiver le tampon
de collage.</para>
<indexterm zone="gpm disable-paste">
<primary sortas="b-disable-paste">disable-paste</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="gpm-prog">
<term><command>gpm</command></term>
<listitem><para>est un outil pour copier/coller et un serveur de souris pour les
consoles virtuelles.</para>
<indexterm zone="gpm gpm-prog">
<primary sortas="b-gpm">gpm</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="gpm-root">
<term><command>gpm-root</command></term>
<listitem><para>est un gestionnaire par défaut pour <command>gpm</command>. Il
est utilisé pour dessiner des menus sur la fenêtre principale.</para>
<indexterm zone="gpm gpm-root">
<primary sortas="b-gpm-root">gpm-root</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="hltest">
<term><command>hltest</command></term>
<listitem><para>est une application d'exemple utilisant la bibliothèque de
haut niveau. Elle a pour but d'être lue par les développeurs essayant d'utiliser
cette bibliothèque.</para>
<indexterm zone="gpm hltest">
<primary sortas="b-hltest">hltest</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="mev">
<term><command>mev</command></term>
<listitem><para>est un programme rapportant les événements de la souris.</para>
<indexterm zone="gpm mev">
<primary sortas="b-mev">mev</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="mouse-test">
<term><command>mouse-test</command></term>
<listitem><para>est un outil pour déterminer le type de souris et le
périphérique auquel il est attaché.</para>
<indexterm zone="gpm mouse-test">
<primary sortas="b-mouse-test">mouse-test</primary></indexterm>
</listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/general/sysutils/unzip.xml
0,0 → 1,134
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY unzip-download-http "http://www.mirrorservice.org/sites/ftp.info-zip.org/pub/infozip/src/unzip551.tar.gz">
<!ENTITY unzip-download-ftp "ftp://ftp.info-zip.org/pub/infozip/src/unzip551.tar.gz">
<!ENTITY unzip-md5sum "8a25712aac642430d87d21491f7c6bd1">
<!ENTITY unzip-size "1.1 MB">
<!ENTITY unzip-buildsize "6.5 MB">
<!ENTITY unzip-time "0.11 SBU">
]>
 
<sect1 id="unzip" xreflabel="UnZip-&unzip-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-07-29 07:17:28 $</date>
</sect1info>
<?dbhtml filename="unzip.html"?>
<title>UnZip-&unzip-version;</title>
 
<sect2>
<title>Introduction à <application>UnZip</application></title>
 
<para>Le paquetage <application>UnZip</application> contient des outils
d'extraction <filename>ZIP</filename>. Ils sont utiles pour extraire des fichiers
d'archives <filename>ZIP</filename>. Les archives <filename>ZIP</filename> sont
créés avec les outils <application>PKZIP</application> ou
<application>Info-ZIP</application> principalement dans un environnement
<acronym>DOS</acronym>.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;: <ulink
url="&unzip-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;: <ulink
url="&unzip-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &unzip-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&unzip-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&unzip-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&unzip-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Téléchargements supplémentaires</title>
<itemizedlist spacing='compact'>
<listitem><para>Correctif requis&nbsp;: <ulink
url="&patch-root;/unzip-&unzip-version;-fix_Makefile-1.patch"/></para>
</listitem>
<listitem><para>Correctif requis&nbsp;: <ulink
url="&patch-root;/unzip-&unzip-version;-fix_libz-1.patch"/></para>
</listitem>
<listitem><para>Correctif recommandé&nbsp;: <ulink
url="&patch-root;/unzip-&unzip-version;-dont_make_noise-1.patch"/></para>
</listitem></itemizedlist>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>UnZip</application></title>
 
<para>Installez <application>UnZip</application> en exécutant les commandes
suivantes&nbsp;:</para>
 
<screen><userinput><command>patch -Np1 -i ../unzip-&unzip-version;-fix_Makefile-1.patch &amp;&amp;
patch -Np1 -i ../unzip-&unzip-version;-fix_libz-1.patch &amp;&amp;
patch -Np1 -i ../unzip-&unzip-version;-dont_make_noise-1.patch &amp;&amp;
cp unix/Makefile . &amp;&amp;
make prefix=/usr LOCAL_UNZIP=-DUSE_UNSHRINK linux &amp;&amp;
make prefix=/usr LOCAL_UNZIP=-DUSE_UNSHRINK linux_shlibz &amp;&amp;
make prefix=/usr LOCAL_UNZIP=-DUSE_UNSHRINK install &amp;&amp;
cp -d libunzip.so* /usr/lib</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Explications des commandes</title>
 
<para><command>make prefix=/usr LOCAL_UNZIP=-DUSE_UNSHRINK linux</command>&nbsp;:
cette commande surcharge la variable <varname>prefix</varname> qui est
configurée à <filename class="directory">/usr/local</filename> dans le
<filename>Makefile</filename>, initialise la variable d'environnement
<envar>LOCAL_UNZIP</envar> pour instruire <application>UnZip</application>
sur l'utilisation de l'algorithme de compression basée sur <acronym>LZW</acronym>
et construit les exécutables pour un système Linux. Les alternatives à 'linux'
sont visibles avec une commande <command>make list</command>.</para>
 
<para><command>make ... linux_shlibz</command>&nbsp;: construit une
<filename>libunzip</filename> partagée et la lie avec
<application>UnZip</application> et <application>zlib</application>.</para>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<para>Le paquetage <application>UnZip</application> contient
<command>unzip</command>, <command>funzip</command>, <command>unzipfsx</command>,
<command>zipgrep</command>, <command>zipinfo</command> et le bibliothèque
<filename class="libraryfile">libunzip</filename>.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>unzip</title>
<para><command>unzip</command> liste, teste et extrait des fichiers à partir de
l'archive <filename>ZIP</filename>.</para></sect3>
 
<sect3><title>funzip</title>
<para><command>funzip</command> autorise la redirection des commandes en sortie
de <command>unzip</command>.</para></sect3>
 
<sect3><title>unzipfsx</title>
<para><command>unzipfsx</command> est le morceau réalisant l'auto-extraction qui
pourra être ajouté à une archive <filename>ZIP</filename>. Les fichiers dans ce
format utilisent permettent au destinataire de décompresser l'archive sans avoir
besoin d'installer <application>UnZip</application>.</para></sect3>
 
<sect3><title>zipgrep</title>
<para><command>zipgrep</command> est un grep pour les archives
<filename>ZIP</filename>.</para></sect3>
 
<sect3><title>zipinfo</title>
<para><command>zipinfo</command> produit des informations techniques sur les
fichiers d'une archive <filename>ZIP</filename>, incluant les droits d'accès,
le cryptage, le type de compression, etc.</para></sect3>
 
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/general/sysutils/fcron.xml
0,0 → 1,230
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY fcron-download-http "http://fcron.free.fr/archives/fcron-&fcron-version;.src.tar.gz">
<!ENTITY fcron-download-ftp "ftp://ftp.seul.org/pub/fcron/fcron-&fcron-version;.src.tar.gz">
<!ENTITY fcron-md5sum "bf39dcef6d0c452f167f5a31a1231e4e">
<!ENTITY fcron-size "390 KB">
<!ENTITY fcron-buildsize "3.4 MB">
<!ENTITY fcron-time "0.10 SBU">
]>
 
<sect1 id="fcron" xreflabel="Fcron-&fcron-version;">
<sect1info>
<othername>$LastChangedBy: dj $</othername>
<date>$Date: 2005-07-29 07:17:28 $</date>
</sect1info>
<?dbhtml filename="fcron.html"?>
<title><application>Fcron</application>-&fcron-version;</title>
<indexterm zone="fcron">
<primary sortas="a-fcron">fcron</primary></indexterm>
 
<sect2>
<title>Introduction à <application>Fcron</application></title>
 
<para>Le paquetage <application>Fcron</application> contient un exécuteur de
commandes périodiques dont le but est de remplacer <application>Vixie
Cron</application>.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;:
<ulink url="&fcron-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;:
<ulink url="&fcron-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &fcron-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&fcron-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&fcron-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&fcron-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Dépendances de <application>Fcron</application></title>
<sect4><title>Optionnel</title>
<para><ulink url="../server/mail.html">MTA</ulink>,
<xref linkend="Linux_PAM"/>,
<ulink url="http://www.nsa.gov/selinux/">SELinux</ulink>,
<xref linkend="docbook-utils"/> et
<ulink url="../postlfs/editors.html">un éditeur texte</ulink> (par défaut,
<xref linkend="vim"/>)</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>Fcron</application></title>
 
<para id="fcron-syslog"><application>Fcron</application> utilise les capacités
cron de <command>syslog</command> pour tracer tous les messages. Comme
<acronym>LFS</acronym> ne vient pas avec cet outil dans
<filename>/etc/syslog.conf</filename>, il est nécessaire de le faire avant
d'installer <application>Fcron</application>. Cette commande ajoutera la ligne
ligne nécessaire dans le fichier <filename>/etc/syslog.conf</filename>
actuel&nbsp;:</para>
<indexterm zone="fcron fcron-syslog">
<primary sortas="e-etc-syslog.conf">/etc/syslog.conf</primary></indexterm>
 
<screen><userinput><command>cat &gt;&gt; /etc/syslog.conf &lt;&lt; "EOF"
# Début de l'ajout de fcron dans /etc/syslog.conf
 
cron.* -/var/log/cron.log
 
# Fin de l'ajout de fcron
EOF</command></userinput></screen>
 
<para>Le fichier de configuration a été modifié, donc recharger le démon
<command>sysklogd</command> activatera les modifications.</para>
 
<screen><userinput><command>/etc/rc.d/init.d/sysklogd reload</command></userinput></screen>
 
<para>Pour des raisons de sécurité, un utilisateur et groupe non privilégiés
doivent être créés pour <application>Fcron</application>&nbsp;:</para>
 
<screen><userinput><command>groupadd fcron &amp;&amp;
useradd -d /dev/null -c "Fcron User" -g fcron -s /bin/false fcron</command></userinput></screen>
 
<para>Installez <application>Fcron</application> en exécutant les commandes
suivantes&nbsp;:</para>
 
<screen><userinput><command>./configure --without-sendmail --with-answer-all=no &amp;&amp;
make</command></userinput></screen>
 
<para>Maintenant, en tant qu'utilisateur root&nbsp;:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Explications des commandes</title>
 
<para><parameter>--without-sendmail</parameter>&nbsp;:
<application>Fcron</application> utilisera le <acronym>MTA</acronym> installé
pour envoyer des courriers électroniques informant des résultats du script
<command>fcron</command>. Omettez ce commutateur et utilisez
<parameter>--with-sendmail=<replaceable>[/chemin/vers/MTA]</replaceable></parameter>
si vous souhaitez utilisez cette fonctionnalité.</para>
 
<para><parameter>--with-answer-all=no</parameter>&nbsp;: après l'installation
des fichiers, le script <command>make install</command> entre dans une routine
de configuration. Le premier test sera soit d'installer un script de démarrage
dans le répertoire <filename class="directory">/etc/rc.d/init.d</filename> avec
les liens appropriés pour les niveaux d'exécution 2, 3, 4 et 5. Le second sera
de stopper tout processus <command>fcron</command> en cours d'exécution et
d'exécuter le nouveau. Comme c'est probablement votre première installation et
qu'un modèle <acronym>BLFS</acronym> est désirable, répondez 'n' aux deux tests.
</para>
 
</sect2>
 
<sect2>
<title>Configurer <application>Fcron</application></title>
 
<sect3 id="fcron-config"><title>Fichiers de configuration</title>
<para><filename>/etc/fcron.conf</filename>,
<filename>/etc/fcron.allow</filename> and
<filename>/etc/fcron.deny</filename></para>
<indexterm zone="fcron fcron-config">
<primary sortas="e-etc-fcron.conf">/etc/fcron.conf</primary></indexterm>
<indexterm zone="fcron fcron-config">
<primary sortas="e-etc-fcron.allow">/etc/fcron.allow</primary></indexterm>
<indexterm zone="fcron fcron-config">
<primary sortas="e-etc-fcron.deny">/etc/fcron.deny</primary></indexterm>
</sect3>
 
<sect3><title>Informations de configuration</title>
<para>Aucune modification n'est nécessaire dans les fichiers de configuration.
Les informations de configuration sont disponibles dans la page man de
<filename>fcron.conf</filename>.</para>
 
<para>Les scripts <command>fcron</command> sont écrits en utilisant
<command>fcrontab</command>. Référez-vous à la page man de
<command>fcrontab</command> pour les paramètres correspondant à votre
situation.</para>
 
<para id="fcron-init">Installez le script de démarrage
<filename>/etc/rc.d/init.d/fcron</filename> à partir du paquetage
<xref linkend="intro-important-bootscripts"/>.</para>
<indexterm zone="fcron fcron-init">
<primary sortas="f-fcron">fcron</primary></indexterm>
 
<screen><userinput><command>make install-fcron</command></userinput></screen>
 
<para id="fcron-pam">Si <application>Linux-<acronym>PAM</acronym></application>
est installé, deux fichiers de configuration <acronym>PAM</acronym> sont installés
dans <filename class='directory'>/etc/pam.d</filename>. Autrement si
<filename class='directory'>/etc/pam.d</filename> n'est pas utilisé, l'installation
ajoutera deux sections de configuration au fichier
<filename>/etc/pam.conf</filename> existant. Vous devez vous assurer que les fichiers
correspondent à vos préférences. Modifiez-les suivant vos besoins.</para>
<indexterm zone="fcron fcron-pam">
<primary sortas="e-etc-pam.d">/etc/pam.d/*</primary></indexterm>
<indexterm zone="fcron fcron-pam">
<primary sortas="e-etc-pam.conf">/etc/pam.conf</primary></indexterm>
</sect3>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<segmentedlist>
<segtitle>Programmes installés</segtitle>
<segtitle>Bibliothèques installées</segtitle>
<segtitle>Répertoires installés</segtitle>
 
<seglistitem>
<seg>fcron, fcrondyn, fcronsighup and fcrontab</seg>
<seg>None</seg>
<seg>/usr/share/doc/fcron-&fcron-version; et /var/spool/fcron</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Descriptions courtes</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="fcron-prog">
<term><command>fcron</command></term>
<listitem><para>est le démon exécutant les scripts de façon périodique.</para>
<indexterm zone="fcron fcron-prog">
<primary sortas="b-fcron">fcron</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="fcrondyn">
<term><command>fcrondyn</command></term>
<listitem><para>est un outil dont le but est d'interagir avec un démon
<command>fcron</command> en cours d'exécution.</para>
<indexterm zone="fcron fcrondyn">
<primary sortas="b-fcrondyn">fcrondyn</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="fcronsighup">
<term><command>fcronsighup</command></term>
<listitem><para>demande à <command>fcron</command> de relire les tables
<application>Fcron</application>.</para>
<indexterm zone="fcron fcronsighup">
<primary sortas="b-fcronsighup">fcronsighup</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="fcrontab">
<term><command>fcrontab</command></term>
<listitem><para>est un programme utilisé pour installer, modifier, afficher et
supprimer les tables utilisées par <command>fcron</command>.</para>
<indexterm zone="fcron fcrontab">
<primary sortas="b-fcrontab">fcrontab</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
/tags/tBLFS-6_0/blfs/general/sysutils/pkgconfig.xml
0,0 → 1,88
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY pkgconfig-download-http "http://www.freedesktop.org/software/pkgconfig/releases/pkgconfig-&pkgconfig-version;.tar.gz">
<!ENTITY pkgconfig-download-ftp "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/pkgconfig-&pkgconfig-version;.tar.gz">
<!ENTITY pkgconfig-md5sum "a7e4f60a6657dbc434334deb594cc242">
<!ENTITY pkgconfig-size "604 KB">
<!ENTITY pkgconfig-buildsize "5.2 MB">
<!ENTITY pkgconfig-time "0.22 SBU">
]>
 
<sect1 id="pkgconfig" xreflabel="pkgconfig-&pkgconfig-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-07-29 07:17:28 $</date>
</sect1info>
<?dbhtml filename="pkgconfig.html"?>
<title><application>pkgconfig</application>-&pkgconfig-version;</title>
 
<sect2>
<title>Introduction à <application>pkgconfig</application></title>
 
<para>Le paquetage <application>pkgconfig</application> contient des outils
pour passer le chemin d'inclusion et/ou les chemins des bibliothèques pour
construire des outils lors de l'exécution de <command>make</command>.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;:
<ulink url="&pkgconfig-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;:
<ulink url="&pkgconfig-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &pkgconfig-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&pkgconfig-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&pkgconfig-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&pkgconfig-time;</para></listitem></itemizedlist>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>pkgconfig</application></title>
 
<para>Installez <application>pkgconfig</application> en exécutant les commandes
suivantes&nbsp;:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Configurer <application>pkgconfig</application></title>
 
<para>Le paramètrage par défaut pour <envar>PKG_CONFIG_PATH</envar> est
<filename>/usr/lib/pkgconfig</filename> à cause du préfixe utilisé pour
installer pkgconfig. Vous pouvez ajouter à <envar>PKG_CONFIG_PATH</envar>
des chemins supplémentaires sur votre système où les fichiers de
<application>pkgconfig</application> sont installés. Notez que
<envar>PKG_CONFIG_PATH</envar> est seulement nécessaire pour la compilation
des paquetages, pas après.</para>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<para>Le paquetage <application>pkgconfig</application> contient
<command>pkg-config</command>.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>pkg-config</title>
<para><command>pkg-config</command> est une fonction renvoyant des
méta-informations sur la bibliothèque spécifiée.</para></sect3>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/general/sysutils/cpio.xml
0,0 → 1,103
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY cpio-download-http "http://ftp.gnu.org/pub/gnu/cpio/cpio-&cpio-version;.tar.gz">
<!ENTITY cpio-download-ftp "ftp://ftp.gnu.org/pub/gnu/cpio/cpio-&cpio-version;.tar.gz">
<!ENTITY cpio-md5sum "76b4145f33df088a5bade3bf4373d17d">
<!ENTITY cpio-size "448 KB">
<!ENTITY cpio-buildsize "5.4 MB">
<!ENTITY cpio-time "0.12 SBU">
]>
 
<sect1 id="cpio" xreflabel="cpio-&cpio-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-07-29 07:17:28 $</date>
</sect1info>
<?dbhtml filename="cpio.html"?>
<title>cpio-&cpio-version;</title>
 
<sect2>
<title>Introduction à <application>cpio</application></title>
 
<para>Le paquetage <application>cpio</application> contient des outils pour
l'archivage.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;: <ulink
url="&cpio-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;: <ulink
url="&cpio-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &cpio-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&cpio-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&cpio-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&cpio-time;</para></listitem></itemizedlist>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>cpio</application></title>
 
<para>Installez <application>cpio</application> en exécutant les commandes
suivantes&nbsp;:</para>
 
<screen><userinput><command>sed -i -e "s/invalid_arg/argmatch_invalid/" src/mt.c &amp;&amp;
./configure CPIO_MT_PROG=mt --prefix=/usr \
--bindir=/bin --libexecdir=/tmp \
--with-rmt=/usr/sbin/rmt &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Explications des commandes</title>
 
<para><command>sed -i -e "s/invalid_arg/argmatch_invalid/" src/mt.c</command>&nbsp;:
cette commande corrige un problème de construction du programme <command>mt</command>.</para>
 
<para><parameter>CPIO_MT_PROG=mt</parameter>&nbsp;: ce paramètre force la
construction et l'installation du programme <command>mt</command>.</para>
 
<para><parameter>--bindir=/bin</parameter>&nbsp;: ce paramètre installe
<command>cpio</command> dans <filename class="directory">/bin</filename> au lieu
de <filename class="directory">/usr/bin</filename>, comme l'indique les
recommandations de <acronym>FHS</acronym>.</para>
 
<para><parameter>--libexecdir=/tmp</parameter>&nbsp;: ce paramètre est utilisé
pour que <filename class='directory'>/usr/libexec</filename> ne soit pas créé.</para>
 
<para><parameter>--with-rmt=/usr/sbin/rmt</parameter>&nbsp;: ce paramètre désactive
la construction du programme <command>rmt</command> car il est déjà installé par le
paquetage <application>tar</application> dans <acronym>LFS</acronym>.</para>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<para>Le paquateg <application>cpio</application> contient
<command>cpio</command> et <command>mt</command>.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>cpio</title>
<para><command>cpio</command> copie des fichiers sur ou à partir d'archives.</para></sect3>
 
<sect3><title>mt</title>
<para><command>mt</command> contrôle les opérations du lecteur de cassettes
magnétiques.</para></sect3>
 
</sect2>
 
</sect1>
 
/tags/tBLFS-6_0/blfs/general/sysutils/sysstat.xml
0,0 → 1,211
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY sysstat-download-http "http://perso.wanadoo.fr/sebastien.godard/sysstat-&sysstat-version;.tar.gz">
<!ENTITY sysstat-download-ftp "ftp://ftp.surfnet.nl/pub/ibiblio/system/status/sysstat-&sysstat-version;.tar.gz">
<!ENTITY sysstat-md5sum "51569230bf82e434919a56b0c7c411ba">
<!ENTITY sysstat-size "124 KB">
<!ENTITY sysstat-buildsize "1.2 MB">
<!ENTITY sysstat-time "0.12 SBU">
]>
 
<sect1 id="sysstat" xreflabel="Sysstat-&sysstat-version;">
<sect1info>
<othername>$LastChangedBy: dj $</othername>
<date>$Date: 2005-07-29 07:17:28 $</date>
</sect1info>
<?dbhtml filename="sysstat.html"?>
<title>Sysstat-&sysstat-version;</title>
<indexterm zone="sysstat">
<primary sortas="a-Sysstat">Sysstat</primary></indexterm>
 
<sect2>
<title>Introduction à <application>Sysstat</application></title>
 
<para>Le paquetage <application>Sysstat</application> contient des outils pour
surveiller les performances et l'activité du système.
<application>Sysstat</application> contient l'outil <command>sar</command>,
commun avec les autres Unix commerciaux, et des outils dont vous pouvez planifier
l'exécution avec cron pour récupérer et conserver un historique des données de
performance et d'activité.</para>
 
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;:
<ulink url="&sysstat-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;:
<ulink url="&sysstat-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;:
&sysstat-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:
&sysstat-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&sysstat-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&sysstat-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Dépendances de <application>Sysstat</application></title>
<sect4><title>Recommandé</title>
<para><xref linkend="fcron"/></para></sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation de <application>Sysstat</application></title>
 
<para>Installez <application>Sysstat</application> en exécutant les commandes
suivantes&nbsp;:</para>
 
<screen><userinput><command>make config &amp;&amp;
make</command></userinput></screen>
 
<para>Maintenant, en tant qu'utilisateur root&nbsp;:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Explications des commandes</title>
 
<para><command>make config</command>&nbsp;: exécute le processus de configuration
interactif. La première question vous demande un répertoire d'installation
(<quote>Installation directory</quote>). Répondez par
<filename class="directory">/usr</filename>, car c'est équivalent au paramètre
<parameter>--prefix=/usr</parameter> d'<application>Autoconf</application> passé
à <command>configure</command>. Pour tout le reste, vous pouvez simplement appuyé
sur <command>Enter</command> pour accepter les valeurs par défaut.</para>
 
</sect2>
 
<sect2>
<title>Configurer <application>Sysstat</application></title>
 
<sect3><title>Information sur cron</title>
 
<para>Pour commencer à conserver un historique avec
<application>Sysstat</application>, vous devez ajouter ou créer une table
de planification (crontab) pour un utilisateur privilégié. L'emplacement
par défaut des données de l'historique est <filename
class="directory">/var/log/sa</filename>. L'utilisateur exécutant les outils
<application>Sysstat</application> via cron doit avoir un accès en écriture
à cet endroit.</para>
 
<para>Ci-dessous est un exemple de ce que vous pouvez installer dans crontab.
Ajustez les paramètres pour que cela corresponde à vos besoins. Utilisez
<command>man sa1</command> et <command>man sa2</command> pour des informations
sur les commandes.</para>
 
<screen><userinput># 8am-7pm activity reports every 10 minutes during weekdays
0 8-18 * * 1-5 /usr/lib/sa/sa1 600 6 &amp;
# 7pm-8am activity reports every hour during weekdays
0 19-7 * * 1-5 /usr/lib/sa/sa1 &amp;
# Activity reports every hour on Saturday and Sunday
0 * * * 0,6 /usr/lib/sa/sa1 &amp;
# Daily summary prepared at 19:05
5 19 * * * /usr/lib/sa/sa2 -A &amp;</userinput></screen>
 
<para>Assurez-vous que vous soumettez la crontab modifiée au démon cron.</para>
</sect3>
 
<sect3 id="sysstat-init"><title>Informations au lancement du système</title>
<indexterm zone="sysstat sysstat-init">
<primary sortas="f-sysstat">sysstat</primary></indexterm>
 
<para>Au lancement du système, un message LINUX RESTART doi être inséré dans le
fichier du jour pour réinitialiser les compteurs du noyau. Ceci peut être
automatisé en installant le script de démarrage
<filename>/etc/rc.d/init.d/sysstat</filename> inclus dans le paquetage <xref
linkend="intro-important-bootscripts"/> avec la commande suivante&nbsp;:</para>
 
<screen><userinput role='root'><command>make install-sysstat</command></userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Contenu</title>
 
<segmentedlist>
<segtitle>Programmes installés</segtitle>
<segtitle>Bibliothèques installées</segtitle>
<segtitle>Répertoires installés</segtitle>
 
<seglistitem>