# HG changeset patch # User Christophe Lincoln # Date 1233958620 -3600 # Node ID 44735ed858290e41bf913e50f28d957ca23bf9af # Parent 682988d4d77f495d9a41a560e4d14cc9405227ad fr: copy current handbook pages to handbook-stable diff -r 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/book.css --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/book.css Fri Feb 06 23:17:00 2009 +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 information */ + +#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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/chroot-env.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/chroot-env.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/cmdline.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/cmdline.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/development.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/development.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/enlightenment.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/enlightenment.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/favicon.ico Binary file doc/handbook-stable/handbook/favicon.ico has changed diff -r 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/gen-livecd.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/gen-livecd.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/graphics.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/graphics.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/hacking-livecd.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/hacking-livecd.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/images/css/content-tl.png Binary file doc/handbook-stable/handbook/images/css/content-tl.png has changed diff -r 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/images/css/content-tr.png Binary file doc/handbook-stable/handbook/images/css/content-tr.png has changed diff -r 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/images/css/footer-bl.png Binary file doc/handbook-stable/handbook/images/css/footer-bl.png has changed diff -r 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/images/css/footer-br.png Binary file doc/handbook-stable/handbook/images/css/footer-br.png has changed diff -r 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/images/css/header.png Binary file doc/handbook-stable/handbook/images/css/header.png has changed diff -r 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/index.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/index.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/install.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/install.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/jwm.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/jwm.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/livecd.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/livecd.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/liveusb.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/liveusb.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/multimedia.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/multimedia.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/network-config.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/network-config.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/network.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/network.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/office.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/office.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/packages.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/packages.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/secure-shell.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/secure-shell.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/security.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/security.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/system-admin.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/system-admin.html Fri Feb 06 23:17:00 2009 +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.greyware.com
+
+

+Pour se synchroniser avec un serveur de temps, il faut être root : +

+
+ # rdate -s tick.greyware.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 © 2008 SliTaz - + GNU General Public License;
+ Documentation publiées sous + GNU Free Documentation License + et codée en xHTML 1.0 valide. +
+ + + diff -r 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/system-tools.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/system-tools.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/template.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/template.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/utilities.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/utilities.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/web-server.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/web-server.html Fri Feb 06 23:17:00 2009 +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 682988d4d77f -r 44735ed85829 doc/handbook-stable/handbook/x-window.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/handbook-stable/handbook/x-window.html Fri Feb 06 23:17:00 2009 +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. +
+ + +