# HG changeset patch # User Christophe Lincoln # Date 1206788465 -3600 # Node ID 820d0069a6a37a34588e944fa6cea7adb33ea156 # Parent 7f6a249b7cad027f2d5cc57633a055cf34dafc55 French doc with Handbook and Cookbook diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/base-apps.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/base-apps.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,646 @@ + + + + SliTaz Cookbook - Base apps + + + + + + + + + + + + + + + +
+
+ + +

Applications de base

+

+Install et configuration des bibliothèques et des applications de base. +

+ + +

A propos

+

+Ce chapitre décrit l'installations des bibliothèque et des applications de +base en mode texte, fournies avec SliTaz. +

+

Affecter une variable d'environnement ($fs)

+

+Une variable d'environnement permet de ne pas spécifier tout le chemin vers le +répertoire, mais simplement $NomDeVariable. Nous allons afecter un variable '$fs' +pour indiquer le chemin vers le système de fichier racine 'rootfs'. Pour cela vous +pouvez vous placer dans le répertoire de travail de SliTaz, et tapez: +

+
+ # export fs=$PWD/rootfs
+
+

+Pour vérifier: +

+
+ # echo $fs
+
+ +

bc-1.06 - Calculatrice en mode texte

+

+L'application bc +(www.gnu.org/software/bc/) +fourni une petite calculette, lors de la compilation l'utilitaire dc est +aussi construit mais SliTaz ne l'installe pas. A noter que dc est aussi +diponible avec Busybox. Pour la copie de dc, il faut supprimer le liens +de dc vers BusyBox si il existe. Nous utilison un répertoire _pkg (package) +pour l'installation. Un petit nettoyage des exécutables avec strip +et copie des utilitaires: +

+
+ # cd src
+ # wget http://ftp.gnu.org/pub/gnu/bc/bc-1.06.tar.gz
+ # tar xzfv bc-1.06.tar.gz
+ # cd bc-1.06
+ # ./configure --prefix=/usr --infodir=/usr/share/info \
+   --mandir=/usr/share/man
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -vs _pkg/usr/bin/*
+ # cp -avi _pkg/usr/bin/bc $fs/usr/bin
+
+

libs

+

+Un petit ldd sur bc devrait donner: +

+
+        libc.so.6 => /lib/libc.so.6 (0x40029000)
+        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
+
+ +

zlib-1.2.3 - Bibliothèques de compression

+

+Le paquet zlib (http://www.zlib.net/) +fourni des fonctions de compression et de décompression, utilisées entre autre, +par le serveur SSH dropbear et le serveur X: +

+
+ # cd ..
+ # wget http://www.gzip.org/zlib/zlib-1.2.3.tar.bz2
+ # tar xjfv zlib-1.2.3.tar.bz2
+ # cd zlib-1.2.3
+ # ./configure --shared --prefix=/usr
+ # make
+ # strip -vs libz.so*
+ # cp -av libz.so* $fs/usr/lib
+
+ +

pcre-7.4 - Expressions régulières compatible perl

+

+Le paquet pcre (http://www.pcre.org/) +fourni les bibliothèques des fonctions d'expressions régulières compatible +Perl PCRE, utilisées entre autre par le serveur web LightTPD: +

+
+ # cd ..
+ # wget ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-7.4.tar.gz
+ # tar xzfv pcre-7.4.tar.gz
+ # cd pcre-7.4
+ # ./configure --prefix=/usr
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -vs _pkg/usr/bin/*
+ # strip -vs _pkg/usr/lib/*
+ # cp -av _pkg/usr/bin/* $fs/usr/bin
+ # cp -av _pkg/usr/lib/*.so* $fs/usr/lib
+
+ +

e2fsprogs-1.39 - Utilitaires de gestion des systèmes de fichiers

+

+Le paquet e2fsprogs (http://e2fsprogs.sourceforge.net/) fournit les utilitaires pour la +manipulation des systèmes de fichiers ext3 et ext2. Nous n'allons pas tout +prendre, car cela nous fait gangner de la place. A noter que nous utilisons +fsck de Busybox: +

+
+ # cd ..
+ # wget http://puzzle.dl.sourceforge.net/sourceforge/e2fsprogs/e2fsprogs-1.39.tar.gz
+ # tar xzf e2fsprogs-1.39.tar.gz
+ # cd e2fsprogs-1.39
+ # ./configure --prefix=/usr --with-root-prefix="" \
+   --enable-elf-shlibs --disable-evms --sysconfdir=/etc \
+   --infodir=/usr/share/info --mandir=/usr/share/man
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -vs _pkg/sbin/*
+ # strip -vs _pkg/lib/*
+ # strip -vs _pkg/usr/bin/*
+ # strip -vs _pkg/usr/sbin/*
+ # strip -vs _pkg/usr/lib/*
+
+

+Install des utilitaires, des fichiers de configuration, et des bibliothèques +dans le rootfs de SliTaz. Attention si vous avez décidé d'utiliser fsck, +il ne faut pas écraser un lien Busybox: +

+
+ # cp -i _pkg/sbin/{badblocks,blkid,dumpe2fs,e2fsck,e2image} $fs/sbin
+ # cp -i _pkg/sbin/{e2label,findfs,logsave,mke2fs,mkfs.*} $fs/sbin
+ # cp -i _pkg/sbin/{resize2fs,tune2fs} $fs/sbin
+ # cp -a _pkg/lib/* $fs/lib
+ # rm -rf $fs/lib/libss*
+ # cp -a _pkg/etc/* $fs/etc
+ # cp -a _pkg/usr/bin/* $fs/usr/bin
+ # cp -a _pkg/usr/sbin/* $fs/usr/sbin
+ # cp -ad _pkg/usr/lib/*.so $fs/usr/lib
+ # rm -rf $fs/usr/lib/libss*
+
+

+Vous pouvez aussi copier le fichier de la locale pour le français: +

+
+ # mkdir $fs/usr/share/locale
+ # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
+
+ +

dropbear-0.50 - Client et serveur SSH légé

+

+Dropbear (http://matt.ucc.asn.au/dropbear/dropbear.html) est un petit client et +serveur sécurisé, supportant le protocole SSH 2. Dropbear est compatible avec +openSSH, et utilise ~/.ssh/authorized_keys pour la gestion des clés public. Dropbear +fournit aussi une version de scp, qu'il faut compiler avec 'manke scp': +

+
+ # cd ..
+ # wget http://matt.ucc.asn.au/dropbear/releases/dropbear-0.50.tar.gz
+ # tar xzf dropbear-0.50.tar.gz
+ # cd dropbear-0.50
+ # ./configure --prefix=/usr
+ # make
+ # make scp
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v scp
+ # strip -v _pkg/usr/bin/*
+ # strip -v _pkg/usr/sbin/*
+
+

+Install du client, et des outils associés dans /usr/bin, et install +du server dans /usr/sbin: +

+
+ # cp scp $fs/usr/bin
+ # cp -a _pkg/usr/bin/* $fs/usr/bin
+ # cp -a _pkg/usr/sbin/* $fs/usr/sbin
+
+

libs

+
+        libutil.so.1 => /lib/libutil.so.1 (0x40025000)
+        libz.so.1 => /usr/lib/libz.so.1 (0x40028000)
+        libcrypt.so.1 => /lib/libcrypt.so.1 (0x4003b000)
+        libc.so.6 => /lib/libc.so.6 (0x40068000)
+        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
+
+

+Copie de la bibliothèque libutil.so.1 dans $fs/lib, si ce n'est pas déjà le cas. +Les autres bibliothèques devraient être présentes, suite à la construction du +système de base: +

+
+ # cp -a /lib/libutil* $fs/lib
+
+

Configurer Dropbear

+

+Les fichiers de configuration utilisateur sont dans ~/.ssh, contenant +authorized_keys et known_hosts. Les répertoire ~/.ssh et le fichier +known_hosts, sont créés automatiquement la première fois que l'utilisateur +lance dbclient. Les fichiers de configuration système du server Dropbear sont +par défaut dans /etc/dropbear: +

+
+ # mkdir $fs/etc/dropbear
+
+

+Pour que le serveur fonctionnent, il faut générer les clés sécurisées +avant de démarrer le serveur sur SliTaz. Vous pouvez utiliser dropbearkey +avec les commandes ci-dessous: +

+
+ # dropbearkey -t rsa -f /etc/dropbear/dropbear_rsa_host_key
+ # dropbearkey -t dss -f /etc/dropbear/dropbear_dss_host_key
+
+

+Sur SliTaz vous pouvez démarrer le serveur SSH avec la commande : +

+
+ # /etc/init.d/dropbear start
+
+ +

lighttpd-1.4.18 - Serveur web HTTP

+

+LightTPD (www.lighttpd.net) est un +serveur web puissant, léger, et sécurisé. Le projet est très actif, et la +configuration du serveur et simple. Il supporte les hôtes virtuels, les scripts +CGI, et il permet une gestion intelligente de la charge CPU. +

+
+ # cd ..
+ # wget http://www.lighttpd.net/download/lighttpd-1.4.18.tar.gz
+ # tar xzf lighttpd-1.4.18.tar.gz
+ # cd lighttpd-1.4.18
+ # ./configure -enable-shared --disable-ipv6 --prefix=/usr \
+   --libdir=/usr/lib/lighttpd --mandir=/usr/share/man
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -vs _pkg/usr/bin/*
+ # strip -vs _pkg/usr/sbin/*
+ # strip -vs _pkg/usr/lib/lighttpd/*
+
+

+Installation du serveur, et des bibliothèques générées. Nous allons ensuite +supprimer copier seulement quelques modules (9) : +

+
+ # cp _pkg/usr/bin/* $fs/usr/bin
+ # cp _pkg/usr/sbin/* $fs/usr/sbin
+ # mkdir $fs/usr/lib/lighttpd
+ Modules :
+ # cp _pkg/usr/lib/lighttpd/mod_access.so $fs/usr/lib/lighttpd
+ # cp _pkg/usr/lib/lighttpd/mod_accesslog.so $fs/usr/lib/lighttpd
+ # cp _pkg/usr/lib/lighttpd/mod_alias.so $fs/usr/lib/lighttpd
+ # cp _pkg/usr/lib/lighttpd/mod_auth.so $fs/usr/lib/lighttpd
+ # cp _pkg/usr/lib/lighttpd/mod_cgi.so $fs/usr/lib/lighttpd
+ # cp _pkg/usr/lib/lighttpd/mod_compress.so $fs/usr/lib/lighttpd
+ # cp _pkg/usr/lib/lighttpd/mod_rewrite.so $fs/usr/lib/lighttpd
+ # cp _pkg/usr/lib/lighttpd/mod_status.so $fs/usr/lib/lighttpd
+ # cp _pkg/usr/lib/lighttpd/mod_userdir.so $fs/usr/lib/lighttpd
+
+

libs

+

+Il ne devrait vous manquer que libdl.so.2, que nous allons copier: +

+
+ # cp -a /lib/libdl* $fs/lib
+
+

/var/www - Racine des documents du serveur

+

+Le répertoire /var/www est le répertoire racine des documents servis par +défaut. Vous y avez accès via l'url http://localhost/. Ce répertoire peut +contenir une page index.html s'affichant automatiquement lors +d'une requête. Nous allons créer le répertoire /var/www, à vous de vois ce +que vous vouleu y mettre : +

+
+ # mkdir -p $fs/var/www
+
+

lighttpd.conf - Fichier de configuration de LightTPD

+

+Le fichier de configuration principale de LightTPD se trouve dans /etc/lighttpd, +et se nomme lighttpd.conf. Le fichier de configuration fournit par SliTaz est auto +documenté, il suffit de le parcourir. Vous trouverez d'autres exemples sur le site +web de LightTPD. Vous trouverez aussi un exemple de configuration dans /doc +de l'archive de LightTPD: +

+
+ # cp -a ../slitaz-tools-1.1/etc/lighttpd $fs/etc
+
+

+Création du répertoire contenant les fichiers de log: +

+
+ # mkdir $fs/var/log/lighttpd
+
+

Utilisateur et groupe www

+

+Nous allons ajouter un utilisateur et un groupe pour le serveur web, cela ajoute +de la sécurité, et il n'y a aucune raison pour qu'il tourne sous root. L'utilisateur +par défaut sur SliTaz est 'www', mais vous pouvez changer cela dans le fichier de +configuration lighttpd.conf. L'application adduser de Busybox ayant des limitations +nous ajoutons l'utilisateur 'www' manuellement. Nous changeons aussi les permissions +sur le répertoire des logs du serveur web: +

+
+ # echo "www:x:80:80:www:/var/www:/bin/sh" >> $fs/etc/passwd
+ # echo "www:*:13509:0:99999:7:::" >> $fs/etc/shadow
+ # echo "www:*:13509:0:99999:7:::" >> $fs/etc/shadow-
+ # chroot $fs /bin/ash
+ /# addgroup -g 80 www
+ /# chown www.www /var/log/lighttpd
+ # exit
+
+

+Pour démarrer le serveur web vous pouvez utiliser le script /etc/init.d/lighttpd +fourni dans SliTaz tools, en tapant la commande /etc/init.d/lighttpd start. +Vous pouvez aussi automatiser son lancement au boot avec un lien de /etc/init.d/lighttpd +pointant vers /etc/rc.d/60lighttpd. +

+ +

iptables-1.3.7 - Netfilter, pare-feu Linux

+

+Netfilter (www.netfilter.org) est le module qui +fournit au noyau Linux les fonctions de pare-feu, de partage de connexions internet (NAT) et +d'historisation du trafic réseau. La commande iptables permet de configurer Netfilter, +iptables-restore et iptables-save permettent de sauvegarder/restaurer la configuration +Netfilter: +

+
+ # cd ..
+ # wget http://www.netfilter.org/projects/iptables/files/iptables-1.3.7.tar.bz2
+ # tar xjf iptables-1.3.7.tar.bz2
+ # cd iptables-1.3.7
+ # make KERNEL_DIR=../linux-2.6.20 BINDIR=/sbin \
+   LIBDIR=/lib MANDIR=/usr/share/man
+ # make KERNEL_DIR=../linux-2.6.20 BINDIR=/sbin \
+   LIBDIR=/lib MANDIR=/usr/share/man \
+   DESTDIR=$PWD/_pkg install
+ # strip  _pkg/sbin/*
+ # strip  _pkg/lib/iptables/*
+
+

+Installation des applications iptables*, et des bibliothèques suffisantes pour un firewall +basique: +

+
+ # cp -a _pkg/sbin/iptables* $fs/sbin
+ # mkdir $fs/lib/iptables
+ # cp -a _pkg/lib/iptables/{libipt_standard.so,libipt_conntrack.so} \
+   $fs/lib/iptables
+ # cp -a _pkg/lib/iptables/{libipt_tcp.so,libipt_udp.so} $fs/lib/iptables
+
+

+Pour satifaire les dépendances d'iptables, il faut copier la bibliothèque libnsl*: +

+
+ # cp -va /lib/libnsl* $fs/lib/tls
+ # strip $fs/lib/libnsl*
+
+ +

sqlite-3.5.1 - Petit moteur de base de données SQL

+

+Ce paquet fourni sqlite3 et les bibliothèques sqlite3.so* +(www.sqlite.org). SQLite est +intégré directement aux programmes en utilisant des fichiers de bases +de données, il est performant et rapide: +

+
+ # cd ..
+ # wget http://www.sqlite.org/sqlite-3.5.1.tar.gz
+ # tar xzf sqlite-3.5.1.tar.gz
+ # cd sqlite-3.5.1
+ # ./configure --prefix=/usr --disable-tcl
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip _pkg/usr/lib/*.so*
+ # strip _pkg/usr/bin/*
+
+

+Installation des bibliothèques et de l'utilitaire sqlite3 +dans le rootfs de SliTaz: +

+
+ # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
+ # cp -a _pkg/usr/bin/* $fs/usr/bin
+
+ +

cdrkit-1.1.5 - Outils de manipulation de cdrom et images ISO

+

+cdrkit (www.cdrkit.org) +fournit des outils de manipulation de cdrom. SliTaz installe par défaut +wodim pour la gravure et genisoimage pour la création d'image ISO (c'est +le paquet cdrkit-base-1.1.5). La compilation est un peu particulière +(cmake), mais ne devrait pas poser trop de problèmes: +

+
+ # cd ..
+ # wget http://cdrkit.org/releases/cdrkit-1.1.5.tar.gz
+ # tar xzf cdrkit-1.1.5.tar.gz
+ # cd cdrkit-1.1.5
+ # make
+ # make install PREFIX=$PWD/_pkg/usr
+ # strip -v _pkg/usr/bin/*
+ # strip -v _pkg/usr/sbin/*
+ # cp _pkg/usr/bin/genisoimage $fs/usr/bin
+ # cp _pkg/usr/bin/wodim $fs/usr/bin
+
+

+Copie de la bibliothèque libcap.so.1 requise par wodim: +

+
+ # cp -a /lib/libcap.so* $fs/lib
+
+ +

cpio-2.8 - Archiveur

+

+cpio (http://www.gnu.org/software/cpio/) +fournit des outils de manipulation de s archives au format cpio. Ce +format d'archive est utilisé pour les paquets SliTaz et l'image initramfs +du cdrom. A noter que Busybox fournit aussi une version de cpio qui +permet seulemnt de désarchiver: +

+
+ # cd ..
+ # wget ftp://sunsite.cnlab-switch.ch/mirror/gnu/cpio/cpio-2.8.tar.gz
+ # tar xzf cpio-2.8.tar.gz
+ # cd cpio-2.8
+ # ./configure --prefix=/usr --bindir=/bin \
+   --libexecdir=/usr/bin --mandir=/usr/share/man \
+   --infodir=/usr/share/info
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/bin/*
+ # strip -v _pkg/usr/bin/*
+
+

+Installation de cpio dans /bin et de rmt +dans /usr/bin. Vous pouvez aussi installer les fichiers de +localisation pour le français: +

+
+ # cp -a _pkg/bin/* $fs/bin
+ # cp -a _pkg/usr/bin/* $fs/usr/bin
+ # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
+
+ +

microperl-5.8.8 - Un tout petit Perl

+

+Microperl est une micro implémentation de Perl permettant d'utiliser la plus +part des fonctions de base fournies par le puissant langage qu'est Perl. Vous +trouverez plus d'infos dans l'archine source et le fichier +README.micro. Nous applicaons un petit sed sur le +fichier de configuration, pour que microperl cherche les modules dans +/usr/lib/perl5. Nous créons aussi un lien pour que les scripts +#/usr/bin/perl fonctionnent : +

+
+ # wget http://ftp.funet.fi/pub/CPAN/src/perl-5.8.8.tar.gz
+ # tar xzf perl-5.8.8.tar.gz
+ # cd perl-5.8.8
+ # sed -i s/'usr\/local'/'usr'/ uconfig.sh
+ # sed -i s/'perl5\/5.9'/'perl5'/ uconfig.sh
+ # sed -i s/'unknown'/'i486-pc-linux-gnu'/ uconfig.sh
+ # make -f Makefile.micro regen_uconfig
+ # make -f Makefile.micro
+ # strip microperl
+ # cp microperl $fs/usr/bin
+ # chroot $fs /bin/ash
+ /# cd /usr/bin
+ /# ln -s microperl perl
+ /# exit
+
+ +

module-init-tools-3.2 - Outils de manipulation des modules du noyau

+

+Les module-init-tools de kernel.org, modprobe, insmod, rmmod, lsmod, que +BusyBox fournit aussi. Nous avons fait le choix de les utiliser car nous pouvons +compiler modutils/modprobe pour qu'il support les modules compressés (.gz), +afin de gagner de la place. Pour cela il faut utiliser l'option --enable-zlib. Ensuite +c'est le nettoyage, et la copie des binaires. Nous ne prenons pas tout ce qui a +créé, seulement ce dont nous avons besoin, depmod, insmod, modinfo, modprobe, +rmmod dans /sbin, et lsmod dans /bin. +

+
+ # cd ..
+ # wget http://ftp.kernel.org/pub/linux/utils/kernel/module-init-tools/module-init-tools-3.2.tar.bz2
+ # tar xjf module-init-tools-3.2.tar.bz2
+ # cd module-init-tools-3.2
+ # ./configure --enable-zlib --prefix=/usr --sbindir=/sbin --bindir=/bin \
+   --sysconfdir=/etc --infodir=/usr/share/info --mandir=/usr/share/man
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/sbin/{depmod,insmod,modinfo,modprobe,rmmod}
+ # strip -v _pkg/bin/lsmod
+ # cp -i _pkg/sbin/{depmod,insmod,modinfo,modprobe,rmmod} $fs/sbin
+ # cp -i _pkg/bin/lsmod $fs/bin
+ # cd ..
+
+ +

Copie des modules du kernel

+

+Copie des fichier depuis linux-2.6.20/_pkg. +

+
+ # cp -a linux-2.6.20/_pkg/lib/* $fs/lib
+
+

Compression des modules du kernel

+

+Compression des modules, cette opération permet de ganger 50% de +place environ, nous commençons par nous déplacer dans le rootfs +, puis nous chercons tous les fichiers portant l'extension .ko +pour les compresser. Vous pouvez aussi faire cela avec le script 'gzmodtaz.sh' +contenu dans SliTaz tools: +

+
+ # cd $fs
+
+

+Avec 'gztazmod.sh': +

+
+ # cp -v ../src/slitaz-tools-1.1/utils/gztazmod.sh sbin
+ # ./sbin/gztazmod.sh lib/modules/2.6.20-slitaz
+
+

+Ou à la main: +

+
+ # cd lib/modules/2.6.20-slitaz
+ # find . -name "*.ko" -exec gzip '{}' \;
+ # sed 's/\.ko/.ko.gz/g' modules.dep > tmp.dep
+ # rm modules.dep
+ # mv tmp.dep modules.dep
+
+ +

Génération de l'initramfs, et d'une image ISO

+

+Pour créer une nouvelle image ISO vous pouvez utiliser 'mktaziso' +contenu dans +SliTaz tools. +Ou vous pouvez créer un nouvelle image initramfs, et la copier dans +/boot de la racine de cd-rom (rootcd), et pour finir créer un image +ISO avec genisoimage: +

+
+ # cd $fs
+ # find . -print | cpio -o -H newc | gzip -9 > ../rootfs.gz
+ # cd ..
+ # cp rootfs.gz rootcd/boot
+ # genisoimage -R -o slitaz-test.iso -b boot/isolinux/isolinux.bin \
+   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
+   -V "SliTaz" -input-charset iso8859-1 -boot-info-table rootcd
+
+

+Test iso image: +

+
+ # qemu -cdrom slitaz-test.iso
+
+

Suite

+

+Le prochain chapitre se nomme Base ncurses. Il +décrit l'installation et la configuration des bibliothèques et d'applications +ncurses. +

+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/base-ncurses.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/base-ncurses.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,509 @@ + + + + SliTaz Cookbook - Base ncurses + + + + + + + + + + + + + + + +
+
+ + +

Bibliothèques et applications ncurses

+

+Installation et config des bibliothèques et d'applications ncurses. +

+ + +

A propos

+

+Ce chapitre décrit la construction et l'installation des bibliothèques, et +de quelques applications ncuses dans SliTaz. La procédure consite à se +déplacer dans le réperoire /src, télécharger les sources de l'application en +question, les désarchiver, lire les info du (des) fichier(s) README et/ou +INSTALL, compiler, et installer le binaire dans SliTaz. Une fois l'application +installée il faut créer une nouvelle initramfs, la copier dans la racine du +cdrom, et créer une nouvelle image ISO. Pour cela vous pouvez utiliser +mktaziso contenu dans : +SliTaz tools. +

+

Affecter une variable d'environnement ($fs)

+

+Une variable d'environnement permet de ne pas spécifier tout le chemin vers le +répertoire, mais simplement $NomDeVariable. Nous allons afecter un variable +'$fs' pour indiquer le chemin vers le système de fichier racine 'rootfs'. +Pour cela vous pouvez vous placer dans le répertoire de travail de SliTaz, +et tapez: +

+
+ # export fs=$PWD/rootfs
+
+

+Pour vérifier: +

+
+ # echo $fs
+
+ +

ncurses-5.6 - Utilitaires et bibliothèques pour terminal

+

+ncurses (dickey.his.com/ncurses/) +contient des fonctions pour afficher le texte de plusieurs manières sur +l'écran d'un terminal Linux, et il nous fourni aussi les fichier terminfo. +Les bibliothèques ncurses, sont, entre-autre, utilisée par retawq, nano, +et certains jeux. Nous installon les bibliothèques dans /lib et le reste dans +/usr/bin, avec un petit strip pour nettoyer le tout: +

+
+ # cd src
+ # wget ftp://invisible-island.net/ncurses/ncurses-5.6.tar.gz
+ # tar xzf ncurses-5.6.tar.gz
+ # cd ncurses-5.6
+ # ./configure --prefix=/usr \
+   --libdir=/lib --sysconfdir=/etc \
+   --infodir=/usr/share/info --mandir=/usr/share/man \
+   --with-shared --without-debug --without-ada
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/lib/*
+ # strip -v _pkg/usr/bin/*
+
+

+Copie de la bibliothèque libncurses dans SliTaz, et de quelques applications. +L'utilitaire 'reset' est et utilisé à la fin du script d'initialisation rcS, +pour enlever le logo Linux. Si vous le désirez, vous pouvez aussi copier tous +les utilitaires assoiciés (tack,tic,toe,etc), attention à ne pas écraser un lien Busybox: +

+
+ # cp -a _pkg/lib/libncurses.so* $fs/lib
+ # cp -ia _pkg/usr/bin/{clear,ncurses5-config,tset,reset} \
+   $fs/usr/bin
+
+

+Copie de quelques fichiers terminfo, nous n'utilison que quelques fichiers, si +vous en désirez plus à vous de les copier: +

+
+ # mkdir -v $fs/usr/share/terminfo
+ # mkdir -v $fs/usr/share/terminfo/{a,l,r,v,x}
+ # cp _pkg/usr/share/terminfo/a/ansi \
+   $fs/usr/share/terminfo/a
+ # cp _pkg/usr/share/terminfo/l/linux \
+   $fs/usr/share/terminfo/l
+ # cp _pkg/usr/share/terminfo/r/rxvt \
+   $fs/usr/share/terminfo/r
+ # cp _pkg/usr/share/terminfo/x/{xterm,xterm-color,xterm-new,xterm-vt220} \
+   $fs/usr/share/terminfo/x
+ # cp _pkg/usr/share/terminfo/v/{vt100,vt102*} \
+   $fs/usr/share/terminfo/v
+
+

+Copie des fichiers tabset: +

+
+ # cp -a _pkg/usr/share/tabset $fs/usr/share
+
+ +

clex-3.16 - Gestionnaire de fichiers

+

+CLEX (http://www.clex.sk/) est un +petit gestionnaire de fichiers ncurses (160 Ko stripé). Le fichier de configuration +rc est ~./.clexrc et le fichier ~/.clexbm est utilisé pour les bookmarks: +

+
+ # cd ..
+ # wget http://www.clex.sk/download/clex-3.16.tar.gz
+ # tar xzf clex-3.16.tar.gz
+ # cd clex-3.16
+ # ./configure --prefix=/usr --infodir=/usr/share/info \
+   --mandir=/usr/share/man
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/usr/bin/clex
+
+

+Install du binaire clex dans le rootfs de SliTaz: +

+
+ # cp _pkg/usr/bin/clex $fs/usr/bin
+
+

libs

+

+Si on lance la commande ldd sur clex, les dépendances +suivantes devraient être affichées: +

+
+        libncurses.so.5 => /lib/libncurses.so.5 (0x40025000)
+        libc.so.6 => /lib/libc.so.6 (0x40064000)
+        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
+
+ +

nano-2.0.6 - Editeur de texte avancé

+

+GNU nano (www.nano-editor.org) est un +éditeur de texte bien connu du monde GNU/Linux, efficace et rapide, supportant +la colorisation syntaxique. C'est l'éditeur de texte par défaut de SliTaz: +

+
+ # cd ..
+ # wget http://www.nano-editor.org/dist/v2.0/nano-2.0.6.tar.gz
+ # tar xzf nano-2.0.6.tar.gz
+ # cd nano-2.0.6
+ # ./configure --enable-all --enable-extra --prefix=/usr \
+   --infodir=/usr/share/info --mandir=/usr/share/man \
+   --sysconfdir=/etc
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/usr/bin/nano
+
+

+Copie du binaire nano et du lien rnano, dans SliTaz: +

+
+ # cp -a _pkg/usr/bin/* $fs/usr/bin
+
+

+Copie des fichiers de configuration de nano dans /usr/share/nano +de notre rootfs: +

+
+ # cp -a _pkg/usr/share/nano $fs/usr/share
+
+

libs

+

+Si on lance la commande ldd sur nano, les dépendances +suivantes devraient être affichées: +

+
+        libncurses.so.5 => /lib/libncurses.so.5 (0x40025000)
+        libc.so.6 => /lib/libc.so.6 (0x40064000)
+        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
+
+

locale

+

+Au sujet de la langue, vous pouvez copier les fichiers .mo, créé +lors de l'installation de nano, dans +/usr/share/locale/{fr,en,de,es,etc}/LC_MESSAGES. Exemple pour la +langue française: +

+
+ # cp -a _pkg/usr/share/locale/fr/LC_MESSAGES $fs/usr/share/locale/fr
+
+

Personnaliser nano

+

+Vous pouvez personnaliser nano via le fichier /etc/nanorc, ou +~/.nanorc propre à chaque utilisateur du système, c'est dans ce +fichier que vous pouvez, par exemple, définir les couleur utilisées +par nano grâce au fichiers contenus dans /usr/share/nono. Vous trouverez +un large exemple de ce fichier dans l'archive de nano et dans +SliTaz tools. +

+

+Pour un fichier de configuration système, vous pouvez copier le fichier +nanorc de SliTaz tools, dans /etc du rootfs: +

+
+ # cd ..
+ # cp -a slitaz-tools-1.1/etc/nanorc $fs/etc
+
+ +

retawq-0.2.6c - Navigateur web en mode texte

+

+retawq (retawq.sourceforge.net) +est petit navigateur web en mode texte. Nous passons quelques option utiles +lors de la configuration, retawq a besoin des fichiers terminfo, des +bibliothèques libncurses, et libpthread: +

+
+ # wget http://switch.dl.sourceforge.net/sourceforge/retawq/retawq-0.2.6c.tar.gz
+ # tar xzf retawq-0.2.6c.tar.gz
+ # cd retawq-0.2.6c
+ # ./configure --enable-i18n --enable-local-cgi --path-prefix=/usr \
+   --path-doc=/usr/share/doc/retawq --path-man=/usr/share/man
+ # make
+ # strip -v retawq
+
+

+Copie du binaire retawq dans SliTaz: +

+
+ # cp retawq $fs/usr/bin
+
+

libs

+
+        libncurses.so.5 => /lib/libncurses.so.5 (0x40025000)
+        libpthread.so.0 => /lib/libpthread.so.0 (0x40064000)
+        libc.so.6 => /lib/libc.so.6 (0x40074000)
+        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
+
+

+Vous pouvez copier libpthread depuis votre système hôte, ou utiliser le +paquet glibc-minimum-2.3.6 distribué par SliTaz: +

+
+ # cp -a /lib/libpthread* $fs/lib
+ # strip --strip-unneeded $fs/lib/*
+
+

locale

+

+Pour la langue, vous pouvez copier les fichiers .mo, contenu dans +/i18n de l'archive de retawq, dans /usr/share/locale/{fr,en,de,es, +etc}/LC_MESSAGES. Exemple pour la langue française, en renommant le +fichier fr.mo en retawq.mo: +

+
+ # cp -v i18n/fr.mo $fs/usr/share/locale/fr/LC_MESSAGES/retawq.mo
+
+

Personnaliser retawq

+

+Pour personnalisé retawq, vous pouvez utiliser un répertoire personnel +~/.retawq, contenant un fichier config. Vous pouvez aussi mettre un +fichier bookmarks (pour les marques pages) à la racine du répertoire +de l'utilisateur. Vous trouverez un large exemple dans l'archive de +retawq, ou dans SliTaz tools, contenant un fichier bookmarks.html avec +une liste de favorits web. Vous pouvez aussi copier la doc (/docu) de retawq +dans /usr/share/doc/retawq. +

+ +

htop-0.6.5 - Visionneur de processus système

+

+htop (htop.sourceforge.net/) +est un logiciel qui pemet d'afficher les processus du système, avec +une interface ncurses. +

+

+Retour au répertoire /src, téléchargement, détarrage, configuration, +compilation, et nettoyage avec strip: +

+
+ # cd ..
+ # wget http://switch.dl.sourceforge.net/sourceforge/htop/htop-0.6.5.tar.gz
+ # tar xzf htop-0.6.5.tar.gz
+ # cd htop-0.6.5
+ # ./configure --prefix=/usr --mandir=/usr/share/man
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/usr/bin/htop
+
+

+Copie du binaire htop dans SliTaz: +

+
+ # cp _pkg/usr/bin/htop $fs/usr/bin
+
+

+Vous pouvez encore copier l'icone d'htop, ce trouvant dans: +_pkg/usr/share/pixmaps. +

+

libs

+
+        libm.so.6 => /lib/libm.so.6 (0xb7f97000)
+        libncurses.so.5 => /lib/libncurses.so.5 (0xb7f55000)
+        libc.so.6 => /lib/libc.so.6 (0xb7e20000)
+        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0xb7fc9000)
+
+ +

dialog-1.1-20070409 - Interfaces graphiques aux scripts shell

+

+dialog,(invisible-island.net/dialog/dialog.html), est un utilitaire +permettant de construire des interfaces graphiques basées sur la +console: +

+
+ # cd ..
+ # wget ftp://invisible-island.net/dialog/dialog.tar.gz
+ # tar xzf dialog.tar.gz
+ # cd dialog-1.1-20070409
+ # ./configure --enable-nls --with-ncurses --prefix=/usr \
+   --sysconfdir=/etc --mandir=/usr/share/man
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/usr/bin/dialog
+
+

+Copie du binaire dialog dans SliTaz: +

+
+ # cp _pkg/usr/bin/dialog $fs/usr/bin
+
+

libs

+
+        libncurses.so.5 => /lib/libncurses.so.5 (0x40027000)
+        libm.so.6 => /lib/libm.so.6 (0x40066000)
+        libc.so.6 => /lib/libc.so.6 (0x40089000)
+        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
+
+

locale

+

+Vous pouvez installer les fichiers pour la localisation, si vous le désirez: +

+
+ # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
+
+

+Le fichier de configuration de dialog est /etc/dialogrc, et/ou ~/.dialogrc +pour chaque utilisateur. Il y a aussi pleins d'exemples de scripts dans +le répertoire /sample des sources de dialog. +

+ +

ninvaders-0.1.1 - Clone du jeu Space Invaders

+

+nIvaders (http://ninvaders.sourceforge.net/) est un clone du eu Space Invaders, +qui ne fait que 46 ko une fois stripé. Nous commençons par nous placer dans +le répertoire /src, téléchargement, détarrage, compilation, nettoyage avec +l'utilitaire strip et copie du binaire nInvaders dans +/usr/games de SliTaz : +

+
+ # cd ..
+ # wget http://ovh.dl.sourceforge.net/sourceforge/ninvaders/ninvaders-0.1.1.tar.gz
+ # tar xzf ninvaders-0.1.1.tar.gz
+ # cd ninvaders-0.1.1
+ # make
+ # strip -v nInvaders
+ # cp nInvaders $fs/usr/games
+
+ +

bastet-0.41 - Bastard tetris clone

+

+Un petit jeu de tetris (17 Ko strippé) : +

+
+ # wget http://fph.altervista.org/prog/bastet-0.41.tgz
+ # tar xzf bastet-0.41.tgz
+ # cd bastet-0.41
+ # make
+ # strip bastet
+ # cp bastet $fs/usr/games
+ # mkdir -p $fs/var/games
+ # touch $fs/var/games/bastet.scores
+ # chmod 666 $fs/var/games/bastet.scores
+
+ +

rhapsody-0.28b - Client de chat IRC

+

+Rhapsody (http://rhapsody.sourceforge.net/) +est un client de chat supportant le protocole IRC, rapide et légé. Rhapsody +fournit un menu pour une gestion des serveurs, des canaux, et sa propre +configuration. Il est donc facile d'utilisation: +

+
+ # cd ..
+ # wget http://switch.dl.sourceforge.net/sourceforge/rhapsody/rhapsody_0.28b.tgz
+ # tar xzf rhapsody_0.28b.tgz
+ # cd rhapsody-0.28b
+ # ./configure -i /usr/bin -d /usr/share/doc/rhapsody
+ # make
+ # strip -v rhapsody
+
+

+Installation du binaire dans Slitaz, et des fichiers d'aide. Il faut +aussi ajuster les permissions sur ces fichiers afin que tout le monde +puisse les lire: +

+
+ # cp rhapsody $fs/usr/bin
+ # mkdir $fs/usr/share/doc/rhapsody
+ # cp -a help $fs/usr/share/doc/rhapsody/help
+ # chmod 644 $fs/usr/share/doc/rhapsody/help/*
+
+

libs

+

+Rhapsody utilise les librairies suivantes : +

+
+        libncurses.so.5 => /lib/libncurses.so.5 (0x40026000)
+        libc.so.6 => /lib/libc.so.6 (0x40066000)
+        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000))
+
+

Personnaliser rhapsody

+

+Vous pouvez personnaliser rhapsody via le fichier ~/.rhapsodyrc, ou +utiliser <Ctrl+T> pour afficher les options. +

+ +

Génération de l'initramfs, et d'une image ISO

+

+Pour créer une nouvelle image ISO vous pouvez utiliser 'mktaziso' +contenu dans SliTaz tools. Ou vous pouvez créer un nouvelle +image initramfs, et la copier dans /boot de la racine de cd-rom +(rootcd), et pour finir créer un image ISO avec genisoimage: +

+
+ # cd $fs
+ # find . -print | cpio -o -H newc | gzip -9 > ../rootfs.gz
+ # cd ..
+ # cp rootfs.gz rootcd/boot
+ # genisoimage -R -o slitaz-cooking.iso -b boot/isolinux/isolinux.bin \
+   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
+   -V "SliTaz" -input-charset iso8859-1 -boot-info-table rootcd
+
+

Suite

+

+Le prochain chapitre du Cookbook déccript l'installation des +locale pour le français (Locale & i18n). +

+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/base-system.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/base-system.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,807 @@ + + + + SliTaz Cookbook - Base system - Créer la base du LiveCD + + + + + + + + + + + + + + + +
+
+ + +

Système de base

+

+Construire une distro SliTaz GNU/Linux utilisant Busybox et fonctionnant en RAM. +

+ + +

A propos

+

+Ce document décrit la construction de la base de SliTaz, pour cela nous +utilisons: un noyau Linux, BusyBox, et Syslinux pour booter le système. +Slitaz utilise une archive initramfs décompressée en RAM par le +kernel au démarrage du système. Nous allons créer la box, pour qu'elle tienne +dans un système de fichier racine de 3 à 4 Mb, en utilisant 'strip' sur +les bibliothèques et les binaires, pour gagner de la place. +

+

+Les scripts et les fichiers de configuration sont crées avec GNU nano, il faut +utiliser la combinaison de touches <Ctrl+X> pour enregistrer et quitter. +Mais vous pouvez biensûr, utiliser votre éditeur de texte préféré à la place. +

+

+Ce document est inspiré d'un howto trouvé dans l'archive de BusyBox. +Qui est lui-même basé sur un papier présenté par Erik Andersen +à la conférence Embedded Systems en 2001. +

+ +

Wget src

+

+Création d'un répertoire src pour le téléchargement et +la compilation: +

+
+ # mkdir -p src
+ # cd src
+
+ + +

Désarchiver et préparer le noyau Linux

+

+Nous allons commencer par compiler un noyau Linux, ce qui peut prendre un +peu de temps. +

+

Noyau Linux

+

+Votre kernel doit supporter le système de fichier intramfs, sinon le +cd-rom ne pourra démarrer. Vous pouvez aussi installer les modules dans +un répertoire donné afin de ne pas toucher au système hôte. La configuration +des sources du noyau Linux se fait avec make menuconfig, en +ncurser ou graphiquement avec make gconfig ou, +make xconfig. Pour cela il faut que les paquets de développements +GTK et/ou QT soient installés. Vous trouverez dans +SliTaz tools les +Makefiles de divers noyau 2.6.xx. +

+

+Une fonctionnalité des noyaux 2.6 est que si nous lançons make menuconfig, +xconfig, ou config, pour la première fois, le menu de configuration affiché +est basé sur la configuration de notre noyau actuel. +

+

+Les options choisies dépendent de vos besoins, sachez que vous pouvez installer +module-init-tools pour prendre en charge les modules compressés. Pour un système +minimum vous pouvez ne choisir que les options vitales. +

+

+Nous commençons par un cd dans les sources, mrproper +pour mettre un peu d'ordre, puis on lance une interface de configuration, +gconfig, xconfig, menuconfig, ou +oldconfig: +

+
+ # tar xjf linux-2.6.20.tar.bz2
+ # cd linux-2.6.20
+ # make mrproper
+ # cp ../slitaz-tools-1.1/Makefiles/linux-2.6.20-slitaz.config .config
+ # make oldconfig
+ (# make menuconfig)
+ # make bzImage
+ # make modules
+ # make INSTALL_MOD_PATH=$PWD/_pkg modules_install
+ # cd ..
+
+

+Si vous désirez plus d'info sur la compilation du noyau, référez-vous aux +pages de manuels. A noter que vous pouvez installer ce noyau et +redémarrer dessus, vous compilerez la suite avec votre propre noyau. +

+ +

Création de la racine du sytème (rootfs)

+

+La prochaine étape créera un système de fichier racine nommé 'rootfs', +pour Root File System, dans l'espace de travail SliTaz. +

+
+ # mkdir ../rootfs
+
+

Install BusyBox

+

+BusyBox (www.busybox.net) est un +exécutable unique qui propose des versions allégées des principaux outils +indispensables pour utiliser un noyau Linux. Il est principalement destiné +à l'embarqué et permet de presque tout faire. C'est un shell proposant les +commandes de coreutils et des démons système. Il y a même un serveur web, et +un client/serveur DHCP (udhcpc). +

+
+ # tar xjf busybox-1.2.2.tar.bz2
+
+

+Pour configurer et compiler. N'oubliez pas les options dumpkmap, init, etc, +pour vous aider, vous trouverez le Makefile de BusyBox dans SliTaz tools. Le +make install créera un répertoire _install dans le répertoire courant: +

+
+ # cd busybox-1.2.2
+ # cp ../slitaz-tools-1.1/Makefiles/busybox-1.2.2.config .config
+ # make oldconfig
+ (# make menuconfig)
+ # make
+ # make install
+ # chmod 4755 _install/bin/busybox
+
+

+Copier les fichiers de la compilation de Busybox, se trouvant dans le +répertoire _install, dans le système de fichiers racine (rootfs): +

+
+ # cp -a _install/* ../../rootfs
+
+

+Le lien linuxrc pointant vers bin/busybox, les dossiers /bin, /lib, et /sbin, +on été ajoué au répertoire /rootfs. On peut le vérifier avec ls. Il se peut que +le lien linuxrc ne soit pas présent si vous n'avez pas séléctionner l'option du +support initrd dans BusyBox. Nous effaçons le lien linuxrc, et créons un lien +pour init qui pointe sur bin/busybox: +

+
+ # cd ../../rootfs
+ # ls -CF
+ bin/  linuxrc@  sbin/  usr/
+
+ # rm linuxrc
+ # ln -s bin/busybox init
+
+

ldd sur BusyBox

+

+La commande ldd permet de connaître les bibliothèques utilisées par +un programme. Les bibliothèques utilisées par Busybox peuvent différer sen fonction +du système hôte utilisé, sur Debian par exemple vous devrez copier les bibliothèques +situées dans /lib/tls. Les commandes ci-dessous sont donnée avec l'option '-v' pour +verbose ou volubile. Pour éliminer les symboles des binaires exécutable et des +bibliothèques partagées qui servent au débuggage nous utilison strip. A noter +que vous pourriez aussi utiliser les bibliothèques uClibc ou mklibs : +

+
+ # mkdir lib
+
+

+Exemple sur SliTaz ou autres: +

+
+ # cp /lib/{libcrypt.so.1,libm.so.6,libc.so.6} lib
+ # cp /lib/ld-linux.so.2 lib
+
+

+Exemple sur Debian Etch: +

+
+ # cp /lib/tls/{libcrypt.so.1,libm.so.6,libc.so.6} lib
+ # cp /lib/ld-linux.so.2 lib
+
+

+Nettoyage de bibliothèques avec strip: +

+
+ # strip -v lib/*
+
+

Linux tree et config

+

+Création de quelques répertoires pour créer une arborrescence Linux classique pour +SliTaz. /dev pour les devices, /etc, /home, /usr, /proc, /root, et compagnie. +Pour en savoir plus sur la hierarchie d'un système de fichiers, et son contenu, il +existe le Filesystem Hierarchy Standard, disponible en plusieurs formats sur +www.pathname.com/fhs/. +

+

+Vous êtes libre de créer votre propre arbre. Dans les systèmes unix traditionnels, +/usr contient généralement des fichiers provenant de la distribution, /dev contient +les périphériques (devices), /etc contient les fichiers de configuration, /lib des +bibliothèques, /home pour la maison des utilisateurs, et /var des données variables. +A noter que nous ne créons pas /lib, /bin, /sbin, ils seront crée lors de +l'installation de BusyBox: +

+
+ # mkdir -p dev etc root home proc media mnt sys tmp var
+ # mkdir -p usr/{lib,local,games,share} \
+   var/{cache,lib,lock,log,games,run,spool} \
+   media/{cdrom,flash,usbdisk}
+
+

+Changement des permissions sur le répertoire /tmp: +

+
+ # chmod 1777 tmp
+
+

+Configuration de base de la glibc, /etc/ld.so.conf et /etc/rpc ne sont pas +indispensable pour un micro système: +

+
+ # touch etc/ld.so.conf
+ # cp /etc/rpc etc
+
+

Créer le devices dans /dev

+

+Ceci peut se faire avec le script 'mkdevs.sh' trouvé dans busybox. +ou avec notre script 'mktazdevs.sh' contenu dans SliTaz tools. Si vous +voulez des détails, lisez les scripts. Si vous utilisé la version BusyBox, +il faut encore créer le réperoire pts: +

+
+ # cp ../src/slitaz-tools-1.1/utils/mktazdevs.sh bin
+ # ./bin/mktazdevs.sh dev
+ou:
+ # cp ../src/busybox-1.2.2/examples/bootfloppy/mkdevs.sh bin
+ # ./bin/mkdevs.sh dev
+ # mkdir -p dev/{pts,input,shm,net,usb}
+
+

+A noter que nous démarrons mdev -s avec le script rcS, pour créer +les devices dynamiquement lors du boot. +

+

Support de la résolution des noms d'hôtes (DNS)

+

+Copie des bibliothèques libnss_* du système hôte, dans notre +système SliTaz, ces bibliothèques sont utilisées pour la résolution +des noms et nettoyage avec strip: +

+
+ # cp /lib/{libnss_dns.so.2,libnss_files.so.2} lib
+ # cp /lib/libresolv.so.2 lib
+ # strip -v lib/*.so*
+
+ +

Configuration de votre Box

+

+Créer les fichiers nécessaires dans /etc. Pour plus d'infos, il faut +simplement regarder le contenu des fichiers. Nous commençons par créer +quelques fichiers utiles au fonctionnement de base du sytème: +

+

Réseau

+

+Création des fichiers de base utilisés pour configurer le réseau: +

+
+ # echo "127.0.0.1      localhost" > etc/hosts
+ # echo "localnet    127.0.0.1" > etc/networks
+ # echo "slitaz" > etc/hostname
+ # echo "order hosts,bind" > etc/host.conf
+ # echo "multi on" >> etc/host.conf
+
+

/etc/nsswitch.conf

+

+Fichier de configuration utilisé pour la résolution des noms: +

+
+ # nano etc/nsswitch.conf
+
+
+# /etc/nsswitch.conf: GNU Name Service Switch config.
+#
+
+passwd:     files
+group:      files
+shadow:     files
+
+hosts:      files dns
+networks:   files
+
+
+

/etc/securetty

+

+Le fichier /etc/securetty, liste les terminaux sur lesquels root peut se +connecter: +

+
+ # nano etc/securetty
+
+
+# /etc/securetty: List of terminals on which root is allowed to login.
+#
+console
+
+# For people with serial port consoles
+ttyS0
+
+# Standard consoles
+tty1
+tty2
+tty3
+tty4
+tty5
+tty6
+tty7
+
+
+

/etc/shells

+

+Le fichier /etc/shells, liste les shells de connection valides. Ce fichier est +entre autre utilisé par le serveur SSH dropbear: +

+
+ # nano etc/shells
+
+
+# /etc/shells: valid login shells.
+/bin/sh
+/bin/ash
+/bin/hush
+
+
+

/etc/issue et /etc/motd

+

+Création des fichiers /etc/issue affiché à la fin du boot, et du message du +jour affiché après le login: +

+
+ # echo "SliTaz GNU/Linux 1.0 Kernel \r \l" > etc/issue
+ # echo "" >> etc/issue
+ # nano etc/motd
+
+
+
+ (°-  { Get documentation in: /usr/share/doc.
+ //\    Use: 'less' or 'more' to read files, 'su' to be root. }
+ v_/_
+
+SliTaz is distributed in the hope that it will be useful, but
+with ABSOLUTELY NO WARRANTY.
+
+
+

/etc/busybox.conf

+

+Ce fichier est le fichiers de configuration de BusyBox, il permet +de configurer, entre autre des droits sur les applications Busybox. +Pour plus d'informations vous pouvez lire le document texte: +sécurité du système +du Handbook. Fichier busybox.conf : +

+
+ # nano etc/busybox.conf
+
+
+# /etc/busybox.conf: SliTaz GNU/linux Busybox configuration.
+#
+
+[SUID]
+# Allow command to be run by anyone.
+su = ssx root.root
+passwd = ssx root.root
+loadkmap = ssx root.root
+mount = ssx root.root
+reboot = ssx root.root
+halt = ssx root.root
+
+
+

+Pour plus de sécurité, on change les permission sur ce fichier: +

+
+ # chmod 600 etc/busybox.conf
+
+

/etc/inittab

+

+Fichier de configuration d'init minimal. Il permet d'avoir d'avoir une +console root sans passer par le login, et une console activable sur tty2. +

+
+ # nano etc/inittab
+
+
+# /etc/inittab: init configuration for SliTaz GNU/Linux.
+
+::sysinit:/etc/init.d/rcS
+::respawn:-/bin/sh
+tty2::askfirst:-/bin/sh
+::ctrlaltdel:/bin/umount -a -r
+::ctrlaltdel:/sbin/reboot
+
+
+

+Vous trouverez aussi un large exemple d'un fichier inittab dans +l'archive de BusyBox. +

+

/etc/profile

+

+Ce fichier est lu lors de chaque login, et affecte tous les utilisateurs. +Il faut utiliser le fichier ~/.profile pour la config propre à chaque user. +

+
+ # nano etc/profile
+
+
+# /etc/profile: system-wide .profile file for the Bourne shells
+
+PATH="/usr/sbin:/usr/bin:/sbin:/bin:/usr/games"
+LD_LIBRARY_PATH="/usr/lib:/lib"
+
+if [ "`id -u`" -eq 0 ]; then
+  PS1='\e[1m\u@\h:\w\#\e[m '
+else
+  PS1='\e[1m\u@\h:\w\$\e[m '
+fi
+
+DISPLAY=:0.0
+
+export PATH LD_LIBRARY_PATH PS1 DISPLAY ignoreeof
+umask 022
+
+
+

Utilisateurs, groupes, et mots de passes

+

+Création des fichiers de configuration des utilisateurs, des groupes, +des mots de passes situé dans: etc/{passwd,shadow,group,gshadow}, +et ajustage des permissions: +

+
+ # echo "root:x:0:0:root:/root:/bin/sh" > etc/passwd
+ # echo "root::13525:0:99999:7:::" > etc/shadow
+ # echo "root:x:0:" > etc/group
+ # echo "root:*::" > etc/gshadow
+ # chmod 640 etc/shadow
+ # chmod 640 etc/gshadow
+
+

+Vous pouvez ajouter d'autres utilisateurs, tel que hacker +utilisé par le mode liveCD de SliTaz. Vous pouvez aussi configuer un mot de passe pour +le super-utilisateur root, avec la commande passwd. Pour ajouter un utilisateur existant +dans un groupe existant, vous devez éditer les fichiers /etc/group et /etc/gshadow, car +l'applet adduser fourni avec busybox n'offre pas toutes les options fournies par le +programme original. +

+

/etc/fstab et /etc/mtab

+

+Liste les systèmes de fchiers à monter: +

+
+ # nano etc/fstab
+
+
+# /etc/fstab: informations on static file system.
+#
+proc            /proc        proc    defaults          0       0
+sysfs           /sys         sysfs   defaults          0       0
+devpts          /dev/pts     devpts  defaults          0       0
+tmpfs           /dev/shm     tmpfs   defaults          0       0
+
+
+

+Le fichier /etc/mtab est utilisé entre autre par mkfs*, il liste les partitions montées. +Il a besoin de /proc, car c'est un lien sur /proc/mounts: +

+
+ # chroot . /bin/ash
+ /# ln -s /proc/mounts /etc/mtab
+
+

Clavier

+

+Vous pouvez créer un fichier .kmap spécifique à votre clavier grâce à la +commande dumpkmap fournie avec BusyBox. Vous trouverez quelques fichiers kmap +dans l'archive SliTaz tools +tel que fr_CH. Pour créer un fichier .kmap (changez fr_CH à votre +configuration): +

+
+ /# mkdir /usr/share/kmap
+ /# /bin/busybox dumpkmap > /usr/share/kmap/fr_CH.kmap
+ /# exit
+
+

+Une fois ceci fait vous pouvez charger automatiquement votre clavier +avec loadkmap dans un script tel que etc/ini.d/rcS, par exemple. +

+

/usr/share/doc

+

+Vous pouvez aussi ajouter divers documents, comme le manuel d'utilisateur +de SliTaz, que vous pouvez télécharger sous forme d'archive tar.gz, depuis le +site web de SliTaz. +

+
+ # mkdir -p usr/share/doc
+
+

Installation du script udhcpc

+

+Udhcpc est un client DHCP stable et rapide, fourni avec Busybox, mais +ayant un développemnt indépandent. Site web: http://udhcp.busybox.net/. Vous pouvez utiliser default.script +de l'archive BusyBox. Ce script se met dans /usr/share/udhcpc/default.script, +mais cela peut être modifié en ligne de commande. Sur SliTaz le client est lancé au boot +par le script /etc/init.d/network.sh via le fichier de configuration /etc/network.conf: +

+
+ # mkdir usr/share/udhcpc
+ # cp ../src/busybox-1.2.2/examples/udhcp/simple.script \
+   usr/share/udhcpc/default.script
+ # chmod +x usr/share/udhcpc/default.script
+
+

/etc/init.d/rcS

+

+Pour finir cette première mouture il faut encore créer le script d'initialisation +/etc/init.d/rcS pour monter les systèmes de fichiers, et lancer quelques commandes. +Pour plus d'information vous pouvez jeter un coup d'oeil au chapitre sur +les scripts de démarrage et d'arrêt. Vous pouvez +changer la valeur de la variable KMAP= pour que le bon clavier soit chargé: +

+
+ # mkdir etc/init.d
+ # nano etc/init.d/rcS
+
+
+#! /bin/sh
+# /etc/init.d/rcS: rcS initial script.
+#
+
+KMAP=fr_CH
+
+echo "Processing /etc/init.d/rcS... "
+
+/bin/mount proc
+/bin/mount -a
+/bin/hostname -F /etc/hostname
+/sbin/ifconfig lo 127.0.0.1 up
+/sbin/loadkmap < /usr/share/kmap/$KMAP.kmap
+
+
+
+
+ # chmod +x etc/init.d/rcS
+
+

Note

+

+A noter que vous pouvez encore installer +tazpkg (10 Ko). +C'est un gestionnaire de paquets que nous avons créé, vous touverez toutes les +infos d'install dans l'archive source. Vous pouvez aussi installer divers +fichiers depuis SliTaz tools, tel les lisences. +

+ +

Build a initramfs cpio archive

+

+L'initramfs est une archive cpio du système générée depuis la racine, +elle est décompressée en RAM par le noyau Linux lors du démarrage (boot), pour créer +le système de fichiers en mémoire vive. Pour générer une archive initramfs, nous +nous plaçons dans le répertoire racine du système de fichiers (rootfs), nous fesons +une recherche avec find, et nous utilisons des pipes |. +Ensuite nous créons une archivecpio gzipée avec gzip, +que nous plaçons dans le répertoire de travail. +

+

+L'initramfs de SliTaz se nomme rootfs.gz, c'est le nom du +système racine, mais avec l'extension .gz. Si vous changé +le nom, il faudrat le spécifier dans le fichier isolinux.cfg pour isolinux, +ou menu.lst pour GRUB. +

+

+Génération de l'initramfs: +

+
+ # find . -print | cpio -o -H newc | gzip -9 > ../rootfs.gz
+
+

+Vous devriez avoir un fichier rootfs.gz d'environ 1 à 2 Mb dans le +répertoire de travail de SliTaz. +

+

+Pour une nouvelle image, lors de modif dans rootfs, il suffit de copier +la nouvelle archive rootfs.gz dans rootcd/boot, et de créer une nouvelle +image ISO avec genisoimage ou mkisofs. Pour cela vous +pouvez utiliser mktaziso se trouvant dans SliTaz tools. Ce script +se chargera de vérifier si les répertoires sont bien présents, de générer une +nouvelle archive cpio compressée et de créer une nouvelle image ISO bootable. +

+ +

Make rootcd files

+

+Les étapes suivantes vont vous permettre de créer la racine du cd-rom +bootable. Nous commençons par créer le répertoire rootcd, boot, et isolinux +pour les fichiers déstinés au cd-rom: +

+
+ # cd ..
+ # mkdir -p rootcd/boot/isolinux
+
+

+En option vous pouvez créer d'autres repértoires pour y mettre divers données, +tel que des documents html ou des paquets. +

+ +

Copier le kernel

+

+Il suffit de copier le noyau préalablement compilé, dans rootcd/boot: +

+
+ # cp src/linux-2.6.20/arch/i386/boot/bzImage rootcd/boot
+
+

Copie de l'initramfs dans rootcd/boot

+

+Il ne faut pas oublier de générer une nouvelle archive initramfs +lors de modification dans le rootfs (root file system). +

+
+ # cp rootfs.gz rootcd/boot
+
+

Install du bootloader isolinux

+

+Le bootloader isolinux, il suffit de copier isolinux.bin depuis l'archive +des source de Syslinux: +

+
+ # cd src
+ # tar xzf syslinux-3.35.tar.gz
+ # cp syslinux-3.35/isolinux.bin ../rootcd/boot/isolinux
+ # cd ..
+
+

isolinux.cfg - Configuration d'isolinux

+

+Voici un exemple du fichier isolinux.cfg qui devrait bien fonctionner. Vous +pouvez le modifier à volonté: +

+
+ # nano rootcd/boot/isolinux/isolinux.cfg
+
+
+display display.txt
+default slitaz
+label slitaz
+    kernel /boot/bzImage
+    append initrd=/boot/rootfs.gz rw root=/dev/null vga=788
+implicit 0
+prompt 1
+timeout 80
+
+
+

+Voici quelques changements que vous pourriez faire dans isolinux.cfg: +

+ +

display.txt

+

+Un petit message de bienvenue, propulsé par isolinux, à vous de modifier +ce fichier comme bon vous semble: +

+
+ # nano rootcd/boot/isolinux/display.txt
+
+
+/*       _\|/_
+         (o o)
+ +----oOO-{_}-OOo---------------------------------------------------+
+     ____  _ _ _____
+    / ___|| (_)_   _|_ _ ____
+    \___ \| | | | |/ _` |_  /
+     ___) | | | | | (_| |/ /
+    |____/|_|_| |_|\__,_/___|
+
+ SliTaz GNU/Linux - Temporary Autonomous Zone
+
+     <ENTER> to boot.
+
+                                                                   */
+
+ +

Créer un image ISO avec genisoimage ou mkisofs

+
+ # genisoimage -R -o slitaz-cooking.iso -b boot/isolinux/isolinux.bin \
+   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
+   -V "SliTaz" -input-charset iso8859-1 -boot-info-table rootcd
+
+

+Pour chaque nouvelle modification dans le système de fichier racine +de la box, vous devez créer une nouvelle image ISO. +

+

+Vous pouvez créer un petit script qui se chargera de générer une nouvelle +archive cpio compressée et une nouvelle image ISO, ou utiliser mktaziso se +trouvant dans SliTaz tools. A noter que vous pouvez aussi utiliser GRUB pour +booter la box. +

+ +

Craver ou tester l'ISO avec Qemu

+

+Vous pouvez graver l'image ISO avec Graveman, k3b, ou wodim, et booter +dessus. Voisi un exemple de commande de gravure avec wodim (valable aussi pour +cdrecord), avec un kernel 2.6.*: +

+
+# wodim -v -speed=24 -data slitaz-cooking.iso
+
+

Qemu

+

+A noter que vous pouvez tester l'image ISO avec le logiciel d'émulation Qemu +(Sur Debian # aptitude install qemu). Pour émuler l'image ISO fraîchement crée, +il suffit de taper : +

+
+# qemu -cdrom slitaz-cooking.iso
+
+

Suite

+

+La suite logique du Cookbook est le chapitre Base apps fournissant toutes les instructions pour installer et +configurer les applications de base distribuée par SliTaz. +

+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/book.css --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/book.css Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,170 @@ +/* + CSS style for SliTaz GNU/Linux *book. + Pankso 2007 - www.slitaz.org +*/ + +body { + font: 13px sans-serif, vernada, arial; + background: #222222; + margin: 0; + padding-bottom: 100%; +} + +#header { + background: #BFB06B url(images/css/header.png) repeat-x top; + color: black; + height: 50px; + border-top: 1px solid black; + border-bottom: 1px solid black; +} +#quicknav { + margin-right: 6px; + text-align: right; + font-size: 12px; + } +#quicknav { + margin-right: 6px; +} + +#quicknav a { + background: inherit; + color: #222222; +} + +#quicknav a:hover { + background: inherit; + color: #EDEDED; +} + +/* content. */ + +#content { + background: white url(images/css/content-tl.png) no-repeat top left; + color: black; + padding: 20px; + margin: 30px 50px 0px 50px; + width: auto; + text-align: justify; +} + +#content li { + line-height: 1.5em; + text-align: left; +} + +/* Footer. */ + +#footer { + font-size: 11px; + font-weight: bold; + background: #eaeaea url(images/css/footer-bl.png) no-repeat bottom left; + color: black; + height: 20px; + padding: 6px 0px 0px 10px; + margin: 0px 50px 0px 50px; + width: auto; + text-align: center ; +} + +#footer a { + text-decoration: none; + background: #eaeaea; + color: #3E1220; +} + +#footer a:hover { + background: #eaeaea; + color: #DF8F06; +} + +/* Legal informations */ + +#copy { + font-size: 11px ; + text-align: center ; + background: transparent; + color: #a8a8a8; + padding-top: 20px; +} + +#copy a { + background: inherit; + color: #a8a8a8; +} + +#copy a:hover { + background: inherit; + color: #EDEDED; +} + +/* Div for round corners. */ + +.content-right, .footer-right { + width: 16px; + color: white; + background-color: #333333; +} +.content-right { + background: url(images/css/content-tr.png) no-repeat top right; + height: 16px; + right: 50px; + top: 82px; + position: absolute; +} + +.footer-right { + background: url(images/css/footer-br.png) no-repeat bottom right; + height: 20px; + float: right; +} + +/* General HTML entities for content. */ + +h1 { + margin: 0px 0px 0px 16px; +} + +h2 { + margin: 12px 0; + color: #484B7C; + background: white; +} + +h3 { + font-weight: bold; + color: #6c0023; + background: white; +} + +a { + text-decoration: underline; +} +a:hover { + text-decoration: none; +} + +pre { + padding: 5px; + color: black; + background: #e1e0b0; +} +pre.script { + padding: 10px; + color: black; + background: #e8e8e8; + border: 1px inset #333333; +} + +code { + font-size: 12px; + color: #669900; + background: transparent; +} + +li { + line-height: 1.4em; +} + +hr { + border: 0pt none; +} diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/boot-scripts.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/boot-scripts.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,220 @@ + + + + SliTaz Cookbook - Boot scripts + + + + + + + + + + + + + + + +
+
+ + +

Boot scripts

+

+Les scripts de démarrage et d'arrêt avec leurs fichiers de configuration. +

+ + + + +

SliTaz et son démarrage

+

+Dans les premières version du livre, les scripts étaient créer à la main avec +la commande cat. Avec le temps, les scripts de démarrage et le +fichier de configuration principale sont devenu trop gros et sont trop souvent +modifiés pour être inclus dans le Cookbook. Tous les scripts et configuration +se trouve dans l'archive des outils SliTaz ou le paquet +slitaz-tools. Vous pouvez +ouvrir avec un éditeur de texte et les étudier. +

+

+SliTaz n'utilise pas de niveau d'execution, tout le système est initialisé via +un script principale et son fichier de configuration. Ce script lance lui-même +quelque petits scripts qui s'occupe de l'internationalisation ou des options +passé en ligne de commande au démarrage. +

+ + +

/etc/init.d/* - Répertoire des scripts et démons

+

+Le réperoire /etc/init.d contient tous les vrais scripts rc, les scripts +finnissant par '.sh' sont de simples scripts shell, et les démons, tel +que 'dropbear' ou 'lighttpd', sont aussi de scripts mais qui lance un service. +Les scripts des démons permettent de démarrer, arrêter, ou redémarrer un démon +via la commande : +

+
+ # /etc/init.d/demon [start|stop|restart]
+
+

+Le répertoire /etc/init.d devrait déjà exister, si vous avez suivi le cookbook +depuis le début. Si ce n'est pas le cas: mkdir -p /etc/init.d. +Sur SliTaz vous trouverez un fichier /etc/init.d/README décrivant le +fonctionnemnt de base des scripts rc. A noter aussi que tous les scripts de +démarrage et démons peuvent faire appel au fichier +/etc/init.d/rc.functions. Ce fichier permet d'inclure divers +fonctions dans les scripts rc. SliTaz utilise une fonction status +vérifiant si la commande précédante a réussi (0) ou pas. +

+ + +

/etc/init.d/rcS - Script d'initialisation principale

+

+Le script /etc/init.d/rcS configure tous les services de base +et initialise le système de base. Il commence par monter les systèmes de +fichiers, démarrer syslogd et klogd, lancer mdev, nettoyer le système, etc. +Il utilise le fichier de configuration /etc/rcS.conf pour +connaître les démons et scripts à lancer au démarrage. Vous pouvez parcourir +le script pour connaître en détail les commandes exécutées : +

+
+ # nano rootfs/etc/init.d/rcS 
+
+ + + +

Scripts et démons spécifiques

+ +

bootopts.sh - Les options du mode LiveCD

+

+Ce script est utilisé pour configurer les options du mode LiveCD, passées en +ligne de commande au boot, et lisible via le fichier /proc/cmdline. C'est +le script qui permet d'utiliser une clé USB ou un disque dure externe comme +partition /home avec l'option home=usb ou home=sda[1-9], ou encore de spécifier +directement la langue et le clavier à utiliser. +

+ +

network.sh - Initialisation du réseau

+

+Le script network.sh utilise le fichier de configuration /etc/netwok.conf pour +connaître l'interface à utiliser, si l'on veut lancer le client DHCP ou pas, +un IP fixe ou pas. Sur SliTaz le script /etc/init.d/network.sh configure les +interfaces réseau au boot, en ce servant des infornations contenues dans +/etc/network.conf. Si la variable $DHCP est égale à yes, alors le script +/etc/init.d/network.sh lancera le client DHCP sur l'interface $INTERFACE. +

+ +

i18n.sh - Internationalisation

+

+SliTaz sauvegarde la configuration de la locale par défaut dans le fichier +/etc/locale.conf qui est lu par /etc/profile, à chaque login. Le fichier +/etc/locale.conf est généré lors du boot grâce au script /etc/init.d/i18n.sh. +Ce script lance l'application 'tazlocale' que vous trouverez dans +SliTaz tools, si le fichier +de configuration /etc/locale.conf n'existe pas. Nous utilisons le même processus +pour la configuration du clavier en utilisant 'tazkmap' et le fichier de +configuration /etc/kmap.conf. Ces deux applications s'intallent dans +/sbin sur SliTaz, et utilise les bibliothèques ncurses, +ainsi que dialog. Ce script vérifie +aussi si le fichier de configuration du fuseau horaire /etc/TZ existe, +sinon il le crée en se basant sur la configuration du clavier. +

+ +

local.sh - Commande local

+

+Création d'un script /etc/init.d/local.sh pour permettant à l'administrateur +système d'ajouter facilement des commandes local exécutées au boot: +

+
+#!/bin/sh
+# /etc/init.d/local.sh: Local startup commands.
+# All commands here will be executed at boot time.
+#
+. /etc/init.d/rc.functions
+
+echo "Starting local startup commands... "
+
+
+ +

rc.shutdown

+

+Ce script est invoqué par /etc/inittab lors de l'arrêt du système. Il stop +aussi tous les démons via la variable RUN_DAEMONS du fichier de configuration +pricipale /etc/rcS.conf. +

+ + +

/etc/inittab - Fichier de configuration d'init

+

+Le premier fichier lu par le noyau au boot. Il définit le script d'initialisation +(/etc/init.d/rcS), les shells, et les actions en cas d'arrêt ou de reboot. Vous +trouverez une exemple complet et commenté dans l'archive de Busybox et un petit +sur cette page : +

+
+# /etc/inittab: init configuration for SliTaz GNU/Linux.
+# Boot-time system configuration/initialization script.
+#
+::sysinit:/etc/init.d/rcS
+
+# /sbin/getty respawn shell invocations for selected ttys.
+tty1::respawn:/sbin/getty 38400 tty1
+tty2::respawn:/sbin/getty 38400 tty2
+tty3::respawn:/sbin/getty 38400 tty3
+tty4::respawn:/sbin/getty 38400 tty4
+tty5::respawn:/sbin/getty 38400 tty5
+tty6::respawn:/sbin/getty 38400 tty6
+
+# Stuff to do when restarting the init 
+# process, or before rebooting.
+::restart:/etc/init.d/rc.shutdown
+::restart:/sbin/init
+::ctrlaltdel:/sbin/reboot
+::shutdown:/etc/init.d/rc.shutdown
+
+
+ +

Suite

+

+Le Cookbook continue via le chapitre : X window system. +

+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/favicon.ico Binary file doc/cookbook/favicon.ico has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/gtk-apps.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/gtk-apps.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,343 @@ + + + + SliTaz Cookbook - GTK+ apps + + + + + + + + + + + + + + + +
+
+ + +

Applications GTK+

+

+Compilation et installation d'applications graphique utilisant GTK+. +

+ + +

A propos

+

+Ce chapitre décrit les commandes passés pour la compilation et +l'installation des applications GTK+ distribuées par défaut sur le +LiveCD de SliTaz. L'installation +des bibliothèques GTK+ est décrite dans le chapitre : +GTK+ libs. +

+

Variable d'environnement ($fs)

+

+Pour ne pas spécifier tout le chemin vers le répertoire rootfs, export +de la variable d'environnement : +

+
+ # export fs=$PWD/rootfs
+
+

+Pour vérifier : +

+
+ # echo $fs
+
+ +

leafpad-0.8.10 - Editeur de texte tout simple

+

+Site web : http://tarot.freeshell.org/leafpad/ +

+
+ # wget http://savannah.nongnu.org/download/leafpad/leafpad-0.8.10.tar.gz
+ # tar xzf leafpad-0.8.10.tar.gz
+ # cd leafpad-0.8.10
+ # ./configure --prefix=/usr
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip _pkg/usr/bin/*
+
+

Install in rootfs

+
+ # cp _pkg/usr/bin/* $fs/usr/bin
+ # cp _pkg/usr/share/pixmaps/leafpad.png $fs/usr/share/pixmaps
+ # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
+
+ +

gitmail-0.4 - Ghost In The Mail, client de mail

+

+Ghost In The Mail permet d'envoyer rapidement, et facilement des +mails via le protocole SMTP. +

+

+Site web : http://gitmail.sourceforge.net/ +

+
+ # wget http://switch.dl.sourceforge.net/sourceforge/gitmail/gitmail-0.4.tar.gz
+ # tar xzf gitmail-0.4.tar.gz
+ # cd GhostInTheMail-0.4
+ # ./configure --prefix=/usr
+ # make
+ # make DESTDIR=$PWD/_pkg \
+   gitmaildocdir=/usr/share/doc/GhostInTheMail \
+   install
+ # strip _pkg/usr/bin/*
+
+

Install in rootfs

+
+ # cp _pkg/usr/bin/* $fs/usr/bin
+
+ +

gqview-2.0.4 - Gestionnaire d'images

+

+Site web : http://gqview.sourceforge.net/ +

+
+ # wget http://belnet.dl.sourceforge.net/sourceforge/gqview/gqview-2.0.4.tar.gz
+ # tar xzf gqview-2.0.4.tar.gz
+ # cd gqview-2.0.4
+ # ./configure --prefix=/usr --mandir=/usr/share/man
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip _pkg/usr/bin/*
+
+

Install in rootfs

+
+ # cp _pkg/usr/bin/* $fs/usr/bin
+ # cp _pkg/usr/share/pixmaps/* $fs/usr/share/pixmaps
+ # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
+
+ +

mtpaint-3.11 - Création et traitement d'images

+

+Site web : http://mtpaint.sourceforge.net/ +

+
+ # wget http://switch.dl.sourceforge.net/sourceforge/mtpaint/mtpaint-3.11.tar.bz2
+ # tar xjf mtpaint-3.11.tar.bz2
+ # cd mtpaint-3.11
+ # ./configure --cpu=i486 --prefix=/usr intl
+ # make
+ # strip src/mtpaint
+
+

Install in rootfs

+
+ # cp src/mtpaint $fs/usr/bin
+ # cp po/fr.mo $fs/usr/share/locale/fr/LC_MESSAGES/mtpaint.mo
+ # cp src/icons1/icon.xpm $fs/usr/share/pixmaps/mtpaint.xpm
+
+ +

Transmission-0.72 - Client BitTorrent léger

+

+Transmission est un client BitTorrent, rapide, léger, et simple d'utilisation. +La complitation du paquet fourni un client en ligne de commande +(transmissioncli) et un client GTK+ (transmission-gtk). Nous installons que +le client GTK+, le client en ligne de commande est distribué sous forme de +paquet SliTaz (*.tazpkg). +

+

+Site web : http://transmission.m0k.org/ +

+
+ # wget http://download.m0k.org/transmission/files/Transmission-0.72.tar.gz
+ # tar xzf Transmission-0.72.tar.gz
+
+ La version 0.72 est mal archivée:
+ # mv "Transmission .72" Transmission-0.72
+
+ # cd Transmission-0.72
+ # ./configure --prefix=/usr  --disable-openssl
+ # make
+ # strip gtk/transmission-gtk
+ # strip cli/transmissioncli
+
+

Install in rootfs

+
+ # cp gtk/transmission-gtk $fs/usr/bin
+ # cp gtk/transmission.png $fs/usr/share/pixmaps
+ # cp gtk/po/fr.mo $fs/usr/share/locale/fr/LC_MESSAGES/transmission-gtk.mo
+
+ +

emelfm2-0.3.5 - Gestionnaire de fichiers

+

+L'application emelFM2, est un gestionnaire de fichiers, fournissant +pleins de fonctions utiles, tel que le montage de périphériques, un +visualisateur de texte, l'ouverture d'un terminal dans le répertoire +courant, etc. +

+

+Site web : http://emelfm2.net/ +

+
+ # cd ..
+ # wget http://emelfm2.net/rel/emelfm2-0.3.5.tar.gz
+ # tar xzf emelfm2-0.3.5.tar.gz
+ # cd emelfm2-0.3.5
+ # make PREFIX=/usr
+ # make i18n PREFIX=/usr
+ # make install PREFIX=$PWD/_pkg/usr
+ # make install_i18n PREFIX=$PWD/_pkg/usr
+ # strip -v _pkg/usr/bin/*
+ # strip -v _pkg/usr/lib/emelfm2/plugins/*
+
+

Install in rootfs

+
+ # cp _pkg/usr/bin/* $fs/usr/bin
+ # cp -a _pkg/usr/lib/* $fs/usr/lib
+ # cp -a _pkg/usr/share/pixmaps $fs/usr/share
+ # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
+
+ +

geany-0.11 - Environnement de Développement Intégré

+

+Geany et un IDE, il est simple, léger, et rapide, proposant la +coloration syntaxique, les onglets, pliage/dépliage du code, la +complétion automatique, de l'aide à l'écriture, une liste des symboles, +et bien plus. +

+

+Site web: http://geany.uvena.de/ +

+

+Pour compiler et faire fonctionner geany sur SliTaz, il faut les +bibliothèques libstdc++ et libgcc1, toutes deux fournies par gcc (nous +utilisons gcc-4.1.1 que nous avons recompilé, mais vous pouvez copier +les bibliothèques depuis votre système hôte). +

+

+Note: Si la force est avec vous, vous pouvez l'activer via l'option: +--enable-the-force +

+
+ # wget http://mesh.dl.sourceforge.net/sourceforge/geany/geany-0.11.tar.gz
+ # tar xzf geany-0.11.tar.gz
+ # cd geany-0.11
+ # ./configure --prefix=/usr --mandir=/usr/share/man \
+   --disable-vte --enable-the-force
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/usr/bin/*
+
+

Install in rootfs

+
+ # cp _pkg/usr/bin/* $fs/usr/bin
+ # cp -a _pkg/usr/share/geany $fs/usr/share
+ # cp _pkg/usr/share/pixmaps/geany.png $fs/usr/share/pixmaps
+ # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
+
+ +

gftp-2.0.18 - Client FTP simple et rapide

+

+L'application gFTP est un client FTP proposant une interface graphique +en GTK+. Simple, rapide, efficace et facile à prendre en main. A noter +que nous compilons sans le support ssl et l'interface texte. Get, +untar, configure, compile and install. +

+

+Site web : http://www.gftp.org/ +

+
+ # wget http://www.gftp.org/gftp-2.0.18.tar.gz
+ # tar xzf gftp-2.0.18.tar.gz
+ # cd gftp-2.0.18
+ # ./configure --prefix=/usr --mandir=/usr/share/man \
+   --disable-ssl --disable-textport \
+   --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip _pkg/usr/bin/*
+
+

Install in rootfs

+

+Slitaz ne fournit que le client GTK+ sur le LiveCD. A noter que +gftp est simplement un petit script détectant +l'environnement (console ou X) et lançant la bonne interface, de +plus ça fait qu'u nom à se souvenir pour l'utilisateur : +

+
+ # cp _pkg/usr/bin/gftp $fs/usr/bin
+ # cp _pkg/usr/bin/gftp-gtk $fs/usr/bin
+ # cp -a _pkg/usr/share/gftp $fs/usr/share
+ # cp -a _pkg/usr/share/pixmaps $fs/usr/share
+ # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
+
+

+Pour gagner un peu de place et éviter les doublons, vous pouvez +supprimer le COPIYING (17 Ko) inclut dans /usr/share/gftp. La licence +GNU étant déjà présente dans /usr/share/license, si vous le voulez +vous pouvez créer un lien symbolique, à vous de voir. +

+ +

xpad-2.12 - Mini application de prise de notes.

+

+L'application xpad permet de prendre rapidement divers notes via des +fenêtres GTK personnalisables. +

+

+Site web : http://xpad.sourceforge.net/ +

+
+ # wget http://surfnet.dl.sourceforge.net/sourceforge/xpad/xpad-2.12.tar.bz2
+ # tar xjf xpad-2.12.tar.bz2
+ # cd xpad-2.12
+ # ./configure --prefix=/usr --mandir=/usr/share/man \
+   --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip _pkg/usr/bin/*
+
+

Install in rootfs

+
+ # cp _pkg/usr/bin/xpad $fs/usr/bin
+ # cp -a _pkg/usr/share/pixmaps $fs/usr/share
+ # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
+
+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/gtk-libs.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/gtk-libs.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,276 @@ + + + + SliTaz Cookbook - GTK+ libs + + + + + + + + + + + + + + + +
+
+ + +

Bibliothèques GTK+

+

+Compilation et installation des bibliothèques GTK+ et compagnie. +

+ + +

A propos

+

+Ce chapitre décrit l'installation et la configuration sur SliTaz, des +bibliothèques GTK permettant d'insataller des miliers de logiciels. +A noter que vous pouvez simplement compiler, et créer un paquet +SliTaz que vous installé ensuite à la demande avec tazpkg. +

+

+La compilation de GTK demandes pas mal de temp, et il faut satisfaire +beaucoup de dépendances. Vous trouverez (en anglais) le guide de +compilation de GTK: gtk-building.html sur developer.gnome.org. Ce document +précise qu'il faut compiler dans l'ordre: GLib, Pango, ATK, puis GTK+. +Avant de commancer il faur vérifier que les dépendances soient bien installées +sur votre système hôte. Les paquets GLib, Pango, ATK, et GTK+ vont ensemles, +et sont distribués par l'équipe des développeurs GTK. Nous ne les décrivons pas, +seulement les commandes à lancer. +

+

Variable d'environnement ($fs)

+

+Pour ne pas spécifier tout le chemin vers le répertoire rootfs, export +de la variable d'environnement: +

+
+ # export fs=$PWD/rootfs
+
+

+Pour vérifier: +

+
+ # echo $fs
+
+ +

cairo-1.2.6 - 2D graphics library

+

+Nous commençons par libcairo +(http://www.cairographics.org/) +utilisé pour compiler pango: +

+
+ # cd src
+ # wget http://cairographics.org/releases/cairo-1.2.6.tar.gz
+ # tar xzf cairo-1.2.6.tar.gz
+ # cd cairo-1.2.6
+ # ./configure --prefix=/usr --mandir=/usr/share/man \
+   --with-html-dir=/usr/share/doc
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/usr/lib/*.so*
+
+

Install in rootfs

+
+ # cp -av _pkg/usr/lib/*.so* $fs/usr/lib
+
+ +

glib-2.12.4 - C routines

+
+ # cd ..
+ # wget ftp://ftp.gtk.org/pub/glib/2.12/glib-2.12.4.tar.bz2
+ # tar xjf glib-2.12.4.tar.bz2
+ # cd glib-2.12.4
+ # ./configure --prefix=/usr --sysconfdir=/etc \
+   --mandir=/usr/share/man --with-html-dir=/usr/share/doc
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/usr/bin/*
+ # strip -v _pkg/usr/lib/*.so*
+
+

Install in rootfs

+

+Option, les utilitaires glib-genmarshal et gobject-query on besoin de +/lib/tls/librt.so.1: +

+
+ # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
+ # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
+ 
+ Les binaires en option:
+ # cp -a _pkg/usr/bin/* $fs/usr/bin
+
+ +

pango-1.14.8 - Library for layout and rendering of text

+
+ # cd ..
+ # wget ftp://ftp.gtk.org/pub/pango/1.14/pango-1.14.8.tar.bz2
+ # tar xjf pango-1.14.8.tar.bz2
+ # cd pango-1.14.8
+ # ./configure --prefix=/usr --sysconfdir=/etc \
+   --mandir=/usr/share/man --with-html-dir=/usr/share/doc
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/usr/bin/*
+ # strip -v _pkg/usr/lib/*.so*
+ # strip -v _pkg/usr/lib/pango/1.5.0/modules/*
+
+

Install in rootfs

+
+ # cp -a _pkg/usr/bin/* $fs/usr/bin
+ # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
+ # cp -a _pkg/usr/lib/pango $fs/usr/lib
+ # rm -rf $fs/usr/lib/pango/1.5.0/modules/*.la
+ # cp -a _pkg/etc $fs
+
+

+Création du fichier /etc/pango/pango.modules via un chroot dans +le rootfs (pango-querymodules utilise librt.so.1): +

+
+ # chroot $fs /bin/ash
+ /# pango-querymodules > /etc/pango/pango.modules
+ # exit
+
+ +

atk-1.12.4 - Accessibility toolkit

+
+ # cd ..
+ # wget http://ftp.gnome.org/pub/gnome/sources/atk/1.12/atk-1.12.4.tar.bz2
+ # tar xjf atk-1.12.4.tar.bz2
+ # cd atk-1.12.4
+ # ./configure --prefix=/usr --mandir=/usr/share/man \
+   --with-html-dir=/usr/share/doc
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/usr/lib/*.so*
+
+

Install in rootfs

+
+ # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
+ # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
+
+ +

gtk+-2.8.20 - The GIMP Toolkit

+
+ # cd ..
+ # wget ftp://ftp.gtk.org/pub/gtk/v2.8/gtk+-2.8.20.tar.bz2
+ # tar xjf gtk+-2.8.20.tar.bz2
+ # cd gtk+-2.8.20
+ # ./configure --prefix=/usr --sysconfdir=/etc \
+   --mandir=/usr/share/man --with-html-dir=/usr/share/doc
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/usr/bin/*
+ # strip -v _pkg/usr/lib/*.so*
+ # strip -v --strip-unneeded \
+   _pkg/usr/lib/gtk-2.0/2.4.0/*/*
+
+

Install in rootfs

+
+ # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
+ # mkdir $fs/usr/lib/gtk-2.0
+ # cp -a _pkg/usr/lib/gtk-2.0/2.4.0 $fs/usr/lib/gtk-2.0
+ # rm -rf $fs/usr/lib/gtk-2.0/2.4.0/*/*.la
+ 
+ Locale et themes:
+ # cp -a _pkg/usr/share/locale/fr $fs/usr/share/locale
+ # cp -a _pkg/usr/share/themes $fs/usr/share
+ 
+ Les applications:
+ # cp  _pkg/usr/bin/gtk-query-immodules-2.0 $fs/usr/bin
+ # cp  _pkg/usr/bin/gtk-update-icon-cache $fs/usr/bin
+ # cp  _pkg/usr/bin/gdk-pixbuf-csource $fs/usr/bin
+ # cp  _pkg/usr/bin/gdk-pixbuf-query-loaders $fs/usr/bin
+ ...
+ 
+ Pour l'application gtk-demo:
+ # cp -a _pkg/usr/bin/gtk-demo $fs/usr/bin
+ # cp -a _pkg/usr/share/gtk-2.0 $fs/usr/share
+
+

+Création des fichiers /etc/gtk-2.0/gtk.immodules et gdk-pixbuf.loaders +via un chroot dans le rootfs: +

+
+ # chroot $fs /bin/ash
+ /# mkdir /etc/gtk-2.0
+ /# gtk-query-immodules-2.0 > /etc/gtk-2.0/gtk.immodules
+ /# gdk-pixbuf-query-loaders > /etc/gtk-2.0/gdk-pixbuf.loaders
+ # exit
+
+

+A ce stade vous pouvez tester GTK+ avec l'application 'gtk-demo' en +créant une ISO, et en utilisant 'qemu'. Vous pouvez aussi compiler +une petite application GTK+ tel que LeafPad, et tester! La compilation et +l'installation des application GTK+ distribuées par défaut avec SliTaz, est +décrite dans le chapitre gtk-apps. +

+ +

Génération de l'initramfs, et d'une image ISO

+

+Pour créer une nouvelle image ISO vous pouvez utiliser 'mktaziso' +contenu dans SliTaz tools. Vous pouvez aussi créer +un nouvelle image initramfs, et la copier dans /boot de la racine de cdrom +(rootcd), et pour finir créer un image ISO avec genisoimage: +

+
+ # cd $fs
+ # find . -print | cpio -o -H newc | gzip -9 > ../rootfs.gz
+ # cd ..
+ # cp rootfs.gz rootcd/boot
+ # genisoimage -R -o slitaz-cooking.iso -b boot/isolinux/isolinux.bin \
+   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
+   -V "SliTaz" -boot-info-table rootcd 
+
+

Suite

+

+Après les bibliothèques, les applications GTK+. +

+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/hacker.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/hacker.txt Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,58 @@ +SliTaz cookbook - SliTaz User /home/hacker +================================================================================ +SliTaz et l'utilisateur hacker. + + +L'utilisateur hacker, est l'utilisateur par défaut en mode LiveCD, il n'a pas +de mot de passe. Son répertoire personnel est: /home/hacker. Il y a divers +répertoires est fichiers préinstallés que l'on peut trouver dans /home, des +SliTaz tools. Si l'option home=usb est spécifiée au boot, le script +d'initialisation slitaz-bootopts.sh vérifie que le répertoire /home/hacker, +si ce n'est pas le cas, les fichiers par défaut sont copier sur la clé USB. + + +Adduser hacker +-------------- +Ajout de l'utilisateur hacker avec le shell ash, en se chrootant dans le rootfs: + + # chroot rootfs /bin/ash + # adduser hacker -s /bin/ash + Enter new password: + ... + # exit + + +/home/hacker/* +-------------- +Le contenu du répertoire /home/hacker sur SliTaz: + + * Documents/ - Répertoire déstiné aux documents personnel. + * bookmarks.html - Fichier de marques pages utilisé par retawq. + * Images/ - Répertoire d'images: Art ASCII, Logos, Icons, etc. + * Templates/ - Répertoire des modèles, html, shell script, etc. + * Public/ - Répertoire public du serveur web. + * . - Les fichiers cachés (commence par un point). Ce + sont les fichiers de configuration des divers + applications. + +A vous de copier depuis SliTaz tools, les fichiers qui vous semblent utiles, +et ou de les modifier à votre convenance. + + +Les permissions +--------------- +Si vous copié les fichiers d'hacker avec un utilisateur qui n'a pas la même id, +les fichiers ne seront pas modifiables par hacker. Pour cela il faut modifier +les permissions en ce chrootant: + + # chroot rootfs /bin/ash + # chown -R hacker.hacker /home/hacker + Si besoin est: + # chmod 755 /home/hacker + # chmod 755 /home/hacker/Art + etc... + # exit + + +================================================================================ + http://www.slitaz.org/ diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/images/css/content-tl.png Binary file doc/cookbook/images/css/content-tl.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/images/css/content-tr.png Binary file doc/cookbook/images/css/content-tr.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/images/css/footer-bl.png Binary file doc/cookbook/images/css/footer-bl.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/images/css/footer-br.png Binary file doc/cookbook/images/css/footer-br.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/images/css/header.png Binary file doc/cookbook/images/css/header.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/index.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/index.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,212 @@ + + + + SliTaz Cookbook + + + + + + + + + + + + + + + +
+
+ + +

Livre de cuisine de SliTaz

+

+Index des documents du cookbook de SliTaz, construction pas à pas d'un système +mini GNU/Linux Live et installable. +

+

Table des matières

+

LiveCD

+ +

Paquets, recette, wok et système

+ + + +

Introduction

+

+Le cookbook vous permet de suivre la création du LiveCD de SliTaz et de faire +un voyage au coeur d'un système GNU/linux. Vous serez ensuite capable de +personnaliser votre nouveau système ou de créer votre propre distro autonome +fonctionnant en mémoire vive (RAM), et pleinement installable, sur disque dure +ou clé USB. Une fois démarré, vous pouvez enlever le cd-rom et SliTaz +fonctionne encore. SliTaz peut aussi être utilisé comme environnement dans +lequel on se chroot, ou comme cd-rom multitâches. Le seul prérequis est une +distribution hôte dans laquel nous allons piquer des bibliothèques, utiliser +le compilateur, et les outils de développement. Ce système hôte peut-être: un +environnement de développement chrooté, un distro minimal, SliTaz installé +sur un disque dur ,ou une distro "généraliste" tel que Debian, Slackware, +Fedora, Mandriva, Gentoo, Arch, etc. A noter que nous n'installons rien dans +le système hôte lors de nos commandes. +

+

+SliTaz utilise BusyBox, comme base du +système et le noyau Linux. BusyBox c'est le couteaux Suisse de l'embarqué, +utilisant une faible empreinte mémoire, et fournissant beaucoup de fichiers +d'exemples. Busybox est donc notre principale source d'informations, c'est +un utilitaire issu du projet Debian. Nous utilisons et chérissons cette +fabuleuse ditribution, nous ne pouvons donc, que vous conseiller d'utiliser +Debian GNU/Linux. +

+

+SliTaz utilise le bootloader Syslinux et une archive initramfs du système, +compresée avec cpio. Cette archive est ensuite +décompréssée en mémoire vive lors du boot par le noyau, dans un système +sans taille fixe, en gardant le contrôle sur init. Lors des +copies ou compilation d'applications on utilisera strip pour +nettoyer les réperoires. Les logiciels genisoimage et mkisofs peuvent être +utilisés à choix pour la création des images iso. Pour finir vous pouvez +tester l'image .iso avec Qemu ou en gravant l'image sur un +cdrom réinscriptible. +

+ +

Organisation du répertoire de travail

+

+Pour créer SliTaz, nous utilisons un répertoire de travail et plusieurs +sous-répertoires. Que vous ayez un environnement chrooté pour développer, +ou un système hôte, nous proposons d'utiliser un répertoire nommé distro/, +pour travailler. Le répertoire distro/ peut être un simple dossier, ou une +partition, mais vous êtes évidemment libre, de mettre tous cela ailleur. +

+

distro/

+

Contenu du répertoire de travail:

+ +

+Par la suite, l'initramfs et l'image ISO bootable (slitaz-cooking.iso) +seront crées à la racine du répertoire de travail SliTaz/. +

+

Option: rootfs.ext2 - Utilisation d'un disque dure virtuel

+

+Option: rootfs.ext2 (root file system in ext2). C'est un disque dur +virtuel, formaté en ext2 et monté en boucle sur rootfs/. Un périphérique de +boucle, permet d'utiliser un fichier comme s'il s'agissait d'un périphérique +normal (disque dur, disquette, etc), pour construire un système de fichiers +dedans. Ce fichier peut être du nombre de méga-octets que vous désirez, nous +vous proposons 20480 kb, ce qui correspond à un 20 Mb: +

+
+ # dd if=/dev/zero of=rootfs.ext2 bs=1k count=20480
+
+

+Création d'un système de fichier ext2 sur le fichier rootfs.ext2, l'option +-F force le formatage du fichier. A noter que que l'utilisation +de l'option -m 0, n'alloue aucune place à l'utilisateur root, +par défaut elle occupe environ 5%, et l'option -t défini le type +du système de fichier à utiliser, tel que ext2, ou ext3: +

+
+ # mkfs -t ext2 -F -m 0 rootfs.ext2
+
+

+Nous pouvons maintenant monter rootfs.ext2 en boucle, grâce à l'option +-o loop fournie par l'utilitaire mount, et cela +dans le répertoire rootfs/. Vous pouvez vérifier si le montage c'est bien +effectué avec la commande df -h: +

+
+ # mkdir rootfs
+ # mount -o loop rootfs.ext2 rootfs
+ # df -h
+
+

+A la fin de la session de travail, vous pouvez démonter le volume avec umount: +

+
+ # umount rootfs
+
+

+Vous serez maintenant, sûrement intéressé par +la construction du système de base SliTaz. +

+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/locale.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/locale.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,182 @@ + + + + SliTaz Cookbook - Locale & i18n + + + + + + + + + + + + + + + +
+
+ + +

Locale & i18n

+

+Installation et configuration de la locale pour le français. +

+ + +

Installation des locales

+

+Ce chapitre décrit l'installation des locales sur SliTaz GNU/Linux, depuis +un système hôte SliTaz GNU/Linux. L'install des locales pour le serveur X est +décrite dans le chapitre X window system. +Les divers fichiers copier dans ce chapitre proviennent de la compilation +du paquet glibc-2.3.6 fesant partie de la toolchain. +

+

Répertoires des divers fichiers

+

+Nous commençons par créer les répertoires qui contiendront les bibliothèques +et les fichiers utiles aux différentes locales. Le répertoire LC_MESSAGES +contient les fichiers .mo pour les messages traduits s'y ils existent: +

+
+ # mkdir -p rootfs/usr/share/{i18n,locale}
+ # mkdir -p rootfs/usr/lib/{locale,gconv}
+ # mkdir -p rootfs/usr/share/i18n/{charmaps,locales}
+ # mkdir -p rootfs/usr/share/locale/fr/LC_MESSAGES
+
+

+Copie des fichiers de localisation pour le Français, le Suisse romand, +et le Suisse allemand, dans /usr/share/i18n/locales: +

+
+ # cp -a /usr/share/i18n/locales/{de_CH,fr_CH,fr_FR,i18n,iso14651_t1} \
+   rootfs/usr/share/i18n/locales
+
+

+Copie des fichier translit_* dans /usr/share/i18n/locales: +

+
+ # cp -a /usr/share/i18n/locales/{translit_circle,translit_cjk_compat} \
+   rootfs/usr/share/i18n/locales
+ # cp -a /usr/share/i18n/locales/{translit_combining,translit_compat} \
+   rootfs/usr/share/i18n/locales   
+ # cp -a /usr/share/i18n/locales/{translit_font,translit_fraction} \
+   rootfs/usr/share/i18n/locales
+ # cp -a /usr/share/i18n/locales/{translit_narrow,translit_neutral} \
+   rootfs/usr/share/i18n/locales
+ # cp -a /usr/share/i18n/locales/{translit_small,translit_wide} \
+   rootfs/usr/share/i18n/locales
+
+

+Copie des fichier charmaps dans /usr/share/i18n/charmaps +

+
+ # cp -a /usr/share/i18n/charmaps/ANSI_X3.* rootfs/usr/share/i18n/charmaps
+ # cp -a /usr/share/i18n/charmaps/{ISO-8859-1.gz,ISO-8859-2.gz,ISO-8859-15.gz} \
+   rootfs/usr/share/i18n/charmaps
+
+

+Copie des bibliothèques gconv dans /usr/lib/gconv du rootfs de SliTaz: +

+
+ # cp /usr/lib/gconv/{ANSI_X3.110.so,gconv-modules,UNICODE.so} \
+   rootfs/usr/lib/gconv
+ # cp /usr/lib/gconv/{ISO8859-1.so,ISO8859-2.so,ISO8859-15.so} \
+   rootfs/usr/lib/gconv
+ # strip -v rootfs/usr/lib/gconv/*.so
+
+

+Copie de l'utilitaire locale: +

+
+ # cp /usr/bin/locale rootfs/usr/bin
+
+

+Il faut encore que le fichier /usr/lib/locale/locale-archive soit généré, +pour cela nous utilisons l'utilitaire localedef, en se chrootant dans SliTaz: +

+
+ # cp /usr/bin/localedef rootfs/usr/bin
+ # chroot rootfs /bin/ash
+
+

+Utilisation de localedef pour la Suisse romand et la France: +

+
+ /# localedef -i fr_CH -f ISO-8859-1 fr_CH
+ /# localedef -i fr_FR -f ISO-8859-1 fr_FR
+ /# exit
+
+

+Vous pouvez supprimer le binaire localedef pour gagner +un peu de place. +

+
+ # rm rootfs/usr/bin/localedef
+
+ +

Config et utilisation d'une locale

+

+Pour utiliser la langue lors d'une session, vous pouvez créer un script +lancé au boot, ou ajouter 2 lignes au fichier ~/.profile, propre à chaque +utilisateurs, avec pour contenu: +

+
+
+export LANG=fr_CH
+export LC_ALL=fr_CH
+
+
+

+Voilà la langue Française devrait fonctionner, si vous installez retawq ou +nano vous pouvez vérifier le bon fonctionnement des locales en copiant +le fichier .mo des sources de Retawq, ou Nano, dans: +/usr/share/locale/fr/LC_MESSAGES. +

+

Suite

+

+SliTaz utilise le script /etc/init.d/i18n.sh et le fichier de configuration +/etc/locale.conf pour gérer la locale du système. Ce script est détaillé dans +le chapitre scripts de démarrage et arrêt. +Sur un système SliTaz, il suffit donc de modifier le fichier /etc/locale.conf +avec un éditeur de texte, ou de lancer 'tazlocale' pour changer la locale par +défaut du système, ou de spécifier la langue au boot via l'option +lang=xx. +

+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/misc.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/misc.txt Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,28 @@ +SliTaz Cookbook - misc +=============================================================================== +Divers, tout ce qui ne va pas bien ailleur. + + + * HicolorTheme - Thème par défaut des icons. + + +HicolorTheme +------------ +Thème par défaut des icons, en soit il n'est pas indispensable, mais +son installation évite des messages d'erreurs sur la console. + + # wget http://icon-theme.freedesktop.org/releases/hicolor-icon-theme-0.10.tar.gz + # tar xzf hicolor-icon-theme-0.10.tar.gz + # cd hicolor-icon-theme-0.10 + # ./configure --prefix + # make DESTDIR=$PWD/_pkg install + + Install dans le $fs de SliTaz: + + # cp -a _pkg/usr $fs + +Vous pouvez ensuite copier les icons que vous désirez, tel que +gnome-fs-home.png. + +=============================================================================== + http://www.slitaz.org/ diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/packaging.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/packaging.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,59 @@ + + + + SliTaz Cookbook - Packaging + + + + + + + + + + + + + + + +
+
+ + +

Packaging

+ + + + + + + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/receipts.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/receipts.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,244 @@ + + + + SliTaz Cookbook - Receipts (Recettes des paquets) + + + + + + + + + + + + + + + +
+
+ + +

Receipts (Recettes des paquets)

+

+Ce document décrit les possibilités offertes par les recettes utilisées par +Tazwok pour compiler et générer des paquets pour SliTaz et tazpkg, via +(le wok et les outils). La recette d'un paquet +est aussi utilisée par Tazpkg pour installer/désinstaller et donner des +informations au sujet d'un paquet.tazpkg (package). Chaque recette commence +par un commentaire en English : +

+
+ # SliTaz package receipt.
+
+ +

Variables de base

+

+Les 5 premières variables devraient toujours être présentes et configurées. +Elles configure respectivement le non du paquet ($PACKAGE), sa version, sa +catégorie, une courte description et le nom du mainteneur. Exemple pour le +paquet du gestionnaire de fichiers Clex : +

+
+ PACKAGE="clex"
+ VERSION="3.16"
+ CATEGORY="base-apps"
+ SHORT_DESC="Text mode file manager."
+ MAINTAINER="pankso@slitaz.org"
+
+ +

Variables optionnelles

+

+Tazwok sait aussi utiliser divers variables optionnelles si elles existent, il +peut par exemple, utiliser un autre nom pour le paquet source. Il y a aussi des +variables qui sont utilisées par Tazpkg pour gérer les dépendances ou donner +des informations sur le paquet. +

+

+$DEPENDS: Specifie les dépendances, il peut y avoir plusieurs +paquets séparés par un espace ou sur plusieurs lignes. Cette variable est +principalement utilisée par Tazpkg lors de l'installation du paquet et Tazwok +pour construire de gros paquets comme Xorg. Exemple pour Clex qui dépend du +paquet ncurses : +

+
+ DEPENDS="ncurses"
+
+$BUILD_DEPENDS: Specifie les dépendances de compilation, séparées +par un espace ou sur plusieurs lignes. Cette variable est utilisée par Tazwok +lors de la cuisson d'un paquet et Tazwok. Exemple : +

+
+ BUILD_DEPENDS="ncurses-dev"
+
+

+$TARBALL : L'archive source avec sont extension (tar.gz, tgz ou +tar.bz2). En générale, les variables $PACAKAGE et $VERSION sont utilisées et +il suffit de modifier l'extension, cela permet de mettre à jour le paquet en +ne modifiant que la variable de la version. Exemple générique (voir aussi +la variable $SOURCE) : +

+
+ TARBALL="$PACKAGE-$VERSION.tar.gz"
+
+

+$WEB_SITE : Le site web officiel du paquet. Il se peut que +certaines bibliothèques n'aient pas de site Web, dans ce cas il n'y a pas +besoin de spécifier d'URL. Tazwok et Tazpkg s'attendent a trouver l'URL +complet avec le http : +

+
+ WEB_SITE="http://www.clex.sk/"
+
+

+$WGET_URL : L'url de téléchargement des l'archive source. En +générale la variable $TARBALL devraient être utilisée pour faciliter la mise +à jour du paquet en ne modifiant que $VERSION. Le fichier de configuration de +Tazwok configure aussi, par défaut, 3 variable de miroir souvent utilisés. +$GNU_MIRROR pour les miroir GNU, $SF_MIRROR pour SourceForge et XORG_MIRROR +pour le mirroir du serveur graphique Xorg. Exemple pour Clex : +

+
+ WGET_URL="http://www.clex.sk/download/$TARBALL"
+
+

+$WANTED : Il y a des paquets SliTaz qui sont dépendants de la +compilation d'un paquet source. La recette de ces paquets ne nécessite pas de +règles de compilation, une variable $WANTED peut être utilisée pour copier des +fichiers depuis les sources du paquet voulu en utilisant la variable $src. +

+

+$SOURCE : Il se peut que le nom du paquet Tazpkg diffère du nom +du paquet source. C'est le cas par exemple pour les paquets d'Xorg, le nom +Tazpkg des bibliothèque X11 est 'xorg-libX11' et le nom du paquet source est +libX11. Cette astuces permet aussi de continuer à utiliser les varibables +$src et $_pkg lors la cuisson d'un paquet. A noter que dans le cas libX11, +le nom de l'archive source devient $SOURCE-$VERSION.tar.gz. +

+ +

Variables utilisables dans les fonctions

+

+Tazwok configure plusieurs variables permettant de faciliter la compilation et +la construction de paquets Tazpkg. Ces variables sont gérées automatiquement +par Tazwok en utilisant les informations contenues dans les recettes, elles +peuvent être utilisées par la fonction compile_rules et genpkg_rules décrites +toutes deux dans le chapitre : Fonctions. +

+

+$src : Définit le chemin vers le répertoire des sources désarchivée. +

+

+$_pkg : Définit le chemin vers les binaires compliés et installés +via la commande 'make DESTDIR=$PWD/_pkg install'. Cette variable est utilisée +pour copier les fichiers générés et créer des paquets tazpkg. +

+

+$fs : Définit le chemin vers le pseudo système de fichier (fs) +propre à chaque paquet. Le 'fs' d'un paquet correspond à la racine du système +cible, un binaire tel que Clex sera par exemple dans $fs/usr/bin/clex, à noter +qu'il faut créer les répertoires nécessaires via la fonction genpkg_rules() +avant de copier des fichiers. +

+

+$CONFIGURE_ARGS : Cette variables est définie dans le fichier de +configuration de Tazwok (tazwok.conf), elle permet de spécifier des +arguments d'optimisation générique lors de la configuration d'un paquet. +Par défaut l'architecture est i486. +

+ +

Fonctions

+

+Une recette peut contenir 4 fonctions. Tazwok sait traiter les fonctions +contenant les règles de compliation (compile_rules) et les règles servant à +générer un paquet Tazpkg (genpkg_rules). Ces fonctions peuvent contenir toutes +sortes de commandes GNU/Linux standards tels que sed ou patch et les variables +configurées automatiquements. A noter que ces deux fonctions utilisent les +commandes du Cookbook de SliTaz : http://www.slitaz.org/doc/cookbook/ +

+

compile_rules()

+

+Pour compiler un paquet vous pouvez utiliser la variable $src pour vous +déplacer (cd) dans le répertoire des sources et utiliser $CONFIGURE_ARGS +pour inclure les arguments depuis le fichiers de configuration de Tazwok. +Pour construire le paquet il suffit généralement de lancer 'make' sans +arguments et pour installer le paquet dans un répertoire _pkg/ il faut +utiliser la commande 'make DESTDIR=$PWD/_pkg install'. Exemple générique : +

+
+# Rules to configure and make the package.
+compile_rules()
+{
+	cd $src
+	./configure --prefix=/usr --infodir=/usr/share/info \
+	--mandir=/usr/share/man $CONFIGURE_ARGS
+	make
+	make DESTDIR=$PWD/_pkg install
+}
+
+

genpkg_rules()

+

+Pour générer un paquet Tazpkg il faut mettre les commandes à lancer dans la +fonction genpkg_rules. Dans cet exemple on créer le répertoire +usr/ dans le pseudo système de fichiers du paquet, on copie tout +le(s) binaires(s) et on finit par un strip pour nettoyer les fichiers : +

+
+# Rules to gen a SliTaz package suitable for Tazpkg.
+genpkg_rules()
+{
+	mkdir -p $fs/usr
+	cp -a $_pkg/usr/bin $fs/usr
+	strip -s $fs/usr/bin/*
+}
+
+

pre_install() et post_install()

+

+Ces deux fonctions sont lancées par Tazpkg lors de l'installation du paquet. +Il faut les définir avant de générer le paquet.tazpkg avec Tazwok. Si aucune +commandes n'est nécessaires ces deux fonction n'ont aucune raison d'être et +peuvent être supprimées. Exemple avec echo pour afficher un peu de texte +(aucune fonction ne doit être vide) : +

+
+# Pre and post install commands for Tazpkg.
+pre_install()
+{
+	echo "Processing pre-install commands..."
+}
+post_install()
+{
+	echo "Processing post-install commands..."
+}
+
+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/release-tasks.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/release-tasks.txt Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,44 @@ +SliTaz Cookbook - LiveCD release tasks +=============================================================================== +Les choses à faire avant de publier un nouvelles version. + + + * Préparer l'arbre de la distribution et la liste des paquets, générer un + fichier de configuration et le configurer avec les commandes de Tazlito + (tazlito gen-config && tazlito configure). + + * Vérifier le menu de JWM pour que toutes les applications soient disponibles + et que le fond d'écran configuré soit bien présent (/usr/share/images). A + noter que le menu/thème de JWM est installé par les SliTaz tools. + + * Ajouter l'utilisateur hacker avec le script addhacker, les fichiers copier + son placés dans addfiles et proviennent des exemples fournits par les + outils (slitaz-tools). Les permissions devraient être vérifiée. Le Cookbook + en parle : http://www.slitaz.org/doc/cookbook/hacker.txt + + * Checker la version de Slitaz spécifiée dans le message : /etc/issue + Il faut que se soit la même que dans le fichier isolinux.msg affiché en + premier au démarrage et dans le fichiers de configuration du miroir pour + Tazpkg : /var/lib/tazpkg/mirror. + + * Editer le fichier isolinux.msg pour y mettre la date de publication/version + en accord avec /etc/issue. + + * En cas de chroot et modifications dans le rootfs, on peut reconstruire + le système avec 'tazlito gen-initiso' (ne pas oublier de fichiers cachés + dans /root). + + * Ajouter et vérifier les documents et images qui sont à la racine du cdrom, + le fichier README, index.html, style.css et le répertoire des images. Tous + les fichiers sont dans l'archive des slitaz-tools et il suffit de les + copier dans addfiles/ avant de regénérer l'ISO. + + * Tester, tester, encore tester... + + * Préparer l'annonce pour le site Web et le flux RSS, mettre à jour le + Handbook si ce n'est pas déjà fait et modifier la TODO list de la partie + développement du site (http://www.slitaz.org/devel/). + + +=============================================================================== + http://www.slitaz.org/ diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/rootcd.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/rootcd.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,215 @@ + + + + SliTaz Cookbook - Rootcd + + + + + + + + + + + + + + + +
+
+ +

Rootcd

+

+Déscriptions et améliorations des fichiers contenus sur le cdrom. +

+ + + + +

Syslinux/isolinux

+

+Syslinux et le bootloader principale de SliTaz, nous utilisons la version +isolinux pour faire démarrer le système contenu sur le cd-rom. Il est simple, +efficace, et largement configurable. Isolinux a été installé lors de la +création du système de base : Base system. +Le binaire est isolinux.bin, et le fichier de configuration est: isolinux.cfg. +Voici un exemple d'isolinux.cfg, utilisant isolinux.msg pour afficher l'image +splash, et utilisant des fichiers d'aides affichables via F1, F2, F3, etc. Vous +trouverez un fichier help.txt, options.txt, etc, dans SliTaz tools : +

+
+display isolinux.msg
+default slitaz
+label slitaz
+	kernel /boot/bzImage
+	append initrd=/boot/rootfs.gz rw root=/dev/null vga=788
+implicit 0	
+prompt 1	
+timeout 80
+F1 help.txt
+F2 options.txt
+F3 isolinux.msg
+F4 display.txt
+
+ + +

Splash image au boot d'isolinux

+

+Nous pouvons configurer isolinux pour avoir une jolie image au boot de SliTaz, +ou tout autres système utilisant isolinux. Cette image à un format particulier +.lss, propre à Syslinux, et elle doit être au mode indexé de 16 couleurs. Vous +pouvez utiliser le logo officiel, ppmforge, imagemagic, Gimp, ou autre pour +créer votre image. +

+

+L'archive de Syslinux fourni un logo officiel (sample/syslogo.lss) que vous +pouvez directement utiliser en le copiant dans la racine du cd-rom. SliTaz +fourni un logo (rootcd/boot/isolinux/splash.lss) que vous trouverez dans +l'archive des SliTaz tools. Pour afficher l'image au boot, il faut que l'option +'display' appelle le fichier isolinux.msg, qui lui charge l'image au format +*.lss. A noter que le fichier isolinux.msg, utilise des caractères ASCII 24. +Exemple de création avec 'echo', d'un fichier isolinux.msg utilisant une image +splash.lss : +

+
+ # echo -e "\24isplash.lss\n" > isolinux.msg
+
+

+Vous pouvez aussi ajouter un message texte afficher sous l'image splash en +modifiant ce fichier avec un éditeur de texte, echo, ou cat. +

+ + +

ISO bootable avec isolinux

+

+Pour créer un image ISO bootable, en utilisant isolinux, et genisoimage : +

+
+ # genisoimage -R -o slitaz-test.iso -b boot/isolinux/isolinux.bin \
+   	-c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
+   	-V "SliTaz" -input-charset iso8859-1 -boot-info-table rootcd 
+
+ + +

GRUB

+

+GRUB (GRand Unified Bootloader), est un bootloader distribué par le projet GNU. +C'est lui que nous utilisons lors d'une installation sur disque dure, il peut +booter Linux, BSD, Hurd, et Window$. GRUB fournit l'image stage2_eltorito pour +faire démarrer les images ISO. Pour trouver stage2_eltorito sur votre système, +il faut que le paquet GRUB soit installé. Pour finir vous devez copier +stage2_eltorito dans le racine du cdrom. A noter que SliTaz fournit un paquet +(.tazpkg) de grub-0.97, que vous trouverez sur les miroirs et vous pouvez +aussi recompiler grub-0.97 depuis les sources. Exemple de copie de l'image +stage2_eltorito depuis un système Debian ou SliTaz : +

+
+ # mkdir -p rootcd/boot/grub
+ # cp /usr/lib/grub/i386-pc/stage2_eltorito \
+   	rootcd/boot/grub
+
+

+Le fichier de configuration de grub se nomme menu.lst, c'est un fichier texte +éditable avec votre éditeur de texte préféré. En voici un exemple : +

+
+# By default, boot the first entry.
+default 0
+
+# Boot automatically after 20 secs.
+timeout 20
+
+# Change the colors.
+color yellow/brown white/black
+
+title  SliTaz GNU/Linux 1.0 (vga 800x600) (Kernel 2.6.20)
+       kernel /boot/bzImage root=/dev/null vga=788
+       initrd /boot/rootfs.gz
+
+title  SliTaz GNU/Linux 1.0 (vga 1024x768) (Kernel 2.6.20)
+       kernel /boot/bzImage root=/dev/null vga=771
+       initrd /boot/rootfs.gz
+
+ + +

ISO bootable avec GRUB

+

+Pour créer un image ISO bootable, en utilisant GRUB, et genisiimage ou mkisofs : +

+
+ # genisoimage -R -o slitaz-test.iso -b boot/grub/stage2_eltorito \
+   	-no-emul-boot -V "SliTaz" -boot-load-size 4 -input-charset iso8859-1 \
+   	-boot-info-table rootcd
+
+ +

Memtest86

+

+L'application memtest86 (92 ko), est un outil autonome de test de mémoire vive +(RAM). Nous téléchargeons l'utilitaire dans le répertoire src, décompression de +l'archive, et copie du binaire précompilé : +

+
+ # mkdir -v -p src
+ # cd src
+ # wget http://www.memtest86.com/memtest86-3.2.tar.gz
+ # tar xzfv memtest86-3.2.tar.gz
+ # cd memtest86-3.2
+ (# more README)
+ # cp precomp.bin ../../rootcd/boot/memtest
+ # cd ../..
+
+

+Une fois installé, vous pouvez ajouter un label pour memtest86 au fichier: +isolinux.cfg en spécifiant le chemin vers l'utilitaire : +

+
+label memtest
+	kernel /boot/memtest
+
+

+Ou si vous voulez utiliser GRUB, les lignes pour lancer memtest86 sont: +

+
+title 	Memtest86 (Test system memory)
+kernel 	/boot/memtest
+
+

+Une fois les lignes ajoutées, vous pouvez créer un nouvelle ISO, et la tester. +

+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/template.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/template.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,55 @@ + + + + SliTaz Cookbook - Template + + + + + + + + + + + + + + + +
+
+ + +

+CONTENT +

+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/wok-tools.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/wok-tools.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,260 @@ + + + + SliTaz Cookbook - Wok & Tools + + + + + + + + + + + + + + + +
+
+ + +

Wok & Tools

+ + + +

Les utilitaires du projet

+

+Au file du temps le projet SliTaz à créer divers petits utilitaires permettant +de reconstruire le système depuis les sources et de façon automatique. +Tazwok est utilisé pour +compiler et générer des paquets (cook pour cuire) via +les intructions trouvées dans les recettes. Le +projet propose aussi une archive d'outils contenant divers petits utilitaires, +des exemples et des fichiers de configuration. Le générateur de distribution +Live Tazlito (SliTaz Live Tool), déstiné aux utilisateurs +et développeurs. Tazlito permet d'extraire et reconstruire une image ISO +de LiveCD et de générer des distributions à saveure depuis une liste de +paquets, un fichier de configuration et une description. Les utilitaires sont +tous distribués sous forme d'archive source et sont installés par défaut sur +SliTaz. Les développeurs ou futur contributeurs peuvent se référencer à la page +forge donnant des +informations sur la gestion du projet SliTaz. +

+

Tazwok et le wok

+

+L'idée est d'utiliser un répertoire (wok) contenant tous les paquets +disponibles, chaque paquet contient au minimum une recette (receipt) servant +à télécharger, désarchiver, compiler et générer le paquet binaire. Pour +fonctionner, Tazwok a aussi besoin d'un répertoire pour stocker les sources +téléchargées ($SOURCES_REPOSITORY) et d'un répertoire pour les paquets générés +($PACKAGES_REPOSITORY), ces valeurs peuvent être configurées via le fichier : +/etc/tazwok.conf. +

+ + +

Woking - Utiliser le wok

+

+Woking ou comment utiliser le wok pour construire des paquets. Pour commencer +il faut que Tazwok soit +installé sur votre système et que les principaux outils de développement le +soit aussi (binutils, compilateur, librairies-dev, make), sur Slitaz il suffit +d'installer le meta-paquet slitaz-toolchain : +

+
+ # tazpkg recharge
+ # tazpkg get-install slitaz-toolchain
+
+

Récupérer le wok

+

+Pour travailler il faut récupérer le wok depuis le dépôt Mercurial ou depuis +une archive sur le miroir principale (TuxFamily) de Slitaz. En supposant que +SliTaz se construit dans /home/slitaz : +

+
+ $ hg clone http://hg.slitaz.org/wok/ /home/slitaz/wok
+
+

+Les archives sont aussi récupérable depuis l'URL : +ftp://download.tuxfamily.org/slitaz/wok/. +Il suffit de prendre la dernière version et de la désarchiver où bon vous +semble. Avant de compiler son premier paquet il faut configurer Tazwok pour +qu'il trouve le wok préalablement téléchargé. Par défaut le chemin est +/home/slitaz/wok, vous pouvez le changer ou renommer le wok +téléchargé. Pour afficher/vérifier les chemins que Tazwok va utiliser et +le nombres de paquet disponibles dans le wok, vous pouvez utiliser la +commande stats de Tazwok : +

+
+ # tazwok stats
+
+ + +

Compiler et générer des paquets

+

+Configuer, compiler, striper, générer le paquet SliTaz et le compresser peut +se faire en une seule commandes. Pour éviter toute frustration... il est +conseillé de commencer par construire un paquet, sans modifier sa recette, et +ne demandant pas de dépendances. M4 est idéal pour se lancer et cuire (cook) : +

+
+ # tazwok cook m4
+
+

+Une fois le travail fini, le paquet SliTaz se trouvent dans le repositoire +spécifié dans la configuration (Par défaut /home/slitaz/packages). +Si tout c'est bien passé, vous pouvez installer le paquet sur le système hôte +ou l'utiliser pour générer votre distribution LiveCD via +Tazlito. Pour +créer un nouveau paquet vous pouvez utiliser la commande new-tree +avec l'option --interactive et lire la document au sujet des +possibilités proposée par les recettes des paquets. +Toutes les commandes disponibles avec Tazwok sont décrite dans : +Tazwok manual +

+

Cooklists - Liste de cuisson

+

+Pour compiler plusieurs paquets en une seule commande, on peut utiliser des +listes de cuisson. Il y a des listes exemples dans le répertoire +/usr/share/examples/tazwok/cooklists sur SliTaz, c'est juste un fichier texte +avec un paquet par ligne. Exemple avec mypkgs.cooklist : +

+
+ # tazwok cook-list mypkgs.cooklist
+
+ + +

Options de compilations des paquets

+

+Vous êtes libre d'utiliser les options de compilation que vous désirez, il faut +juste respecter le FSH, la doc dans /usr/share/doc par exemple et suivre les +standards de Freedesktop (.desktop en autre). Ensuite c'est une questions de +choix, on peut par exemple désactiver le support XML pour avoir un binaire PHP +plus petit et se débarasser de libxml2, mais dans le cas de PHP le gain de +place ne vaut pas le coup par rapport aux pertes de fonctionnailtés. Si vous +avez des doutes, regardez des recettes existantes et leure options de +compilation dans compile_rules. +

+

Optimisation

+

+Les paquets SliTaz officiels sont optimisés pour i486, les options +d'optimisation passées en arguments à configure sont spécifiées dans le +fichier de configuration de Tazwok (/etc/tazwok.conf) et peuvent +être appelées via la variable $CONFIGURE_ARGS. Si vous voulez +compiler un paquet avec des arguments différents, vous pouvez modifier le +fichier de configuration de Tazwok : +

+
+CONFIGURE_ARGS="--build=i486-pc-linux-gnu --host=i486-pc-linux-gnu"
+
+ + +

Fichiers inclus ou exclus des paquets

+

+Au sujet des fichiers à inclures ou exclures du paquet, l'idée et de mettre le +minimum dans le paquet de base et de créer des paquets séparés pour les +fichiers optionnels ou de développement. En général, les paquets de base ne +contiennent pas de man, info, doc ou librairies statique, il faut créer un +paquet-doc ou paquet-dev. A noter que SliTaz ne propose pas la commande man ou +info, donc pas de manuel ou fichier GNU info et que la création de paquets +contenant la doc est vraiment en option, surtout si la documentation est en +English. Par contre, un bout de texte au sujet du paquet dans le Handbook est +plus qu'apprécié. +

+

+Au niveau des fichiers de configuration, quand c'est possible, le but est de +proposer des fichiers de configurations de base permettant de faire fonctionner +directement le paquet. Dans le cas du serveur Web LightTPD, le paquet SliTaz +fourni des fichiers de configuration fait maison et le script de démarrage du +démon situé dans /etc/init.d, le tout documenté dans le Handbook. Pour un +nouveau paquet, vous êtes libre de choisir sa configuration par défaut en +fonction de ce qui vous semble le plus simple pour l'utilisateur final. Sur +SliTaz vous disposez aussi d'un répertoire /usr/share/examples destiné à des +exemples de configuration ou autres types d'exemples utiles. +

+ + +

Catégories des paquets

+

+Les catégories des paquets existent à titre d'information et ne sont pas encore +vraiment figée. L'idée est de classer les paquets pour une futur interface web +dont les pages seraient générée chaque nuit depuis le wok en récupérant les +données dans les recettes des paquets. Dans l'immédiat, les paquets de +développement dans 'devel', Xorg et compagnie dans 'x-window' et la plus part +des nouveautés dans 'extra'. +

+ + +

Structure d'un paquet dans le wok

+

+La structure des paquets dans le wok devraient être respectée si l'on veut que +Tazwok trouve les bons fichiers et répertoires. Contenu possible d'un paquet +(le répertoire taz/ est créé lors le la cuission) : +

+ + + +

Structure d'un paquet tazpkg

+

+Les paquets SliTaz sont des archives cpio contenant un système de fichiers +compressé avec gzip et des fichiers : +

+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/x-window-system.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/x-window-system.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,536 @@ + + + + SliTaz Cookbook - Template + + + + + + + + + + + + + + + +
+
+ + +

X window system

+

+Installation et configuration de base du système de fenêtres X. +

+ + +

A propos

+

+Ce chapitre décrit l'installation et la configuration du système X +window sur SliTaz. Nous allons installer, les bibliothèques pour les +polices, expat, XML, un server graphique (Xvesa), un émulateur de +terminal (XTerm), divers petits outils, et un gestionnaire de +fenêtres (JWM). Nous vous proposons aussi d'installer les +bibliothèques JPEG et le navigateur web Links (en français). +

+

Variable d'environnement ($fs)

+

+Pour ne pas spécifier tout le chemin vers le répertoire rootfs, export +de la variable d'environnement: +

+
+ # export fs=$PWD/rootfs
+
+

+Pour vérifier: +

+
+ # echo $fs
+
+ +

expat-2.0.0 - XML parser library

+

+Expat (http://expat.sourceforge.net/) +contient des bibliothèques d'analyse XML: +

+
+ # cd ..
+ # wget http://switch.dl.sourceforge.net/sourceforge/expat/expat-2.0.0.tar.gz
+ # tar xzf expat-2.0.0.tar.gz
+ # cd expat-2.0.0
+ # ./configure --sysconfdir=/etc --prefix=/usr \
+   --mandir=/usr/share/man
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/usr/lib/*
+ # strip -v _pkg/usr/bin/*
+
+

+Par la suite nous allons installer 'xterm' qui a besoin de libexpat.so.0, +il suffit de créer un lien symbolique sur libexpat.so.1.5.0, et le tour est +joué. Ensuite vous pouvez installerles bibliothèques, et l'application 'xmlwf' +dans le rootfs: +

+
+ # cd _pkg/usr/lib
+ # ln -s libexpat.so.1.5.0 libexpat.so.0
+ # cp -a *.so* $fs/usr/lib
+ # cd ..
+ # cp -a bin/* $fs/usr/bin
+ # cd ../..
+
+

libs

+Bibliothèques uitilisées par xmlwf: +
+        libexpat.so.1 => /usr/lib/libexpat.so.1 (0x40021000)
+        libc.so.6 => /lib/tls/libc.so.6 (0x40041000)
+        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
+
+ +

freetype-2.3.1 - Bibliothèques de police sytème

+

+Le paquet freetype (http://www.freetype.org/) +contient des bibliothèques utilisées par X pour la configuration des polices +du système: +

+
+ # cd ..
+ # wget http://download.savannah.gnu.org/releases/freetype/freetype-2.3.1.tar.bz2
+ # tar xjf freetype-2.3.1.tar.bz2
+ # cd freetype-2.3.1
+ # ./configure --sysconfdir=/etc --prefix=/usr \
+   --mandir=/usr/share/man
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -vs _pkg/usr/lib/*
+ # cp -a _pkg/usr/bin/* $fs/usr/bin
+ # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
+
+ +

fontconfig 2.4.2 - Outils de gestion des polices

+

+Le paquet fontconfig (www.fontconfig.org/wiki/) +fourni la bibliothèque libfontconfig, utilisée par de nombreux +programme sous X. Note: XFree86 fournit aussi ces bibliothèques, et +les utilitaires. Nous avons choisi d'utiliser le paquet original, car +il fonctionne mieux avec JWM: +

+
+ # cd ..
+ # wget http://fontconfig.org/release/fontconfig-2.4.2.tar.gz
+ # tar xzf fontconfig-2.4.2.tar.gz
+ # cd fontconfig-2.4.2
+ # ./configure --sysconfdir=/etc --prefix=/usr \
+   --mandir=/usr/share/man --localstatedir=/var
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/usr/bin/*
+ # strip -v _pkg/usr/lib/*
+ # cp -a _pkg/usr/bin/* $fs/usr/bin
+ # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
+ # cp -a _pkg/etc $fs
+ # cp -a _pkg/var $fs
+
+

libs

+

+Un 'ldd' sur fc-cache donne, le bibliothèques ci-dessous. Vous pouvez utiliser +libfreetype d'Xfree86: +

+
+        libfreetype.so.6 => /usr/lib/libfreetype.so.6 (0xb7f12000)
+        libz.so.1 => /usr/lib/libz.so.1 (0xb7eff000)
+        libexpat.so.1 => /usr/lib/libexpat.so.1 (0xb7edf000)
+        libfontconfig.so.1 => /usr/lib/libfontconfig.so.1 (0xb7eb0000)
+        libc.so.6 => /lib/tls/libc.so.6 (0xb7d7b000)
+        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0xb7f8c000)
+
+ +

Xserver - Serveur graphique Xvesa d'Xfree86

+

+Nous allons utiliser la versions binaires du serveur Xvesa et les polices +distribuée par Xfree86.org +(www.free86.org/). Nous allons par contre, +copier les bibliothèques d'Xorg depuis le système hôte, car elle seront +utilisées par la compilation des applications X, Xvesa fonctionne très bien +comme ça et cela simplifie les choses. Vous pouvez aussi +recompiler les paquets d'Xorg sur votre système de +développement. +

+

Xtinyx server - Xvesa

+

+Le serveur Xvesa est très léger, et utilise peut de bibliothèques, il +se trouve dans l'archive Xtinyx.tgz. Téléchargement et install dans +/usr/bin du rootfs de SliTaz: +

+
+ # cd ..
+ # mkdir -p XFree86-4.6.0 && cd XFree86-4.6.0
+ # wget http://ftp.xfree86.org/pub/XFree86/4.6.0/binaries/Linux-ix86-glibc23/Xtinyx.tgz
+ # tar xzf Xtinyx.tgz
+ # cp bin/Xvesa $fs/usr/bin
+ # strip $fs/usr/bin/Xvesa
+ # chmod 4711 $fs/usr/bin/Xvesa
+
+

libs pour Xvesa

+
+        libz.so.1 => /usr/lib/libz.so.1 (0xb7ed6000)
+        libm.so.6 => /lib/tls/libm.so.6 (0xb7eb1000)
+        libc.so.6 => /lib/tls/libc.so.6 (0xb7d7e000)
+        /lib/ld-linux.so.2 (0xb7ef8000)
+
+

rgb.txt - Les couleurs RGB sous X

+

+Le fichier de configuration des couleurs utilisée par le serveur X +se nomme rgb.txt, nous vous proposons de copier celui +du système hôte. La bibliothèque libX11.so d'Xorg va chercher les +fichiers de configuration dans /usr/share/X11, et le serveur Xvesa +dans /usr/X11R6/lib/X11, nous allons créer un lien dans /usr/share/X11 +afin de satisfaire cela: +

+
+ # mkdir -p $fs/usr/share/X11
+ # cp /usr/share/X11/rgb.txt $fs/usr/share/X11
+ # chroot $fs /bin/ash
+ /# mkdir -p /usr/X11R6/lib/X11/
+ /# ln -s /usr/share/X11/rgb.txt /usr/X11R6/lib/X11/rgb.txt
+ /# exit
+
+

Xfnts - Les polices

+

+Pour que le serveur fonctionnent il nous faut les polices de base, que vous +pouvez télécharger depuis xfree86.org, les compiler depuis les paquets d'Xorg, +ou les copier depuis votre système hôte. Les polices du système peuvent se +mettre dans différents dossiers, et une fois installées pour devez lancer +lc-cache pour mettre à jour le cache. Attention les fonts +prennent de la place, vous pouvez ne copier que le minimum. Le répertoire +/usr/share/fonts contient les polices truetype tels que biststream-vera: +

+
+ # wget http://ftp.xfree86.org/pub/XFree86/4.6.0/binaries/Linux-ix86-glibc23/Xfnts.tgz
+ # tar xzf Xfnts.tgz
+ # mkdir -p $fs/usr/X11R6/lib/X11/fonts
+ # mkdir -p $fs/usr/share/fonts/truetype
+
+ Copie des polices...
+ (# cp -a lib/X11/fonts/* $fs/usr/X11R6/lib/X11/fonts)
+ (# cp -a /usr/share/fonts/truetype/* $fs/usr/share/fonts/truetype
+
+

+Pour regénérer le fichier fonts.dir, il vous faut lancer mkfontdir sur le réperoire +en question: +

+
+ # mkfontdir $fs/usr/X11R6/lib/X11/fonts/75dpi
+
+

+Les fichiers de configuration de fontconfig, se trouvent dans /etc/fonts, fourni +par le paquet fontconfig. Vous pouvez maintenant lancer 'fc-cache', et pour +connaître la liste des polices vous pouvez utiliser 'fc-list'. Vous pouvez faire +cela avec un chroot dans le rootfs: +

+
+ # chroot $fs /bin/ash
+ # fc-cache -v
+ # fc-list
+ # exit
+
+

Xlib locale - Les fichiers de localisation

+

+Sur SliTaz nous avons installé que 4 locales, C, iso8859-1, iso8859-15, et +iso8859-2 provenant de la compilation d'Xorg. +Vous pouvez copier les fichiers depuis le système hôte ou utiliser les fichiers +distribuées par XFree86. Exemple de copie de toutes les locales depuis le +système hôte: +

+
+ # mkdir -p $fs/usr/share/X11/locale
+ # cp -a /usr/share/X11/locale/* $fs/usr/share/X11/locale
+
+

Utilisation de X

+

+A noter que vous pouvez déjà utiliser Xvesa comme terminal X, si vous +avez une machine sur le réseau acceptant les connexions Xdmcp. Pour +cela vous pouvez lancer le server avec l'option -query, +exemple: +

+
+ # Xvesa -ac -shadow -screen 1024x768x24 -query 192.168.0.2
+
+ +

xterm - Emulateur de terminal

+

+Le paquet Xterm (invisible-island.net/xterm/)fournit un émulateur de terminal pour X: +

+
+ # wget ftp://invisible-island.net/xterm/xterm-223.tgz
+ # tar xzf xterm-223.tgz
+ # cd xterm-223
+ # ./configure --prefix=/usr --sysconfdir=/etc \
+   --mandir=/usr/share/man --localstatedir=/var \
+   --with-app-defaults=/usr/share/X11/app-defaults \
+   --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip _pkg/usr/bin/*
+ # cp _pkg/usr/bin/* $fs/usr/bin
+ # cp -a _pkg/usr/share/X11/* $fs/usr/share/X11
+
+

libs

+

+Un ldd sur XTerm, nous fait copier les bibliothèques manquantes depuis +le système hôte et n'oubliez pas de stripper le tout à la fin: +

+
+    libXft.so.2 => /usr/lib/libXft.so.2 (0xb7f09000)
+    libXrender.so.1 => /usr/lib/libXrender.so.1 (0xb7f00000)
+    libfontconfig.so.1 => /usr/lib/libfontconfig.so.1 (0xb7ed5000)
+    libfreetype.so.6 => /usr/lib/libfreetype.so.6 (0xb7e68000)
+    libz.so.1 => /usr/lib/libz.so.1 (0xb7e54000)
+    libX11.so.6 => /usr/lib/libX11.so.6 (0xb7d68000)
+    libXaw.so.7 => /usr/lib/libXaw.so.7 (0xb7d0f000)
+    libXmu.so.6 => /usr/lib/libXmu.so.6 (0xb7cfa000)
+    libXext.so.6 => /usr/lib/libXext.so.6 (0xb7cec000)
+    libXt.so.6 => /usr/lib/libXt.so.6 (0xb7c9e000)
+    libSM.so.6 => /usr/lib/libSM.so.6 (0xb7c96000)
+    libICE.so.6 => /usr/lib/libICE.so.6 (0xb7c7f000)
+    libncurses.so.5 => /lib/libncurses.so.5 (0xb7c3c000)
+    libc.so.6 => /lib/libc.so.6 (0xb7b2c000)
+    libexpat.so.1 => /usr/lib/libexpat.so.1 (0xb7b0b000)
+    libXau.so.6 => /usr/lib/libXau.so.6 (0xb7b08000)
+    libXdmcp.so.6 => /usr/lib/libXdmcp.so.6 (0xb7b03000)
+    libdl.so.2 => /lib/libdl.so.2 (0xb7aff000)
+    libXpm.so.4 => /usr/lib/libXpm.so.4 (0xb7aee000)
+
+ +

libpng-1.2.18 - Bibliothèques PNG

+

+Les bibliothèques PNG (http://libpng.org/pub/png/libpng.html)permettent de manipuler +et d'utiliser les images au format .png: +

+
+ # wget http://puzzle.dl.sourceforge.net/sourceforge/libpng/libpng-1.2.18.tar.bz2
+ # tar xjf libpng-1.2.18.tar.bz2
+ # cd libpng-1.2.18
+ # ./configure --enable-shared --prefix=/usr \
+   --mandir=/usr/share/man
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip _pkg/usr/lib/*.so*
+ # cp -a _pkg/usr/lib/libpng12.so* $fs/usr/lib
+ # cp -a _pkg/usr/bin/libpng12* $fs/usr/bin
+
+ +

jwm-2.0 - Gestionnaire de fenêtres

+

+Joe's Window Manager (http://www.joewing.net/programs/jwm/) est un gestionnaire de fenêtres +ultra léger, et convivial. C'est le window manager par défaut de SliTaz. Le +fichier de configuration principal est dans /etc/jwm/system.jwmrc, comprenant +la config du menu et du style: +

+
+ # cd ..
+ # wget http://www.joewing.net/programs/jwm/releases/jwm-2.0.tar.bz2
+ # tar xjf jwm-2.0.tar.bz2
+ # cd jwm-2.0
+ # ./configure --prefix=/usr --mandir=/usr/share/man \
+   --sysconfdir=/etc/jwm --disable-xinerama
+ # make
+ # strip src/jwm
+ # cp src/jwm $fs/usr/bin
+ # mkdir $fs/etc/jwm
+ # cp example.jwmrc $fs/etc/jwm/system.jwmrc
+
+

libs

+

+Les bibliothèques que ldd nous aura fourni: +

+
+    libX11.so.6 => /usr/lib/libX11.so.6 (0xb7e35000)
+    libpng12.so.0 => /usr/lib/libpng12.so.0 (0xb7e12000)
+    libXft.so.2 => /usr/lib/libXft.so.2 (0xb7e00000)
+    libXrender.so.1 => /usr/lib/libXrender.so.1 (0xb7df7000)
+    libfontconfig.so.1 => /usr/lib/libfontconfig.so.1 (0xb7dcc000)
+    libfreetype.so.6 => /usr/lib/libfreetype.so.6 (0xb7d5f000)
+    libz.so.1 => /usr/lib/libz.so.1 (0xb7d4a000)
+    libXpm.so.4 => /usr/lib/libXpm.so.4 (0xb7d3a000)
+    libXext.so.6 => /usr/lib/libXext.so.6 (0xb7d2c000)
+    libc.so.6 => /lib/libc.so.6 (0xb7c1c000)
+    libXau.so.6 => /usr/lib/libXau.so.6 (0xb7c19000)
+    libXdmcp.so.6 => /usr/lib/libXdmcp.so.6 (0xb7c14000)
+    libdl.so.2 => /lib/libdl.so.2 (0xb7c0f000)
+    libm.so.6 => /lib/libm.so.6 (0xb7bea000)
+    libexpat.so.1 => /usr/lib/libexpat.so.1 (0xb7bc9000)
+
+

+Vous pouvez démarrer le server X et JWM avec la commande ci-dessous, ou en +créant un script, tel que /usr/bin/startx avec pour contenu: +

+
+Xvesa -ac -shadow -screen 1024x768x24 & exec jwm
+
+

Sur SliTaz

+

+SliTaz utilise le fichier ~/.xsession pour lancer un session grahique. +La commande 'startx' vérifie si il existe, si oui il le lance, sinon il lance +le script 'tazx' pour configurer le système X. La page du guide de l'utilisateur +au sujet d'X window est dans: /usr/share/doc/slitaz/user-guide/x-window.html, +et sur le site web. +

+

+Nous avons choisi d'utiliser les icons du thème Tango: +http://tango.freedesktop.org/, +que nous n'avons pas compilé. Nous utilison seulement le minimum, et +des images au format 16x16 que nous mettons dans /usr/share/icons. +

+

+Pour tester JWM, avec une ISO en cuisson: +

+
+ # Xvesa -ac -shadow -screen 800x600x24 & exec jwm
+
+ +

jpeg-6b - Bibliothèques JPEG

+

+Les bibliothèques de manipulation des images JPEG, et quelques +petits utilitaires: +

+
+ # wget http://www.ijg.org/files/jpegsrc.v6b.tar.gz
+ # tar xzf jpegsrc.v6b.tar.gz
+ # cd jpeg-6b
+ # ./configure --enable-shared --prefix=/usr \
+   --mandir=/usr/share/man
+ # make
+ # strip .libs/*
+ # cp -a .libs/*.so* $fs/usr/lib
+ # cp .libs/{cjpeg,djpeg,jpegtran} $fs/usr/bin
+
+ +

tiff-3.8.2 - Bibliothèques et utilitaires TIFF

+

+Les bibliothèques de manipulation des images TIFF, et quelques +petits utilitaires en option: +

+
+ # wget ftp://ftp.remotesensing.org/pub/libtiff/tiff-3.8.2.tar.gz
+ # tar xzf tiff-3.8.2.tar.gz
+ # cd tiff-3.8.2
+ # ./configure  --prefix=/usr --mandir=/usr/share/man
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip _pkg/usr/bin/*
+ # strip _pkg/usr/lib/*.so*
+ # cp -a _pkg/usr/lib/*.so* $fs/usr/lib
+
+

+A vous d'installer les utilitaires que vous voulez. +

+ +

links-2.1pre29 - Navigateur web graphique et texte

+

+Links (links.twibright.com) est +un navigateur web proposant un mode texte et un mode graphique, il est +traduit dans de multiples langues, dont le français: +

+
+ # cd ..
+ # wget http://links.twibright.com/download/links-2.1pre28.tar.gz
+ # tar xzf links-2.1pre28.tar.gz
+ # cd links-2.1pre28
+ # ./configure --prefix=/usr --sysconfdir=/etc --mandir=/usr/share/man \
+   --without-directfb --without-ssl --enable-graphics --enable-javascript
+ # make
+ # make DESTDIR=$PWD/_pkg install
+ # strip -v _pkg/usr/bin/*
+ # cp -v _pkg/usr/bin/* $fs/usr/bin
+
+

libs

+
+    libtiff.so.3 => /usr/lib/libtiff.so.3
+    libjpeg.so.62 => /usr/lib/libjpeg.so.62 (0xb7ede000)
+    libpng12.so.0 => /usr/lib/libpng12.so.0 (0xb7eba000)
+    libz.so.1 => /usr/lib/libz.so.1 (0xb7ea7000)
+    libX11.so.6 => /usr/lib/libX11.so.6 (0xb7dbb000)
+    libdl.so.2 => /lib/tls/libdl.so.2 (0xb7db7000)
+    libpcre.so.0 => /usr/lib/libpcre.so.0 (0xb7d96000)
+    libm.so.6 => /lib/tls/libm.so.6 (0xb7d70000)
+    libc.so.6 => /lib/tls/libc.so.6 (0xb7c3e000)
+    libXau.so.6 => /usr/lib/libXau.so.6 (0xb7c3b000)
+    libXdmcp.so.6 => /usr/lib/libXdmcp.so.6 (0xb7c36000)
+    /lib/ld-linux.so.2 (0xb7f5d000)
+
+ +

Génération de l'initramfs, et d'une image ISO

+

+Pour créer une nouvelle image ISO vous pouvez utiliser 'mktaziso' +contenu dans SliTaz tools. +Ou vous pouvez créer un nouvelle image initramfs, et la copier dans +/boot de la racine de cd-rom (rootcd), et pour finir créer un image +ISO avec genisoimage: +

+
+ # cd $fs
+ # find . -print | cpio -o -H newc | gzip -9 > ../rootfs.gz
+ # cd ..
+ # cp rootfs.gz rootcd/boot
+ # genisoimage -R -o slitaz-cooking.iso -b boot/isolinux/isolinux.bin \
+   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
+   -V "SliTaz" -boot-info-table rootcd
+
+

Suite

+

+La suite logique du cookbook passe par l'installation des bibliothèques +GTK décrite dans le chapitre : GTK+ libs. +

+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/cookbook/xorg.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/cookbook/xorg.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,160 @@ + + + + SliTaz Cookbook - Xorg + + + + + + + + + + + + + + + +
+
+ + +

Howto Xorg - Serveur graphique modulaire

+ +

+Note : SliTaz utilise le serveur Xvesa fournit par XFree86 et les bibliothèques +d'Xorg, cette page décrit la compilation des bibliothèques d'Xorg utilisées +sur SliTaz. Ce document est principalement destiné aux développeurs et +contributeurs du projet, mais il peut être utile à toutes personnes cherchant +à recompiler Xorg et les bibliothèques Xlib depuis les sources en générant +un minimum de dépendances. +

+ + +

Construire Xorg automatiquement avec Tazwok

+

+Sur SliTaz, ou si vous avez installé Tazwok, vous pouvez recompiler Xorg en +quelques commandes. Le wok contient un meta-paquet nommé xorg et +un autre nommé xorg-dev, ils permettent de compiler/cuire tous +les paquets Xorg utilisé par SliTaz. Pour compiler vous devez avoir installé +la plus part des paquets de développement, si ce n'est pas le cas : +

+
+ # tazpkg get-install slitaz-dev-pkgs
+
+

+Ensuite vous pouvez lancer la cuisson (si tout est prêt, wok et paquets de +developpement), en commençant par les proto's (xproto, etc) : +

+
+ # tazwok cook xorg-dev-proto
+ # tazwok cook xorg
+ # tazwok cook xorg-dev
+
+ + +

Obtenir Xorg (7.2) avec wget

+

+Xorg est distribuée sous forme de modules, ce qui est bien pratique, car +l'on peut installer uniquement ce que l'on veut, mais cela demande beaucoup +de téléchargements. Pour vous aidez nous avons créer un petit script qui +télécharge le minimum pour SliTaz, vous trouverez le script +getXorg.sh dans SliTaz tools (1.1). +A noter que ce script n'est plus mis à jour, les développeurs utilisent +les outils et le wok. Pour utiliser le script de +téléchargemnt, il faut ce placer dans le répertoire dans lequel vous désirez +télécharger Xorg, puis lancer le script préalablement copié : +

+
+ # cd ..
+ # mkdir Xorg && cd Xorg
+ # cp slitaz-tools-1.1/utils/getXorg-7.2.sh .
+ # ./getXorg-7.2.sh
+
+ +

Compiler Xorg à la main

+

+La compilation d'Xorg est assez longue, il y a beaucoup de paquets. +Pour commnencer il faut complier tous les paquets proto téléchargés, +vous pouvez utiliser la commande make DESTDIR=$PWD/_pkg install +pour installer le paquet dans un répertoire donné. Exemple avec xproto: +

+
+ # cd proto
+ # tar xzf xproto-X11R7.2-7.0.10.tar.gz
+ # cd xproto-X11R7.2-7.0.10
+ # ./configure --prefix=/usr --sysconfdir=/etc \
+   --mandir=/usr/share/man --localstatedir=/var \
+   --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu
+  # make
+  # make install
+
+

+Compilation des bibliothèques en reprenant les options utilisées +pour les proto. Exemple avec le premier paquet à compiler xtrans, +n'oubliez pas de lancer ldconfig si vous installer le +paquet sur la machine de développement: +

+
+ # cd .. && cd lib
+ # tar xzf xtrans-X11R7.2-1.0.3.tar.gz
+ # cd xtrans-X11R7.2-1.0.3
+ # ./configure --prefix=/usr --sysconfdir=/etc \
+   --mandir=/usr/share/man --localstatedir=/var \
+   --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu
+ # make
+ # make install
+ # ldconfig
+
+

+Une fois que tous les paquets des bibliothèques sont compilés, vous pouvez +commencer à compiler des applications pour X tels que le terminal graphique +Xterm. SliTaz utilise encore le paquet 'rgb' contenant le fichier +/usr/share/X11/rgb.txt définissant les couleurs. Exemple de compilation pour +xsetroot, application permettant de changer la couleur du fond +d'écran (modifiez $VERSION par la version que vous avez téléchargé : +

+
+ # cd .. && cd app
+ # tar xzf xsetroot-$VERSION.tar.gz
+ # cd xsetroot-$VERSION
+ # ./configure --prefix=/usr --sysconfdir=/etc \
+   --mandir=/usr/share/man --localstatedir=/var \
+   --build=i486-pc-linux-gnu --host=i486-pc-linux-gnu
+ # make && make install
+
+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/book.css --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/book.css Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,170 @@ +/* + CSS style for SliTaz GNU/Linux *book. + Pankso 2007 - www.slitaz.org +*/ + +body { + font: 13px sans-serif, vernada, arial; + background: #222222; + margin: 0; + padding-bottom: 100%; +} + +#header { + background: #BFB06B url(images/css/header.png) repeat-x top; + color: black; + height: 50px; + border-top: 1px solid black; + border-bottom: 1px solid black; +} +#quicknav { + margin-right: 6px; + text-align: right; + font-size: 12px; + } +#quicknav { + margin-right: 6px; +} + +#quicknav a { + background: inherit; + color: #222222; +} + +#quicknav a:hover { + background: inherit; + color: #EDEDED; +} + +/* content. */ + +#content { + background: white url(images/css/content-tl.png) no-repeat top left; + color: black; + padding: 20px; + margin: 30px 50px 0px 50px; + width: auto; + text-align: justify; +} + +#content li { + line-height: 1.5em; + text-align: left; +} + +/* Footer. */ + +#footer { + font-size: 11px; + font-weight: bold; + background: #eaeaea url(images/css/footer-bl.png) no-repeat bottom left; + color: black; + height: 20px; + padding: 6px 0px 0px 10px; + margin: 0px 50px 0px 50px; + width: auto; + text-align: center ; +} + +#footer a { + text-decoration: none; + background: #eaeaea; + color: #3E1220; +} + +#footer a:hover { + background: #eaeaea; + color: #DF8F06; +} + +/* Legal informations */ + +#copy { + font-size: 11px ; + text-align: center ; + background: transparent; + color: #a8a8a8; + padding-top: 20px; +} + +#copy a { + background: inherit; + color: #a8a8a8; +} + +#copy a:hover { + background: inherit; + color: #EDEDED; +} + +/* Div for round corners. */ + +.content-right, .footer-right { + width: 16px; + color: white; + background-color: #333333; +} +.content-right { + background: url(images/css/content-tr.png) no-repeat top right; + height: 16px; + right: 50px; + top: 82px; + position: absolute; +} + +.footer-right { + background: url(images/css/footer-br.png) no-repeat bottom right; + height: 20px; + float: right; +} + +/* General HTML entities for content. */ + +h1 { + margin: 0px 0px 0px 16px; +} + +h2 { + margin: 12px 0; + color: #484B7C; + background: white; +} + +h3 { + font-weight: bold; + color: #6c0023; + background: white; +} + +a { + text-decoration: underline; +} +a:hover { + text-decoration: none; +} + +pre { + padding: 5px; + color: black; + background: #e1e0b0; +} +pre.script { + padding: 10px; + color: black; + background: #e8e8e8; + border: 1px inset #333333; +} + +code { + font-size: 12px; + color: #669900; + background: transparent; +} + +li { + line-height: 1.4em; +} + +hr { + border: 0pt none; +} diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/chroot-env.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/chroot-env.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,196 @@ + + + + SliTaz Handbook - Chroot env + + + + + + + + + + + + + + + +
+
+ +

Chroot environment

+ +

+Ce document décrit les étapes à réaliser pour créer un environnement chrooté, +afin de changer la racine du système pour travailler. Cela permet de compiler, +tester et développer SliTaz sans risques pour le système hôte depuis lequel +on travaille. Ce système hôte peut être SliTaz installée en dur ou tout autre +système GNU/Linux tel que Debian, Fedora, PCLinuxOS, etc. On peut aussi créer +un environnement chrooté en mode LiveCD associé à un media USB. Les seuls +prérequis sont d'avoir une image ISO de SliTaz à disposition et un peu de +temps. A noter que toutes les opérations sont réalisées en tant +qu'administrateur (root). +

+

Préparer l'environnement

+

+Pour commencer, il faut extraire le contenu de l'image ISO dans le répertoire +qui va servir au chroot. Le répertoire de chroot peut se créer à l'endroit que +l'on veut, nous utilisons un répertoire /home/slitaz/chroot-env. +Pour extraire le contenu d'une image ISO, il faut la monter en loop +sur un répertoire, pour ensuite copier le système de fichiers racine +compressé (rootfs.gz) dans le répertoire de chroot. En +supposant que l'ISO est dans le répertoire courant : +

+
+ # mkdir /tmp/loop
+ # mount -o loop slitaz-cooking.iso /tmp/loop
+ # mkdir -p /home/slitaz/chroot-env
+ # cp /tmp/loop/boot/rootfs.gz \
+   /home/slitaz/chroot-env
+ # umount /tmp/loop
+
+

+Maintenant qu'on a une copie du système de fichiers compressé, il faut le +décompresser et le désarchiver (c'est une archive cpio compressée +avec lzma ou gzip). Pour finir cette étape de préparation et continuer, on +peut retirer le rootfs qui n'est plus utilisé : +

+
+ # cd /home/slitaz/chroot-env
+ # (zcat rootfs.gz 2>/dev/null || lzma d rootfs.gz -so) | cpio -id
+ # rm rootfs rootfs.gz
+
+

+Si le désarchivage du rootfs compressé avec LZMA échoue en utilisant la +première méthode vous pouvez utiliser: +

+
+ # unlzma rootfs.gz -S .gz 
+ # cat rootfs | cpio -id
+
+ +

Utiliser l'environnement

+

+Pour utiliser l'environnemnt chrooté, il suffit de monter quelques systèmes +de fichier virtuels et d'utiliser la commande chroot. Pour se +simplifier la vie on peut rapidement créer un petit script automatisant +le chroot. Exemple en utilisant le répertoire de chroot +/home/slitaz/chroot-env et en créant un script nommé +chroot_in_env.sh dans /home/slitaz. A noter que +le contenu du script n'a pas besoin d'être tapé mais simplement copié/coller +dans le terminal et que sur un autre système que SliTaz vous pouvez +décommenter les lignes montant/démontant /dev et +/tmp : +

+
+ # cat > /home/slitaz/chroot_in_env.sh << "EOF"
+
+
+#!/bin/sh
+# Chroot in SliTaz to hack.
+#
+ROOTFS="/home/slitaz/chroot-env"
+
+# Mount virtual Kernel file systems and chroot.
+#
+#mount --bind /dev $ROOTFS/dev
+#mount --bind /tmp $ROOTFS/tmp
+mount -t proc proc $ROOTFS/proc
+mount -t sysfs sysfs $ROOTFS/sys
+mount -t devpts devpts $ROOTFS/dev/pts
+mount -t tmpfs shm $ROOTFS/dev/shm
+
+echo "Chrooting in $ROOTFS... "
+chroot $ROOTFS /bin/sh --login
+
+# Unmount virtual Kernel file systems on exit.
+#
+umount $ROOTFS/dev/shm
+umount $ROOTFS/dev/pts
+umount $ROOTFS/sys
+umount $ROOTFS/proc
+#umount $ROOTFS/tmp
+#umount $ROOTFS/dev
+
+echo "Exiting of $ROOTFS chroot environment... "
+
+EOF
+
+

+Pour finir et tester l'environnement, il suffit de rendre le script exécutable +et le lancer : +

+
+ # chmod +x /home/slitaz/chroot_in_env.sh
+ # sh /home/slitaz/chroot_in_env.sh
+
+

Activer le réseau

+

+Pour avoir le réseau afin de télécharger, naviguer en mode texte et installer +des paquets de développement, il suffit de lancer le client DHCP sur la bonne +interface, exemple avec eth1 : +

+
+ /# udhcpc -i eth1
+
+

Installer des paquets

+

+Si le réseau est fonctionnel, il suffit de recharger la liste des paquets et +utiliser tazpkg get-install pour installer de nouveaux paquets. +Si la connexion n'est pas possible, on peut télécharger les paquets du miroir +depuis un autre système, les copier dans l'environnement chrooté et les +installer via la commande tazpkg install. Pour installer la base +des outils de compilation : +

+
+ /# tazpkg recharge
+ /# tazpkg get-install slitaz-toolchain
+
+

+Une fois l'environnement configuré, on peut complier des applications +depuis les sources pour en créer des paquets, tester des scripts et autre. +Le chapitre développement du Handbook et le +Cookbook devraient aider à +aller plus loin. +

+

Sortir de l'environnement

+

+Pour sortir de l'environnement chrooté il suffit de taper exit, +le script chroot_in_env.sh va finir son rôle en démontant +le systèmes de fichiers virtuels propre au Kernel Linux : +

+
+ /# exit
+ #
+
+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/cmdline.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/cmdline.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,363 @@ + + + + SliTaz Handbook - Ligne de commandes + + + + + + + + + + + + + + + +
+
+ +

Références en ligne de commandes (cmdline)

+ + + + +

Introduction aux commandes

+

+Ce document se veut être un rapide référentiel pour utiliser SliTaz en ligne +commandes via un terminal Linux ou un terminal graphique (XTerm). +Vous disposez de nombreuses commandes GNU/Linux de manipulation des fichiers, +de maintenance système ou de gestion du réseau. Vous pouvez aussi naviguer sur +le web, chatter sur l'IRC, télécharger, éditer des scripts et même jouer en +mode texte. Note : il faut être root pour les opérations de montage +de disques durs ou de cdrom. Vous pouvez utiliser la commande su +pour devenir administrateur système. +

+ +

Aide et liste des commandes disponibles

+

+La plupart des commandes des systèmes GNU/Linux ont une option d'aide pour des +infos sur leur utilisation. Pour avoir de l'aide et connaître des informations +sur l'utilisation d'une commande il faut taper le nom de la commande suivie +de l'option --help. Exemple avec la commande de copie de fichiers +cp : +

+
+ $ cp --help
+
+

+Pour lister les commandes disponibles sur le système, vous pouvez simplement +taper 2 fois sur la touche de tabulation qui se trouve à gauche du clavier +et comporte 2 flèches horizontales et opposées. Pour connaître les commandes +fournient par Busybox, vous pouvez taper help. +

+ +

Lister les fichiers contenus dans un répertoire

+

+Pour lister les fichiers et les dossiers contenus dans un répertoire, vous +pouvez utiliser la commande ls. Pour connaître toutes les +possibilités, n'oubliez pas d'utiliser l'option --help. Pour +simplement lister les fichiers du répertoire courant : +

+
+ $ ls
+
+

+Lister tous les fichiers en utilisant l'option -al : +

+
+ $ ls -al
+
+

+Lister un répertoire donné: +

+
+ $ ls /home/slitaz
+
+ +

Se déplacer dans les répertoires

+

+Pour naviguer dans les fichiers vous pouvez utiliser la commande +cd : +

+
+ $ cd /usr/share/doc
+ Revenir au réperoire parent :
+ $ cd ..
+
+

+Pour aller dans le répertoire de l'utilisateur (root = /root) : +

+
+ $ cd
+ Ou :
+ $ cd ~
+ Ou encore :
+ $ cd $HOME
+
+ + +

Copier des fichiers

+

+La commande cp copier des fichiers ou des dossiers. L'exemple +copie le fichier info.txt se trouve dans le répertoire courant, vers le +répertoire Documents/ : +

+
+ $ cp info.txt Documents/
+
+

+Copier un répertoire entier. Ici la commande copie le répertoire Templates/ +dans /home/hacker : +

+
+ $ cp -a Templates /home/hacker
+
+ + +

Créer de nouveaux répertoires

+

+mkdir de l'Anglais make a directory. Cette commande permet de créer un nouveau +répertoire. La commande ci-dessous crée un répertoire qui se nomme Projects. +Il se créera dans le répértoite /home de l'utilisateur courant ou dans le +répertoire dans lequel on se trouve : +

+
+ $ mkdir Projects
+
+

+Création d'un répertoire qui se nomme script-1.0 dans le dossier Projects/ : +

+
+ $ mkdir Projects/script-1.0
+
+ + +

Supprimer des fichiers ou des répertoires

+

+La commande rm permet de supprimer un fichier. Imaginons que +nous allons supprimer le fichier fichier.txt et qui se trouve dans le +répertoire courant : +

+
+ $ rm fichier.txt
+
+

+La commande rm a plusieurs options. Pour supprimer tout un +répertoire avec son contenu, il faut utiliser l'option -rf. +Exemple : +

+
+ $ rm -rf /home/hacker/Templates
+
+ + +

Lire des fichiers

+

+Pour lire le contenu d'un fichier ou d'un script, vous pouvez utiliser les +commandes less, more, cat, ou encore +le navigateur web Retawq. Exemples avec un fichier README, essential.txt, et +script.sh : +

+
+ $ less -EM essential.txt
+ ou:
+ $ more README
+ ou encore:
+ $ cat /chemin/script.sh
+
+

+Afficher un fichier texte ou html avec le navigateur web Retawq : +

+
+ $ retawq /usr/share/doc/index.html
+
+ + +

Editer des fichiers

+

+L'édition de fichiers texte, scripts, fichier de configurations, etc, peut se +faire facilement avec l'éditeur GNU Nano dans une console ou un terminal +graphique. Exemple avec un fichier bookmarks.html (<Ctrl+X> pour quitter +et enregistrer) : +

+
+ $ nano Public/bookmarks.html
+
+ + +

Cat

+

+Vous pouvez utiliser la commande cat pour créer divers +fichiers texte. EOF signifie End Of File, c'est là que le fichier se termine. +Exemple avec un fichier packages.list, cette commande supprime le contenu +actuel du fichier : +

+
+ $ cat > packages.list << "EOF"
+ Du texte...
+ et encore texte
+ 
+ EOF
+
+

+Pour ajouter du texte à la suite du fichier, mettez 2 fois: plus grand que +(>>) après cat, exemple : +

+
+ $ cat >> packages.list << "EOF"
+ Du texte...
+ 
+ EOF
+
+ + +

Naviguer sur le web

+

+Surfer sur la toile avec SliTaz simplement et rapidement avec 'retawq', +navigateur web en mode texte. A noter que vous pouvez aussi utiliser +le navigateur en local. Vous naviguerez ensuite facilement avec les flèches +de votre clavier, les liens sont en bleu et il faut taper <ENTER> pour +les suivre : +

+
+ $ retawq http://slitaz.libordux.org/
+ ou:
+ $ retawq http://localhost/
+
+ +

Discuter sur les canaux IRC

+

+Pour discuter et transférer des fichiers via les multiples serveurs IRC +de la planète, SliTaz fournit Rhapsody. Ce client IRC est simple, rapide, +léger, fournissant un menu de configuration ncurses très agréable et facile à +prendre en main. Pour lancer l'application depuis un terminal, se connecter +à un serveur (irc.tuxfamily.org) et joindre le canal #tuxfamily : +

+
+ $ rhapsody
+ /connect irc.tuxfamily.org
+ /join #tuxfamily
+
+ +

Télécharger des fichiers

+

+Pour télécharger divers formats de fichiers sur internet, vous disposez de la +commande wget. Vous pouvez rapatrier une simple page html, +le contenu de tout un répertoire ou tout un site web : +

+
+ $ wget http://www.slitaz.org/doc/handbook/
+
+ +

Lister les partitions disponibles

+

+Pour lister les partitions d'un disque dur interne ou externe, vous pouvez +utiliser la commande cat pour afficher le contenu du fichier +/proc/partitions ou utiliser l'utilitaire fdisk +avec l'option -l signifiant list. Vous pouvez ensuite +monter la (les) partitions que vous désirez utiliser : +

+
+ $ cat /proc/partitions
+ ou
+ # fdisk -l
+
+ +

Monter une partition, un cdrom ou une clé USB

+

+Pour monter une partition locale, dans le système de fichier SliTaz, nous vous +conseillons d'utiliser le répertoire /mnt. Dans l'exemple nous créons les +répertoires nécessaires, et nous montons la partition hda6 du +premier disque dur local sur /mnt/hda6 : +

+
+ # mkdir -p /mnt/hda6
+ # mount -t ext3 /dev/hda6 /mnt/hda6
+
+

+SliTaz fonctionne en RAM, vous pouvez monter ce même cdrom ou le retirer +pour en monter un autre (/dev/cdrom est un lien sur le premier lecteur de +cdrom). A noter qu'un cdrom est un média amovible, il devrait donc se +monter sur /media : +

+
+ # mount -t iso9660 /dev/cdrom /media/cdrom
+
+

+Pour monter une clé USB ou flash disk il faut spécifier le bon système de +fichiers. Normalement une clé USB achetée dans le marché est formatée en +FAT32 ce qui permet de la lire depuis GNU/Linux et Windows. Sur un système +GNU/Linux elle est reconnue généralement comme le disque sda1, nous avons +donc préparer un lien sda1 sur flash, pour se +faciliter la tâche. C'est aussi un média amovible et devrait se monter sur +/media : +

+
+ # mount -t vfat /dev/flash /media/flash
+
+ +

Eteindre le système, ou redémarrer

+

+Pour arrêter SliTaz ou redémarrer, vous pouvez utiliser la commande +halt, reboot ou utiliser la combinaison des touches +<Ctrl+Alt+Delete>, ce qui correspond à un redémarrage système. En cas de +problèmes, essayez d'utiliser l'option -f, signifiant +forced : +

+
+ # halt
+ Pour redémarrer :
+ # reboot
+ Ou :
+ # reboot -f
+
+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/development.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/development.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,332 @@ + + + + SliTaz Handbook - Developpement + + + + + + + + + + + + + + + +
+
+ +

Développement

+ + + + +

À propos du dévelopement

+

+SliTaz fournit quelques outils de développement, conception de sites web, +édition avancée de scripts, et de code source avec l'IDE 'geany'. Création +d'interface graphique à vos scripts SHell avec 'dialog'. +

+

+Si vous cherchez des informations sur le développement de SliTaz, +le cookbook (livre de +cuisine) vous décrira toutes les étapes de construction du système. Sur le +site web de SliTaz, la partie devel +vous donnera des informations générales au sujet des développeurs et des +possibilités de participation. +

+ +

Scripts SHell

+

+L'écriture de scripts SHell est la manière la plus simple pour commencer à +coder, ils permettent d'avoir rapidement un résultat et les seuls prérequis +sont de savoir ouvrir un terminal et utiliser un éditeur de texte tels +que Nano, LeafPad ou Geany. Les scripts SHell permettent de faire énomérement +de choses sur un système GNU/Linux, initialiser le système, faire des +sauvegardes, exécuter des tâches répétitives, afficher des informations sur +l'état du système, créer ou modifier des fichier, etc. Dans un script SHell, +vous pouvez aussi utiliser des variables, des fonctions ou encore des appels +pour inclure un fichier. A noter que vous pouvez nommer vos scripts comme bon +vous semble et que l'utilisation de l'extension .sh est largement +utilisée. +

+

Créer un script SHell

+

+Avant de commencer un nouveau script SHell, vous devez faire attention +à l'interprétateur utilisé. La plus part du temps les scripts SHell +utilisent /bin/sh, cela permet d'être plus portable. +Il y a aussi des scripts qui appelent /bin/bash, mais cela +implique que Bash soit installé sur le système. Pour qu'un script SHell +fonctionne il doit être exécutable par l'utilisateur courant, le changement +des permissions sur un fichier peut se faire en ligne de commande via +l'outils chmod. Pour créer un script.sh et le +rendre exécutable : +

+
+ $ touch script.sh
+ $ chmod +x script.sh
+
+

+Maintenant que vous avez un nouveau fichier exécutable, vous allez pouvoir +l'éditer. Vous pouvez continuer en restant dans le terminal et en utilisant +l'éditeur Nano (Ctrl+X pour enregistrer) ou en ouvrant l'IDE Geany sur le +fichier : +

+
+ $ nano script.sh
+ Ou :
+ $ geany script.sh &
+
+

+Voici un µscript qui contient une variable NAME et qui en +affiche la valeur avec la commande echo : +

+
+#!/bin/sh
+
+NAME="kayam"
+
+echo "$NAME est sympa."
+
+
+

+Une fois que vous avez créé/modifié votre script.sh, il suffit +d'enregistrer et d'exécuter le script pour voir le résultat : +

+
+ $ ./script.sh
+
+

+Voilà pour cette brève introduction au scripts SHell. Pour aller plus loin, le +web regorge d'informations à ce sujet et regarder ce qu'on fait les autres +peut aussi aider. +

+ +

Dialog

+

+Dialog permet de créer des interfaces graphique basées sur la console, telles +que 'tazkmap'. Le fichier de configuration de dialog est /etc/dialogrc, et/ou + ~/.dialogrc pour chaque utilisateur. Voici un simple exemple d'utilisation de + dialog via une console ou un terminal : +

+
+ $ dialog --title "Hello $USER" \
+   --msgbox "Message propulsé par dialog." 5 54
+
+

+Vous trouverez pleins d'exemples de scripts dans le répertoire /sample des +sources de dialog, que vous pouvez télécharger depuis: +invisible-island.net/dialog/dialog.html. Download des sources avec +'wget' et décompression : +

+
+ $ wget ftp://invisible-island.net/dialog/dialog.tar.gz
+ $ tar xzf dialog.tar.gz
+
+ +

Geany IDE

+

+Geany est un IDE ou Environnement de Dévelopement Intégré, il est simple, +léger, et rapide, proposant la coloration syntaxique, les onglets, +pliage/dépliage du code, la complétion automatique, de l'aide à l'écriture. +Vous avez une liste des symboles, fonctions, méthodes, variables très utiles, +avec une petite flèche de signalisation. Et encore, sélecteur de couleurs +intégré, fenêtre de messages, lancement du script courant via le bouton +Exécuter, etc. C'est avec lui que nous avons créé cette page, +la documentation, et presque tout le site web (un peu avec Nano aussi). +

+

Lancer Geany

+

+Vous trouverez Geany dans le menu de JWM --> Development --> Geany. +Un fois lancé pour la première fois, vous pouvez ajuster vos préférences +via --> Editer --> Préférences. Vous pouvez aussi lancer Geany via un +terminal X et la commande : +

+
+ $ geany &
+
+

+Note : Lors de la compilation des sources, le scripts ./configure +propose l'option : --enable-the-force... Que l'on peut utiliser +si l'on penser avoir la force et être Luc Skywalker! +

+ +

Perl ou Microperl - Coder/utiliser des scripts Perl

+

+Sur SliTaz vous pouvez coder et utiliser le puissant langage de scripts Perl +via le binaire perl ou microperl. Microperl est une +version très allégée de Perl compilée à partir des sources officielles de Perl, +les scripts fonctionnant avec microperl sont complètement compatible avec la +version complète de Perl. C'est justement une des forces de Perl, il est portable +et fonctionne sur toutes les systèmes d'exploitations. Perl est un langage +interprété cela veut dire que le code n'a pas besoin d'être compilé et qu'il +peut être utilisé directement. A noter que sur SliTaz, perl +et/ou microperl se sont pas installé par défaut sur le LiveCD, vous +pouvez soit reconstruire votre propore ISO en incluant Perl ou installer via +le gestionnaire de paquets. A noter que le paquet Microperl fait mois d'1 Mb +et ne fournit aucun modules, juste le minimum : +

+
+ # tazpkg install perl
+ Ou :
+ # tazpkg install microperl
+
+ +

Hello world!

+

+Le but de ce µscript est d'afficher Hello World. Vous pouvez +commencer par créer le fichier et le rendre exécutable depuis la ligne de +commandes et l'éditer ensuite graphiquement avec l'IDE Geany. A noter que nous +nommons le scripts hello.pl mais que vous pouvez nommer un +script Perl comme bon vous semble, avec ou sans l'extension .pl : +

+
+ $ touch hello.pl
+ $ chmod +x hello.pl
+ $ geany hello.pl &
+
+

+La première ligne d'un scripts Perl commence par définir le chemin vers +l'interprétateur Perl, généralement /usr/bin/perl et pour +afficher du texte il suffit d'utiliser la commande print. +Code à copier/coller. A noter que le langage Perl est sensible à la casse et +qu'une instruction devrait toujours se terminer par un point-virgule : +

+
+#!/usr/bin/perl
+#
+
+print "Hello World!\n";
+
+
+

+Pour exécuter et tester le script : +

+
+ $ ./hello.pl
+
+ +

Scripts CGI et Perl

+

+Les scripts CGI ont pour but d'afficher des pages web générées dynamiquement. +Le langage Perl assoicié au serveur web LightTPD vous permet d'utiliser +des scripts CGI via votre espace public ou via des hôtes virtuels. Perl est +tout à fait adapté au web 2.0 et permet de générer rapidement des pages xHTML. +Sur Slitaz, vous devez avoir installé Perl ou Microperl et +configuré le serveur Web LightTPD avant +de pouvoir utiliser des scripts CGI codé en Perl. A noter que par défaut vous +pouvez utiliser des scripts SHell (.sh) et les placer dans /cgi-bin/). +

+

+Une fois le server bien configuré, vous pouvez directement placer des scripts +CGI dans votre répertoire $HOME/Public/cgi-bin en utilisant +l'extension .pl ou .cgi et les visualiser en local +ou à distance. Exemple de script CGI utilisant Perl : +

+
+#!/usr/bin/perl
+#
+print "content-type : text/html\n\n";
+
+print "Hello World!\n";
+
+
+ + +

Python

+

+Le langage de programmation Python est disponible sous forme de paquet +facilement installable. Un fois Python installé vous pouvez créer vos propre +scripts/programmes et utiliser des applications CGI via le serveur Web LightTPD +en prenant soin de configurer le serveur +correctement. A noter que le dépôt Mercurial officiel de SliTaz fourni une +interface Web CGI/Python, c'est une solution adaptée à la production, robuste +et fiable. Pour installer le paquet python avec Tazpkg : +

+
+ # tazpkg get-install python
+
+ + +

Toolchain - Bibliothèques, compilateur C et outils associés

+

+Pour compiler des logiciels depuis les sources ou son propre code, vous avez +au minimum, besoin de la chaîne d'outils de base (toolchain), +composée des outils Binutils, de la bibliothèque Glibc , du compilateur +GCC, des headers du noyau et de l'utilitaire Make. Cette chaîne +d'outils peut être installée via le gestionnaire de paquets Tazpkg et une +seule commande. A noter que cette toolchain est utilisée par les +développeurs de SliTaz pour compiler le système entier depuis les sources. +Pour installer les paquets via l'installation d'un meta paquet créant les +dépendances qu'il faut : +

+
+ # tazpkg get-install slitaz-toolchain
+
+

+L'installation de la toolchain permet de compiler beaucoup d'applications +de base et en mode texte. A noter que beaucoup de paquets compileront sans +problème en utilisant le SHell Ash de Busybox, mais d'autres paquets ne +compileront pas sans Bash. GNU bash est disponnible sous forme de paquet +ainsi que divers outils de développement de base tels que Flex, M4, Bison, +ou encore Pkg-config. Si vous cherchez pkg-config par exemple : +

+
+ $ tazpkg search pkg-config
+
+

+Si vous désirez compiler des applications utilsant les bibliothèques Ncurses, +vous devez installer le paquet ncurses-dev complet (par défaut +il n'y a que le paquet minimum installé). A noter que le paquet ncurses fournit +aussi divers petits programmes tels que tic ou tack : +

+
+ $ tazpkg search ncurses
+
+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/enlightenment.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/enlightenment.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,190 @@ + + + + SliTaz Handbook - Enlightenment + + + + + + + + + + + + + + + +
+
+ +

Enlightenment (e17)

+ + + + +

Introduction et présentation de e17

+

+Enlightenment est un environnement de bureau complet, entièrement configurable +à la souris et proposant de nombreux thèmes. La version fournie par le projet +SliTaz est une version encore en développement connue sous le nom de e17, +cette version est considérée suffisament stable pour être intégrée dans la +distribution et travailler en production. Cela dit, SliTaz ne propose pas des +outils tels que Rage ou Entrance, mais ce qu'il faut pour disposer d'un +d'environnement de bureau complet, simple d'utilisation, stable, réactif et +efficace. Tous les réglages peuvent se faire graphiquement via le panneau de +configuration intégrés au bureau, le menu s'affiche via un clique de gauche +sur l'écran ou depuis une gondole. Il est entre autres possible d'utiliser le +glisser/déposer depuis un gestionnaire de fichiers et le bureau ou d'afficher +des icônes pour lancer ses applications préférées. +

+

+Enlightenment a été conçu pour être déployable sur des systèmes avec peu de +ressources comme sur les systèmes plus puissants. IL permet d'avoir des fonds +d'écran, des éléments du menus et des gadgets animés et interactifs, sait +gérer les bureaux virtuels (Alt + roulette de la souris). D'autres +fonctionnalités très pratiques permettent de gagner du temps sur des tâches +simples, comme par exemple le fait de déplacer une fenêtre d'un bureau à un +autre via le pager ou le fait d'enrouler une fenêtre avec la molette sur sa +bordure. +

+

+Site Web : www.enlightenment.org +

+ + +

Installation et lancement

+

+Installer et lancer Enlightenment sur SliTaz se résume à exécuter une commande +et éditer un fichier. Si vous n'avez pas rechargé votre liste de paquets depuis +quelques temps, pensez à la mettre à jour. Pour installer Enlightenment et ses +dépendances : +

+
+ # tazpkg get-install enlightenment
+
+

+Une fois tous les paquets installés, vous pouvez reconfigurer votre session X +avec tazx en spécifiant e17 en argument : +

+
+ $ tazx e17
+
+

+Pour commencer à utiliser Enlightenment il faut sauver le fichier, sortir de +sa session X courante et redémarrer une session graphique avec : +

+
+ $ startx
+
+

Éditer ~/.xsession

+

+Pour configurer manuellement votre session X via le fichier de configuration +de votre session X (~/.xsession). Il faut modifier la ligne +lançant le serveur Xvesa, commenter ou supprimer la ligne exécutant +JWM et ajouter exec enlightenment_start à la fin du fichier. +~/.Xsession peut être édité depuis le menu de JWM et la catégorie +Preferences ou avec Nano dans un terminal. N'oubliez pas d'ajouter +-terminate à la ligne lançant Xvesa. Simple exemple : +

+
+# ~/.xsession: Start X window session on your system.
+#
+Xvesa -ac -shadow -terminate -screen 1280x800x24 -mouse /dev/input/mice,5 &
+#exec jwm
+exec enlightenment_start
+
+

+Sortez de votre session est relancez startx. +

+ + +

Menu et icônes de bureau

+

+Enlightenment respect les standards de Freedesktop, les applications sont +classées par catégorie et apparaîssent automatiquement lors de leur +installation si un un fichier de bureau est fournit. Les fichiers de bureau +(.desktop) du système sont contenu dans le répertoire +/usr/share/applications ou le repértoire personnel +~/.local/share/applications. Ces fichiers de bureau ont une +syntaxe simple, sont éditables depuis le panneau de configuration ou avec +un simple éditeur de texte. Les fichiers des menus affichant les catégories +dans le menu d'Enlightenment sont contenus dans le paquet +slitaz-menus : +

+
+ # tazpkg get-install slitaz-menus
+
+

Un icône sur le bureau

+

+Pour avoir un icône sur le bureau lançant une application vous pouvez créer +à la main un fichier .desktop dans votre répertoire personnel +~/Desktop, les fichiers de bureau placés dans ce réperoire sont +automatiquement reconnus par Enlightenment. Un simple fichier de bureau peut +tenir sur huit lignes avec respectivement le nom (Name), le nom +généric, un commentaire, la commande à exécuter (Exec), l'icône, +le type et les catégories Freedesktop. Exemple d'un fichier de bureau pour +Xterm : +

+
+[Desktop Entry]
+Name=XTerm (sb)
+GenericName=Terminal
+Comment=Run commands in a shell
+Exec=xterm -bg black -fg white -cr orange -sb -bd violet -rightbar
+Icon=xterm.png
+Type=Application
+Categories=Utility;Terminal;
+
+ + +

Thèmes graphiques

+

+Enlightenment est conçu de manière à pouvoir tout configurer en fonctions de +ses préférences. Vous pouvez facilement modifier l'apparence des fenêtres, +de l'image de démarrage, du fond d'écran, les mouvements des fenêtres, les +gondoles et autres gadjgets. Vous trouverez plusieurs thèmes complet ou +fonds décran sur le site Web dédié aux outils et graphisme du bureau get-e.org. +Les thèmes s'installent graphiquement via le menu et l'interface de +configuration des thèmes, vous pouvez aussi les mettre manuellement dans vos +répertoires de configuration personnel de Enlightenment : ~/.e/e. +

+

+Enlightenment users art : www1.get-e.org +

+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/favicon.ico Binary file doc/handbook/favicon.ico has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/gen-livecd.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/gen-livecd.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,294 @@ + + + + SliTaz Handbook - Générer son propre LiveCD à saveur + + + + + + + + + + + + + + + +
+
+ +

Générer un LiveCD à saveur

+

+Comment créer son propre LiveCD facilement est rapidement avec Tazlito. +

+ + + + +

Pour commencer

+

+Créer sa propre version du LiveCD de SliTaz avec Tazlito (SliTaz Live +Tool) prend peu de temps et permet de choisir précisément les paquets +logiciels que l'on veut retrouver dans le système. Le support des saveurs +vous pemet de générer un LiveCD personnalisé en modifiant une liste de paquets +ou en utilisant des saveurs crées et envoyées sur slitaz.org par des +utilisateurs ou contributeurs. Tazlito est un outil en ligne de commande, il +ne faut pas que cela vous repousse, vous aurez votre propre image ISO en 2 +commandes et la graverez en 1 commande. +

+

+La génération du LiveCD demande un minimum de 256 Mb de RAM et la compression +du système avec LZMA peut prendre un certain temps. Il est possible de créer +une distribution depuis le mode LiveCD ou depuis un système installé. En mode +LiveCD, il est conseillé d'utiliser un media USB ou un disque dur pour stocker +les fichiers générés, conserver le travail et gagner de la place en RAM. +

+

+Tazlito est aussi utilsé par les développeurs SliTaz pour générer le LiveCD +officiel. Les seuls prérequis sont d'avoir Tazlito d'installé, c'est le cas +par défaut sur SliTaz, mais vous pouvez générer le LiveCD depuis une autre +distribution à condition d'avoir les paquets voulus sous la main ou de le +télécharger. +

+

Installer Tazlito sur une autre distribution

+

+Tazlito n'a aucune dépendance particulière pour générer le LiveCD, mais il +dépend de Cdrkit pour graver l'image et de Tazpkg pour regénérer des paquets +SliTaz depuis ceux qui sont installés. Pour récupérer Tazlito et l'installer +en suivant les instructions du fichier README contenu dans les sources de Tazlito. +

+ + +

Un LiveCD en 2 commandes

+ +

+Une fois le travail fini, vous trouvez l'image ISO du LiveCD dans le répertoire +/home/slitaz/distro. +

+ + + +

Récupérer une saveur

+

+Une saveur est un fichier .flavor contenant toutes les informations +nécessaires à la création du LiveCD. La saveur fournit une liste des paquets +(distro-packages.list), une description et des fichiers +additionnels propres à la saveur choisie. La liste des saveurs peut être +téléchargées et mise à jour avec Tazlito : +

+
+ # tazlito list-flavors
+ Ou :
+ # tazlito list-flavors --recharge
+
+

+La liste des saveurs va automatiquement s'afficher, donnant la taille du +LiveCD et une brève description. Pour la suite, la commande +get-flavor va télécharger le fichier de saveur .flavor +extraire automatiquement la liste des paquets et la description dans le +répertoire courant et mettre les fichiers additionnels dans le répertoire +/home/slitaz/distro/addfiles. Pour stocker les saveurs nous vous +proposons d'utiliser un répertoire spécifique tel que +/home/slitaz/flavors, vous pouvez créer ce répertoire et vous y +placer avec les commandes : +

+
+ # mkdir -p /home/slitaz/flavors
+ # cd /home/slitaz/flavors
+
+

+Pour télécharger et/ou extraire les fichiers d'une saveur particulière : +

+
+ # tazlito get-flavor saveur-particuliere
+
+

+La description d'une saveur peut être affichée avec la commande +show-flavor de Tazlito. Une fois la saveur choisie téléchargée +et/ou extraite, vous pouvez générer la distribution. +

+ + +

Générer la distribution

+

+Pour une première ISO nous vous conseillons de tester sans modifier la liste, +ensuite vous pourrez supprimer ou ajouter des paquets à volonté. Mais attention, +les paquets du système de base sont indispensables. La commande +gen-distro génère une image ISO avec tous les paquets de la +liste, il faut être root et être dans le même répertoire que liste et le +fichier de configuration. Pour générer un LiveCD : +

+
+ # tazlito gen-distro
+
+

+Voilà, votre première image ISO du LiveCD est générée dans +/home/slitaz/distro, sans compte pour l'utilisateur hacker. +

+

L'utilisateur hacker

+

+Si vous désirez avoir un compte utilisateur avec hacker, il faut l'ajouter +et recréer le système de fichier racine compressé : +

+
+ # tazlito addhacker
+ # tazlito gen-initiso
+
+

Nettoyer, regénérer et aller plus loins

+

+Pour continuer et aller plus loin, +vous pouvez simplement ajouter un ou deux paquets à la liste, nettoyer la distro +et regénérer le système de fichier racine avec une nouvelle image ISO : +

+
+ # tazlito clean-distro
+ # tazlito gen-distro
+
+

+Tazlito fournit encore plusieurs possibilités, telles que la gravure de l'ISO +ou la copie de fichiers additionnels dans le système ou directement sur le cdrom. +Pour connaître toutes les commandes disponibles, vous pouvez vous référer au +manuel de Tazlito +installé par défaut sur tous les systèmes SliTaz et accessible depuis le menu +de JWM +

+ + +

Créer une saveur

+

+Tazlito permet de facilement créer une saveur particulière à partir des +résultats de fabrication de la distribution (gen-distro). Le +fichier de saveur produit contiendra tous les fichiers additionnels, la +decription et la liste de paquets et réutilisé ultérieurement et mis à jour +en fonction des versions des paquets. Pour générer une saveur en répondant à +une ou deux questions : +

+
+ # tazlito gen-flavor nouvelle-saveur
+
+

+Une fois que votre saveur est fonctionnel et bien testées, vous avez la +possibilité de l'envoyer sur slitaz.org afin qu'elle soit mise à disposition +de tous, listée via list-flavor et utilisable via +get-flavor. Pour envoyer une saveur vous avez plusieurs moyens, +passer par la liste de discussion, mettre le fichier en ligne et le signaler +sur le forum ou directement l'envoyer par mail à un contributeur du projet. +

+ + + +

Fichiers additionnels

+

+Les fichiers de saveurs contiennent généralement des fichiers additionnels +copiés directement dans le système de fichier racine ou dans la racine du +cdrom. Le chemin vers les fichiers à utiliser est spécifié dans le fichier +de configuration tazlito.conf, logiquement et par défaut, les +fichiers sont situé dans /home/slitaz/distro/addfiles. Les +fichiers additionnels de la saveur core fournissent par exemple +le menu du gestionnaire de fenêtres JWM et les fonds +d'écrans. Il suffit de modifier, ajouter ou supprimer des fichiers dans le +pseudo système racine (rootfs) ou la racine du CD +(rootcd) et de regénérer la distribution pour retouver les +fichiers dans l'ISO. Pour nettoyer et regénérer la distribution : +

+
+ # tazlito clean-distro
+ # tazlito gen-distro
+
+ + +

Paquets utilisés

+

+Pour créer votre distro il vous faut des paquets SliTaz. Tazlito et Tazpkg +permettent de recréer les paquets depuis un système SliTaz en fonctionnement +ou de télécharger les paquets directement en fonction de la saveur choisie. +Par logique, sur SliTaz, les paquets se mettent dans le répertoire +/home/slitaz/packages, mais vous pouvez chager cela via un +fichier de configutation de Tazlito (tazlito.conf). +

+

+Si vous voulez récupérer des paquets à la main, vous pouvez utiliser un +logiciel FTP tel que gFTP (installé par défaut sur SliTaz) ou la ligne de +commande et wget pour télécharger des paquets officiels. L'URL +direct vers les versions des paquets : +ftp://download.tuxfamily.org/slitaz/packages/ +

+

+Vous pouvez aussi utiliser vos propre paquets en les mettant dans le répertoire +des paquets. Si vous cherchez de la documentation au sujet de la création de +paquets SliTaz, vous pouvez vous référer au livre de cuisine ou +Cookbook. +

+ + +

Fichier de configuration

+

+Par défaut Tazlito utilise le fichier de configuration système +/etc/tazlito/tazlito.conf ou un fichier tazlito.conf +situé dans le répertoire courant. C'est à dire que vous pouvez utiliser le +fichier par défaut ou avoir un fichier de configuration spécifique à chaque +distro que vous créez. Ce fichier de configuration permet de changer le nom +de l'image ISO, le nom du préparateur et les chemins vers les répertoires de +travail. Pour créer et configurer directement un fichier de configuration, il +suffit de lancer Tazlito avec la commande configure et cela depuis +le répertoire de la distro (vous pouvez le créer ailleur). En supposant que +avez l'arbre de la distro dans /home/slitaz/distro et que vous +vous y êtes placé avec cd : +

+
+ $ tazlito configure
+
+

+Une fois que vous avez répondu aux questions, vous pouvez soit recréer l'image +ISO, reconstruire le système racine et l'ISO ou générer une nouvelle distro +avec la liste des paquets. +

+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/graphics.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/graphics.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,138 @@ + + + + SliTaz Handbook - Graphisme + + + + + + + + + + + + + + + +
+
+ +

Graphisme et gestion d'images

+ + + + +

Gcolor2 - Selecteur et gestionnaire de colors

+

+Gcolor2 est un petit outils permettant de séléctionner et conserver des +palettes de couleures. C'est très utile lors de la créations de thèmes pour +SliTaz par exemple. Vous trouverez l'application dans la catégorie +Graphics ou vous pouvez la lancer via la commande : +

+
+ $ gcolor2 &
+
+ + +

Gimp - Manipulation et création d'images

+

+The GIMP (GNU Image Manipulation) est un logiciel de manipulation d'images de +très haute qualité. Il permet de faire tous ce qu'on peut attendre d'une +application de traitement d'images, gestion avançée des calques, filtres, +chemin, outils divers, dégradés, ou encore le support des scripts ajoutant des +fonctionnalités. Gimp support un très grand nombre de format d'images tel que +PNG, JPEG, XPM, PPM, TIFF, PostScript, PSD, il propose aussi son propre format +XCF pemettant de conserver par exemple les claques. Pour installer Gimp : +

+
+ # tazpkg get-install gimp
+
+

+Gimp est extensible et peut se configurer via l'interface principale, les +fichiers de configurations, brosses ou scripts personnels vont dans le +répertoire caché ~/.gimp-2.2. +

+ + +

GQview - Gestionnaire d'images

+

+GQview est rapide et léger, il permet une navigation très rapide entre les +images, par sélection des dossiers se trouvant dans votre arborescence, et +cela se fait en un seul clic de souris. Il intègre la possibilité de faire des +diaporamas, des rotations d'images et d'afficher les données EXIF, d'ajouter +des mots clés ou tags, de configurer les actions, de glisser-déposer. Il +donne aussi la possibilité d'éditer les images dans un logiciel externe de +son choix (mtPaint ou Gimp par exemple), l'interface est entièrement traduite +en français, et est très simple d'utilisation. +

+ + +

jpeg - Outils JPEG en ligne de commande

+

+Pour que les applications utilisant les images JPEG fonctionnent, elles +doivent êtres liée aux bibliothèques fournies par le paquet jpeg-6b, ce paquet +propose aussi quelques petits utilitaires à utiliser en ligne de commande. +Pour modifier des images JPEG en ligne de commande, vous pouvez utiliser +jpegtran, installé par défaut sur SliTaz. L'utilitaire +jpegtran permet par exemple de faire une rotation de +l'image via l'option -rotate. Le paquet jpeg-6b fournit aussi les +outils cjpeg et djpeg. Pour connaître les options +disponibles avec tous ces outils, vous pouvez utiliser l'option +--help propre à chaque application. Exemple avec +cjpeg : +

+
+ $ cjpeg --help
+
+ + +

mtPaint - Création et traitement d'images

+

+mtPaint est une application de création et de retouche d'images, PNG, TIFF, +XPM, BMP. Il est presque entièrement traduit en français, offre beaucoup de +fonctions, simple, léger, et rapide. L'outil mtPaint fournit une fonction de +capture d'écran (screenshot), que vous pouvez utiliser via le menu +--> Graphics --> Grab screenshot, ou en tapant la commande ci-dessous +dans un terminal: +

+
+ $ mtpaint -s
+
+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/hacking-livecd.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/hacking-livecd.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,444 @@ + + + + SliTaz Handbook - Hacking LiveCD + + + + + + + + + + + + + + + +
+
+ +

Hacking SliTaz LiveCD

+ + + + +

Introduction

+

+Hacking SliTaz LiveCD ou comment s'amuser avec l'image ISO du LiveCD, +la modifier, la personnaliser et la reconstruire à la main. A noter que vous +avez aussi la possibilité de +créer une saveur avec Tazlito et cela de. Créer +sa propre image ISO bootable ne demande que peut de temps, les étapes à suivre +sont soigneusement décrites dans ce document et sont faciles à réaliser. La +manipulation de l'images ISO permet d'ajouter des nouveaux fichiers ou de +modifier les fichiers existants sur le cdrom. L'image ISO de SliTaz fait moins +de 30 Mb et un CD-R ou CD-RW classique fournit 700 Mb, il reste donc pas mal +de place, pour mettre par exemple, vos photos afin de les montrer en +live via SliTaz et un diaporama propulsé par le gestionnaire +d'images GQview. Le hacking de l'image ISO permet de modifier les +fichiers de configuration du chargeur de démarrage (boot loader) et +son image splash ou d'en utiliser un autre tel que GRUB. Vous pouvez +aussi facilement et directement ajouter des utilitaire tel que Memtest86 (outil +servant à tester la RAM d'une machine). En utilisant les mêmes techniques, il +est également possible de modifier le contenu du système en soit, cela demande +quelques manipulations supplémentaires et un peu plus de temps... libre. +

+ +

Organisation et préparation

+

+Pour commencer il faut définir l'endroit ou l'on va travailler, créer un +répertoire de travail et plusieurs sous-répertoires destinés à accueillir les +différents fichiers. Le hacking de l'ISO peut se faire depuis un +système SliTaz ou tous autres système GNU/Linux tels que Debian, Fedora, +PCLinuxOS, Slackware, etc. Si vous utilisez SliTaz en mode LiveCD (vous pouvez +retirer le cdrom une fois SliTaz lancée en RAM et graver votre nouvelle ISO), +nous vous conseillons d'utiliser un media USB pour conserver le travail, sinon +il sera perdu à l'arrêt du système. Pour travailler nous vous proposons +d'utiliser un répertoire hacked/ que vous pouvez créer dans +un répertoire /home/slitaz, à la racine de votre espace +utilisateur, ou ailleurs si vous le désirez. Utiliser un répertoire +/home/slitaz vous permet de stocker une image ISO originale et +de créer en options un répertoire src/ pour télécharger +d'éventuelles paquets sources. Toutes les étapes de hacking peuvent +se faire en lignes de commandes via un termial X tel que XTerm ou en mode +texte et un terminal Linux. A noter que nous vous conseillons de faire les +opérations en tant que root afin d'éviter tous problèmes de +permissions. Pour devenir administrateur (root), créer le +répertoire de travail dans /home/slitaz/hacked et se placer +dedans : +

+
+ $ su
+ # mkdir -p /home/slitaz/hacked
+ (# mkdir -p /home/slitaz/src)
+ # cd /home/slitaz/hacked
+
+

Récupérer les fichiers contenus sur l'ISO

+

+Maintenant que vous êtes dans le répertoire de travail, il faut créer la +racine de votre cdrom modifié et récupérer les fichiers contenu dans l'ISO +original du LiveCD. C'est à dire le noyau Linux (bzImage), le +système de fichiers compressé (rootfs.gz) et les fichiers du +chargeur de démarrage Isolinux. Pour récupérer ces fichiers vous avez deux +solutions, soit les prendre depuis un cdrom gravé, soit directement depuis +une image ISO local. Pour créer la racine de votre CD (rootcd) +et copier les fichiers depuis un périphérique cdrom reconnu comme +/dev/cdrom et monté sur /media/cdrom : +

+
+ # mount -t iso9660 /dev/cdrom /media/cdrom
+ # mkdir rootcd
+ # cp -a /media/cdrom/* rootcd
+
+

+Pour monter une image ISO en loop sur le répertoire temporaire +nommé /tmp/loop (avec l'image ISO slitaz-cooking.iso +préalablement téléchargée ou copiée), créer la racine du CD, copier les +fichiers et démonter l'image ISO : +

+
+ # mkdir /tmp/loop
+ # mount -o loop slitaz-cooking.iso /tmp/loop
+ # mkdir rootcd
+ # cp -a /tmp/loop/* rootcd
+ # umount /tmp/loop
+
+

+Voilà, tous les fichiers nécessaires devraient être présents dans le répertoire +rootcd/, pour vous en assurer, vous pouvez pouver lister +récursivement les fichiers via la commande ls : +

+
+ # ls -R rootcd
+
+ +

Ajouter des fichiers dans l'ISO

+

+L'ajout de divers fichiers et répertoires dans l'image ISO consiste +simplement à copier des données à la racine du cdrom (rootcd/) +et à générer une nouvelle image. Les données ajoutées peuvent être classées +dans un ou des répertoires préalablement créés à la racine du CD. Une fois +l'image ISO gravée sur un CD-R/CD-RW vous pourrez utiliser SliTaz comme +avant, monter le cdrom sur /media/cdrom et naviguer dans vos +données graphiquement avec emelFM2, dans un terminal avec Clex ou en ligne de +commandes. Vos données seront aussi lisibles depuis tous les systèmes GNU/Linux, +BSD, et même... Windows. +

+

Créer un ou des répertoires et copier des données

+

+Pour créer et copier des fichiers vous pouvez commencer par utiliser la +ligne de commande et continuer graphiquement en tant que simple utilisateur. +Nous allons créer un répertoires images/ en tant que root +et changer les permissions pour que tous les utilisateurs puissent écrire +dedans : +

+
+ # mkdir rootcd/images
+ # chmod 777 rootcd/images
+
+

+Maintenant qu'un nouveau répertoire existe en écriture pour tous, il faut le +remplir. Une fois que vous avez fini de copier vos données, il suffit de +générer une nouvelle image ISO bootable. +

+ +

Modifier la configuration d'isolinux

+

+Modifier la configuration d'isolinux vous permet de créer des entrées +personnalisées avec des options de boot prédéfinies, vous pouvez par +exemple ajouter un label lançant SliTaz avec les options +lang=fr et kmap=fr_CH. Au niveau graphisme, vous +pouvez facilement changer l'image splash s'affichant au démarrage. +L'application isolinux est le chargeur de démarrage +(boot loader) du LiveCD, il est fournit par le paquet Syslinux. +L'archive source de Syslinux fournit diverses applications dont le rôle est +de démarrer un système GNU/Linux. La version binaire isolinux.bin +est déstinée aux image ISO, ce chargeur de démarrage est simple, rapide et +facilement configurable via un fichier de configuration principale, éditable +graphiquement ou dans un terminal avec votre éditeur de texte préféré. +La syntaxe du fichier de configuration isolinux.cfg est facile +à comprendre, pour ajouter de nouvelles entrées il suffit de copier/coller +en utilisant le fichier original. Pour éditer graphiquement le fichier +isolinux.cfg avec Leafpad : +

+
+ # leafpad rootcd/boot/isolinux/isolinux.cfg &
+
+

Fichier de configuration isolinux.cfg

+

+Le fichier isolinux.cfg, fourni en standard sur le LiveCD de +SliTaz, commence par la valeur display, cette valeur permet +d'afficher tel quel un fichier texte ou d'afficher un fichier +(isolinux.msg) utilisant des caractères ASCII 24 et permettant +d'afficher du texte avec une image splash. La valeur +default défini le nom du label à démarrer par +défaut après le temps d'attente (timeout). Timeout +correspond au nombre de secondes à attendre avant de booter, vous pouvez le +mettre à 0, hôter la ligne pour démarrer instantanément ou choisir un temps +d'attente plus long tel que 80 s. Pour finir, le prompt peut +être désactivé via la valeur 0, les valeurs F1, F2, F3 +affichent des fichiers d'aides et F4 est un display au format texte : +

+
+display isolinux.msg
+default slitaz
+label slitaz
+      kernel /boot/bzImage
+      append initrd=/boot/rootfs.gz rw root=/dev/null vga=788
+implicit 0	
+prompt 1	
+timeout 80
+F1 help.txt
+F2 options.txt
+F3 isolinux.msg
+F4 display.txt
+
+

+Exemple d'un label slitazfr que vous pouvez ajouter à l'orginal, +pour configurer directement la langue du système en français et avoir le +clavier Belge : +

+
+label slitazfr
+      kernel /boot/bzImage
+      append initrd=/boot/rootfs.gz rw root=/dev/null lang=fr kmap=be
+
+

+Une fois que vous avez fini de modifier le fichier de configuration, il ne +faut pas oublier d'enregistrer vos changements avant de +générer une nouvelle image ISO bootable avec isolinux. +

+ +

Installer et utiliser Memtest86

+

+L'application memtest86 (92 ko) est un outil autonome de test de mémoire vive +(RAM). Memetes86 permet de tester en profondeur l'état des barrettes de RAM et +de déceler une quelconque défaillance. L'outil s'installe dans le répertoire +boot/ de la racine du cdrom et se lance directement au démarrage +de la machine en tapant simplement memtest au prompt d'isolinux. +Direction /home/slitaz/src (si le répertoire n'existe pas : +mkdir -p /home/slitaz/src) pour télécharger les sources et les +désarchiver : +

+
+ # cd /home/slitaz/src
+ # wget http://www.memtest86.com/memtest86-3.3.tar.gz
+ # tar xzf memtest86-3.3.tar.gz
+
+

+Le paquet source de Memtest86 étant désarchivé (vous y trouverez un fichier +README en anglais donnant des informations sur l'outil), vous +allez pouvoir l'installer dans le root CD de votre ISO hackée. En +partant du principe que vous utilisez un répertoire de travail +/home/slitaz/hacked, nous allons copier le binaire précompilé +dans le répertoire boot/ de la racine du CD : +

+
+ # cp memtest86-3.3/precomp.bin \
+   /home/slitaz/hacked/rootcd/boot/memtest
+
+

+Maintenant que le binaire est installé dans le root CD, il suffit +d'ajouter une entrée pour Memtest86 dans le fichier de configuration d'isolinux +et de générer une nouvelle image ISO bootable. +Direction /home/slitaz/hacked pour éditer le fichier +isolinux.cfg avec LeafPad par exemple : +

+
+ # cd /home/slitaz/hacked
+ # leafpad rootcd/boot/isolinux/isolinux.cfg &
+
+
+label memtest
+      kernel /boot/memtest
+
+

+Site web officiel de Memtest86 : +http://www.memtest86.com/ +

+ +

Manipuler la racine du système Live

+

+La modification du système Live vous permet par exemple d'ajouter rapidement +un nouvel utilisateur avec mot de passe, de personnaliser le graphisme ou +d'ajouter des commandes exécutées automatiquement au démarrage du LiveCD. Les +opérations nécessaires à la modification du système de fichier racine ( +root file system) sont : extraire le système du fichier compresé +rootfs.gz, modfier, reconstruire l'image du système compressé +et générer une nouvelle ISO. En partant du principe que vous avez déjà +préparé votre répertoire de travail, il faut commencer +par créer un répertoire destiné à contenir les fichiers du système modifiable. +Le système racine compressé étant nommé rootfs.gz, nous vous +proposons d'utiliser un répertoire rootfs/ pour l'extraire. +Direction le répertoire de travail hacked/, création du +répertoire racine et copie du système compressé depuis le répertoire +rootcd/boot/ (la racine du cdrom) : +

+
+ # cd /home/slitaz/hacked
+ # mkdir rootfs
+ # cp rootcd/boot/rootfs.gz rootfs
+
+

+Maintenant que vous avez une copie du système compressé, il suffit de le +décompresser et de le désarchiver avec cpio. Techniquement : Le +fichier rootfs.gz est une archive Cpio compressé avec LZMA ou +Gzip, elle est reconnue comme une image initramfs par le noyau +Linux. Lors du démarrage de la machine, le noyau se charge en mémoire et +décompresse l'image du système en mémoire vive pour finir par exécuter les +scripts d'initialisation. Pour extraire le système dans le répertoire +rootfs/ et supprimer la copie désarchivée (Rappel : vous pouvez +copier/coller les commandes) : +

+
+ # cd rootfs
+ # (zcat rootfs.gz 2>/dev/null || lzma d rootfs.gz -so) | cpio -id
+ # rm rootfs rootfs.gz
+
+

+Le système est prêt à être modifié, vous pouvez lister les fichiers contenus +à la racine de votre système hackable en utilisant la commande ls. +

+

Modifier un fichier

+

+Pour faire simple et vous aider comprendre le principe, nous allons modifier +un fichier script dans le but d'ajouter deux commandes exécutées +automatiquement à chaque démarrage du LiveCD. La cible est : +etc/init.d/local.sh, il suffit de l'ouvrir avec votre éditeur de +texte préféré tel que Geany : +

+
+ # geany etc/init.d/local.sh &
+
+

+Nous allons ajouter une commande affichant un message et faisant dormir le +système 4 secondes (c'est juste pour se faire la main). Example de lignes à +ajouter au script déstiné aux commandes locales : +

+
+echo "* Hacked SliTaz version booting..."
+sleep 4
+
+

Reconstruire l'image du système compressée

+

+Une fois les modifications terminées, vous pouvez reconstruire une image +compressée de votre système modifié en utilisant find pour +trouver les fichiers, cpio pour archiver, lzma ou +gzip pour compresser et des pipes | pour connecter +le tout. Cette commande doit être lancée depuis le répertoire racine du +système (rootfs/) et crée un fichier compressé +rootfs.gz dans le répertoire précédant : +

+
+ # find . -print | cpio -o -H newc | lzma e -si -so > ../rootfs.gz
+ Ou avec gzip :
+ # find . -print | cpio -o -H newc | gzip -9 > ../rootfs.gz
+
+

+Pour finir il suffit de copier votre système compressé dans le répertoire +boot/ de la racine du CD et de générer une nouvelle image ISO bootable avec isolinux. Pour copier le +rootfs en écrasant l'actuel, direction le répertoire de travail : +

+
+ # cd ../
+ # cp -a rootfs.gz rootcd/boot
+
+ +

Générer une image ISO bootable avec isolinux

+

+La suite de commandes permettant de créer une image avec le +boot loader isolinux, utilise l'application +genisoimage suivie de nombreuses options. Le nom de l'ISO est +spécifié au début, après l'option -o et le répertoire racine +(rootcd/) tout à la fin, après l'option +-boot-info-table : +

+
+ # genisoimage -R -o slitaz-hacked.iso -b boot/isolinux/isolinux.bin \
+   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
+   -V "SliTaz-Hacked" -input-charset iso8859-1 -boot-info-table rootcd
+
+

+Si vous désirez vérifier le contenu de l'ISO avant gravage, il suffit +de monter l'image en loop et de lister les fichiers. Sur SliTaz +et la plupart des systèmes GNU/Linux, vous pouvez graver des images au +format ISO avec l'utilitaire wodim fournit par cdrkit. +

+

Générer de nouvelles ISO via un script

+

+Si vous testez plusieurs possibilités et que vous êtes amené à souvent générer +des nouvelles images ISO, vous aurez peut être envie de semi-automatiser les +opérations via un simple petit script SHell. Ce petit script peut être créé +en ligne de commandes ou édité graphiquement, mais il ne faut oublier de le +rendre exécutable. Vous pouvez créer le script avec la commande +cat, à noter que EOF signifie End Of File, +c'est la que le fichier se termine. Nous vous proposons de nommer le script +gen_hacked_iso.sh et d'utiliser deux variables permettant de +rapidement changer le nom de l'image ISO et le chemin vers le répertoire +racine du cdrom : +

+
+ # cat > gen_hacked_iso.sh << "EOF"
+
+
+#!/bin/sh
+# Gen a new hacked ISO image.
+#
+ISO_NAME="slitaz-hacked.iso"
+ROOTCD="rootcd"
+
+genisoimage -R -o $ISO_NAME -b boot/isolinux/isolinux.bin \
+   -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
+   -V "SliTaz-Hacked" -input-charset iso8859-1 -boot-info-table $ROOTCD
+
+EOF
+
+

+Pour utiliser le script, il suffit de le rendre exécutable et de l'exécuter : +

+
+ # chmod +x gen_hacked_iso.sh
+ # ./gen_hacked_iso.sh
+
+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/images/css/content-tl.png Binary file doc/handbook/images/css/content-tl.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/images/css/content-tr.png Binary file doc/handbook/images/css/content-tr.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/images/css/footer-bl.png Binary file doc/handbook/images/css/footer-bl.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/images/css/footer-br.png Binary file doc/handbook/images/css/footer-br.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/images/css/header.png Binary file doc/handbook/images/css/header.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/index.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/index.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,176 @@ + + + + SliTaz Handbook + + + + + + + + + + + + + + + +
+
+ +

Livre de main de SliTaz

+ +

Table des matières

+ +

Applications

+ +

Système

+ + + +

À propos de ce Handbook

+

+Le Handbook de SliTaz est le livre de référence au sujet de l'utilisation du +système au niveau utilisateur, administrateur et développeur en général. Ce +Handbook réunit des travaux de référence, des mini manuels et une collection +d'instructions destinées à fournir un livre complet, de haute qualité, +facilement consultable et fournissant des réponses rapides sur un sujet +spécifique. Le Handbook est écrit au format xHTML 1.0 avec l'IDE Geany et +l'éditeur de texte GNU Nano. +

+

+Vous pouvez vous référer à la table des matières de cette page pour un +accès aux divers documents à thèmes. Pour commencer en mode LiveCD, nous vous +conseillons de jeter un coup d'oeil au chapître : +Utiliser le LiveCD. Vous pouvez lire le Handbook +de manière linéaire en utilisant le liens de navigation rapide situés dans le +coin droite en haut de chaque pages ou naviguer dans les pages en fonction de +vos besoins. +

+

+La dernière version du Handbook de SliTaz est lisible via la partie +documentation du site web de +www.slitaz.org. Au moment de la +publication d'une nouvelle version de SliTaz, le Handbook est archivé et +prend le même numéro de version que SliTaz. Il est alors inclus en standard, +dans la distribution de base officielle. +

+

Participer/collaborer/réclamer

+

+La documentation du projet se veut une oeuvre collaborative. Vous pouvez +facilement participer à l'écriture ou à la relecture de documents, nous faire +part de vos suggestions et commentaires. Si vous avez besoin d'une description +supplémentaire, d'un texte de référence ou autre, vous pouvez, sans hésiter, +nous contacter et nous faire une demande spécifique. +

+

+Si vous avez remarqué des erreurs dans les textes ou si vous avez fait une +relecture complète d'un chapître, vous pouvez envoyer/attacher vos +correctifs sous forme de patch ou envoyer toute la page relue ou encore +signaler les erreurs directement dans le contenu du mail. +

+

+Pour écrire un nouveau document ou un bout de texte à rajouter dans un +chapître existant, vous pouvez utiliser la page modèle du Handbook +(template.html) associée à sa feuille de style +CSS (handbook.css) ou simplement utiliser un +fichier texte (une personne de la liste se chargera de la mise en page). Une +fois votre texte mis en page, vous pouvez l'envoyer sur la liste afin qu'il +soit relu et corrigé. Votre documents sera ensuite intégré au Handbook +officiel de SliTaz. Par la suite, vous avez le choix de rester le mainteneur +du document ou de passer la main. +

+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/install.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/install.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,240 @@ + + + + SliTaz Handbook - Installation + + + + + + + + + + + + + + + +
+
+ +

Instructions d'installation sur HD

+ + + + +

A propos de ce document

+

+Ce document fournit les instructions pour une installation de SliTaz GNU/Linux +sur un disque dur (HD). Il vous faudra passer quelques commandes et éditer +quelques fichiers au format texte. Le temps à consacrer pour une +installation de base est d'environ 10 min. A noter que vous pouvez toujours +utiliser une clé USB ou un disque dur externe en tant que partition +/home, comme avec le mode LiveCD. A noter +que vous avez le choix entre un installation semi-automatisée ou une +installation à la main, commande par commande. +

+ + +

Prérequis

+

+Il vous faut un cdrom ou une image ISO de SliTaz et environ 80 Mb de libre +sur un disque dur de votre ordinateur. Si le mode liveCD fonctionne c'est +que vous pouvez installer SliTaz facilement et sans aucun problèmes. +

+

+Pour commencer, vous devez avoir une partition montée pour installer SliTaz +et avoir ouvert un terminal avec un SHell administrateur (root). +En mode LiveCD, vous pouvez devenir root avec la commande +su suivi du mot de passe root. Pour lister les +partitions disponibles, vous pouvez utiliser les commandes : +cat /proc/partitions ou fdisk -l. Pour créer un +système de fichiers sur une partition, vous pouvez utiliser l'utilitaire +mkfs. Exemple avec la partition hda1 et le système +de fichiers journalisé ext3, attention cette commande détruit +définitivement toutes les données de la partition spécifiée : +

+
+ # mkfs.ext3 /dev/hda1
+
+ + +

Installateur

+

+SliTaz fourni un installateur en mode ncurses, simple, intutif et en français. +Il fournit les instructions nécessaires, pas à pas, pour que l'installation +du système se passe sans soucis et que vous puissiez redémarrer sur votre +nouveau système SliTaz GNU/Linux. Les étapes sont toutes automatisées, vous +pourrez installer le gestionnaire de démarrage GRUB si besoin est, ou +ajouter une ligne au fichier de configuration de votre gestionnaire de +démarrage actuel. Pour afficher le premier message et commencer l'installation : +

+
+ # slitaz-installer
+
+ + +

Installation à la main

+

+Si vous avez utilisé l'installateur, vous pouvez directement passer au +bootloader GRUB. +

+

+A noter que vous pouvez copier/coller les commandes depuis Firefox dans le +terminal, en utilisant le bouton du milieu. A noter aussi que ce document ne +demande qu'a être amélioré, toute contribution est la bienvenue. +

+

Monter la partition cible

+

+Pour monter la partition cible sur un point de montage tel que le répertoire +/mnt/target, vous pouvez utiliser la commande mount. +Exemple : +

+
+ # mkdir /mnt/target
+ # mount -t ext3 /dev/hda1 /mnt/target
+
+ + +

Monter le cdrom

+

+Tous les fichiers utiles se trouvent sur le cdrom de SliTaz. Il faut le noyau +Linux, le système de fichiers racine compressé (rootfs.gz), et des packages +additionnels si vous le désirez. Pour monter le périphérique de cdrom sur +le point de montage /media/cdrom : +

+
+ # mount -t iso9660 /dev/cdrom /media/cdrom
+ ou
+ # mount -t iso9660 /dev/hdd /media/cdrom
+
+ + +

Installation du système

+

+Création du répertoire /boot et copie du noyau Linux, qui se nomme bzImage +sur le cdrom. Nous allons renommer le noyau en vmlinuz suivi de son numéro +de version, que l'on peut obtenir avec la commande +uname -r en mode live : +

+
+ # mkdir /mnt/target/boot
+ # cd /media/cdrom/boot
+ # cp bzImage /mnt/target/boot/vmlinuz-2.6.22.9-slitaz
+
+

+Copie du rootfs: +

+
+ # cp rootfs.gz /mnt/target
+
+

+Nous allons maintenant nous déplacer dans la cible, et décompressé l'archive +rootfs.lf avec lzma et cpio. Nous supprimons ensuite le fichier rootfs et le +lien init, utilisé par le mode liveCD : +

+
+ # cd /mnt/target
+ # lzma d rootfs.lz -so | cpio -id 
+ # rm rootfs.lz init
+
+

+Voilà SliTaz est installé. Si vous avez déjà GRUB ou Lilo d'installé, vous +pouvez ajouter les lignes nécessaires pour faire booter SliTaz, et redémarrer. +Sinon il vous faut installer le boot loader GRUB. +

+ +

Installer le bootloader GRUB

+

+Le paquet GRUB devrait être installé sur le LiveCD de SliTaz. GRUB est un +chargeur de démarrage (boot loader) permettant de lancer les systèmes +GNU/Linux, BSD et même Windows, via de simple entrée dans un fichier texte. +Ce fichier texte se nomme menu.list, il permet de finement +configurer le chargeur de démarrage, il peut être modifié manuellement et à +tous moments. +

+

+Installation de GRUB sur le mbr, avec comme racine /mnt/target (la cible), et +comme disque hda : +

+
+ # grub-install --root-directory=/mnt/target /dev/hda
+
+

+Vous pouvez maintenant ajouter les lignes de configuration ci-dessous pour +SliTaz, au fichier menu.lst de la cible. Pour cela vous pouvez utiliser +l'éditeur de texte Nano ou LeafPad en mode graphique . A noter que pour +connaître la version du noyau Linux sur un système GNU/Linux, vous pouvez +utiliser la commande $ uname -a. Pour éditer le fichier de +configuration de GRUB (Un exemple est fournit) : +

+
+ # nano /mnt/target/boot/grub/menu.lst
+ (Ctrl+X pour quitter)
+ ou :
+ # leafpad /mnt/target/boot/grub/menu.lst
+
+

/boot/grub/menu.lst - Exemple

+
+
+ title  SliTaz GNU/Linux (cooking) (Kernel 2.6.22.9-slitaz)
+        root(hd0,0)
+        kernel /boot/vmlinuz-2.6.22.9-slitaz root=/dev/hda1 vga=788
+
+
+ +

Redémarrer (reboot)

+

+Vous devriez pouvoir redémarrer sur votre nouveau système SliTaz GNU/Linux. +Après l'installation de SliTaz sur un disque dur, il est recommandé de +commencer par configurer le système, en fonction de ses besoins, du matériel, +et des possibilités. Pour configurer votre système après le reboot et +apprendre à utiliser SliTaz, vous pouvez vous référer au Handbook. Vous pouvez +redémarrer via le menu du gestionnaire de fenêtres JWM ou via la commande : +

+
+ # reboot
+
+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/jwm.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/jwm.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,215 @@ + + + + SliTaz Handbook - JWM + + + + + + + + + + + + + + + +
+
+ +

JWM le gestionnaire de fenêtres

+ + + + +

Introduction et présentation de JWM

+

+Le gestionnaire de fenêtres (en anglais window manager ou WM) +fourni de base avec SliTaz, se nomme : JWM (Joe's Window Manager). +Un gestionnaire de fenêtres est une application tournant au dessus du serveur +X, permetant de contrôler l'apparence des fenêtres, d'ouvrir un terminal X ou +d'afficher des applications. Il permet ensuite de placer, de réduire, et de +dimensionner les fenêtres à son propre gré. JWM sais aussi gérer plusieurs +bureaux virtuels, fournit des raccourcis clavier configurables, et propose un +joli menu supportant les icônes. JWM est un gestionnaire de fenêtres très +léger, c'est un bureau graphique efficace, ne consommant pas toutes les +ressources du système, il est relativement facile d'accès à un débutant dans +le monde libre de GNU/Linux. Côté développeur l'utilisation d'un gestionnaire +de fenêtres léger est appréciable, l'économie des ressources système +signifiant un gain en rapidité, même sur des machines puissantes. +

+

+Joe's Window Manager est écrit en C, simple, rapide, épuré, stable et +efficace. JWM propose une ou plusieurs barre(s) des tâches, un menu avec des +icônes et un pager pour la gestion des bureaux virtuels, la barre des tâches +peut aussi afficher l'heure en différents formats et un dock par instance de +JWM. De plus il est facilement configurable via un seul fichier texte vous +permettant de changer le menu, les polices et leurs tailles, et les +différentes couleurs. Le projet est en actif développement et les +fonctionnalités s'additionnent avec le temps, depuis la version 2.0 vous +bénéficiez, par exemple, du support des couleurs dégradées (gradient), +de la gestion du fond d'écran ou de la possibilité de déplacer les fenêtres +via le pager. +

+ +

Utilisation et configuration de JWM

+

+La prise en main de Joe's Window Manager est très rapide. Pour afficher le +menu il suffit de cliquer quelque part sur le bureau ou sur le bouton du menu +qui se trouve, par défaut, en bas à gauche de l'écran. Vous pouvez +redimensionner une fenêtre via une des bordures ou un des coins, les passer +d'un bureau virtuel à l'autre via le pager, les réduire ou encore les +maximiser. Vous disposez aussi de raccourcis clavier configurables pour un +accès plus rapide aux applications que vous utilisez le plus souvent. Sur +SliTaz le fichier de configuration système est : +/etc/jwm/system.jwmrc. A part ce fichier de configuration +système, chaque utilisateur peut utiliser son propre fichier de configuration +caché ~/.jwmrc. Ce fichier est un fichier texte utilisant la +syntaxe XML, il peut être modifié avec un simple éditeur de texte, les lignes +commençant par : <!-- sont des commentaires qui vous aiderons +à savoir quelle balise fait quoi. +

+

+Pour faciliter la personnalisation de son bureau, SliTaz copie automatiquement, +lors du lancement de la première session graphique, un fichier de configuration +système à la racine du répertoire personnel de l'utilisateur. Vous pouvez +directement modifier ce fichier et faire vos essais sans risques. Pour l'éditer +avec votre éditeur de texte préféré : +

+
+ $ geany $HOME/.jwmrc &
+
+

+Pour récupérer un fichier de configuration original, il faut copier celui du +système dans son répertoire personnel en le renommant par .jwmrc, +vous pourez ensuite (re)commencer à l'éditer : +

+
+ $ cp /etc/jwm/system.jwmrc $HOME/.jwmrc
+
+

+Maintenant que vous avez un fichier de configuration personnel vous allez +pouvoir créer votre propre menu en utilisant les icônes dont vous avez envie. +La balise : RootMenu correspond au menu affiché par un clique +sur un des trois boutons de la souris. Pour ajouter une catégorie vous devez +utiliser la balise : Menu contenant elle même des entrées pour divers +programmes. Une entrée dans le menu de JWM peut tenir sur une seule ligne, +exemple avec l'application de gestion d'images GQview : +

+
+<Program icon="gqview.png" label="GQview">gqview</Program>
+
+

+Il existe encore de nombreuses possibilités de configuration comme +l'utilisation de plusieurs RootMenu en fonction des boutons de +la souris, le choix du mode utilisé pour déplacer les fenêtres, la création +de groupes, etc. Le manuel disponible en ligne sur le site web officiel du +projet devrait vous aider à aller plus loin, pour afficher une liste des +options possibles en ligne de commandes il suffit de taper : +jwm -h dans un terminal. +

+ +

Créer son propre style pour JWM

+

+Créer son style graphique avec JWM est relativement facile et se fait +rapidement, les balises sont claires et les attributs possibles sont donnés +dans les commentaires. Lors de l'élaboration de votre travail, vous pouvez +voir vos modification au fur et à mesure en redémarrant le gestionnaire de +fenêtres via le menu ou la commande : jwm -restart. Dans le +fichier de configuration les balises de styles débutent après la ligne de +commentaires : <!-- Visual Styles -->. Pour commencer voici une petite +liste des balises de styles principales avec une courte description : +

+ +

+Les couleurs peuvent être définies avec leur nom ou leur numéro RGB, tel que : +#3A4956. Pour utiliser de belles couleurs en mode dégradé +(gradient), vous devez spécifier deux couleurs séparées par +deux points, exemple : #6C0023:#3E1220. Vous pouvez aussi changer +les polices et leurs tailles en utilisant la balise : Font. Il y +a encore quelques petites choses que vous pouvez modifier pour personnaliser +votre bureau, telles que le format de l'horloge ou le nom du bouton et son icône. +Avant de redémarrer JWM avec votre nouveau fichier de configuration, vous +pouvez vérifier sa syntaxe en utilisant la commande : jwm -p. +Pour aller plus loin, le manuel officiel décrit tous les tags, les options +possibles et les attributs valides. Vous pouvez le consulter en ligne sur le +site web de JWM. +

+ +

JWM sur le web

+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/livecd.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/livecd.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,347 @@ + + + + SliTaz Handbook - LiveCD + + + + + + + + + + + + + + + +
+
+ +

Utiliser le LiveCD et ses options

+ + + + +

Rapide introduction au LiveCD

+

+Le LiveCD de SliTaz GNU/Linux est une distribution libre fonctionnant depuis +un cdrom. La distribution vous permet d'emporter avec vous un mini système +ultra rapide, léger et sans rien installer. L'utilisation du LiveCD de SliTaz +est absolument sans risques pour le système d'exploitation existant sur +l'ordinateur hôte et SliTaz ne touche pas aux disques durs. Le LiveCD est +disponible sous forme d'image au format ISO contenant le système +d'exploitation complet et compressé. Cette image ISO peut être gravée sur +un cdrom (CD-RW ou un CD-R), ensuite, il suffit de redémarrer la machine +avec le cdrom dans le lecteur de CD ou DVD pour lancer SliTaz en mémoire vive +(RAM). Une fois en fonctionnement, SliTaz est autonome, vous pouvez retirer le +cdrom et utiliser le système pendant des mois sans redémarrer... +

+ + +

Démarrer sur le CD (boot)

+

+L'utilisation de SliTaz nécessite que votre machine démarre (boot) +depuis le périphérique de CD/DVD et non pas depuis le disque dur. Dans la +plupart des cas votre ordinateur est déjà configuré pour amorcer sur cdrom, si +ce n'est pas le cas, il faut modifier l'ordre de démarrage via l'interface de +configuration du BIOS accessible, en général, en pressant une touche +(F10, F12, esc ou autre) dans les +premières secondes qui suivent l'allumage de la machine. Quand vous êtes dans +le BIOS, il faut chercher les paramètres relatifs à la séquence de démarrage +tels que Boot Order ou Boot Device et changer l'ordre pour +que le cdrom arrive en premier. Pour finir, n'oubliez pas d'enregistrer les +modifications avant de quitter l'interface de configuration du BIOS. +

+

+Quand la machine a réussi à démarrer sur le cdrom, vous vous retrouvez avec +une image splash du logo de Slitaz et une invite de commande +permettant de passer différentes options au noyau Linux et aux scripts de +démarrage (boot scripts) utilisés par SliTaz. Il suffit alors de +taper sur la touche ENTER pour lancer le système avec ou sans +options, la touche F1 affichera un texte d'aide et d'informations. +

+ + +

Options et paramètre à passer au démarrage

+

+Le système LiveCD de SliTaz propose diverses options à passer au démarrage +(boot), via l'invite de commandes propulsé par Syslinux. Il y deux +types d'options : celles de SliTaz et celles du noyau Linux. Les options +propres à SliTaz sont utilisées par les scripts de démarrage et les paramètres +du noyau Linux (kernel boot parameters), tel que le mode VGA, sont +gérés directement par le noyau. Pour passer des options au démarrage vous devez +commencer par taper slitaz suivit des options, pour vous simplifier +la vie vous pouvez simplement taper par exemple fr et ENTER pour +charger un fichier de clavier (en clavier qwerty slitaz +correspond à : slitqw). Exemple : +

+
+ slitaz vga=791 no387
+
+

+A noter que le noyau Linux conserve les données passées au boot dans +le fichier texte /proc/cmdline. Sur un système GNU/Linux en +fonctionnement, ce fichier est facilement lisible depuis un terminal et via la +commande : +

+
+ $ cat /proc/cmdline 
+
+ + +

Paramètres du noyau Linux

+

+Sur les systèmes GNU/Linux, les paramètres spécifiques au noyau Linux varient +en fonction de la configuration utilisée lors de la compilation de celui-ci. +Le noyau utilisé par SliTaz est construit avec un minimum de modules et +propose peu de paramètres modifiables au démarrage. Cela dit, vous avez +la possibilité de désactiver l'émulation d'un coprocesseur mathématique via +le code : no387 et/ou d'activer irqpoll en cas de +problèmes d'interruption avec le matértiel (lecteur CD/DVD par exemple). Le +noyau Linux de SliTaz fournit aussi un mode de sortie video vga VESA pour le +framebuffer. C'est lui qui affiche le petit logo Tux et gère la +taille d'affichage du terminal Linux. A noter qu'une fois le système démarré, +vous avez accès à six pseudo terminaux Linux via les combinaisons de touches : +Ctrl+alt+F1, Ctrl+alt+F2, etc. +

+ +

vga=XXX - Modes VGA du noyau

+
+Colors | 640x480  800x600  1024x768  1280x1024  1600x1200
+-------------------------------------------------------
+256    |  769      771       773       775        796
+32768  |  784      787       790       793        797
+65536  |  785      788       791       794        798
+16,8M  |  786      789       792       795        799
+
+ + +

Option : home=usb - Conserver ses donnés

+

+L'option home=usb ou home=* active +le montage d'une partition d'un périphérique USB externe sur le répertoire +/home (maison) destiné aux utilisateurs du système. +L'utilisation d'une clé USB, d'un disque dur externe ou d'une carte SD, +permet de conserver les informations utilisateur sur un support persistant. +Associer le LiveCD de Slitaz à un support de stockage a de gros avantages, +tels que de conserver la configuration de vos applications préférées, vos +marques pages, vos documents, vos images, etc. Cette technique vous permet +aussi de créer votre propre menu et votre propre thème pour le gestionnaire de +fenêtres JWM. Vous pouvez par exemple facilement utiliser une image en fond +d'écran et la retrouver à chaque fois que vous utiliser le cdrom de SliTaz. +Ces informations sont stockées dans des fichiers de configurations cachés +propre à chaque compte du système. La plupart des applications destinées aux +utilisateurs ont un fichier/répertoire de configuration système généralement +situé dans /etc et un fichier/répertoire caché (commençant par +un point) appartenant à l'utilisateur. Pour utiliser cette option il faut une +partition formatée en ext3 et située sur un périphérique USB tel +qu'une clé USB flash memory, le format ext3 est un +système de fichiers journalisé, supportant la gestion des permissions et +offrant donc bien plus de sécurité que le format FAT32 ou +NTFS utilisé par Windows. A noter que la lecture ou l'écriture +sur un système de fichiers ext3 n'est pas supportée nativement +par Windows mais que SliTaz peut lire et écrire sur un système de fichiers +FAT32 grâce au support natif fourni par le noyau Linux. +

+

+Si vous avez déjà un media externe formaté en ext3, vide ou +contenant des données mais ayant assez d'espace libre, vous pouvez directement +l'utiliser. Aucune donnée existante ne sera détruite, il y aura juste un +répertoire hacker/ créé automatiquement lors de la première +utilisation du LiveCD avec le périphérique et la partition en question. +

+

Partitions et formatage d'un media

+

+Dans la plupart des cas les clés USB et les cartes de type SD card +n'ont qu'une seule partition, généralement reconnue comme sda1 +par le noyau Linux. Une fois formatée, vous pouvez utiliser cette première +partition en passant l'option home=sda1 ou plus simplement +home=usb à l'invite de commandes disponible au démarrage du +système. Si vous désirez utiliser une partition d'un disque dur externe, +composé de multiples partitions, vous pouvez utiliser l'option +home=sda[1-9] en spécifiant la bonne partition. A noter que vous +pouvez aussi partitionner une clé USB en différentes partitions et utiliser +une de ces partitions comme home. Pour savoir si votre media a bien +été reconnu et connaître l'emplacement depuis lequel il est accessible, vous +pouvez utiliser l'utilitaire fdisk avec l'option -l. +Pour utiliser cette commande vous devez avoir les droits d'administrateur +système (root), que vous pouvez obtenir via la commande +su suivi du mot de passe root. Exemple : +

+
+ $ su
+ # fdisk -l
+
+

+Le formatage en ext3 va détruire toutes les données contenues sur +la partition en question, attention à ne pas vous tromper de disque ou de +partition. Une fois que le media sera formaté, il sera prêt à être utilisé +pour stocker vos données personnelles. Pour formater la première partition +d'un périphérique sda, vous pouvez utiliser la commande +mkfs.ext3 ou l'utilitaire Tazusb : +

+
+ # mkfs.ext3 /dev/sda1
+ ou:
+ # tazusb format /dev/sda1
+
+

Utiliser un media

+

+L'utilisation d'un périphérique externe commence lors du démarrage +(boot) du système LiveCD, il faut spécifier l'option +home=usb ou home=* précédée par +slitaz. La partition peut aussi être spécifiée en utilisant +l'UUID ou le label de la partition. Exemple : +

+
+ slitaz home=usb
+ slitaz home=sdb1
+ slitaz home=UUID/LABEL
+
+

+Lors de l'exécution des scripts de démarrage, SliTaz lit le fichier +/proc/cmdline pour savoir si une partition doit être montée sur +/home. Si l'option existe, le script va commencer par attendre +environ 10 secondes que le media soit bien détecté par le noyau Linux et +tenter de monter la partition. Lors de la première utilisation le contenu +original du répertoire /home/hacker est copié sur la nouvelle +partition préalablement montée. Vous aurez alors un système fonctionnant en +mémoire vive et des données personnelles sur votre media de type USB. +

+ + +

Options : lang=XX et kmap=XX - Langue et clavier

+

+Le LiveCD de Slitaz vous propose de configurer la langue et le clavier +directement au boot ou graphiquement pendant l'initialisation du +système. Cela veut dire que si vous ne spécifiez pas la langue ou le clavier +via l'invite de commandes, le système lancera automatiquement une interface +de configuration lors de l'exécution des scripts de démarrage. SliTaz est +en français fr et en anglais en, les claviers +be ca de en es fr_CH fr it jp us . Exemple d'utilisation de +ces options : +

+
+ slitaz lang=fr kmap=be
+
+ + +

Option : config=<device>,<path>

+

+L'option config= vous permet de lancer un script au démarrage +du LiveCD, ce script peur être situé sur une partition d'un disque dur local +ou sur un media de type USB. Cette option permet par exemple, de monter une +image ISO sur /usr afin de pouvoir éconnomiser le la mémoire +vive et utilisé SliTaz sur de machines ayant 32 Mb RAM. Exemple avec un script +nommé slitaz.sh et sutué sur la première partition du premier +disque dur local : +

+
+ slitaz config=/dev/hda1,slitaz.sh
+
+ + +

Option : sound=*

+

+L'option sound=no ou sound=noconf vous permettent +respéctivement, de supprimer tous les modules et applications en rapport au +support du son pour gagner de la mémoire vive (RAM), ou de sauter la +configuration automatique au démarrage si vous ne désirez pas configurer le son +mais quand même conserver le nécessaire pour un configuration manuel par +la suite. +

+
+ slitaz sound=no
+
+ + +

Option : modprobe=modules

+

+L'option mdprobe=modules vous permettent de charger des modules +du noyau à la volée lors du démarrage du système. Cette options est utile par +exemple si un driver compilé en modules est nécessaire à la configuration de +la carte réseau ou son. A noter que sur un système en fonction, vous pouvez +lister les modules disponibles via la commande : modprobe -l et +que la commande lspci peut vous aider à connaître votre matériel +et le nom du bon driver. Pour charger un ou des modules : +

+
+ slitaz modprobe=modules1,modules2
+
+ + +

Sessions - Login, mots de passes et X

+

+Quand le système a finit son initialisation, l'écran est nettoyé et l'invite +de login ou le gestionnaire de connexion Slim s'affiche. Sur un +système GNU/Linux il y a un administrateur système nommé root, il +a tous les droits et ne devrait pas être utilisé pour se loguer directement. +SliTaz a donc un compte root et propose un utilisateur hacker +sans mot de passe. Pour devenir root au sein d'une session utilisateur, +vous pouvez utiliser la commande su suivie du mot de passe root. +En mode LiveCD, le mot de passe root est root. +

+

+Une fois logué dans une session, vous pouvez utiliser les nombreuses commandes +disponibles, les outils en mode texte tels que l'éditeur GNU Nano ou le +gestionnaire de fichiers Clex. Vous pouvez aussi lancer une session graphique +(X) via la commande startx ou encore vous connecter à une machine +distante via une session SSH ou X. La commande startx va lancer +le serveur graphique (Xvesa) et démarrer le gestionnaire de fenêtres JWM, vous +aurez alors la possibilité d'utiliser des applications graphiques via le menu +fourni par SliTaz et propulsé par JWM (Joe Window Manager). Pour lancer une +session X depuis une console Linux, dans le cas par exemple ou vous avez utilisé +l'option screen=text et que Slim n'est pas lançé : +

+
+ $ startx
+
+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/liveusb.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/liveusb.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,492 @@ + + + + SliTaz Handbook - LiveUSB + + + + + + + + + + + + + + + +
+
+ +

LiveUSB - SliTaz sur un media USB

+ + + + +

Methodes, type de media et notes

+

+Ce document décrit les étapes à réaliser pour installer les fichiers nécessaires +afin de démarrer SliTaz depuis un périphérique de type USB (clé, carte SD, +disque dur externe). Ce n'est pas une installation du système à proprement +parler, le mode de fonctionnemnt de SliTaz reste le même qu'en mode LiveCD, +c'est à dire que le système sera entièrement chargé en mémoire vive (RAM) +lors du démarrage. Avoir SliTaz sur un media USB vous permet de vous passer +du cdrom sur les machines capables de démarrer depuis un périphérique USB et +l'utiliser le même media pour stocker vos données personnelles de manière +persistante. Il faut aussi savoir que tous les PC ne sont pas capables de +démarrer directement sur USB et que le démarrage du système est plus long +que depuis un cdrom. +

+

Disque dur externe, carte SD ou clé USB

+

+Un media de stockage USB peut être un disque dur externe de grande ou petite +capacité, une carte de type SD/flash ou une clé USB. Vous pouvez par exemple, +utiliser l'ancienne carte d'un appareil de photos numérique ayant au +minimum une capacité de 32 Mb. Cela dit, l'utilisation de +GRUB avec les clés USB ne réussi pas toujours et dépend +du type de clé. Si l'utilisation de GRUB échoue, il est conseillé d'utiliser +le gestionaire de démarrage EXTLINUX et d'installer +un MBR fonctionnel sur la clé USB. +

+

+Pour commencer nous vous conseillons d'utiliser une partition formatée en ext3 +et non au format natif FAT32. Le système de fichiers ext3 est un système de +fichiers propre à GNU/Linux, robuste, fiable et illisible nativement depuis +Windows, ce qui peut être un point positif ou négatif. A noter que vous pourrez +aussi utiliser cette même partition pour stocker vos données de manière +persistante via l'option home=usb proposée par SliTaz. Cela dit, +vous pouvez aussi installer SliTaz sur une clé USB au format FAT32 comme +suggéré sur le forum de SliTaz : +SliTaz sur clé USB FAT32. +

+

Étapes à réaliser

+

+En gros, il faut récupérer les fichiers contenus sur le LiveCD, les +copier sur le media USB et installer un gestionnaire de démarrage. A noter +qu'il existe plusieurs gestionnaires de démarrage, Syslinux, GRUB ou encore +Lilo. SliTaz fournit GRUB sur la version standard du LiveCD et dans les paquets +du miroir, il a l'avantage de pouvoir aussi être utilisé pour démarrer +d'autres systèmes d'expoitations et de proposer un SHell permettant par exemple +de réinstaller GRUB dans le MBR (Master Boot Record) d'un disque dur. +

+ + +

LiveUSB en 2 commandes

+

+Pour créer facilement un système Live tenant sur un media USB, vous pouvez +utiliser TazUSB ou installer les fichiers manuellement. TazUSB est un +utilitaire simple, efficace et bien testé. Vous pouvez créer un media en une ou +deux commandes. Pour cela il vous faut un LiveCD de SliTaz et biensûr un media +USB dont vous devez connaître le nom (fdisk -l ou blkid). +Formatage optionnel et génération d'un media bootable reconnu comme /dev/sdb1: +

+
+ # tazusb format /dev/sdb1
+ # tazusb gen-liveusb /dev/sdb1
+
+

+Une fois le media généré, vous pouvez redémarrer sur votre media USB. Si vous +désirez installer des applications, mettre à jour ou configurer le système et +retouver vos modifications lors de a prochaine utilisation, il vous faut +recréer le système compressé en utilisant la commande writefs de +TazUSB. A noter que le menu de JWM propose par défaut des entrées pour écrire +le système sur le media en utilisant gzip, lzma ou aucune compression (prend +plus de place mais démarre beaucoup plus rapidement). +

+ + +

Préparer le media USB

+

+Si vous avez déjà une partition au format ext3, vous n'avez pas besoin de +reformater, sinon il faut créer un système de fichier avec l'utilitaire +mkfs.ext3. Attention le formatage d'une partition détruit toutes +les données qui s'y trouvent. Généralement, la première ou unique partition +d'un media USB est reconnu par le noyau Linux comme /dev/sda, pour +lister les périphériques et partitions disponibles vous pouvez utiliser la +commande fdisk -l avant de créer le système de fichiers ext3 : +

+
+ # mkfs.ext3 /dev/sda1
+ # mount -t ext3 /dev/sda1 /media/flash
+
+

+Le formatage de la partition va créer un répertoire système nommé +lost+found (perdu et trouvé), ce répertoire est utiliser par le +système de fichier en cas de problèmes. Maintenant que le media est formaté +et monté, vous pouvez copier le contenu du cdrom sur le périphérique, soit +depuis un cdrom gravé, soit depuis une image ISO locale : +

+
+ # mount -t iso9660 /dev/cdrom /media/cdrom
+ Ou :
+ # mount -o loop slitaz-cooking.iso /media/cdrom
+
+

+Copie de tous les fichiers contenu dans le répertoire boot/ +du LiveCD, il se peut que le système de fichiers compressé soit nommé +rootfs.lz, si c'est le cas, il faut le renommer en +rootfs.gz : +

+
+ # cp -a /media/cdrom/boot /media/flash
+ # mv /media/flash/boot/rootfs.lz /media/flash/boot/rootfs.gz
+
+ + +

Installer et utiliser GRUB

+

+Pour installer GRUB (GRand Unified Bootloader) il faut commencer par copier +les fichiers stage1 et stage2 depuis +/usr/lib/grub/i386-pc dans le répertoire boot/grub +du media USB. Une fois les fichiers copiés et le media trouvé par GRUB, vous +allez pouvoir installer le gestionnaire de démarrage dans le MBR du +périphérique. Copie des fichiers, lancement du SHell GRUB et recherche de +stage1 fraîchement copié : +

+
+ # cp /usr/lib/grub/i386-pc/stage[1-2] /media/flash/boot/grub
+ # grub
+ grub> find /boot/grub/stage1
+
+

+Ce qui peut donner (hd0,0), (hd1,0) ou encore (hd2,0), GRUB voit le premier +disque hda comme hd0, il faut donc modifier les +valeures en fonction de votre configuration. Il se peut aussi que votre media +ne soit pas trouvé, dans ce cas vous pouvez utiliser le bootloader +EXTLINUX. Pour installer GRUB vous pouvez +utiliser les commandes root et setup. Pour quitter +le SHell GRUB c'est la commande quit : +

+
+ grub> root (hd2,0)
+ grub> setup (hd2)
+ grub> quit
+
+

+La dernière chose qu'il reste à faire avant de redémarrer, est de créer un +fichier de configuration de GRUB permettant de lancer SliTaz avec l'option +home=usb, ce qui permet d'utiliser aussi le media comme partition +/home pour stocker ses données, installer des applications en +espace utilisateur et conserver vos configurations logiciels. Le fichiers +de configuration utilisé par GRUB peut être créé avec votre éditeur de texte +préféré, exemple avec LeafPad : +

+
+ # leafpad /media/flash/boot/grub/menu.lst
+
+
+# /boot/grub/menu.lst: GRUB boot loader configuration.
+#
+
+# Change the colors.
+color yellow/brown light-green/black
+
+# For booting SliTaz from a cdrom or USB media (LiveRAM).
+#
+title 	SliTaz GNU/Linux (Cooking) (Kernel 2.6.22.9)
+kernel 	/boot/bzImage root=/dev/null vga=771 home=usb
+initrd 	/boot/rootfs.gz
+
+

+Vous pouvez encore ajouter ces quelques lignes, pour avoir une entrée +permettant de réinstaller GRUB dans un MBR (utile en cas problèmes) : +

+
+# For installing GRUB into the hard disk
+#
+title Install GRUB into the hard disk
+root 	(hd0,0)
+setup 	(hd0)
+
+

+Voilà, vous pouvez démonter le cdrom et le media. ET redémarrer sur votre +clé USB en prenant soins de configurer correctement le BIOS de votre machine +pour qu'elle démarre depuis le media USB et non depuis le disque dur : +

+
+ # umount /media/cdrom
+ # umount /media/flash
+ # reboot
+
+ + +

GRUB sur cdrom

+

+Il est possible de créer rapidement une image ISO contenant GRUB, servant à +démarrer SliTaz depuis un media USB et cela sur des machines ne pouvant pas +démarrer directement sur USB. Pour ce faire GRUB fourni une image nommée +stage2_eltorito permettant de rendre un cdrom bootable. Pour créer +une image ISO gravable il faut créer la racine du cdrom, copier le fichier +stage2_eltorito et générer une ISO avec genisoimage. +Les commandes peuvent être copiées/collées ligne par ligne. Pour créer la +racine du cdrom (rootcd et copier l'image eltorito de GRUB : +

+
+ $ mkdir -p rootcd/boot/grub
+ $ cp /usr/lib/grub/i386-pc/stage2_eltorito \
+   rootcd/boot/grub
+
+

+Le fichier de configuration de grub se nomme toujours menu.lst, +c'est un fichier texte éditable avec votre éditeur de texte préféré. Vous +pouvez mettre le nombre d'entrées que vous désirez, pour démarrer SliTaz il +faut spécifier la bonne racine root (hd2,0) pour que GRUB trouve +le noyau (bzImage) et le système compressé (roottf.gz). +Un petit fichier de configuration minimaliste : +

+
+# /boot/grub/menu.lst: GRUB boot loader configuration.
+#
+
+title 	SliTaz GNU/Linux (Cooking)
+root 	(hd2,0)
+kernel 	/boot/bzImage root=/dev/null home=usb
+initrd 	/boot/rootfs.gz
+
+

Générer un ISO bootable

+

+Pour générer une image ISO vous pouvez utiliser genisoimage +fourni en standard sur le LiveCD de SliTaz. Cette commande est relativement +longue, les backslash en fin de ligne permettent de continuer la +commande sur la ligne suivante. Dans l'exemple, l'image se nomme +grub.iso, le volume Grub et la racine du cdrom +rootcd : +

+
+ $ genisoimage -R -o grub.iso \
+       -b boot/grub/stage2_eltorito \
+       -no-emul-boot -V "Grub" -boot-load-size 4 \
+       -input-charset iso8859-1 -boot-info-table \
+       rootcd
+
+ + +

Installer et utiliser EXTLINUX

+

+Extlinux est un gestionnaire de démarrage provenant du paquet Syslinux, il +permet de démarrer un système GNU/Linux depuis un système de fichiers ext2 ou +ext3. C'est un gestionnaire de démarrage simple et fiable, il fonctionne bien +pour les clés USB. Pour commencer il faut récupérer la dernière version +du paquet Syslinux depuis le site du noyau Linux et installer le binaire +extlinux dans votre répertoire personnel ~/Bin ou +dans un répertoire système tel que /usr/bin. Pour télécharger, +désarchiver et installer EXTLINUX en espace utilisateur : +

+
+ $ wget http://www.kernel.org/pub/linux/utils/boot/syslinux/syslinux-3.61.tar.gz
+ $ tar xzf syslinux-3.61.tar.gz
+ $ cp syslinux-3.61/extlinux/extlinux ~/.local/bin
+
+

+Maintenant que le binaire extlinux est disponible, vous pouvez +l'installer dans sur un media monté et cela via un SHell administrateur +root obtenu via la commande su. Nous vous conseillons +d'installer EXTLINUX dans un répertoire dédié, c'est à dire +/boot/extlinux du media USB : +

+
+ # mkdir -p /media/flash/boot/extlinux
+ # extlinux --install /media/flash/boot/extlinux
+
+

+Sur les clé USB il faut encore installer un MBR pour s'assurer de rendre le +media bootable. Attention à spécifier le bon périphérique, dans la plus part +des cas une clé USB est reconnue comme sda : +

+
+ # cat syslinux-3.61/mbr/mbr.bin > /dev/sda
+
+

+Le fichier de configuration se nomme extlinux.conf et doit se +trouver dans le même répertoire que le binaire extlinux. Les +chemins vers les fichiers peuvent être absolus ou relatifs au répertoire +d'installation d'extlinux. Ce fichier à la même syntaxe que le fichier +isolinux.cfg utilisé pour démarrer le LiveCD de SliTaz. Vous +utilisant votre éditeur de texte préféré ou la commande cat +(EOT signifie End Of Text, c'est là que le fichier +se termine). A noter que vous pouvez copier/coller le contenu du fichier en +une seule fois : +

+
+ # cat > /media/flash/boot/extlinux/extlinux.conf << "EOT"
+
+
+display display.txt
+default slitaz
+label slitaz
+    kernel /boot/bzImage
+    append initrd=/boot/rootfs.gz rw root=/dev/null home=usb
+
+
+ EOT
+
+

Afficher un message boot

+

+La première ligne display display.txt permet d'afficher un fichier +text au démarrage de EXTLINUX, vous pouvez utiliser/modifier celui utiliser sur +le LiveCD ou en créer un nouveau. Si vous ne voulez pas afficher un +display, il suffit de supprimer la ligne. Pour créer un nouveau +fichier display.txt avec cat : +

+
+ # cat > /media/flash/boot/extlinux/display.txt << "EOT"
+
+
+/*       _\|/_
+         (o o)
+ +----oOO-{_}-OOo---------------------------------------------------+
+     ____  _ _ _____
+    / ___|| (_)_   _|_ _ ____
+    \___ \| | | | |/ _` |_  /
+     ___) | | | | | (_| |/ /
+    |____/|_|_| |_|\__,_/___|
+
+ SliTaz GNU/Linux LiveUSB
+
+ Simple Light Incredible Temporary Autonomus Zone
+
+                                                                   */
+
+
+ EOT
+
+

+Reste plus qu'a redémarrer sur votre clé USB en prenant soins de configurer +correctement le BIOS de votre machine pour qu'elle démarre depuis le media USB +et non depuis le disque dur : +

+
+ # umount /media/flash
+ # reboot
+
+ + +

Installer SliTaz sur USB depuis Windows

+

+Il est possible d'installer SliTaz sur un media USB depuis un système +Windows, cette procédure a été testé sur Windows XP et Vista. Avant de +commercer, téléchargez la dernière version de SliTaz sur le site : +Obtenir SliTaz. Il vous faut aussi +récupérer l'utilitaire syslnux syslinux-3.60.zip. +

+

+1. Extraire l'image sur la clé USB. L'image ISO peut être extraite avec des +outils comme 7-Zip ou Winimage (shareware) +par exemple. Normallement vous devriez obtenir l'arborescence suivante : +

+
+\boot
+\boot\isolinux
+\boot\grub
+\boot\syslinux
+
+

+2. Sur la clé USB, copier les fichiers du gestionnaire de démarrage dans le +répertoire \boot\syslinux : +

+
+\boot\isolinux\*.txt 
+\boot\isolinux\*.msg
+\boot\isolinux\*.cfg
+\boot\isolinux\*.lss
+
+

+3. Toujours dans le répertoire \boot\syslinux, renommer +isolinux.cfg en syslinux.cfg et +isolinux.msg en syslinux.msg. Ce n'est pas +indipensable pour isolinux.msg, mais c'est plus cohérent. +

+

+4. Extraire le fichier syslinux.exe de l'archive téléchargée sur kernel.org et +le copier dans \boot\syslinux sur la clé. +

+

+5. Modifiez le fichier syslinux.cfg pour qu'il corresponde à vos +besoin. Exemple: +

+
+display syslinux.msg
+default slitaz
+label slitaz
+	kernel /boot/bzImage
+	append initrd=/boot/rootfs.gz rw root=/dev/null lang=fr kmap=fr vga=normal
+implicit 0	
+prompt 1	
+timeout 80
+F1 help.txt
+F2 options.txt
+F3 isolinux.msg
+F4 display.txt
+
+

+Note : Par rapport au fichier d'origine la ligne +display isolinux.msg a été remplaçée par +display syslinux.cfg. Et les paramètres +lang=fr kmap=fr on été rajouté sur la ligne append. +

+

+6. Il ne reste plus qu'à exécuter syslinux.exe pour installer le +bootloader. Exemple dans le cas où la clé est désignée par la lettre +K : +

+
+K:
+cd \boot\syslinux
+syslinux -ma -d \boot\syslinux K:
+
+ +

Version rapide

+
    +
  1. Télécharchez l'achive syslnux.zip.
  2. +
  3. Extrayez le répertoire syslinux et copiez le dans le répertoire + boot de la clé USB.
  4. +
  5. Exécutez le script \boot\syslinux\bootusb.bat.
  6. +
+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/multimedia.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/multimedia.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,202 @@ + + + + SliTaz Handbook - Multimedia + + + + + + + + + + + + + + + +
+
+ +

Multimedia

+ + + + +

Slitaz le son et la video

+

+En mode LiveCD SliTaz fournit le support du son mais pas de lecteur video, +cela dit vous pouvez visionner des videos en flash sur Youtube par exemple. +Pour regarder des videos vous pouvez utiliser Xine, il supporte la plus part des +formats tels que OGG ou AVI, à noter que Xine peut aussi faire office de +lecteur de musique. Au niveau du son, vous avez un mixer avec Alsamixer et un +lecteur avec Alsaplayer, ils sont tous deux installée par défaut sur la version +standard du LiveCD et permettent d'écouter des fichiers OGG, MP3 ou WAV. Pour +configurer ou reconfigurer votre carte son, vous avez le choix entre deux +petit programmes permettant de configurer le son simplement via des boîtes de +dialogue. +

+ + +

Configurer une carte son

+

+En mode LiveCD SliTaz configure automatiquement le son au démarrage en lançant +une boîte de dialogue, dans la majeur partie des cas, la carte son est reconnue +et il suffit d'appuyer sur ENTER pour continuer, se loguer et avoir le son +fonctionnel. Cela dit, il se peut que votre carte son ne soit pas reconnue au +démarrage ou simplement pas supportée. Avant de jeter l'éponge, vous pouvez +tenter de configurer manuellement votre carte et demander le l'aide sur la liste +de discussion ou le forum de support matériel. +

+

Soundconf

+

+Pour configurer ou reconfigurer une carte son, SliTaz fournit le script +soundconf, cet utilitaire est utilisé au démarrage, ne pose +qu'une question, charge les bons modules automatiquement et configure +/etc/rcS.conf pour que le driver soit chargé à chaque démarrage. +Soundconf va aussi régler les volumes automatiquement, vous pourrez modifier +les réglages par la suite via le mixer et alsactl. Pour lancer l'interface de +configuration du son, il faut avoir les droits d'administrateur et taper : +

+
+ # soundconf
+
+

Alsactl

+

+Alsactl pour Alsa control permet de stocker ou restaurer les réglages +du son, utile par exemple pour restaurer ses préférences à chaque démarrage. +Lors de la configuration du son avec Soundconf les volumes sont réglés +automatiquement, vous pouvez utiliser alsamixer avec root +pour modifier les valeurs et ensuite lancer alsactl pour stocker +la configuration +

+
+ # alsactl store
+
+

+Pour restaurer ensuite la configuration vous pouvez utiliser la commande +alsactl restore et pour restaurer vos préférences à chaque +démarrage vous pouvez ajouter la commande au script /etc/init.d/local.sh en +l'éditant avec un éditeur de texte ou avec : +

+
+ # echo 'alsactl restore' > /etc/init.d/local.sh
+
+ + +

Alsamixer

+

+Alsamixer et le mixer officiel du projet Alsa, il est simple et efficace. Vous +pouvez le lancer via le menu du gestionnaire de fenêtre ou directement depuis +un terminal. Les volumes se réglent avec les flèches et le mode muet se met ou +s'enlève via la touche m. Pour lancer le mixer depuis un terminal +Linux ou un graphique : +

+
+ $ alsamixer
+
+ + +

Alsaplayer

+

+Le lecteur de musique Alsaplayer se veut simple, épuré et intuitif. Il est réactif +et se prend rapidement en main, l'interface est sobre et adaptable. Alsaplayer +sur SliTaz fournit le support des fichiers OGG, MP3 (via libmad) et WAV, des +playlists, propose des visualisateurs pour accompager le son, la possibilité +de régler la vitesse de lecture ou le volume. Une fois lancé via le menu du +gestionnaire de fenêtre, il suffit de cliquer sur le bouton play ou celui de +la liste de lecture pour commencer à charger un ou des morceaux. +

+ + +

Asunder - Audio CD Ripper

+

+Asunder est un logiciel d'extraction et encodage de pistes audio depuis un CD. +L'outils est très simple d'utilisation, permet d'encoder les morceaux au format +wav, ogg ou mp3 via le paquet lame. Il peut aussi faire une +recheche CDDB, créer une liste de lecture et modifier les noms des fichiers. +Vous trouverez Asunder dans la catégorie Multimedia, il est très rapidement +pris en main et efficace. +

+ + +

Xine

+

+Xine est un projet fournissant des bibliothèques et divers visionneurs de video, +SliTaz fournit les blibliothèques et un media player contenu dans +le paquet xine-ui (ui pour User Interface). Le lecteur +Xine propose un interface Xlib, un pannel de contrôle, une interface de +configuration via un clique de droite sur la fenêtre principale et des plugins. +Il lit la musique OGG, MP3, etc, et les videos au format OGG, AVI ou MPG. Pour +installer Xine et ses dépendances : +

+
+ # tazpkg get-install xine-ui
+
+

+Une fois installé vous pouvez lancer xine depuis la ligne de +commande ou ajouter un entrée dans la catégorie Multimedia du menu de JWM : +

+
+<Program icon="xine.xpm" label="Xine media player">xine</Program>
+
+ + +

mpg123

+

+mpg123 est un lecteur et convertisseur de fichiers audio et s'utilise en ligne +de commande. C'est à dire que vous pouvez écouter ou convertir de la musique +depuis un terminal, pour afficher l'aide vous pouvez utiliser l'option +--help. Pour lire un fichier MP3 par exemple, il suffit de lancer +mpg123 suivi du nom du fuchier audio : +

+
+ $ mpg123 sound.mp3
+
+

+mpg123 permet aussi de convertir et encoder un fichier audio dans un autre +format. Vous pouvez par exemple convertir un fichier MP3 en WAV, exemple : +

+
+ $ mpg123 -w sound.wav sound.mp3
+
+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiée sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/network-config.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/network-config.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,420 @@ + + + + SliTaz Handbook - Network config + + + + + + + + + + + + + + + +
+
+ +

Configuration du réseau

+ + + + +

A propos du réseau sur SliTaz

+

+Par défaut SliTaz lance le client DHCP (udhcpc) sur eth0 lors du boot. Si +votre carte réseau a bien été reconnue comme une interface eth0, et que vous +utilisez un routeur, votre connexion devrait déjà fonctionner. C'est une +configuration dynamique, à chaque démarrage du système le client DHCP obtient +une nouvelle adresse IP depuis le serveur DHCP, qui est intégré au +router, ou situé sur une autre machine. Pour changer la configuration par +défaut vous devez passer par le fichier /etc/network.conf décrit ci-dessous. +Pour les personnes utilisant PPPOE, vous pouvez utiliser +les outils fournis par rp-pppoe et installés par défaut sur SliTaz. +

+ + +

Netbox - Configuration graphique du réseau

+

+Netbox est un petite interface graphique permettant de facilemnt configurer +une interface réseau en utilisant le protocole DHCP ou en demandant une adresse +IP fixe. Les onglets DHCP et Staic IP permettent de démarrer +ou stopper la connexion et change automatiquement les valeurs dans les fichiers +système. Netbox fournit aussi un onglet System wide depuis lequel +vous pouvez directement éditer les fichiers de configuration système. Vous +pouvez lancer Netbox depuis le menu Outils système (System tools) ou +depuis un terminal graphique : +

+
+ $ subox netbox
+
+ + +

/etc/hostname - Le nom de machine

+

+Le fichier /etc/hostname configure le nom de la machine. Le nom de machine est +chargé au démarrage du système avec la commande 'hostname'. Sans argument +cette commande retournera le nom de machine actuel : +

+
+ $ hostame
+
+

+Pour changer le nom de machine vous pouvez utiliser la commande +echo ou utiliser un des éditeurs de texte disponible sur SliTaz +(il faut être root). Exemple avec echo et le nom +de machine kayam : +

+
+ # echo "kayam" > /etc/hostname
+
+ + +

/etc/network.conf

+

+Le fichier /etc/network.conf est le fichier de configuration du réseau sur +votre système SliTaz. Sa syntaxe est simple, vous pouvez modifier son contenu +avec un éditeur de texte tel que Nano. Le fichier /etc/network.conf est +utilisé par le script /etc/init.d/network.sh pour configurer les interfaces +réseau au démarrage du système. +

+

+Le fichier de configuration du réseau (network.conf) vous permet de lancer ou +non le client DHCP au boot. Vous pouvez aussi spécifier une adresse IP fixe +avec son masque de sous réseau, la passerelle par défaut, et le serveur DNS à +utiliser. +

+ + +

IP dynamique - Client DHCP udhcpc

+

+Le client DHCP udhcpc fourni avec Busybox utilise le script +/usr/share/udhcpc/default.script pour obtenir une adresse IP dynamiquement +au boot. Il supporte diverses options que vous pouvez connaître avec l'option +--help : +

+
+ # udhcpc --help
+
+

+Pour ne pas lancer udhcpc sur eth0, ou modifier l'interface (ex: eth1) vous +devez passer par le fichier /etc/network.conf, et spécifier "no" à +la variable DHCP= : +

+
+
+# Dynamic IP address.
+# Enable/disable DHCP client at boot time.
+DHCP="no"
+
+
+ + +

IP fixe - Utilisation d'un adresse spécifique

+

+Vous pouvez spécifier une adresse IP fixe à configurer au démarrage du système, +en mettant la valeur "yes" à la variable STATIC= : +

+
+
+# Static IP address.
+# Enable/disable static IP at boot time.
+STATIC="yes"
+
+
+

+Pour que la configuration fonctionne, vous devez spécifier une adresse IP, +son masque de sous réseau, la passerelle par défaut (gateway), et le serveur +DNS à utiliser. Exemple : +

+
+
+# Set IP address, and netmask for a static IP.
+IP="192.168.0.6"
+NETMASK="255.255.255.0"
+
+# Set route gateway for a static IP.
+GATEWAY="192.168.0.1"
+
+# Set DNS server. for a static IP.
+DNS_SERVER="192.168.0.1"
+
+
+ + +

Connexion internet ADSL en pppoe kernel-mode

+

+Pré-requis: le support ppp et pppoe doit être activé dans le noyau (dur ou +modules) et l'interface ethernet configurée. Vous devez indiquer à ppp +d'utiliser le plugin rp-pppoe du noyau dans /etc/ppp/options : +

+
+plugin rp-pppoe.so
+name <votre identifiant de connexion FAI>
+noipdefault
+defaultroute
+mtu 1492
+mru 1492
+lock
+
+

+Si vous avez compilé le support de votre carte réseau en module dans le noyau, +vous devrez activer ce dernier dans /etc/rcS.conf: +

+
+LOAD_MODULES="<votre module>"
+
+

+Modifier le fichier /etc/ppp/pap-secrets ou /etc/ppp/chap-secrets : +

+
+# client	       server	       secret			IP addresses
+"votre_login_fai"       *       "mot_de_passe"
+
+

+Les fichiers /etc/host.conf et /etc/resolv.conf devraient être automatiquement renseignés. +C'est tout ! Pour vous connecter à internet, il suffit simplement de taper : +

+
+pppd eth0
+
+ + +

Connexion pppoe avec rp-pppoe

+

+Pour configurer sa connexion internet ADSL via le protocole PPPOE, SliTaz +fournit la suite d'utilitaires du paquet rp-pppoe. L'utilisation +de pppoe-setup est un jeu d'enfant et vous permet de configurer +rapidement le réseau. Si vous utilisez DHCP c'est encore plus facile, puisque +c'est le serveur de votre FAI (Fournisseur d'accès internet) qui va s'occuper +de tout. Si vous n'avez pas le DHCP vous devez commencer par désactiver son +utilisation via la variable DHCP="no" du fichier de configuration +/etc/network.conf. A noter que pour modifier des fichiers de +configuration système et se connecter, vous devez devenir administrateur via +la commande su. Pour installer rp-pppoe et changer la variable +DHCP avec Nano (Ctrl + x pour sauver et quitter) : +

+
+ $ su
+ # tazpkg get-install rp-pppoe
+ # nano /etc/network.conf
+
+

Configurer avec pppoe-setup

+

+Pour commencer à configurer votre connexion PPPOE, vous devez ouvrir un +terminal X ou utiliser la console Linux pour lancer pppoe-setup +et répondre aux questions : +

+
+ # pppoe-setup
+
+
    +
  1. Tapez votre nom d'utilisateur. A noter qu'il s'agit du nom + d'utilisateur avec lequel vous communiquez avec votre FAI, ils est + différent de ceux du système, bien sûr.
  2. +
  3. Interface internet, il s'agit par défaut de eth0 sauf si vous en avez + plusieurs, auquel cas vous aurez eth1, eth2, etc.. généralement la touche + entree suffit.
  4. +
  5. Si vous avez un lien ADSL permanent répondez ici par + oui, sinon par non (valeur par + défaut).
  6. +
  7. Spécifiez les DNS primaire et secondaire de votre FAI, il vous + les communiquera, n'hésitez pas à les lui demander.
  8. +
  9. Tapez le mot de passe avec lequel vous communiquez avec votre FAI, + à noter que vous devrez le tapez deux fois.
  10. +
  11. Choisir le firewall ou pare-feu en fonction de votre matériel, + si vous avez un routeur vous pouvez entrer 2 sinon 1. En cas de doute + tapez 1.
  12. +
+

Démarrer et arrêter la connexion

+

+Toujours en ligne de commande, il suffit de lancer pppoe-start +pour démarrer la connexion. Quelques secondes puis le système vous dit qu'il +est connecté. S'il vous donne un message du genre TIMED OUT c'est que vous +avez mal configuré ou que les branchements sont défectueux. Revérifiez votre +cablage et reprenez l'installation au début. Pour démarrer sa connexion : +

+
+ # pppoe-start
+
+

+Pour arrêter la connexion vous pouvez utiliser l'utilitaire +pppoe-stop, toujours en ligne de commande. +

+ + +

Liste des interfaces et des routes

+

+Vous pouvez lister les interfaces réseau disponibles avec la commande +ifconfig suivie de l'option -a, ou afficher +l'aide avec l'option --help : +

+
+ # ifconfig -a
+ # ifconfig --help
+
+

+Pour afficher la table de routage IP du noyau vous pouvez utiliser la commande +route sans arguments : +

+
+ $ route
+
+ + +

Gestion du pare-feu (firewall)

+

+SliTaz fourni un pare-feu très basic, les régles de sécurité du noyau sont +lancées et les règles d'iptables sont désactivées par défaut. Vous pouvez +activer/désactiver son éxécution au démarrage, et créer de nouvelles régles +via le fichier de configuration : /etc/firewall.conf +

+

+Le script du firewall fournit par défaut sur SliTaz, commence par +configurer les options propre au noyau: les redirections ICMP, les sources de +routage, log des adresses impossibles et les filtres contre le spoofing. Le +script lance ensuite les règles d'Iptables définies dans la fonction +iptables_rules() du fichier de configuration : /etc/firewall.conf +

+

+Le firewall utilise l'application Iptables, il se compose de deux +fichiers : Le fichier de configuration /etc/firewall.conf et le script +/etc/init.d/firewall, que vous ne devriez pas avoir besoin de modifier. A +noter qu'il y de nombreuses options avec Iptables, pour de plus amples +informations, référez-vous à la documentation officielle de Netfilter/iptables +disponible en ligne sur : +www.netfilter.org/documentation/ +

+

Démarrer, arrêter, redémarrer le firewall

+

+Le script /etc/init.d/firewall vous permet de démarrer/redémarrer, d'arrêter +et d'afficher le status du firewall. L'option redémarrer est souvent utilisée +pour tester de nouvelles règles, après modification du fichier de +configuration. Exemple : +

+
+ # /etc/init.d/firewall restart
+
+

Activer/désactiver le firewall au boot

+

+Pour activer/désactiver les options de sécurité propre au noyau, mettez "yes" +ou "no" à la variable KERNEL_SECURITY= : +

+
+
+# Enable/disable kernel security at boot time.
+KERNEL_SECURITY="yes"
+
+
+

+Et pour activer/désactiver les règles d'iptables, il faut modifier la variable +IPTABLES_RULES= : +

+
+
+# Enable/disable iptables rules.
+IPTABLES_RULES="yes"
+
+
+

Ajouter, supprimer, ou modifier les règles d'iptables

+

+fichier de configuration: /etc/firewall.conf. En bas du fichier vous trouverez +fichier de configuration: /etc/firewall.conf. En bas du fichier vous touverez +une fonction : iptables_rules() contenant toutes les commandes +d'iptables à lancer lors du démarrage du firewall. Pour supprimer une règle, +nous vous conseillons de commenter les lignes correspondantes avec : +#. A noter qu'il ne faut pas laisser cette fonction vide, si +vous voulez désactiver les règles d'iptables, il est préférable de mettre +"no" à la variable IPTABLES_RULES= du fichier de configuration. +

+

+Exemple de règles iptables. On refuse toutes les connexions entrantes, et +sortantes, puis on accepte les connexions sur l'hôte local, le réseau local, +les ports 80 et 22 utilisés respectivement par le serveur web HTTP et le +serveur sécurisé SSH, et le port 21 pour le FTP. C'est donc très restrictif +comme règles: +

+
+
+# Netfilter/iptables rules.
+# This shell function is include by /etc/init.d/firewall.sh
+# to start iptables rules.
+#
+iptables_rules()
+{
+
+# Drop all connexions.
+iptables -P INPUT DROP
+iptables -P OUTPUT DROP
+
+# Accept all on localhost (127.0.0.1).
+iptables -A INPUT -i lo -j ACCEPT
+iptables -A OUTPUT -o lo -j ACCEPT
+
+# Accept all on the local network (192.168.0.0/24).
+iptables -A INPUT -s 192.168.0.0/24 -j ACCEPT
+iptables -A OUTPUT -d 192.168.0.0/24 -j ACCEPT
+
+# Accept port 80 for the HTTP server.
+iptables -A INPUT -i $INTERFACE -p tcp --sport 80 -j ACCEPT
+iptables -A OUTPUT -o $INTERFACE -p tcp --dport 80 -j ACCEPT
+
+# Accept port 22 for SSH.
+iptables -A INPUT -i $INTERFACE -p tcp --dport 22 -j ACCEPT
+iptables -A OUTPUT -o $INTERFACE -tcp --sport 22 -j ACCEPT
+
+# Accept port 21 for active FTP connections.
+iptables -A INPUT -i $INTERFACE -p tcp --dport 21 -j ACCEPT
+iptables -A OUTPUT -i $INTERFACE -p tcp --sport 21 -j ACCEPT
+
+}
+
+
+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/network.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/network.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,195 @@ + + + + SliTaz Handbook - Template + + + + + + + + + + + + + + + +
+
+ +

Internet

+ + + + +

Mozilla Firefox - Navigateur web

+

+SliTaz est fier de fournir Mozilla Firefox, l'un des meilleurs navigateur Web +au monde, sécurisé, convivial, rapide, respectant les standards, et largement +personnalisable via un système de plugins. La prise en main du +logiciel se fait rapidement et intuitivement, pour lancer Firefox sur SliTaz +il suffit de séléctionner depuis le menu du gestionnaire de fenêtres ---> +Internet --> Mozilla Firefox. Les fichiers de configuration du navigateur +Web sont stockés dans le répertoire personnel, et cachés (commencent par un +point) et se nomment ~/.mozilla/firefox. +

+

+Astuces : En associant le mode LiveCD à un media USB (flash key), +vous garderez vos marques pages et plugins partout ou vous allez. +

+ +

Retawq - Navigateur web

+

+Toutes les versions de SliTaz fournissent le navigateur web Retawq en mode texte. +Vous pouvez lancer 'retawq' depuis la console, un terminal graphique, ou sous X +depuis le menu ---> Internet --> Retawq. Pour lancer Retawq depuis un +terminal, il suffit de taper retawq avec ou sans l'url : +

+
+ $ retawq
+ $ retawq http://www.slitaz.org/
+
+

+Le fichier de configuration personnel est dans ~/.retawq. Vous +pouvez le modifier avec un éditeur de texte. En appuyant sur +la touche <b> vous afficherez le fichier des marques pages +(bookmarks.html), et la touche <h> affichera la page d'accueil. +

+ +

Links - Navigateur web graphique et texte

+

+Links a été le premier navigateur Web graphique proposé sur le LiveCD de +SliTaz, il a été depuis remplaçé par Firefox, mais Links est toujours +disponible sous forme de paquet, facilement installable via la commande : +

+
+ # tazpkg get-install links
+
+

+Links propose un mode graphique et un mode texte. Pour utiliser Links en +mode graphique il faut utiliser l'option -g, vous pouvez ajouter +un icône ou une entrée au menu de JWM pour retrouver +Links facilement. Exemples d'utilisation en ligne de commandes : +

+
+ $ links -g &
+ $ links -g http://www.slitaz.org/ &
+ $ links
+
+

+Les fichiers de configuration personnels sont dans ~/.links et il n'est pas +conseillé de les modifier avec un éditeur de texte. Links fournit une interface +de configuration via la barre d'outils du haut, c'est là que vous pouvez +configurer la langues pour le français, les marques pages, l'affichage, etc. +Quand vous avez modifié des options, il faut les sauvegarder via la barre de +menu --> Configuration --> Enregistrer les options. +

+ +

Rhapsody - Client de chat IRC

+

+Pour lancer Rhapsody, vous pouvez utiliser la console, le terminal graphique, +ou sous X depuis le menu. Pour vous connecter au serveur de TuxFamily, vous +pouvez utiliser la commande ci-dessous, en modifiant votre pseudo. Une fois +connecté vous pouvez utiliser la commande IRC: /join pour joindre le canal +nommé #tuxfamily : +

+
+ $ rhapsody
+ /connect irc.tuxfamily.org
+ /join #tuxfamily
+
+

+Vous pouvez personnaliser rhapsody via le fichier ~/.rhapsodyrc, ou +utiliser <Ctrl+T> pour afficher les options. +

+ +

Ghost In The Mail - Client mail

+

+Pour envoyer rapidement des mails, sans devoir configurer de compte, vous +pouvez utiliser Ghost In The Mail (gitmail). Ce client mail minimum, propose +une interface GTK simple, avec le support des pièces jointes. Il vous permet +d'envoyer des mails en utilisant le protocole SMTP avec votre compte de +messagerie existant. Vous trouverez gitmail via le menu --> Internet +--> Ghost In The Mail. +

+ +

Transmission - Client BitTorrent léger

+

+Transmission est un client BitTorrent, rapide, léger, et proposant une +interface GTK+ simple d'utilisation. Transmission offre une option +"Préférences" qui permet de limiter le taux d'uploads et de +downloads, le port à utiliser, le dossier de téléchargement, et de gérer +les copies de vos fichiers torrents. Vous trouverez le client GTK+ via le menu +--> Internet --> Transmission. Site web du projet : +http://transmission.m0k.org/ +

+ +

gFTP - Client FTP simple et rapide

+

+L'application gFTP est un client de transfert FTP très simple d'utilisation, +rapide et ergonomique. Il dispose de la reprise des transferts interrompus, +d'une gestion complète des signets (sites favoris), ou encore de la gestion +des proxies FTP et HTTP. De plus gFTP permet le glisser déposer entre ses +deux fenêtres, de faire plusieurs transferts en même temps, de comparer ses +deux fenêtres, de mémoriser les mots de passes, de définir une application +externe pour la visualisation (ex Links) et l'édition des fichiers (ex Geany), +ce qui permet de travailler directement sur le serveur. Sur SliTaz vous +trouverez gFTP via le menu du gestionnaire de fenêtres --> Internet --> +gFTP. +

+ + +

pscan - Scanner de ports

+

+Pscan est un petit utiliatire du projet Busybox, permettant de scanner les +ports d'un machine. Vous pouvez utiliser pscan pour scanner +l'hôte local ou un hôte distant, en utilisant le nom ou l'adresse IP de la +machine. Pscan va tester tous les ports de 1 à 1024 et afficher une liste +de ceux qui sont ouvert, le protocole et le service associé (ssh, www, etc) : +

+
+ $ pscan localhost
+
+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/office.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/office.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,120 @@ + + + + SliTaz Handbook - Bureautique + + + + + + + + + + + + + + + +
+
+ +

Bureautique

+ + + + +

Abiword - Traitement de texte

+

+Abiword est une application de traitement de texte très riche en fonctionnalités. +C'est un outils léger, rapide, simple et intuitif, proposant sont propore +format (.abw) supportant les formats OpenOffice et Microsoft Word et peut +exporter en HTML ou PDF. Pour installer Abiword sur SliTaz il suffit de lancer : +

+
+ # tazpkg get-install abiword
+
+ + +

Osmo - Organiseur personnel

+

+Osmo est un petit organisateur personnel fournissant un calendrier, une liste +des tâches et des contact avec la possibilité d'ouvrir directement un +navigateur Web ou un client de messagerie via un clique un URL ou une adresse +email. Osmo propose aussi un calendrier de l'année, un calcultaeur de date et +la possibilité de prendre des notes classées par jours. Osmo est installé par +défaut sur la version standard du LiveCD avec une icône sur la barre des tâches +et une entrée dans le la catégorie Office du menu de JWM. A +noter que si vous utilisé un media USB associé au LiveCD, vous retrouverez vos +données à chaque utilisation. Si vous avez un système installé, vous pouvez +synchroniser les données du media USB avec celles de votre système en utilisant +par exemple Grsync. Osmo conserve vos données dans le répertoire caché : +~/.osmo. +

+ + +

SQLite - Petit moteur de base de données SQL

+

+SQLite est un petit moteur de base de données relationnelles SQL dont la base +de données entière est stockée dans un seul fichier, il est performant, il +offre une grande rapidité d'exécution des requêtes, de plus il implémente la +plus part de la norme SQL92. SQLite est idéal pour gérer de petits sites web +tout en nécessitant un déploiement minimal. En mode graphique, vous pouvez +lancer SQLite depuis le menu du gestionnaire de fenêtres JWM. Le site web +officiel du projet est : +http://www.sqlite.org/ +

+ + +

ePDFView - Visualisateur léger de PDF

+

+Pour lire des documents PDF, SliTaz propose le paquet epdfview, +fournissant un visualisateur PDF léger, rapide et simple à prendre en main. +ePDFView utilise les bibliothèque de rendu Poppler, propose une interface +GTK+ intuitive vous permettant agrandir, de passer d'une page à l'autre, +d'afficher l'index ou encore de faire une recherche. Pour installer ePDFView : +

+
+ # tazpkg get-install epdfview
+
+

+Une fois unstallé vous pouvez ajouter une entrée au menu du gestionnaire de +fenêtre JWM, par exemple dans la catégorie +Office. Si vous utilisez Enlightenment l'application aura +automatiquement une entrée dans le menu Bureautique (Office) +

+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/packages.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/packages.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,182 @@ + + + + SliTaz Handbook - Paquets logiciels + + + + + + + + + + + + + + + +
+
+ +

Gestion des paquets

+ + + + +

Gestionnaire de paquet Tazpkg

+

+Ce chapître décrit la gestion des paquets (.tazpkg) sur votre système. SliTaz +fournit tazpkg, c'est une petite application gérant les paquets +SliTaz portant l'extension .tazpkg. Le gestionnaire de paquets +vous permet de lister les paquets installés, d'afficher une courte description +du paquet, d'en installer de nouveaux depuis le Web, d'en désintaller, ou encore +d'extraire un paquet dans un répertoire donné. +Tazpkg a été créé pour SliTaz, il est écrit en script SHell depuis rien +(from scratch). De plus, il propose une gestion des dépendances et +un système de mises à jour de tous les paquets installés. +

+

+Pour utiliser les commandes de tazpkg touchant au système , vous +devez avoir un accès administrateur (root), vous pouvez utiliser +su suivi du mot de passe root. Lancé sans arguments tazpkg +affichera une petite aide, avec une liste des commandes possibles, vous pouvez +aussi utiliser la commande usage pour afficher cette aide. +

+ +

Fonctionnement de Tazpkg

+

+Tazpkg utilise quelques répertoires et fichiers pour puiser des informations +et stocker les paquets téléchargés en cache. Pour connaître le miroir depuis +lequel les paquets doivent être télécharger, Tazpkg lit le fichier texte : +/var/lib/tazpkg/mirror contenant simplement l'URL sur une ligne. Pour +connaître la liste des paquets disponibles, Tazpkg télécharge et lit un +fichier nommé packages.list (ce fichier peut aussi être lu en ligne via un +navigateur web). Pour connaître les informations au sujet des paquets +installés sur le système, Tazpkg scrute le contenu du répertoire : +/var/lib/tazpkg/installed. Ce répertoire réunit tous les meta fichiers +d'informations sur les paquets. Ces meta fichiers, quand à eux, contiennent +toutes les données utiles pour installer/désinstaller un paquet, lister les +fichiers installés ou encore afficher une brève description. +

+ + +

C'est quoi des paquets ?

+

+Dans le monde GNU/Linux et open source en général, les logiciels sont appelés +des paquets (packages). Les développeurs de ces paquets distribuent leur +travail sous forme de fichiers contenant le code source, ces fichiers sont au +format text et peuvent se lire avec un simple éditeur de texte, le code est +donc ouvert (open source). +

+

+Pour que ce code source fonctionne sur un ordinnateur, il faut qu'il soit +compilé ou construit, afin de produire un ou des fichiers binaires que la +machine sait utiliser. Les binaires sont des séquences de 0 et 1. Pour vous +éviter de compiler le code source des applications, les distributions GNU/Linux +ou BSD, vous proposent un système de paquets précompilés et prêts à fonctionner. +Ces paquets précompilés sont facilement installables via une seule commande ou +quelques manipulations à la souris, plusieurs distributions ont créé leur +propre format de paquets binaires telles que Debian, RedHat ou Gentoo. +SliTaz fournit les outils minimaux pour manipuler des paquets Debian (.deb) +et RedHat (.rmp), ces outils sont propulsés par Busybox et ne sont pas aussi +puissant que les originaux. +

+

+SliTaz a créé son propre format de paquet (.tazpkg), simple, rapide, utilisant +un minimum de dépendances et surtout ultra léger. Le format des paquets est aussi +spécifique à SliTaz. La gestionairre de paquet permet d'avoir le contrôle sur +tous les fichiers installés et leur version, ce qui permet une maintenance plus +simple et une mise à jour automatique des paquets. Si vous compilez vos propres +paquets depuis les sources de manière traditionnelle, vous serez obligé de +recompiler pour avoir une nouvelle version et vous devrez surveiller en amont, +pour chaque nouvelle version. Cela dit, SliTaz offre la possibilité d'installer +des paquets sources de manière semi-automatisée, via l'utilisation de +Tazwok, notez +que c'est plutôt destiné à un public averti et que les mises à jour ne sont +pas fournies pour ce genre de paquets. +

+ + +

Commandes principales

+

+Le gestionnaire de paquet Tazpkg est un outil en ligne de commandes, il a été +conçu pour être simple et rapide à prendre en main. Toutes les commandes sont +décrites dans le manuel du gestionnaire de paquet. Pour commencer il vous suffit de +connaître le nom du gestionnaire de paquet : tazpkg. Lancé sans +arguments, tazpkg va afficher une liste des commandes disponibles avec une +courte description. +

+ +

Garder un système à jour

+

+Il y deux commandes qui devraient être lancées régulièrement par +l'administrateur (root). La commande qui recharge la dernière liste des paquets +et celle qui met à jour tous les paquets installés. Cela permet de garder un +système plus sécurisé et d'avoir les dernières nouveautés. Pour recharger la +liste c'est recharge et pour mettre à jour upgrade, +vous pouvez lancer ces deux commandes sur la même ligne et utiliser le +copier/coller dans un terminal : +

+
+ # tazpkg recharge && tazpkg upgrade
+
+ +

Installer des paquets

+

+Le gestionnaire de paquet vous permet d'installer de nombreux paquets pour +ajouter des fonctionnalités au système ou de disposer d'applications +supplémentaires. La manière la plus courante d'installer un paquet est +d'utiliser la commande get-install qui va télécharger, installer, +vérifier les dépendances sur le paquet et cela de manière automatique. Pour +installer un paquet vous devez connaître le nom du paquet. Pour vous aider à +trouver le nom d'un paquet, vous pouvez utiliser la commande de recherhe +search ou afficher la liste complète des paquets disponibles sur +le miroir via la commande list-mirror. Pour installer le client +de messagerie Sylpheed, il faudra par exemple lancer : +

+
+ # tazpkg get-install sylpheed
+
+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/secure-shell.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/secure-shell.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,145 @@ + + + + SliTaz Handbook - Template + + + + + + + + + + + + + + + +
+
+ +

SHell sécurisé (SSH)

+ + + + +

A propos de Dropbear

+

+Contrôle et administration à distance avec Dropbear et le protocole sécurisé +SSH. Dropbear est un petit client et serveur sécurisé, supportant le protocole +SSH 2. Dropbear est compatible avec OpenSSH et utilise ~/.ssh/authorized_keys +pour la gestion des clés publiques. Dropbear fournit aussi une version de +scp, permettant la copie de fichiers entre des machines distantes +manière sécurisée. +

+

+Site web du projet : +matt.ucc.asn.au/dropbear/dropbear.html +

+ +

Connexion à un hôte distant avec dbclient

+

+Les fichiers de configuration pour le client SSH sont dans ~/.ssh de chaque +répertoire utilisateur, il contient les fichiers authorized_keys et +known_hosts. Le répertoire ~/.ssh et le fichier known_hosts, sont créés +automatiquement la première fois que vous lancez le client sécurisé. +

+

+Pour se connecter à un hôte distant avec son nom d'utilisateur et le nom de +machine, vous pouvez utiliser la commande : +

+
+ $ dbclient utilisateur@machine.org
+
+

+Vous pouvez aussi utiliser l'adresse IP de la machine : +

+
+ $ dbclient user@192.168.0.2
+
+ +

Transfert de fichier à distance avec scp

+

+Pour copier un fichier de votre ordinateur à un autre, scp s'utilse de +la manière suivante. Pour copier un fichier se nommant page.html vers un +répertoire de l'utilisateur. Ne pas oublier les : après le +nom de machine ou l'adresse IP : +

+
+ $ scp page.html user@machine.org:dossier/sous-dossier
+
+

+Copier un fichier d'une machine distante vers la vôtre : +

+
+ $ scp user@machine.org:dossier/sous-dossier/page.html /dossier/votre/machine
+
+ +

Générer des clés rsa et/ou dss avec dropbearkey

+

+Dropbear fournit dropbearkey pour générer des clés sécurisées rsa +et dss. A noter que quand vous démarrez le serveur pour la première fois, des +clés sécurisées seront générées automatiquement si elles n'existent pas. Vous +pouvez utiliser dropbearkey avec les aruments ci-dessous : +

+
+ # dropbearkey -t rsa -f /etc/dropbear/dropbear_rsa_host_key
+ # dropbearkey -t dss -f /etc/dropbear/dropbear_dss_host_key
+
+ +

Démarrer, arrêter, redémarrer le serveur SSH

+

+Par défaut SliTaz ne lance pas le serveur SSH au démarrage du système, pour +qu'il soit lancé automatiquement, il faut ajouter dropbear à la +variable RUN_DAEMONS du fichier /etc/rcS.conf. Pour démarrer, +arrêter, redémarrer le serveur SSH vous pouvez utiliser la commande : +/etc/init.d/dropbear [start|stop|restart]. Exemple pour démarrer +le serveur : +

+
+ # /etc/init.d/dropbear start
+
+

+A noter que le serveur supporte différentes options à lui passer lors de son +lancement. Pour modifier les valeurs par défaut il suffit de modifier le +fichier de configuration des démons : /etc/daemons.conf. +

+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/security.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/security.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,146 @@ + + + + SliTaz Handbook - Sécurité du système + + + + + + + + + + + + + + + +
+
+ +

SliTaz et la sécurité du système

+ + + + +

Politique de sécurité

+

+SliTaz porte une grande attention à  la sécurité du système. Les applications +sont testées de nombreux mois avant d'être inclues dans la distribution. Lors +du boot, un minimum de services sont lancés par les scripts rc. Pour avoir une +liste des démons lancés au démarrage il faut regarder la variable RUN_DAEMONS +du fichier de configuration /etc/rcS.conf. +

+
+ $ cat /etc/rcS.conf | grep RUN_DAEMONS
+
+

+Pour connaître les processus actifs, leur PID et leures resources mémoire, +vous pouvez utiliser la commande 'ps' pour lister les processus en cours ou +lancer l'utilitaire Htop : +

+
+ $ ps
+ $ htop
+
+ + +

Root - L'administrateur système

+

+Root vient de l'anglais racine, sur un système GNU/Linux l'utilisateur +root est l'administrateur système, il a tous les droits sur les +fichiers du système et ceux de tous les utilisateurs. Il est conseillé de ne +jamais se loguer en tant que root et d'utiliser la commande +su suivie du mot de passe de l'utilisateur root, pour +obtenir les droits absolus. Ne pas se loguer en root et surfer sur internet +par exemple, permet d'avoir une double barrière en cas d'attaque ou d'intrusion +suite à un téléchargement. C'est à dire qu'un cracker tentant de +prendre le contrôle de votre machine, devra d'abord craquer votre mot de passe +pour ensuite tenter de craquer celui de l'administrateur root. +

+

+Un système GNU/Linux sécurisé a donc au minimum 2 utilisateurs, un pour +travailler et root pour administrer, configurer ou mettre à jour le +système. Il est aussi conseillé de confier l'administration du système à une +personne. +

+ + + +

Busybox

+

+Le fichier busybox.conf, configure les applets, et leurs droits respectifs. +Sur le LiveCD de SliTaz les commandes: su, passwd, loadkmap, mount, reboot, +halt, peuvent être lancées par tous les utilisateurs, le propriétaire et le +groupe des commandes est root (* = ssx root.root). Le fchier +/etc/busybox.conf n'est lisible que par root, il a les droits +600. A noter que la commande passwd ne fonctionne pas bien si +elle n'est pas ssx, les utilisateurs du système ne peuvent pas changer leur +propre mot de passe. +

+ + +

Serveur SSH

+

+Ce petit texte au sujet de la sécurité est un complément à la page titrée +SHell sécurisé (SSH). Sur SliTaz, le serveur +SSH Dropbear n'est pas lancé par défaut, il faut l'ajouter à la variable +RUN_DAEMON du fichier de configuration /etc/rcS.conf +pour qu'il se lance à chaque démarrage du système. Ou lancer le serveur +manuellement : +

+
+ # /etc/init.d/dropbear start
+
+

+Par défaut dropbear est lancé avec les options : +

+
+ -w   N'autorise pas de login pour root.
+ -g   N'autorise pas de login avec mot de passe pour root.
+
+

+Vous pouvez ajouter de nouvelles options en éditant le fichier de configuration +des démons : /etc/daemons.conf. Pour connaître toutes les options +possibles, vous pouvez taper : dropbear -h. +

+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/system-admin.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/system-admin.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,305 @@ + + + + SliTaz Handbook - Administration du système + + + + + + + + + + + + + + + +
+
+ +

Administration du système

+ + + + +

Configuration de la langue

+

+SliTaz sauvegarde la configuration de la locale par défaut dans le fichier +/etc/locale.conf qui est lu par /etc/profile, à chaque login. Le fichier +/etc/locale.conf est généré lors du premier boot grâce au script +/etc/init.d/i18n.sh, lancé au démarrage. Il suffit donc de modifier le +fichier /etc/locale.conf avec un éditeur de texte, ou de relancer +l'utilitaire tazlocale pour changer la locale par défaut du +système : +

+
+ # tazlocale
+
+

+Pour utiliser la langue lors d'une session , vous pouvez aussi ajouter 2 +lignes au fichier ~/.profile, propre à chaque utilisateur, exportant la +configuration : +

+
+
+export LANG=fr_CH
+export LC_ALL=fr_CH
+
+
+ +

Configuration du clavier

+

+La configuration du clavier et sauvegardée dans /etc/kmap.conf, comme +pour la locale, vous pouvez modifier ce fichier à la main ou en lançant +tazkmap, en tant qu'administrateur (root) : +

+
+ # tazkmap
+
+

+Le clavier et chargé au démarrage par le script /etc/init.d/i18n.sh. +Note : i18n pour internationalisation, et kmap c'est l'extension des +fichiers de clavier utilisé par Busybox. +

+ +

Personnaliser son shell

+

+Après un login vous êtes dans votre shell. Sur SliTaz vous disposez du +shell ash et sh et un lien sur Ash, ce shell est +fournit par Busybox. Ash est léger, rapide, et conforme au normes. Pour +changer le shell par défaut d'un utilisateur, il faut passer par le +fichier /etc/passwd, et modifier la ligne correspondante. Lors d'un login, +le fichier /etc/profile est lu, puis c'est le fichier personnel ~/.profife. +Vous pouvez modifier l'un et l'autre avec un éditeur de texte, pour y +configurer la langue, d'autres aliases, etc. +

+

Exemple: ~/.profile

+
+# ~/.profile: executed by Bourne-compatible login shells.
+#
+
+# Aliases.
+alias ls='ls -F'
+alias df='df -h'
+
+# Env variables.
+export EDITOR=nano
+
+
+ +

Régler l'horloge

+

+Pour connaître l'heure système actuelle vous pouvez utiliser la commande +date. Sur SliTaz la configuration du fuseau horaire est +sauvegardée dans le fichier /etc/TZ. Vous pouvez modifier se fichier via +un des éditeurs disponibles ou simplement en +utilisant la commande echo, exemple pour la zone Europe/Zurich : +

+
+ # echo "Europe/Zurich" > /etc/TZ
+
+

hwclock

+

+Pour faire un réglage fin de l'horloge vous pouvez utiliser 'hwclock', cet +utilitaire permet de synchroniser l'horloge système avec l'horloge matériel, +ou l'inverse. +

+Synchroniser l'horloge système avec l'horloge matériel +(--utc = universal time, --localtime = local time) : +

+
+ # hwclock --hctosys --utc
+
+

+Synchroniser l'horloge matériel avec l'horloge système : +

+
+ # hwclock --systohc --utc
+
+

+Vous pouvez aussi connaître et synchroniser l'horloge système avec un serveur de +temps sur le réseau avec la commande 'rdate', l'option -p affiche +l'heure du serveur : +

+
+ $ rdate -p tick.grayware.com
+
+

+Pour se synchroniser avec un serveur de temps, il faut être root : +

+
+ # rdate -s tick.grayware.com
+
+ +

Gestion des utilisateurs et groupes

+

+La gestion des utilisateurs et groupes du système peut se faire totalement +en ligne de commandes. Vous pouvez par exemple facilement ajouter ou supprimer +des utilisateurs, créer des groupes, ou encore modifier les mots de passe. +Par défaut, SliTaz configure un utilisateur hacker sans mot de passe, afin de +ne pas se connecter en tant que root, même en mode LiveCD. Pour ce connecter +en tant que super-utilisateur (root) il faut utiliser la commande +su. +

+

Mot de passe

+

+Pour modifier un mot de passe il faut utiliser la commande passwd +valable aussi pour root : +

+
+ $ passwd
+ ou:
+ # passwd
+ ou encore:
+ # passwd hacker
+
+

Ajouter un utilisateur ou un groupe

+

+L'ajout d'utilisateurs se fait avec la commande adduser, et +celui d'un groupe avec addgroup. Vous obtiendrez de l'aide en +tapant ces commandes suivies de l'option --help. La commande +ci-dessous ajoute l'utilisateur pomme avec comme shell par défaut Ash : +

+
+ # adduser pomme -s /bin/ash
+
+

+Et pour un groupe (nom du groupe: partage et gid: 100): +

+
+ # addgroup -g 100 partage
+
+

+Pour ajouter un utilisateur existant dans un groupe existant, vous devez +éditer les fichiers /etc/group et /etc/gshadow, car l'applet adduser fournit +avec Busybox n'offre pas toutes les options fournies par le programme +original. +

+

Supprimer un utilisateur ou un groupe

+

+Vous pouvez facilement supprimer un utilisateur du système ou un groupe avec +les commade deluser et delgroup : +

+
+ # deluser pomme
+ Et pour un groupe :
+ # delgroup partage
+
+ +

Ajouter des commandes exécutées au boot

+

+Lors du boot divers scripts sont exécutés, afin de configurer des services ou +autres, tel que le démarrage du serveur web, la mise en réseau, etc. Sur +SliTaz il y a un script: /etc/init.d/local.sh, qui vous permet de rajouter +facilement des commandes qui seront lancées au démarrage du système. Vous +pouvez aussi créer de nouveaux scripts dans /etc/init.d, leurs liens dans +/etc/rc.scripts pour les scripts shell et utiliser /etc/rc.d pour les liens +sur les scripts de démarrage des démons système : +

+
+ # nano /etc/init.d/local.sh
+
+ +

Exécuter des commandes à horaire fixe

+

+Le démon Crond permet d'exécuter automatiquement des commandes à une date et +une heure précise, ou selon un cycle. C'est très utile pour des tâches +routinières d'administration système. Le répertoire utilisé par Cron est : +/var/spool/cron/crontabs. +

+

+Chaque utilisateur du système peut avoir ces propres tâches, elles sont +définies dans le fichier /var/spool/cron/crontabs/user. L'utilitaire crontab +permet, entre autre de lister les tâches propre à un utilisateur. La syntaxe +de ces fichiers est la suivante : +

+
+mm hh jj MMM JJJ tâche > log
+
+

+Nous allons créer le fichier pour root, et tester le démon 'crond', avec une +tâche exécutée toutes les minutes, qui écrit la date dans le fichier +/tmp/crond.test. A noter que l'utilitaire crontab a une option +d'édition des fichiers cron, utilisant 'vi', non fourni avec SliTaz. A la +place vous pouvez utiliser GNU nano (<Ctrl+X> pour enregistrer et +quitter) : +

+
+ # nano /var/spool/cron/crontabs/root
+
+
+* * * * * date >> /tmp/crond.test
+
+

+Lancez crond en fond avec l'option -b (backgroud), +configurée via le fichier /etc/daemons.conf et en utilisant le +script de démarrage : +

+
+ # /etc/init.d/crond start
+
+

+Vous pouvez attendre quelques minutes, et afficher le contenu du +fichier: /tmp/crond.test... OK : +

+
+ # cat /tmp/crond.test
+
+

+Pour arrêter ou redémarrer le démon crond : +

+
+ # /etc/init.d/crond stop
+ Ou :
+ # /etc/init.d/crond restart
+
+

Lancer le démon crond à chaque démarrage

+

+Pour lancer le démon 'crond' à chaque démarrage du système, vous pouvez +l'ajouter à la variable START_DAEMONS du fichier de configuration +/etc/rcS.conf à la suite ou avant le serveur Web ou le serveur SSH. +

+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/system-tools.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/system-tools.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,156 @@ + + + + SliTaz Handbook - Outils système + + + + + + + + + + + + + + + +
+
+ +

Outils système

+ + + + +

Clex - Gestionnaire de fichiers mode texte

+

+Pour naviguer dans vos répertoires vous pouvez utiliser la ligne de commande et +cd, ou lancer 'Clex File Manager' un gestionnaire de fichiers ncurses. +Clex et facile d'utilisation, rapide, et facilement configurable via un panel +de configuration, ou via le fichier ~/.clexrc et ~/.clexbm pour les marques +pages (bookmarks). Pour lancer clex depuis un terminal ou une console : +

+
+ $ clex
+
+ + +

emelFM2 - Gestionnaire de fichiers

+

+L'application emelFM2, est un gestionnaire de fichiers, fournissant toutes les +fonctions utiles aux tâches quotidiennes, telles que le montage de périphériques, +des icônes de navigation, l'ouverture d'un terminal dans le répertoire courant, +le glisser/déposer, création de répertoires, renommage, ou encore la gestion +des permissions. Il propose aussi un éditeur/visualisateur de fichier texte, +des commandes utilisateur, des marques pages pour une navigation plus rapide, +et bien plus. Le gestionnaire emelFM2 propose aussi des options à passer en +ligne de commade lors de son lancement. Vous pouvez spécifier le répertoire +de la poubelle, du panel 1 et/ou 2, pour connaître toutes les options : +$ emelfm2 --help. +

+

+Le menu contextuel (click de droite sur le fichier/répertoire) permet de +facilement désarchiver les archives .taz.gz, de compresséer, créer +des archives ou comparer des fichiers. Vous pouvez aussi créer des liens +symboliques via le bouton "Créer un lien...". Une fois pris en main, emelFM2 +permet de travailler rapidement et efficacement. +

+ + +

Htop - Visionneur de processus système

+

+Htop est un visionneur de processus système affichant les processus, +l'utilisation du ou des processeurs, l'état de la mémoire vive (RAM) et swap. +IL affiche aussi le nombres de tâches, le temps depuis lequel la machine +tourne, les PID ou les commandes actives. Htop s'utilise au clavier en mode +console, supporte la souris avec un terminal X (Xterm) et fournit diveres +options de configuration (F2). Htop peut aussi être utilisé pour tuer un +processus et les flèches ou un clique de souris permettent de séléctonner +une ligne. A noter qu'Htop fonctionne via SSH est peut servir à surveiller +un serveur à distance : +

+ $ htop
+
+ + +

Mountbox - Monter un périphérique

+

+Mountbox est une petite interface GTK à la commande mount +permettant de monter rapidement un media tel qu'une clé USB, disque dur ou +cdrom. Mountbox peut se lancer depuis un terminal ou via le menu Outils système +(System tools). Il suffit de spécifier les prériphérique (Device) et le point +de montage, c'est à dire le répertoire depuis lequel vous voulez accéder aux +données du media en question. Généralement un cdrom se monte sur /media/cdrom, +une clé USB dans /media/flash et les disque durs de la machine local dans /mnt. +A noter que le Handbook contient aussi des informations au sujet de +la commande mount. +

+ + +

Gparted - Gestion des partitions d'un disque dur

+

+Gparted est une application graphique permettant de gérer les partitions d'un +disque dur local ou media USB. Il permet de formater, redimensionner et +vérifier une ou des partitions d'un disque dur, c'est l'outil à utiliser si +vous devez préparer un partitions, graphiquement, pour installer SliTaz. Gparted +support les systèmes de fichiers propores à GNU/Linux (ext2 et ext3) via mkfs +et Parted automatiquement proposé en dépendences. Pour installer Gparted et +le lancer depuis le terminal : +

+
+ # tazpkg get-install gparted
+ # gparted &
+
+

+A noter que si vous désirez une entrée dans le menu de JWM, vous pouvez +utiliser subox pour demander le mot de passe root avant de lancer +Gparted. +

+

Support FAT et NTFS

+

+Pour avoir le support du système de fichiers FAT16 ou FAT32 de Windows, vous +devez installer le paquet dosfstools. Pour le support NTFS en +lecture/écriture vous aurez besoin de : fuse, ntfs-3g +et ntfprogs. +

+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/template.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/template.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,56 @@ + + + + SliTaz Handbook - Template + + + + + + + + + + + + + + + +
+
+ +

Template

+ +

+CONTENT +

+ + + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/utilities.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/utilities.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,211 @@ + + + + SliTaz Handbook - Utilitaires + + + + + + + + + + + + + + + +
+
+ +

Les utilitaires

+ + + + +

Calculatrice

+

+Les opérations de mathématiques peuvent se faire avec la calculatrice en +mode texte Bc. Ouvrez un terminal ou tapez directement dans la console +bc, pour quitter il faut taper quit : +

+
+ $ bc
+ 23+45 <ENTER>
+ 68
+
+ quit
+
+ + +

Cdrkit - Gravure et manipultaion de CD/DVD-R ou RW

+

+Pour graver et manipuler des CD/DVD-R ou RW, SliTaz fournit les outils CdrKit +et une interace grphique nomée burnbox que vous trouverez dans +le menu d'un des gestionnaires de fenêtres, soit JWM ou Enlightenment. +L'outils wodim permet de graver un CD/DVD et d'effacer des +CD/DVD-RW, quand a genisoimage, il permet de créer des images +gravables au format ISO 9660. La gravure en ligne de commande nous impose de +connaître le nom du périphérique/graveur (dev). Wodim offre plusieurs +possibilités pour connaître le graveur à utiliser et plusieurs façcon de +spécifier le périphérique lors de la gravure. Si vous lancez Wodim avec +l'options -devices, il tentera de devinner automatiquement le nom +du bon graveur et l'affichera, l'option -checkdrive permet de +vérifier les graveurs reconnus. Quand au bus, il peut être connu via l'option +-scanbus. Exemple (en étant root) : +

+
+ # wodim -devices
+ Ou :
+ # wodim -checkdrive
+ Pour le bus :
+ # wodim -scanbus
+
+

Créer une image ISO 9660

+

+Pour graver des données sur un CD/DVD, vous devez disposer d'une image ISO. +Pour commencer il faut créer un répertoire contenant tous les fichiers +destinés à être graver, vous pouvez copier vos fichiers en ligne de commande +avec cp, en mode texte avec le gestionnaire de fichiers Clex ou +graphiquement avec emelFM2. Exemple en commandes (vous pouvez être simple +utilisateur), création d'un répertoire iso/ à la racine de +l'espace utilisateur et copie de tous les fichiers contenu dans +Documents/ : +

+
+ $ mkdir ~/iso
+ $ cp -a Documents/* ~/iso
+
+

+Création d'une image ISO nommée image.iso, en utilisant l'outil +genisoimage et en spécifiant la racine du répertoire contenant les +fichiers à insérer dans l'ISO : +

+
+ $ genisoimage -o image.iso ~/iso
+
+

+A noter qu'il existe de multiples options pour créer des images ISO, une des +plus utilisée est l'extension -R, signifiant Rock ridge +et permettant d'utiliser des noms de 255 caractères sans trop de +restrictions, supportant les liens symboliques et les droits sur les fichiers. +Pour connaître toutes les options disponibles, vous pouvez utiliser l'option +-help. Exemple de création en utilisant l'option -R : +

+
+ $ genisoimage -o image.iso -R ~/iso
+
+

Graver une image ISO

+

+Pour graver une image au format ISO 9660 créée vous même ou téléchargée depuis +le web, il faut utiliser wodim en spécifiant le bon périphérique +(dev) du graveur de CD/DVD. Exemple de gravure en mode volubile +(-v) avec un device reconnu comme hdc et +des données contenues dans une image ISO nomée image.iso : +

+
+ # wodim -v dev=/dev/hdc image.iso
+
+

+Autre exemple en spécifiant une vitesse (speed) de gravage de 8 : +

+
+ # wodim -v speed=8 dev=/dev/hdc image.iso
+
+ + +

Nano

+

+L'éditeur de texte par défaut sur SliTaz est GNU Nano. Une fois lancé vous +pouvez utiliser <Ctrl + g> pour afficher l'aide. Pour lancer Nano vous +pouvez taper la commande nano depuis une console, le terminal +graphique xterm, ou sous X depuis le menu --> Editors --> Nano. +

+

+Le fichier d'initialisation du système est /etc/nanorc, il inclu les fichiers +de colorisation syntaxique contenus dans /usr/share/nano. Le fichier de config +utilisateur est ~/.nanorc. Pour éditer directement un fichier, vous pouvez +lancer Nano suivi du fichier à éditer. Exemple (<Ctrl+X> pour quitter et +enregistrer) : +

+
+ $ nano Templates/script-shell.sh
+
+ + +

LeafPad

+

+En mode graphique SliTaz fournit LeafPad, un éditeur ultra léger et rapide, +très pratique pour prendre des notes, ou éditer des fichiers de configuration. +Vous trouverez l'application dans le menu de JWM et e17 ou vous pouvez aussi +lancer directement LeafPad sur un fichier via un terminal : +

+
+ $ leafpad Templates/script-shell.sh
+
+ + +

ISO Master - Éditeur graphique d'images ISO

+

+ISO master est un outils graphique permettant déditer, manipuler et créer des +images ISO gravables. L'outils est simple et intuitif, il vous permet de créer +rapidement des images ISO de la taille que vous désirez, pour ensuite les graver +ou les stocker. +

+

+Site Web : http://littlesvr.ca/isomaster/ +

+ + +

Xpad - Mini application de prise de notes

+

+Xpad est une petite application permettant la prise de notes rapide via des +billets affichable sur le bureau. Chaque note consite en un pad +que vous pouvez cacher et personnaliser via un clic de droite sur la fenêtre +en question. Une fois lancé vous pouvez fermer Xpad via le dock situé sur la +barre des tâches du gestionnaire de fenêtres. Les notes sont sauvegardée dans +votre répertoire personnel et disponnibles à chaque session (si vous utiliser +un media USB avec le LiveCD ou sur un système +installé). +

+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/web-server.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/web-server.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,257 @@ + + + + SliTaz Handbook - Serveur web LightTPD + + + + + + + + + + + + + + + +
+
+ +

Serveur web LightTPD

+ + + + +

A propos de LightTPD

+

+Ce chapitre décrit l'utilisation et la configuration du serveur web LightTPD. +C'est un serveur HTTP sécurisé, rapide, flexible, et utilisant une petite +empreinte mémoire. Il permet une gestion intelligente de la charge CPU, et +support FastCGI, CGI, Auth, Output-Compression, réécriture d'URL, etc. +LightTPD est un serveur idéal pour héberger son propre site, sur une ancienne +machine, et donc à moindre frais. +

+

+Sur SliTaz le serveur web est automatiquement lancé au boot du système et il +est préconfiguré avec PHP. La racine des documents servis par défaut par le +serveur sont dans /var/www et contient une page index.html, +s'affichant par défaut, avec des images dans le répertoire images/. Site web +de LightTPD : http://www.lighttpd.net/ +

+ +

/var/www - Racine des documents du serveur

+

+Le répertoire /var/www est le répertoire racine des documents servis par +défaut. Vous y avez accès via l'url http://localhost/. Ce répertoire contient un page index.html s'affichant +automatiquement lors d'une requête. Si vous ne voulez héberger qu'un site, +vous pouvez mettre tous les document dans /var/www, et si vous voulez héberger +plusieurs sites, il faut créer des hôtes virtuels. +

+ +

~/Public - Répertoire public des utilisateurs

+

+SliTaz propose aux utilisateurs du système d'avoir un espace public pour y +mettre des documents, HTML en général. Ce répertoire se nomme Public et doit +se trouver à la racine de votre répertoire maison, tel que : +/home/hacker/Public. Pour créer ce répertoire vous pouvez utliser la commande : +

+
+ $ mkdir ~/Public
+
+

+Vous pouvez ensuite y avoir accès via l'url http://localhost/~user/. Exemple +pour l'utilisateur hacker : +http://localhost/~hacker/. Vous pouvez +aussi utiliser le nom de machine ou l'adresse IP, pour vous y connecter depuis +une autre machine. +

+ +

/etc/lighttpd/lighttpd.conf - Fichier de configuration de LightTPD

+

+Le fichier de configuration principal de LightTPD se trouve dans +/etc/lighttpd, et se nomme lighttpd.conf. Le fichier de configuration fourni +par SliTaz est auto documenté, il suffit de le parcourir. Vous trouverez +d'autres exemples sur le site web de LightTPD. Sur SliTaz vous touverez aussi +un fichier vhosts.conf destiné à la configuration d'éventuels +hôtes virtuels (pour hébérger plusieurs sites sur le même serveur). +

+ +

Démarrer, arrêter, redémarrer le serveur web

+

+Par défaut SliTaz démarre le serveur au boot, pour qu'il ne soit pas lancé +automatiquement vous devez supprimer lighttpd de la variable +RUN_DAEMONS qui elle, se trouve dans le fichier de configuration du système +d'initialisation /etc/rcS.conf. Pour démarrer, arrêter, +redémarrer le serveur web vous pouvez utiliser la commande +/etc/init.d/lighttpd [start|stop|restart]. Exemple pour +redémarrer le serveur après modification du fichier de configuration : +

+
+ # /etc/init.d/lighttpd restart
+
+ + +

Scripts CGI et Perl

+

+Pour configurer le serveur LightTPD afin qu'il trouve le chemin du binaire +perl et l'utiliser avec les scripts CGI/Perl, vous devez modifier +le fichier de configuration du serveur. Exemple en utilisant Geany : +

+
+ # geany /etc/lighttpd/lighttpd.conf &
+
+
+# CGI module. You can install Perl and assign .pl and .cgi script
+# to /usr/bin/perl
+$HTTP["url"] =~ "/cgi-bin/" {
+  cgi.assign = (
+    ".sh" => "/bin/sh",
+    ".cgi" => "/usr/bin/perl,
+    ".pl" => "/usr/bin/perl
+  )
+}
+
+ + +

Scripts CGI et Python

+

+Pour configurer le serveur LightTPD afin qu'il trouve le chemin du binaire +python et l'utiliser avec les scripts CGI/Python, vous devez +avoir installé le paquet Python et modifier le fichier de configuration du +serveur. Pour installer Python et éditer le fichiers de configuration du +serveur web en utilisant Geany : +

+
+ # tazpkg get-install python
+ # geany /etc/lighttpd/lighttpd.conf &
+
+
+# CGI module. You can install Perl and assign .pl and .cgi script
+# to /usr/bin/perl
+$HTTP["url"] =~ "/cgi-bin/" {
+  cgi.assign = (
+    ".sh" => "/bin/sh",
+    ".cgi" => "/usr/bin/python,
+    ".py" => "/usr/bin/python
+  )
+}
+
+

+Pour que les modifications soient prisent en compte, et utiliser vos premier +scripts CGI/Python sur SliTaz, vous devez encore redémarrer LightTPD : +

+
+ # /etc/init.d/lighttpd restart
+
+ + +

Authentification - Protéger des répertoires

+

+LightTPD fournit un module d'authentification permettant par exemple, de +protéger un répertoire. Le serveur propose plusieurs méthodes d'authentification, +pour commencer nous allons utiliser la méthode basique sans cryptage des mots +de passes. Afin de pouvoir charger le module mod_auth, vous devez +avoir installer le paquets lighttpd-modules (tazpkg get-install +lighttpd-modules), une fois le paquet installé il faut ajouter +mod_auth à la liste des modules : +

+
+# Modules to load.
+# See /usr/lib/lighttpd for all available modules.
+#
+server.modules = (
+  "mod_access",
+  "mod_auth",
+  "...",
+)
+
+

+Maintenant vous pouvez configurer le modules en spécifiant le niveau de debug +la méthode (plain) et le chemin vers le fichier qui contiendra la +liste des noms:pass autorisés à voir le ou les répertoires protégés. Il faut +aussi définir le ou les répertoires qui demandent authentification. Dans cet +exemple nous protégeons le répertoire admin/ et autorisons son +accès à l'utililisateur hacker (user=hacker) : +

+
+# Authentification for protected directory.
+auth.debug = 2
+auth.backend = "plain"
+auth.backend.plain.userfile = "/etc/lighttpd/plain.passwd"
+auth.require = ( "/admin/" =>
+(
+"method" => "basic",
+"realm" => "Password protected area",
+"require" => "user=hacker"
+)
+)
+
+

+Pour finir il suffit de créer le fichier des mots de passes, d'ajouter un +utilisateur et de redémarrer le serveur pour tester. La syntaxe pour les fichiers +basiques est nom:pass. Vous pouvez créer et ajouter un utilisateur +à ce fichier avec la commande echo ou l'éditer avec votre éditeur +de texte préféré. Pour un utilisateur:motdepasse hacker:root dans +un fichier de mots de passes /etc/lighttpd/plain.passwd : +

+
+ # echo "hacker:root" > /etc/lighttpd/plain.passwd
+ Ou/et :
+ # nano /etc/lighttpd/plain.passwd
+
+

+Pour redémarrer le serveur et ensuite tester avec une adresse du type +http://localhost/admin/ : +

+
+ # /etc/init.d/lighttpd restart
+
+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/handbook/x-window.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook/x-window.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,321 @@ + + + + SliTaz Handbook - Système X + + + + + + + + + + + + + + + +
+
+ +

Système de fenêtres X

+ + + + +

A propos de X

+

+Ce petit chapitre décrit l'utilisation et la configuration d'une session +graphique sur votre système. En mode LiveCD, SliTaz fournit le serveur Xvesa +(KDrive), il est léger, rapide et s'adapte à tous type de matériel. Le terminal +graphique ar défaut est XTerm, L'émulateur de termial à onglet Mrxvt est +installable avec Tazpkg. +

+ + +

Slim - Gestionnaire de session

+

+Slim est un gestionnaire de connexion simple à utiliser et configurer, très +léger et personnalisable via un système de thèmes. Le fichier de configuration +est /etc/slim.conf, il définit le serveur graphique à utiliser +avec d'éventuelles options, les commandes à utiliser, les gestionnaires de +fenêtres disponnibles via la touche F1, l'utilisateur par défaut +ou encore le thème graphique à utiliser. Slim propose aussi quelques +utilisateurs spéciaux permettant de sortir du login avec exit, +obtenir un Xterm avec console, redémarrer ou éteindre le système +avec reboot ou halt suivi du mot de passe root. +

+

+En mode LiveCD vous pouvez désactiver le lancement de Slim via l'option de boot +screen=text, sur un système installé vous pouvez désintaller le +paquet ou supprimer slim de la variable RUN_DAEMONS du fichier +/etc/rcS.conf. +

+

+Site Web proposant une section avec des thèmes: +http://slim.berlios.de/ +

+ + +

startx - Session graphique depuis une console Linux

+

+Pour lancer une session graphique il suffit de taper startx +dans le terminal après l'authentification (login). Si c'est la première +fois que vous démarrez X avec l'utilisateur courant, la commande +startx exécutera tazx pour configurer la session. La +configuration est ensuite sauvegardée dans le fichier ~/.xsession, que +vous pouvez modifier avec un éditeur de texte. Pour lancer X : +

+
+ $ startx
+
+ + +

Configuration de votre session X

+

+Par default SliTaz lance le gestionnaire de connexion Slim, une fois le nom +d'utilisateur et le mot de passe entré, Slim va exécuter le fichiers +~/.xinitrc que vous pouvez modifier à la main ou en utilisant +tazx. Si vous voulez par exemple Openbox comme gestionnaire +de fenêtres par défaut: +

+
+ $ tazx openbox
+
+

Avec startx

+

+Quand vous lancez startx, le script cherche le fichier +~/.xsession contenant ligne par ligne les applications à exécuter lors d'une +session graphique. Ce fichier commence par lancer le serveur X avec la bonne +résolution d'écran, suivi de diverses applications, comme un terminal xterm, +ou Links, et pour finir on peut lancer le gestionnaire de fenêtre. +

+

Exemple d'un fichier ~/.xsession

+
+# ~/.xsession: Start X session on you SliTaz system.
+#
+Xvesa -ac -shadow -screen 1024x768x24 -mouse /dev/input/mice,5 &
+sleep 2 &
+lxpanel &
+xterm -bg black -fg white -geometry 80x16+20+20 &
+exec jwm
+
+
+ + +

Xorg

+

+Par défaut SliTaz fournit le mini serveur graphique Xvesa, le serveur Xorg +complet est disponible dans la séléction des paquets du miroir. Xorg est un +serveur complet, mais utilise plus de resources qu'Xvesa, si votre résolution +est bien supportée par le mini serveur et que le taux de rafraîchissement +vous convient, il n'y a pas de raison d'utiliser Xorg. +

+

+Il n'y a pas d'interface graphique de configuration, il va donc falloir passer +par quelques commandes, l'installation et configuration du serveur est +relativement simple et vous pourrez toujours revenir en arrière pour réutiliser +Xvesa. Xorg est distribué sous forme modulaire, c'est à dire que vous aurez +besoin d'installer que le serveur, quelques fichiers de configuration et le +bon driver pour votre carte graphique. Cela dit, le paquet +xorg-serveur a les bonnes dépendances pour fonctionner directement +avec le driver générique vesa. Pour installer le minimum: +

+
+ # tazpkg get-install xorg-server
+
+

+Une fois installé vous pouvez directemnt passer à la configuration ou encore +installer le bon driver si vous le connaissez, exemple pour un carte Nvidia +et pour lister tous les drivers disponibles : +

+
+ # tazpkg get-install xorg-xf86-video-nv
+ Liste:
+ # tazpkg search xf86-video -l
+
+

Configuration automatique du serveur

+

+Pour configurer le serveur Xorg vous avez deux possibilités, utiliser l'option +Xorg -configure ou le script xorgconfig. Il est +recommendé de commencer par utiliser la configuration automatique avec +l'option -configure du serveur. La configuration automatique +d'Xorg doit se faire en mod texte sans serveur X lançé, une fois la commande +éxécutée, vous pouvez tester la configuration ou, faire confiance et +directement copier le fichier générer dans /etc/X11. Pour finir, +vous devrez encore modifier la configuration de Slim pour qu'il utilise Xorg +et non Xvesa. Pour vous retrouver en mode text, sortez de votre session et +tapez simplement exit au login de Slim. Un fois en mode texte, vous pouvez +configurer Xorg et copier le fichier, tout cela en tant qu'administrateur root: +

+
+ # Xorg -configure
+ # cp /root/xorg.conf.new /etc/X11/xorg.conf
+
+

Utiliser Xorg avec Slim

+

+Dans le fichier de configuration de Slim (/etc/slim.conf), il +faut commenter (#) les lignes lançant Xvesa et ces options et +renseigner default_xserver : +

+
+default_xserver     /usr/bin/Xorg
+#default_xserver     /usr/bin/Xvesa
+#xserver_arguments   -ac -shadow dpms +extension Composite -screen 1024x768x24
+
+

+Slim fonctionne comme un démon, il peut être stoppé ou démarré depuis une +console texte, exemple pour démarrer le démon à la main: +

+
+ # /etc/init.d/slim start
+
+

xorg.conf - Fichier de configuration

+

+Xorg utilise le fichiers de configuration /etc/X11/xorg.conf, ce +fichier peut être généré automatiquement et édité avec votre éditeur de texte +préféré. Le fichier de configuration et divisé en plusieures sections comprenant +la configuration des chemins, des modules à charger, du clavier, de la souris +ou encore de l'écran par défaut. Ce docuement ne fournit que quelques exemples, +il est conseillé d'utiliser une fois xorgconfig pour générer un +fichier complet et l'utiliser comme exemple. +

+

+Clavier (fr_CH): +

+
+Section "InputDevice"
+	Identifier  "Keyboard0"
+	Driver      "kbd"
+	Option      "XkbRules"	"xorg"
+	Option      "XkbModel"	"pc105"
+	Option      "XkbLayout"	"ch"
+	Option      "XkbVariant"	"fr"
+EndSection
+
+

+Souris avec detection automatique du protocol: +

+
+Section "InputDevice"
+	Identifier  "Mouse0"
+	Driver      "mouse"
+	Option	    "Protocol" "auto"
+	Option	    "Device" "/dev/input/mice"
+	Option	    "ZAxisMapping" "4 5 6 7"
+EndSection
+
+

+Extension Composite pour les effets de bureau: +

+
+Section "Extensions"
+	Option      "Composite" "1"
+EndSection
+
+ + +

Utiliser Xvesa comme terminal X

+

+Vous pouvez utiliser Xvesa comme terminal X, si vous avez une machine sur +le réseau acceptant les connexions Xdmcp. Pour cela vous pouvez lancer +le serveur avec l'option -query suivi du nom de machine ou de +l'adresse IP. Exemple avec la machine 192.168.0.2 du réseau locale : +

+
+ $ Xvesa -ac -shadow -screen 1024x768x24 -query 192.168.0.2
+
+

+L'utilisation du serveur graphique à distance peut être d'une grande utilité, +la rapidité d'exécution des applications va fortement dépendre du débit de la +connexion internet et de la puissance de la machine distante. Cette technique +fonctionne très bien au sein d'un réseau local et permet d'utiliser les +applications installées sur la machine distante, directement sur l'écran de la +machine locale depuis laquelle vous avez décidez de travailler. A noter que la +machine distante peut disposer de plusieurs comptes utilisés simultanément à +distance et/ou en accès direct. +

+ + +

Polices de caractères

+

+La gestion des polices de caractères (fonts) est propulsée par le +paquet Fontconfig. Ce paquet fournit divers outils pour ajouter, lister et +manipuler les polices. Les fonts peuvent être installées en espace +utilisateur ou au niveau du système, cela veut dire que chaque utilisateur +peut disposer de ses propres polices ou que l'administrateur (root) +peut installer des polices utilisables par tous les utilisateurs du système. +Si vous utilisez un media USB associé au LiveCD +de SliTaz, vous pouvez facilement installer des polices et les retrouver +à chaque utilisation du cdrom. +

+

Installer des fonts

+

+Au niveau du système, les polices s'installent dans le répertoire : +/usr/share/fonts, de base, SliTaz fournit les polices TTF Vera, +elles prennent peu de place et ont un rendu correct. En espace utilisateur, +les polices s'installent dans le répertoire caché : .fonts/, ce +répertoire doit se situer à la racine de l'espace utilisateur. Pour créer un +répertoire personnel destiné à accueillir des nouvelles polices, vous pouvez +utiliser le gestionnaire de fenêtres graphique emelFM2, Clex ou utiliser +la ligne de commande : +

+
+ $ mkdir ~/.fonts
+
+

+Une fois que vous avez installé de nouvelles polices, vous devez lancer +l'outil fc-cache pour générer les fichiers de configuration, +faire en sorte que vos fonts soient disponibles et utilisables par +les applications graphiques : +

+
+ $ fc-cache
+
+ + +
+ + + + +
+ Copyright © 2007 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/index.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/index.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,154 @@ + + + + SliTaz - Documentation + + + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ + +
+ + +

Documentation

+

Livres - Handbook & Cookbook

+ + +

Manuels des utilitaires

+ + +

Notes de publication

+

+Les notes de publication de SliTaz fournissent des informations spécifique au +sujet d'une version stable du système et donne quelques astuces utiles pour +commencer à utiliser SliTaz. Sur le corps du LiveCD, les notes de publication +sont instalées et accessible depuis le menu "Documentation". +

+ +

+SliTaz GNU/Linux 1.0 - Notes de publication + [ xHTML ] + [ Text ] +

+ + +
+
+
+
+
+ + +
+

+Dernière modification : 2008-01-01 12:00:00 - +Haut de la page +

+

+Copyright © 2008 SliTaz - +GNU General Public License +

+ +
+ + +
+

+Valid XHTML 1.0 +

+
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/manuals/tazlito.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/manuals/tazlito.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,235 @@ + + + + Tazlito Manual - SliTaz Live Tool + + + + + + + + +
+ +
+ +

NOM

+

+Tazlito - SliTaz Live Tool. +

+ +

SYNTAXE

+
+tazlito [command] [list|iso|flavor] [dir]
+
+ +

DESCRIPTION

+

+Tazlito est un petit utilitaire permettant d'extraire le LiveCD, reconstruire +l'image ISO ou regénérer le système racine du LiveCD de SliTaz. Tazlito donne +aussi la possibilité de générer une distribution depuis une liste de paquets +préalablements téléchargés et stockés dans un répertoire. Pour fonctionner, +l'application Tazlito utilise un fichier de configuration système +/etc/slitaz-tools/tazlito.conf ou un fichier tazlito.conf se trouvant dans le +répertoire courant. Ce fichier de configuration peut facilement être généré +automatiquement par Tazlito, il spécifie le nom de l'image ISO, le nom du +volume, le préparateur, le chemin vers le repositoire des paquets et celui +vers la distribution. Tazlito permet aussi de configurer un répertoire +contenant des fichiers additionnels, qui seront copiés dans le LiveCD lors +de la génération de la distribution. +

+

+Tazlito est, distribué sous licence libre GNU gpl v3, installé par défaut sur +SliTaz et installé/testé avec succès sur Debian GNU/Linux. Vous trouverez +aussi un complément d'informations au sujet de création de sa propre version +du LiveCD, via le livre de cuisine (Cookbook) de SliTaz +(http://www.slitaz.org/doc/cookbook/) et le Handbook. +

+ +

COMMANDES

+

usage

+

+La commande 'usage' affiche une liste des commandes disponibles avec une +courte description : +

+
+ # tazlito usage
+
+

stats

+

+Stats affiche les variables de configuration, le chemin vers les différents +fichiers et répertoires et les informations sur l'image ISO : +

+
+ # tazlito stats
+
+

gen-config

+

+La commande 'gen-config' vous permet de générer une fichier de configuration +prêt à être édité. Par défaut le fichier est créé dans le répertoire courant +et peut aussi l'être dans un autre répertoire si spécifié : +

+
+ # tazlito gen-config
+ # tazlito gen-config /path/to/distro
+
+

configure

+

+La commande configure permet de configurer le fichier de configuration +système ou celui trouvé dans le répertoire courant : +

+
+ # tazlito configure
+
+

gen-iso

+

+La commande 'gen-iso' pour Generate ISO permet de générer une nouvelle +image ISO du LiveCD suite à des modifications et ajouter dans le système +racine du cdrom. Pour fonctionner cette commande a besoin d'un répertoire +contenant la structure du système Live, cette structure peur facilement être +construite avec la commande 'extract-distro', modifiée et reconstruite via : +

+
+ # tazlito gen-iso
+
+

gen-initiso

+

+La commande 'gen-initiso' va faire le même travail que 'gen-iso' mais en +reconstruisant préalablement l'initramfs compressé du système. L'initramfs +contient tous le système racine de la distribution et doit être reconstruite +en cas de modifications sur les fichiers. +

+
+ # tazlito gen-initiso
+
+

list-flavors

+

+La commande 'list-flavors' télécharge si nécessaire et affiche la liste des +différentes saveurs disponibles. On peut forcer le téléchargement avec +'--recharge'. +

+
+ # tazlito list-flavors
+ # tazlito list-flavors --recharge
+
+

get-flavor

+

+La commande 'get-flavor' télécharge si nécessaire et prépare les fichiers +nécessaires à 'gen-distro' pour refabriquer une saveur. +

+
+ # tazlito get-flavor saveur-particuliere 
+
+

show-flavor

+

+La commande 'show-flavor' affiche les caractéristiques d'une saveur et ses +dimensions après refabrication. Les options '--brief' et '--noheader' réduisent +l'affichage produit. +

+
+ # tazlito show-flavor saveur-particuliere 
+ # tazlito show-flavor saveur-particuliere --brief
+ # tazlito show-flavor saveur-particuliere --brief --noheader
+
+

gen-flavor

+

+La commande 'gen-flavor' crée un fichier de description d'une nouvelle saveur +à partir des résultats de fabrication de 'gen-distro'. Le fichier .flavor +produit pourra être ensuite envoyé à slitaz.org. +

+
+ # tazlito gen-flavor nouvelle-saveur
+
+

extract-distro

+

+La commande 'extract-iso' sert à extraire les fichiers d'une images ISO du +LiveCD, pour en reconstruire la structure (Racine du cdrom et du système). +Il est ensuite possible de faire les modifications ou ajouts souhaités, pour +reconstruire l'image ISO via les commandes 'gen-iso' ou 'gen-initiso'. Exemple +d'utilisation : +

+
+ # tazlito extract-distro slitaz-cooking.iso
+
+

gen-distro

+

+La commande Generate Distribution permet de générer la structure du +système Live et une image ISO via une liste de paquets. Pour fonctionner, cette +commande a besoin d'une liste de paquets, d'un répertoire contenant tous les +paquets (.tazpkg) de la liste et d'un répertoire pour générer la distribution. +La liste de paquets peut être extraite d'une saveur par la commande get-flavor. +Si l'on utilise le Live-CD, les options --cdrom et --iso= permettent +de refabriquer les packets qui placent des fichiers dans /boot sans être obligé +de les télécharger et récupère les fichiers additionnels du Live-CD. +Le chemin vers les différents répertoires sont à configurer dans le fichier de +configuration utilisé et les paquets peuvent être téléchargés depuis les +miroirs de SliTaz ou générés par Tazwok. Pour générer une distro : +

+
+ # tazlito gen-distro
+ # tazlito gen-distro --cdrom
+ # tazlito gen-distro --iso=slitaz.iso
+ # tazlito gen-distro package-list
+
+

clean-distro

+

+Supprime tous les fichiers générés ou extraits de la structure du LiveCD : +

+
+ # tazlito clean-distro
+
+

addhacker

+

+La commande 'addhacker' permet d'ajouter l'utilisateur Hacker à la distribution, +cela permet d'avoir un compte utilisateur sans mot de passe. A noter que cette +commande effectue un changement de permissions sur tous les fichiers contenus +dans /home/hacker : +

+
+ # tazlito addhacker
+
+

check-distro

+

+Cette commande permet simplement de vérifier si les fichiers non installés par +des paquets, sont bien présents dans la distro : +

+
+ # tazlito check-distro
+
+

burn-iso

+

+Burn ISO va deviner le périphérique de cdrom, sa vitesse de gravure et lancer +l'outils Wodim pour graver une image ISO. L'image ISO par défaut est celle +du fichier de configuration courant, mais il est possible de spécifier une +autre image via la ligne de commande : +

+
+ # tazlito burn-iso
+ # tazlito burn-iso slitaz-hacked.iso
+
+ +

MAINTENEUR

+

+Christophe Lincoln <pankso at slitaz.org> +

+ + +
+ + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/manuals/tazpkg.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/manuals/tazpkg.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,324 @@ + + + + Tazpkg Manual - Manuel du gestionnaire de paquets 'tazpkg' + + + + + + + + +
+ +
+ +

NOM

+

+Tazpkg - Tiny autonomous zone package manager +

+ +

SYNTAXE

+
+ tazpkg [command] [package|dir|pattern|list|cat|--opt] [dir|--opt]
+
+ +

DESCRIPTION

+

+Tazpkg est un gestionnaire de paquets ultra léger (~35 Ko) permettant +d'installer, lister, télécharger, mettre à jour ou enlever des paquets +précompilés sur un système GNU/Linux. Tazpkg propose aussi une commande de +recherche et une commande pour la création de paquets. Il a été créé pour les +besoins de SliTaz GNU/Linux, mini distribution autonome. Le format des paquets +utilise l'extension *.tazpkg, c'est une archive cpio contenant un système de +fichiers (fs) compressé avec gzip, la recette et une éventuelle description. +Tazpkg fournit aussi un système de gestion des dépendances basé sur les +recettes des paquets. La recette contient toutes les informations au sujet du +paquet, elle peut aussi contenir les fonctions de pre et post installation. +Cette même recette est par ailleurs utilisée par Tazwok pour compiler les +sources et créer un paquet tazpkg. +

+

+Tazpkg est écrit en script shell depuis rien (from scratch), compatible +Bash, et fonctionnant avec Ash du projet Busybox. Tazpkg est distribué +sous license libre GNU gpl v3. +

+ +

COMMANDES

+

list

+

+Liste et compte les paquets installés sur le système. Cette commande permet +d'afficher sur une colonne la liste tous les paquets installés, vous pouvez +aussi utiliser la commande de recherche (search) pour avoir une liste en +fonction d'un nom (exemple xorg). Cette commande vous permet aussi de lister +les catégories, les paquets en fonction de leur catégorie et les paquets +bloqués : +

+
+ # tazpkg list
+ # tazpkg list cat|categories
+ # tazpkg list blocked
+
+

xhtml-list

+

+La commande 'xhtml-list' permet de créer une liste au format xHTML des +paquets installés sur le système, une fois générée, cette liste peut être +lue avec votre navigateur Web préféré. Cette commande peut être lancée +en tant que simple utilisateur et crée par défaut une liste nommée +'installed-packages.html' dans le répertoire courant. A noter que vous +pouvez aussi changer le nom de la liste générée via la ligne de +commande : +

+
+ # tazpkg xhtml-list
+ # tazpkg xhtml-list list-name.html
+
+

list-mirror

+

+Liste et compte les paquets disponnibles sur le miroir. Cette commande va +afficher le dernier fichier packages.list rechargé depuis le miroir, si la +liste des paquets n'existe pas, il vous sera demandé de lancer la commande +'tazpkg recharge' en tant qu'administrateur (root) pour obtenir la liste +des paquets disponibles. L'option --diff est utilisée pour afficher le +fichier des différences entre la dernière et l'actuelle liste des paquets : +

+
+ # tazpkg list-mirror
+ # tazpkg list-mirror --diff
+
+

info

+

+Donne les informations disponibles dans la recette du paquet en question, sa +version, sa catégorie, le mainteneur, son site Web et ses éventuelles +dépendances (voir aussi Tazwok pour plus d'informations sur les recettes) : +

+
+ # tazpkg info busybox
+
+

desc

+

+Description du paquet (si elle existe). Cette commande affiche le fichier +description.txt propre à chaque paquet, la description est un simple fichier +texte ne dépassant pas le 80 caractères pour un affichage standard dans un +terminal. Si la description du paquet n'existe pas, vous pouvez la créer et +l'envoyer au mainteneur du paquet (quelques lignes suffisent) : +

+
+ # tazpkg desc busybox
+
+

list-files

+

+Liste et compte les fichiers installés avec un paquet. Cette commande va +simplement lire et classer le fichier files.list propre à chaque paquet, ce +fichier est généré automatiquement lors de la création, il est aussi utilisé +pour supprimer tous les fichiers lors de la désinstallation d'un paquet. Pour +lister les fichier installés avec le paquet bc : +

+
+ # tazpkg list-files bc
+
+

search

+

+Recherche de paquets par patron ou nom de paquet. La commande +va chercher le terme voulu dans les paquets installés et dans la liste des +paquets disponibles sur le miroir. Pour obtenir la plus récente liste des +paquets installables depuis internet, il suffit de lancer 'tazpkg recharge' +avant d'effectuer une recherche : +

+
+ # tazpkg search gcc
+
+

search-files

+

+La commande 'search-file' permet de rechercher un fichier parmi tous les +fichiers installés par tous les paquets. Cette commande est très utile pour +trouver le chemin complet vers un fichier et savoir si un fichier est bien +présent sur le système. Exemple : +

+
+ $ tazpkg search-file libnss
+
+

install

+

+Cette commande permet l'installation d'un paquet local avec l'extension +.tazpkg. Voir la commande 'get-install' pour installer un paquet depuis +internet. A noter que vous pouvez forcer l'installation via l'option +--forced, désinstaller et réinstaller ou encore spécifier la racine du système +dans lequel vous désirez installer le paquets via l'option --root= : +

+
+ # tazpkg install package-1.0.tazpkg
+ Ou :
+ # tazpkg install path/to/package-1.0.tazpkg --forced
+ Ou :
+ # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs
+
+

install-list

+

+Installation d'un set de paquets listés dans un fichier. Cette commande +permet d'installer plusieurs paquets en une seule commande et peut aussi être +forcée : +

+
+ # tazpkg install-list my-packages.list
+ # tazpkg install-list my-packages.list --forced
+
+

remove

+

+Désinstallation d'un paquet, il vous sera demandé confirmation (y/N). Cette +commande va supprimer tous les fichiers installés avec le paquet, pour +afficher cette liste, vous pouvez utiliser la commande 'list-files' de Tazpkg +suivie du nom du paquet en question. Exemple avec le paquet bc : +

+
+ # tazpkg remove bc
+
+

extract

+

+Extraire un paquet dans un répertoire donné. Si vous ne spécifiez pas le +répertoire de destination, le paquet sera extrait dans le répertoire courant +en utilisant le nom paquet-version : +

+
+ # tazpkg extract package.tazpkg
+ # tazpkg extract package.tazpkg target/dir
+
+

pack

+

+La commande 'pack' permet de créer un paquet depuis un répertoire préparé à +l'avance ou depuis un paquet désarchivé. Cette commande permet aussi de créer +manuellement un paquet.tazpkg (voir la documentation et Tazwok pour la création +automatique de paquets). Pour empaqueter un paquet : +

+
+ # tazpkg pack package-version
+
+

repack

+

+La commande 'repack' permet de recréer un paquet depuis les fichiers présents +sur le système où il a été précédemment installé. Pour réempaqueter un paquet : +

+
+ # tazpkg repack package
+
+

recharge

+

+Recharge la liste des paquets disponibles sur le miroir (packages.list). Cette +commande va télécharger la plus récente liste des paquets installables depuis +le miroir, à noter qu'avant de commencer, Tazpkg va sauvegarder l'ancienne +liste. Une fois la liste à jour, vous pouvez la consulter via la commande +'list' et effectuer un recherche de paquet via la commande 'search' de Tazpkg. +Pour réafficher la liste des différences, vous pouvez utiliser la commande +'list-mirror --diff'. Et pour afficher et mettre à jour les paquets du système, +vous pouvez utiliser 'upgrade'. Pour recharger la plus récente liste des +paquets : +

+
+ # tazpkg recharge
+
+

upgrade

+

+La commande 'upgrade' permet de mettre à jour tous les paquets installés et +disponibles sur le miroir courant. La mise à jour des paquets est une +importante partie du système, elle permet de garder un système sécurisé avec +les dernières corrections et nouveautés. Le projet SliTaz, même mini, fournit +régulièrement des mises à jours de sécurité et propose généralement les +dernières versions des logiciels. A noter que cette fonction est destinée aux +personnes ayant installé SliTaz sur disque dur, en mode LiveCD les paquets mis +à jour seront perdus lors de l'arrêt du système. Pour garder un système un +jour : +

+
+ # tazpkg upgrade
+
+

check

+

+La commande 'check' permet de vérifier les dépendances sur les paquets +installés et de vérifier si tous les fichiers nécessaires à la reconstruction +des paquets sont bien présents : +

+
+ # tazpkg check
+
+

block ou unblock

+

+Les commandes 'block' et 'unblock' pemettent de bloquer la version du paquet +installé pour qu'il ne soit pas mis à jour par la commande 'upgrade'. La liste +des paquets bloqués est contenue dans le fichier : +/var/lib/tazpkg/blocked-packages.list, elle peut aussi être éditée à la main. +Pour bloquer ou débloquer un paquet tel que Grub : +

+
+ # tazpkg block grub
+ Ou :
+ # tazpkg unblock grub
+
+

get

+

+Télécharge un paquet depuis le miroir (si il existe). Le paquet téléchargé +est stocké dans le répertoire courant, pour connaître le chemin vous pouvez +utiliser la commande 'pwd'. Pour télécharger un paquet tel que 'grub', il suffit +de lancer la commande : +

+
+ # tazpkg get grub
+
+

get-install

+

+Installer un paquet depuis un mirroir sur internet. La commande 'get-install' +commence par vérifier si le paquet existe bien sur le miroir et si il n'a pas +déjà été téléchargé, avant de commencer le rapatriement. Pour connaître la +liste des paquets sur le miroir il faut utiliser la commande 'list-mirror' +(voir aussi recharge). Pour installer un paquet tel que 'grub' : +

+
+ # tazpkg get-install grub
+
+

clean-cache

+

+Supprimer les paquets Tazpkg téléchargés dans le cache. Lors de l'installation +de paquets via le Web, Tazpkg garde une copie du paquet, cela est fait pour +gagner de la bande passante en cas de réinstallation, mais il se peut que vous +vouliez libérer de la place sur le disque dur ou que vous désiriez +retélécharger des paquets : +

+
+ # tazpkg clean-cache
+
+

setup-mirror

+

+Configurer l'URL du miroir, la commande 'setup-mirror' vous demandera alors +l'URL du nouveau miroir. Vous pouvez spécifier plusieurs URLs en les séparant +par des espaces. A noter que vous pouvez aussi modifier à la main le +fichier /var/lib/tazpkg/mirror. L'URL doit pointer sur le répertoire contenant +la liste (packages.list) et les paquets : +

+
+ # tazpkg setup-mirror
+
+ +

MAINTENEUR

+

+Christophe Lincoln <pankso at slitaz.org> +

+ +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/manuals/tazwok.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/manuals/tazwok.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,231 @@ + + + + Tazwok Manual + + + + + + + + +
+ +
+ +

NOM

+

+Tazwok - SliTaz sources and packages cooker. +

+ +

SYNTAXE

+
+ tazwok [command] [package|list|category|dir] [--option]
+
+ +

DESCRIPTION

+

+Tazwok est un outils en ligne de commande permettant de configurer et de +compiler un paquet depuis les sources. Tazwok permet aussi de créer des +paquets prêts à être utilisé par Tazpkg, le gestionnaire de paquets créer +pour SliTaz. Pour fonctionner Tazwok utilise un fichier contenant la recette +et toutes les informations nécessaires à la construction du paquet, cette +recette est aussi utilisée par Tazpkg et se compose de différentes variables +et fonctions. Tazwok utilise un fichier de configuration (/etc/tazwok.conf) +pour connaître le chemin vers le wok, les paquets sources et les paquets +(.tazpkg) générés. Il est aussi capable de générer une liste paquets avec +leurs sommes md5, des créer un nouveau paquet de manière interactive, de faire +une recherche, de nettoyer les fichiers générés ou encore de cuire plusieurs +paquets en une seule fois (Voir les commandes disponibles). +

+

+Tazwok est écript en script shell depuis rien (from scratch), compatible Bash, +et fonctionnant avec Ash du projet Busybox. Tazwok est distribué sous license +libre GNU gpl v3. Les recettes avec leures commades sont basée sur le livre +de cuisine de SliTaz, le Cookbook fournit aussi de la documentation au sujet +de Tazwok et du dévellopement de SliTaz. +

+ +

COMMANDES

+

usage

+

+La commande 'usage' affiche la liste des commandes diponibles avec une petite +description en English : +

+
+ # tazwok usage
+
+

stats

+

+Stats affiche les informations contenue dans le fichier de configuration et +le nombre de paquets disponibles dans le wok : +

+
+ # tazwok stats
+
+

list

+

+La commande 'list' permet de lister l'ensemble des paquets contenus dans le +wok ou de lister les catégories par défauts (vous pouvez créer la votre). Elle +permet aussi de lister les paquets d'une catégorie : +

+
+ # tazwok list
+ # tazwok list category
+
+

info

+

+Cette commande donne des informations sur le paquet, nom, version, etc. Info +ce base sur la recette du paquet pour connaître les informations, c'est les +mêmes infos affichées par Tazpkg et les paquets installés : +

+
+ # tazwok info package
+
+

check-log

+

+Lors de la compilation et génération du paquet binaire, Tazwok génére quelques +messages de log stockés dans un fichier 'process.log'. Pour les afficher : +

+
+ # tazwok check-log package
+
+

search

+

+Search permet de faire une recherche de paquet dans le wok. Vous pouvez +spécifier un terme ou un nom de paquet : +

+
+ # tazwok search name
+
+

compile

+

+Compile va compiler. Cette commande utilise les régles de compilation +(compile_rules) spécifiées dans la recette du paquet en question, pour +compiler les sources. A noter qu'il n'y a pas forcement de régles de +compilation, des paquets sont directement généré par 'genpkg' et que la +commande 'cook' permet de compiler les sources et générer le paquet binaire +en une seule fois. Exemple : +

+
+ # tazwok compile package
+
+

genpkg

+

+Genpkg pour Generate package, va générer le paquet (.tazpkg) en +utilisant la fonction 'genpkg_rules' trouvée dans sa recette et compresser +les fichiers. Une fois le paquet généré, il est stocké dans le repositoire +des paquetss spécifié dans le fichier de configuration ('tazwok stats' pour +afficher la configuration courante). Le paquet peut ensuite facilement +s'installer via Tazpkg ou être utilisé par Tazlito pour générer une +distribution LiveCD automatiquement. A noter que les fichiers standards tels +que les locales, le pixmap ou le fichier.desktop sont automatiquement copiés +dans $fs/usr/share, si les chemins sont standards ou si le fichier existe dans +/stuff. Utilisation de 'genpkg' : +

+
+ # tazwok genpkg package
+
+

cook

+

+Cook va simplement compiler et empaqueter les paquet en une seule fois : +

+
+ # tazwok cook package
+
+

cook-list

+

+Cette commade va lancer 'tazwok cook' sur tous les paquets contenus dans la +liste spécifiées en argument. Cook-list est utilisés par exemple, pour cuire +le système de base, les applications de base, le système X, etc. Avant de +lancer cette commande avec un grand nombre de paquets, il est conseillé de +cuire une fois le système de base (base-system) sans la glibc. Sur SliTaz, +vous trouverez des exemples de liste de cuisson (cooklist) dans le répertoire +des exemples /usr/share/examples/tazwok/cooklists : +

+
+ # tazwok cook-list packages.cooklist
+
+

clean

+

+Clean permet simplement de supprimer tous les fichiers générés par la +compilation et l'empaquetage, pour recommencer à cuire (cook) : +

+
+ # tazwok clean package
+
+

new-tree

+

+La commande 'new-tree' permet de créer un nouveau paquet dans le wok et +peut s'utiliser de manière interactive. New-tree va créer le répertoire du +paquet et une recette modèle (receipt), cette recette peur être éditée avec +votre éditeur de texte préféré et peut se configurer via l'option +'--interactive'. Pour vous aider vous pouvez regarder des recettes existantes +et lire la documentation du Cookbook. Exemple d'utilisation : +

+
+ # tazwok new-tree package
+ # tazwok new-tree package --interactive
+
+

gen-list

+

+La commande 'gen-list' permet de générer une liste de paquets (packages.list), +leurs sommes md5 (packages.md5) et en option une liste de paquet contenant plus +d'informations (packages.txt). Les simples listes sont crées en se basant sur +les paquets contenus dans un répertoire. La liste au format texte est construite +avec les recettes contenues dans un wok. Le répertoire des paquets par défaut +est celui spécifié dans le fichier de configuration, vous avez aussi la +possibilité de spécifier le répertoire à utiliser sur la ligne de commande. +Utilisation de la commande 'gen-list' : +

+
+ # tazwok gen-list
+ # tazwok gen-list --text
+ # tazwok gen-list /path/to/repository
+
+

gen-clean-wok et clean-wok

+

+La commande 'gen-clean-wok' permet de générer un wok propre depuis le wok +courant. Cette commande est utile pour sauvegarder un version du wok ou copier +un wok pour tester avec un autre. Quand à la commande 'clean-wok', elle va +nettoyer tous les paquets du wok courant et supprimer tous les fichiers +générés. Pour récupérer un wok propre ou nettoyer le wok actuel : +

+
+ # tazwok gen-clean-wok path/to/new-wok
+ # tazwok clean-wok
+
+

remove

+

+Supprime le paquet spécifié du wok, avec tous les fichiers, stuff et recette +y compris : +

+
+ # tazwok remove package
+
+ +

MAINTENEUR

+

+Christophe Lincoln <pankso at slitaz.org> +

+ + +
+ + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/manuals/template.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/manuals/template.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,60 @@ + + + + Taz Manual - Template + + + + + + + + +
+ +
+ +

NOM

+

+Taz - Tiny autonomus zone +

+ +

SYNTAXE

+
+taz [command] [package|dir|pattern] [dir]
+
+ +

DESCRIPTION

+

+ +

+ +

COMMANDES

+

+ +

+ +

MAINTENEUR

+

+ +

+ + +
+ + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/releases/1.0/book.css --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/releases/1.0/book.css Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,170 @@ +/* + CSS style for SliTaz GNU/Linux *book. + Pankso 2007 - www.slitaz.org +*/ + +body { + font: 13px sans-serif, vernada, arial; + background: #222222; + margin: 0; + padding-bottom: 100%; +} + +#header { + background: #BFB06B url(images/css/header.png) repeat-x top; + color: black; + height: 50px; + border-top: 1px solid black; + border-bottom: 1px solid black; +} +#quicknav { + margin-right: 6px; + text-align: right; + font-size: 12px; + } +#quicknav { + margin-right: 6px; +} + +#quicknav a { + background: inherit; + color: #222222; +} + +#quicknav a:hover { + background: inherit; + color: #EDEDED; +} + +/* content. */ + +#content { + background: white url(images/css/content-tl.png) no-repeat top left; + color: black; + padding: 20px; + margin: 30px 50px 0px 50px; + width: auto; + text-align: justify; +} + +#content li { + line-height: 1.5em; + text-align: left; +} + +/* Footer. */ + +#footer { + font-size: 11px; + font-weight: bold; + background: #eaeaea url(images/css/footer-bl.png) no-repeat bottom left; + color: black; + height: 20px; + padding: 6px 0px 0px 10px; + margin: 0px 50px 0px 50px; + width: auto; + text-align: center ; +} + +#footer a { + text-decoration: none; + background: #eaeaea; + color: #3E1220; +} + +#footer a:hover { + background: #eaeaea; + color: #DF8F06; +} + +/* Legal informations */ + +#copy { + font-size: 11px ; + text-align: center ; + background: transparent; + color: #a8a8a8; + padding-top: 20px; +} + +#copy a { + background: inherit; + color: #a8a8a8; +} + +#copy a:hover { + background: inherit; + color: #EDEDED; +} + +/* Div for round corners. */ + +.content-right, .footer-right { + width: 16px; + color: white; + background-color: #333333; +} +.content-right { + background: url(images/css/content-tr.png) no-repeat top right; + height: 16px; + right: 50px; + top: 82px; + position: absolute; +} + +.footer-right { + background: url(images/css/footer-br.png) no-repeat bottom right; + height: 20px; + float: right; +} + +/* General HTML entities for content. */ + +h1 { + margin: 0px 0px 0px 16px; +} + +h2 { + margin: 12px 0; + color: #484B7C; + background: white; +} + +h3 { + font-weight: bold; + color: #6c0023; + background: white; +} + +a { + text-decoration: underline; +} +a:hover { + text-decoration: none; +} + +pre { + padding: 5px; + color: black; + background: #e1e0b0; +} +pre.script { + padding: 10px; + color: black; + background: #e8e8e8; + border: 1px inset #333333; +} + +code { + font-size: 12px; + color: #669900; + background: transparent; +} + +li { + line-height: 1.4em; +} + +hr { + border: 0pt none; +} diff -r 7f6a249b7cad -r 820d0069a6a3 doc/releases/1.0/favicon.ico Binary file doc/releases/1.0/favicon.ico has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/releases/1.0/images/css/content-tl.png Binary file doc/releases/1.0/images/css/content-tl.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/releases/1.0/images/css/content-tr.png Binary file doc/releases/1.0/images/css/content-tr.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/releases/1.0/images/css/footer-bl.png Binary file doc/releases/1.0/images/css/footer-bl.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/releases/1.0/images/css/footer-br.png Binary file doc/releases/1.0/images/css/footer-br.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/releases/1.0/images/css/header.png Binary file doc/releases/1.0/images/css/header.png has changed diff -r 7f6a249b7cad -r 820d0069a6a3 doc/releases/1.0/relnotes.fr.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/releases/1.0/relnotes.fr.html Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,283 @@ + + + + SliTaz GNU/Linux 1.0 - Notes de publication + + + + + + + + + + + + + + + +
+
+ +

Notes de publication

+ + + + +

Vue d'ensemble

+

+SliTaz GNU/Linux 1.0 a été publiée le 22 mars 2008 après deux ans de travail. +SliTaz est un système libre, complet et communautaire, proposant 448 paquets +logiciels facilement installables via le gestionnaire de paquets Tazpkg. Le +support des LiveCD à saveur est éprouvé et permet de créer facilement une +distribution personnalisée ou de disposer d'un système destiné à une tâche +spécifique telle que le traitement video, le graphisme ou le développement. +Le projet fournit un support technique aux utilisateurs via la liste de +discussion et le forum officiel. Le livre de main ou Handbook de SliTaz, +contient les informations et instructions pour apprendre à utiliser et finement +configurer le système. SliTaz peut s'installer ou se mettre à jour en mode +graphique et en mode texte via un installateur qui se veut simple, intuitif et +rapide. La distribution peut aussi être utilisée depuis un media USB, le +formatage et la configuration d'un périphérique USB peut se faire en quelques +commandes avec TazUSB. +

+ + +

Matériel supporté

+

+SliTaz GNU/Linux supporte toutes les machines à base processeur dit i486 ou +X86, compatible Intel. Un minimum de 128 MB est conseillé pour utiliser le +corps du LiveCD, 64 Mb pour les saveurs slitaz-loram et 16 Mb avec un peu de +swap pour les saveurs slitaz-loram-cdrom ayant la même séléction de paquets +que le corps. Avec une saveur loram le système est moins réactif mais permet +d'installer SliTaz graphiquement sur de très anciennes machines. Une fois +installée SliTaz fonctionne bien avec un minimum de 16 Mb, mais il faut +oublier Firefox pour naviguer sur le web et utiliser Links par exemple. La +plupart des cartes réseau et cartes son supportées par le noyau sont +présentes, la gestion de l'énergie et activée par défaut avec l'ACPI et le +support des batteries de PC portable se fait via les modules ac et battery, +en mode LiveCD l'option laptop permet de charger les modules de gestion +de la batterie au démarrage. +

+ + +

Saveurs de LiveCD

+

+SliTaz GNU/Linux est distribuée sous la forme d'un LiveCD bootable permettant +d'installer graphiquement le système sur disque dur et permettant d'emporter +le système avec soi afin de retrouver ses applications et documents lors de +déplacements. Le projet distribue une image ISO nommée core, c'est le corps +du système fournissant une séléction de paquets multi-utilisations, permettant +de surfer sur le Web, écouter de la musique, éditer ou extraire des pistes +audio, créer des images, développer, installer rapidement des outils en PHP, +gérer des bases de donées SQL, éditer des images ISO ou encore graver des +CD/DVD. Il suffit d'un clique dans le menu des applications pour trouver les +logiciels installés et classés par catégorie. +

+

+Le corps (core) du LiveCD peut aussi se reconstruire et générer des LiveCD +à saveur particulières graphiquement ou en ligne de commande (plus puissant). +La manière la plus simple pour créer son propre LiveCD est de démarrer avec +le LiveCD corps, installer les paquets voulus et générer un distribution avec +Tazlito ou d'utiliser une des saveurs disponible sur le miroir. Pour obtenir +une liste des saveurs disponibles, pensez à recharger la liste de temps en +temps avec la commande 'tazlito list-flavors --recharge'. +

+ + +

Installation

+

+L'installation du système est entièrement automatisée et peut se faire en mode +graphique ou mode texte. Si vous voulez installer vos propres saveurs +de LiveCD, il suffit de conserver slitaz-tools dans la liste des paquets de la +saveur en question. Les prérequis matériel et autres informations utiles à +l'installation sur disque dur sont décrits directement dans l'installateur +et dans le Handbook. Si vous désirez partitionner un disque avant installation, +vous pouvez rapidement utiliser Gparted en mode Live. A la fin de +l'installation, il est possible d'installer le gestionnaire de démarrage +(bootloader) GRUB, il est capable de démarrer des systèmes GNU/Linux, BSD ou +Windows. Cela permet d'installer SliTaz sur la même machine qu'un autre système +tout en laissant le choix du système à utiliser au démarrage de la machine. +

+ + +

Noyau Linux

+

+SliTaz GNU/linux 1.0 est distribuée avec le noyau Linux 2.6.24.2, patché pour +supporter la compression LZMA et corriger un problème d'affichage dans la +console virtuelle. Le support des disques IDE et SCSI est intégré ainsi que +celui des systèmes de fichiers ext2 et ext3. La plupart des cartes réseau +ethernet sont supportées soit directement, soit sous forme de modules +chargeables avec 'modprobe'. La capture video quant à elle nécessite les +modules ieee1394, raw1394 et ohci1394. La gestion des modules/drivers des +cartes son se fait avec 'soundconf'. Une liste complète de modules disponibles +peut être obtenue via la commande 'modprobe -l'. La configuration des modules +à charger au démarrage est située dans le fichier /etc/rcS.conf, en mode LiveCD +vous pouvez utiliser l'option modprobe=mod1,mod2 pour charger divers modules. +La configuration du noyau Linux de SliTaz est disponible dans le fichier +compressé /proc/config.gz et dans le dépôt Mercurial du wok. +

+ + +

Paquets logiciels

+

+La gestion de paquets logiciels se fait avec le gestionnaire de paquets Tazpkg, +simple, intuitif, rapide, stable et proposant un mode interactif. Parmi les +448 paquets disponibles vous trouverez de quoi transformer votre machine en +bureau graphique complet et moderne avec e17, en atelier de graphisme avec +en autre Gimp et Inkscape. SliTaz peut aussi devenir un studio video avec Kino, +une borne internet avec messagerie internet, VOIP et navigateur web. Le système +est aussi conçu pour être un serveur puissant, léger, rapide et stable avec +LightTPD/PHP installés par défaut, le support CGI Perl ou Python, Rsync pour +les sauvegardes incrémentales et IPtables pour le par-feu. SliTaz peut bien sûr +fournir un système de développement complet avec entre autre le compilateur +GCC 4.2.2, Mercurial, l'IDE Geany et tous les paquets de développement des +librairies. Les paquets peuvent être trouvés via la fonction de rechercher de +Tazpkg ou via l'interface du site Web: +http://www.slitaz.org/packages/ +

+

+Les paquets binaires du miroir peuvent être recompilés en utilisant le wok +et Tazwok pour cuire, toutes la documentation développeur est contenue dans +le livre de cuisine ou Cookbook de SliTaz toujours accessible depuis le site +Web du projet. +

+ + +

Bureaux graphiques

+

+Le bureau fourni par défaut avec le coeur du LiveCD est propulsé par JWM, un +gestionnaire de fenêtres très léger et stable, l'intégration de la barre des +tâches nommée LXpanel permet d'avoir un menu généré dynamiquement en fonction +des standards de Freedesktop. Le principe du bureau est d'avoir un petit menu +via un clique sur l'écran avec des favoris, les effets graphiques, les outils +SliTaz pour LiveCD ou LiveUSB, tout ce qui concerne la configuration de JWM +et les actions système. Les applications sont elles, disponibles via le menu +des applications généré par LXpanel. +

+

+Via le support des saveurs de LiveCD ou sur un système installé, vous avez +la possibilité d'installer l'environnement de bureau Enlightenment (e17) et +le gestionnaire de fenêtres Openbox. Les différentes sessions peuvent être +séléctionnées via la touche F1 du gestionnaire de connexion Slim, pour +modifier la session par défaut vous pouvez utiliser l'utilitaire 'tazx' ou +éditer à la main votre fichier ~/.xinitrc personnel. +

+ + +

Support et documentation

+

+Le projet SliTaz propose divers moyens de support et d'aide aux utilisateurs +du système, à commencer par la liste de discussion ou Mailing List, le forum +et le canal IRC. La documentation utilisateur est contenue dans le livre de +main ou Hanbook. Il contient beaucoup d'informations permettant de configurer +SliTaz dans les moindres détails. Le livre est lisible depuis le site web du +projet. Les manuels des différents outils sont installés sur le système et +accessibles depuis le menu Documentation. Ils décrivent toutes les commandes +possibles avec l'outil en question. Au niveau dévelopeur, la construction +du système ou l'utilisation du wok et des recettes sont soigeusement décrites +dans le livre de cuisine ou Cookbook. Les livres, manuels et notes de +publication sont en ligne: +http://www.slitaz.org/doc/ +

+ + +

Sécurité

+

+La version stable bénéficie de mise à jour de sécurité, il est important de +penser à recharger et mettre à jour les paquets régulièrement. Au niveau du +réseau le par-feu est assuré pas IPtables, le serveur LightTPD supporte les +authentifications par mots de passe cryptés et Dropbear fournit un client et un +serveur SSH sécurisé. Les mots de passe des utilisateurs du système sont aussi +cryptés et seul l'administarteur root peut modifier les fichiers système. Pour +plus d'informations ou apprendre à configurer le par-feu, vous pouvez vous +référer au Handbook. Les paquets en rapport à la sécurité sont classés dans +la catégorie: security. +

+ + +

De Cooking à Stable

+

+L'installateur de SliTaz GNU/Linux propose une fonction de mise à jour système +permettant de passer un système en cuission (Cooking) en version stable. Pour +mettre à jour un système il vous faut démarrer sur le LiveCD stable, lancer +l'installateur en appuyant sur Upgrade et spécifier ensuite la partition +contenant le système à mettre à jour. L'installateur va nettoyer le système et +réinstaller tous les paquets non présents sur le cdrom depuis le miroir. Une +fois terminé, vous pourrez redémarrer sur votre nouvelle version de SliTaz. +A noter que cette methode peut aussi servir à refaire une installation propre +du système tout en retrouvant la séléction des paquets précédemment installés. +

+

+A noter que l'installateur va conserver un copie des listes de paquets et une +archive complète du répertoire des fichiers de configuration /etc (etc.tar.gz) +dans: /var/lib/slitaz-installer +

+ + +

Les personnes du projet

+

+SliTaz est fier d'être un projet communautaire et international, les personnes +du projet sont celles qui développent la distribution, s'occupent du site Web +corrigent les logiciels sur les dépôts Hg ou écrivent de la documentation +officielle. En passant par la Suisse, la France, le Quebec, l'Algérie et +l'Angleterre: +

+ +

+Le projet tient encore à remercier tous les relecteurs, testeurs, hackers +et utilisateurs ayant pris du temps pour faire avancer la distribution. +

+ + +
+ + + + +
+ Copyright © 2008 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 7f6a249b7cad -r 820d0069a6a3 doc/releases/1.0/relnotes.fr.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/releases/1.0/relnotes.fr.txt Sat Mar 29 12:01:05 2008 +0100 @@ -0,0 +1,218 @@ +SliTaz GNU/Linux 1.0 - Notes de publication Mars 2008 +=============================================================================== + + + * Vue d'ensemble + * Matériel supporté + * Saveurs de LiveCD + * Installation + * Noyau Linux + * Paquets logiciels + * Bureaux graphiques + * Support et documentation + * Sécurité + * De Cooking à Stable + * Les personnes du projets + + +Vue d'ensemble +-------------- +SliTaz GNU/Linux 1.0 a été publiée le 22 mars 2008 après deux ans de travail. +SliTaz est un système libre, complet et communautaire, proposant 448 paquets +logiciels facilement installables via le gestionnaire de paquets Tazpkg. Le +support des LiveCD à saveur est éprouvé et permet de créer facilement une +distribution personnalisé ou de disposer d'un système destiné à une tâche +spécifique telle que le traitement video, le graphisme ou le développement. +Le projet fournit un support technique aux utilisateurs via la liste de +discution et le forum officiel. Le livre de main ou Handbook de SliTaz, +contient les infomations et instructions pour apprendre à utiliser et finement +configurer le système. SliTaz peur s'installer ou se mettre à jour en mode +graphique et en mode texte via un installateur qui se veut simple, intuitif et +rapide. La distribution peut aussi être utilisée depuis un media USB, le +formatage et la configuration d'un périphérique USB peut se faire en quelques +commandes avec TazUSB. + + +Matériel supporté +----------------- +SliTaz GNU/Linux supporte toutes les machines à base processeur dit i486 ou +X86, compatible Intel. Un minimum de 128 MB est conseillé pour utiliser le +corps du LiveCD, 64 Mb pour les saveurs slitaz-loram et 16 Mb avec un peu de +swap pour les saveurs slitaz-loram-cdrom ayant la même séléction de paquets +que le corps. Avec une saveur loram le système est moins réactif mais permet +d'installer SliTaz graphiquement sur de très anciennes machines. Une fois +installée SliTaz fonctionne bien avec un minimum de 16 Mb, mais il faut +oublier Firefox pour naviguer sur le web et utiliser Links par exemple. La +plupart des cartes réseau et cartes son supportées par le noyau sont +présentes, la gestion de l'energie et activée par défaut avec l'ACPI et le +support des batteries de PC portable se fait via les modules ac et battery, +en mode LiveCD l'option laptop permet de charger les modules de gestion +de la batterie au démarrage. + + +Saveurs de LiveCD +----------------- +SliTaz GNU/Linux est distribuée sous la forme d'un LiveCD bootable permettant +d'installer graphiquement le système sur disque dur et permettant d'emporter +le système avec soi afin de retrouver ses applications et documents lors de +déplacements. Le projet distribue une image ISO nommée core, c'est le corps +du système fournissant une séléction de paquets multi-utilisations, permettant +de surfer sur le Web, écouter de la musique, éditer ou extraire des pistes +audio, créer des images, développer, installer rapidement des outils en PHP, +gérer des bases de donées SQL, éditer des images ISO ou encore graver des +CD/DVD. Il suffit d'un clique dans le menu des applications pour trouver les +logiciels installés et classés par catégorie. + +Le corps (core) du LiveCD peut aussi se reconstruire et générer des LiveCD's +à saveur particulières graphiquement ou en ligne de commande (plus puissant). +La manière la plus simple pour créer son propre LiveCD est de démarrer avec +le LiveCD corps, installer les paquets voulus et générer un distribution avec +Tazlito ou d'utiliser une des saveurs disponible sur le miroir. Pour obtenir +une liste des saveurs disponibles, pensez à recharger la liste de temps en +temps avec la commande 'tazlito list-flavors --recharge'. + + +Installation +------------ +L'installation du système est entièrement automatisée et peut se faire en mode +graphique ou mode texte. Si vous voulez installer vos propres saveurs +de LiveCD, il suffit de conserver slitaz-tools dans la liste des paquets de la +saveur en question. Les prérequis matériel et autres informations utiles à +l'installation sur disque dur sont décrites directement dans l'installateur +et dans le Handbook. Si vous désirez partitionner un disque avant installation, +vous pouvez rapidement utiliser Gparted en mode Live. A la fin de +l'installation, il est possible d'installer le gestionnaire de démarrage +(bootloader) GRUB, il est capable de démarrer des systèmes GNU/Linux, BSD ou +Windows. Cela permet d'installer SliTaz sur la même machine qu'un autre système +tout en laissant le choix du système à utiliser au démarrage de la machine. + + +Noyau Linux +----------- +SliTaz GNU/linux 1.0 est distribuée avec le noyau Linux 2.6.24.2, patché pour +supporter la compression LZMA et corriger un problème d'affichage dans la +console virtuelle. Le support des disques IDE et SCSI est intégré ainsi que +celui des systèmes de fichiers ext2 et ext3. La plupart des cartes réseau +ethernet sont supportées soit directement, soit sous forme de modules +chargeables avec 'modprobe'. La capture video quant à elle nécessite les +modules ieee1394, raw1394 et ohci1394. La gestion des modules/drivers des +cartes son se fait avec 'soundconf'. Une liste complète de modules disponibles +peut être obtenue via la commande 'modprobe -l'. La configuration des modules +à charger au démarrage est située dans le fichier /etc/rcS.conf, en mode LiveCD +vous pouvez utiliser l'option modprobe=mod1,mod2 pour charger divers modules. +La configuration du noyau Linux de SliTaz est disponible dans le fichier +compressé /proc/config.gz et dans le dépôt Mercurial du wok. + + +Paquets logiciels +----------------- +La gestion de paquets logiciels se fait avec le gestionnaire de paquets Tazpkg, +simple, intuitif, rapide, stable et proposant un mode interactif. Parmi les +448 paquets disponibles vous trouverez de quoi transformer votre machine en +bureau graphique complet et moderne avec e17, en atelier de graphisme avec +en autre Gimp et Inkscape. SliTaz peut aussi devenir un studio video avec Kino, +une borne internet avec messagerie internet, VOIP et navigateur web. Le système +est aussi conçu pour être un serveur puissant, léger, rapide et stable avec +LightTPD/PHP installés par défaut, le support CGI Perl ou Python, Rsync pour +les sauvegardes incrémentales et IPtables pour le par-feu. SliTaz peut bien sûr +fournir un système de développement complet avec entre autre le compilateur +GCC 4.2.2, Mercurial, l'IDE Geany et tous les paquets de développement des +librairies. Les paquets peuvent être trouvés via la fonction de rechercher de +Tazpkg ou via l'interface du site Web: http://www.slitaz.org/packages/ + +Les paquets binaires du miroir peuvent être recompilés en utilisant le wok +et Tazwok pour cuire, toutes la documentation développeur est contenue dans +le livre de cuisine ou Cookbook de SliTaz toujours accessible depuis le site +Web du projet. + + +Bureaux graphiques +------------------ +Le bureau fourni par défaut avec le coeur du LiveCD est propulsé par JWM, un +gestionnaire de fenêtres très léger et stable, l'intégration de la barre des +tâches nommée LXpanel permet d'avoir un menu généré dynamiquement en fonction +des standards de Freedesktop. Le principe du bureau est d'avoir un petit menu +via un clique sur l'écran avec des favoris, les effets graphiques, les outils +SliTaz pour LiveCD ou LiveUSB, tout ce qui concerne la configuration de JWM +et les actions système. Les applications sont elles, disponibles via le menu +des applications généré par LXpanel. + +Via le support des saveurs de LiveCD ou sur un système installé, vous avez +la possibilité d'installer l'environnement de bureau Enlightenment (e17) et +le gestionnaire de fenêtres Openbox. Les différentes sessions peuvent être +séléctionnées via la touche F1 du gestionnaire de connexion Slim, pour +modifier la session par défaut vous pouvez utiliser l'utilitaire 'tazx' ou +éditer à la main votre fichier ~/.xinitrc personnel. + + +Support et documentation +------------------------ +Le projet SliTaz propose divers moyens de support et d'aide aux utilisateurs +du système, à commencer par la liste de discussion ou Mailing List, le forum +et le canal IRC. La documentation utilisateur est contenue dans le livre de +main ou Hanbook. Il contient beaucoup d'informations permettant de configurer +SliTaz dans les moindres détails. Le livre est lisible depuis le site web du +projet. Les manuels des différents outils sont installés sur le système et +accessibles depuis le menu Documentation. Ils décrivent toutes les commandes +possibles avec l'outil en question. Au niveau dévelopeur, la construction +du système ou l'utilisation du wok et des recettes sont soigeusement décrites +dans le livre de cuisine ou Cookbook. Les livres, manuels et notes de +publication sont en ligne: http://www.sitaz.org/doc/ + + +Sécurité +-------- +La version stable bénéficie de mise à jour de sécurité, il est important de +penser à recharger et mettre à jour les paquets régulièrement. Au niveau du +réseau le par-feu est assuré pas IPtables, le serveur LightTPD supporte les +authentifications par mots de passe cryptés et Dropbear fournit un client et un +serveur SSH sécurisé. Les mots de passe des utilisateurs du système sont aussi +cryptés et seul l'administarteur root peut modifier les fichiers système. Pour +plus d'informations ou apprendre à configurer le par-feu, vous pouvez vous +référer au Handbook. Les paquets en rapport à la sécurité sont classés dans +la catégorie: security. + + +De Cooking à Stable +------------------- +L'installateur de SliTaz GNU/Linux propose une fonction de mise à jour système +permettant de passer un système en cuission (Cooking) en version stable. Pour +mettre à jour un système il vous faut démarrer sur le LiveCD stable, lancer +l'installateur en appuyant sur Upgrade et spécifier ensuite la partition +contenant le système à mettre à jour. L'installateur va nettoyer le système et +réinstaller tous les paquets non présents sur le cdrom depuis le miroir. Une +fois terminé, vous pourrez redémarrer sur votre nouvelle version de SliTaz. +A noter que cette methode peut aussi servir à refaire une installation propre +du système tout en retrouvant la séléction des paquets précédemment installés. + +A noter que l'installateur va conserver un copie des listes de paquets et une +archive complète du répertoire des fichiers de configuration /etc (etc.tar.gz) +dans: /var/lib/slitaz-installer + + +Les personnes du projet +----------------------- +SliTaz est fier d'être un projet communautaire et international, les personnes +du projet sont celles qui développent la distribution, s'occupent du site Web +corrigent les logiciels sur les dépôts Hg ou écrivent de la documentation +officielle. En passant par la Suisse, la France, le Quebec, l'Algérie et +l'Angleterre: + + Christophe Lincoln + Pascal Bellard + Eric Joseph-Alexandre + Julien Rabier + Paul Issot + Andrew Miller + Serge Daigle + Gauthier Bar + Gwenhaël Goavec-Merou + Mohamed Jabara + Didier Bretin + +Le projet tient encore à remercier tous les relecteurs, testeurs, hackers +et utilisateurs ayant pris du temps pour faire avancer la distribution. + + +=============================================================================== +