Pour aller plus loin avec la ligne de commande

La première question est probablement de savoir ce que vous désirez faire. Supposons que vous cherchiez à visualiser le contenu de votre répertoire de travail. Malheureusement, vous ne connaissez pas la commande qui permet de le faire. Un outil permet de faire une recherche parmi les commandes disponibles : apropos.

Son utilisation est des plus simples. Tapez simplement apropos suivi d'un mot-clé (en anglais) définissant au mieux votre requête. Pour notre exemple, nous cherchons à visualiser le contenu de notre répertoire de travail (en anglais : to display working directory content). Essayons :

$ apropos display
$

Cette commande devrait faire apparaître un grand nombre (155 sur mon système) de lignes ressemblant probablement à(112) :

bell (n)             - Ring a display's bell
bitmap (n)           - Images that display two colors
cal (1)              - displays a calendar
ckalloc, memory, ckfree, Tcl_DisplayMemory,
Tcl_InitMemory, Tcl_ValidateAllMemory (n)
                     - Validated memory allocation interface.

Si vous aussi, vous prétendez être un informaticien plein de qualités,(113) vous ne lirez pas (sauf peut-être en dernier recours) ces 75 lignes. Le mot-clé display n'était probablement pas suffisamment significatif. Essayons autre chose :

$ apropos working
cd (n)              - Change working directory
chdir, fchdir (2)   - change working directory
getcwd (3)          - Get current working directory
pwd (1)             - print name of current/working directory
pwd (n)             - Return the current working directory
rcsclean (1)        - clean up working files
$

Nous obtenons moins d'informations, mais malheureusement pas celle qui nous intéresse(114). Essayons encore :

$ apropos content
dir (1)             - list directory contents
gl_copyscreen (3)   - copy the screen contents of contexts
ls (1)              - list directory contents
perltoc (1)         - perl documentation table of contents
pick (1)            - search for messages by content
pair_content (3x)   - curses color manipulation routines
stat (1)            - print inode contents
vdir (1)            - list directory contents
vga_dumpregs (3)    - dump the contents of the SVGA registers
xev (1x)            - print contents of X events
$

Il semble que la commande recherchée soit dir ou ls ou vdir. Essayons l'une d'entre elles :

$ ls
2Hypergraphes  Impression  Microsoft   Sarah       games
Admin          LaTeX       Mygale      Transfert   local
Archives       Logo        NT          Web         nsmail
Arkeia         Mac         Netscape    archive     test
ConfigNT       Mail        Oueb        bin         tmp
$

… et nous avons donc bien obtenu le contenu du répertoire courant. En conclusion, apropos peut être considéré comme un « moteur de recherche » sur le rôle des commandes disponibles.

Il arrive parfois d'oublier ce que peut faire une commande. Supposons que l'on vous ait parlé de la commande find en vous disant qu'elle était fabuleuse. La commande whatis devrait vous éclairer.

$ whatis find
find (1) - search for files in a directory hierarchy
$

Notez que whatis ne sait pas nécessairement de quoi vous lui causez :

$ whatis trouver
trouver: nothing appropriate
$

whatis permet donc d'obtenir une information succincte sur le rôle d'une commande shell.

Les pages de manuel ont cette propriété d'avoir une structure assez fixe. Détaillons quelques-unes de ses principales entrées :

• Name qui définit en une ligne ce que fait la commande. C'est d'ailleurs cette ligne qui est affichée par whatis. Il s'agit de la seule partie requise pour faire d'une page de documentation quelconque une manpage ;
• Synopsis qui précise la forme d'appel de la commande. Le synopsis précise de plus toutes les options qu'il est possible de passer à la commande et ses arguments éventuels ;
• Description qui décrit effectivement l'action de la commande, précise le rôle de chaque argument ;
• Options précise le rôle de chaque option (vous vous en doutiez, non ?);
• See Also vous donne quelques commandes qui ont une action similaire à la commande dont vous avez la page de manuel sous les yeux et parfois les commandes utilisées par la commande.

Parfois on trouve également en fin de page, des exemples et les bogues connus du programme documenté.

Vous aurez constaté que la page de manuel de find commence en fait non pas par NAME, mais en fait par un nébuleux FIND(1). Les pages de manuel sont souvent hiérarchisées en douze sections numérotées de 1 à 9, n, o et l. Décrivons succinctement cette hiérarchie.

1. commandes de l'utilisateur pouvant être lancées par n'importe qui ;
2. appels système (fonctions fournies par le noyau) ;
3. fonctions propres à certaines bibliothèques (C, X windows, etc.) ;
4. ports et périphériques (c'est-à-dire les fichiers de /dev) ;
5. descriptions de formats de fichier de configuration ;
6. jeux ;
7. divers (essentiellement des conventions) ;
8. outils d'administration système ;
9. routines des noyaux (propre à LINUX).

Les sections suivantes ont vraisemblablement été abandonnées, mais peuvent être toutefois présentes sur de « vieux » systèmes :

• n ce qu'il y a de nouveau. Les documentations résidant dans cette partie se doivent d'être déplacées au bout d'un certain temps dans la section appropriée ;
• o vieilles documentations condamnées à la disparition ;
• l documentation locale propre à un système, un site.

Notons qu'il n'est pas conseillé d'utiliser les trois dernières sections et que ces dernières ont de plus en plus tendance à disparaître (sur le système où ces lignes sont écrites, seule subsiste la section n(115)).

Il peut arriver qu'un mot donné corresponde à des pages de manuel de différentes sections. Par exemple, vous cherchez une information sur la fonction C printf :

$ apropos printf
format (n) - Format a string in the style of sprintf
gl_printf (3) - write formatted output in graphic mode
printf (1) - format and print data
sprintf, printf,(3) - formatted output conversion
printftest (6) - tests the vgagl gl_printf function
snprintf, vsnprintf (3) - formatted output conversion
$

Si vous vous contentez d'un man printf, à votre grand désarroi, vous ne pourrez visualiser que la page de documentation correspondant à la section 1. Comment spécifier à man d'aller regarder dans la section 3 ? Facile : essayez un man 3 printf et réjouissez-vous :

$ man 3 printf
PRINTF(3) Linux Programmer's Manual PRINTF(3)
NAME
printf, fprintf, sprintf, snprintf, vprintf, vfprintf,
vsprintf, vsnprintf - formatted output conversion
SYNOPSIS
#include <stdio.h>
...
$

Bien entendu, il est nécessaire d'interroger une section dans laquelle existe la page de documentation. Il y a fort à parier qu'un man 2 printf vous rétorque narquoisement qu'il n'y a pas d'entrée pour printf dans la section 2 du manuel. 

Le plus rageant avec l'utilisation de man est d'obtenir un insoutenable No manual entry for (le nom de la commande). Par exemple, un man xv produit No manual entry for xv. La première idée qui peut vous venir à l'esprit est qu'il n'existe pas de documentation pour cet outil qu'est xv. C'est possible, mais regardons de plus près une certaine variable d'environnement dénommée MANPATH.

$ echo $MANPATH
/usr/share/man:/usr/local/man
$

Cette variable a le même format que PATHEnvironnement de développement et indique à la commande man les endroits où rechercher les pages de manuel. Dans l'exemple précédent, man ira donc dans /usr/share/man puis (en cas d'échec) dans /usr/local/man pour tenter de trouver l'information qui vous intéresse. Aucune page n'étant associée à xv, man vous le signifie poliment. Il suffit de rajouter un nouveau répertoire de recherche (/usr/X11R6/man sous Linux) à la variable MANPATH pour voir apparaître la page de documentation.

$ export MANPATH=$MANPATH:/usr/X11R6/man
$ man xv
XV(1) XV(1)
NAME
xv - interactive image display for the X Window System
... etc ...
$

Cette variable devrait être a priori « correctement » configurée pour aller visiter les points de chute classiques des pages de manuel, c'est-à-dire (cette liste ne se veut en aucun cas exhaustive) /usr/share/man, /usr/local/man et /usr/X11R6/man.

Dans le cas où vous souhaiteriez installer certaines pages de manuel à certains endroits précis de votre compte utilisateur, vous pouvez utiliser la même démarche et ajouter dans vos fichiersSauvegarder ses configurations grâce aux fichiers de démarrage de démarrage :

export MANPATH=$HOME/man:$MANPATH

de manière à ajouter vos pages de manuels aux pages traitées par la commande man.

Il peut arriver qu'en désespoir de cause, vous désiriez effectuer une recherche exhaustive d'un mot donné dans l'ensemble des pages de manuel. Si vous choisissez de prendre ce risque, sachez que c'est possible, mais qu'il y a de grandes chances que cela prenne un certain temps(116).

Pour toutes les subtilités concernant votre version locale de man, vous n'avez finalement qu'une seule commande à connaître : man man. La boucle est donc bouclée. 

La première source d'informations du point de vue de sa richesse, mais aussi de son « bruit » est sans doute les groupes ou forums de discussion (newsgroups). Apprenez en effet que si vous vous posez une question donnée, la probabilité pour que quelqu'un se la soit déjà posée et surtout ait la réponse, est extrêmement grande.

Les news constituent un vaste panneau d'affichage que tout le monde peut consulter, sur lequel on peut poser des messages à certaines conditions ; ce vaste panneau est séparé en thèmes (group) hiérarchisés. Parmi les milliers de thématiques abordées, on trouve quelques groupes autour d'unix. Ces groupes font partie de la hiérarchie comp.os pour les groupes traitant de l'informatique (computer) et plus précisément des systèmes d'exploitation (operating system), ou de son pendant francophone fr.comp.os. On trouvera parmi ces groupes :

• fr.comp.os.unix : discussion autour d'unix ;
• fr.comp.os.linux.annonces : les annonces concernant les nouvelles versions ou les rencontres entre utilisateurs ;
• fr.comp.os.linux.moderated : groupe modéré sur l'utilisation de LINUX ;
• …

On pourra également lire les groupes comp.os.linux.* de la hiérarchie anglophone.

Il est important de comprendre que ces groupes suivent quelques règles d'usage dont l'ignorance peut vous faire envoyer plus ou moins poliment sur les roses :

• on veillera à respecter la nétiquette(120) dans le cadre de la communication « de un à plusieurs » ;
• on testera son logiciel de news sur un groupe comme fr.test et non sur le groupe sur lequel on a l'intention de poster ;
• on veillera à lire attentivement « toutes » les documentations disponibles (notamment les FaqLes foires aux questions) avant de poser une question dont la réponse se trouve dans une dizaine de manuels, au risque d'obtenir une réponse du genre : man softquejarrivepasàfairemarcher ou RTFM (qui signifie dans sa version polie : read the fantastic manual) ;
• il faudra lire les archives des mois précédents pour éviter de poser une question posée la veille ; une bonne source d'information pour rechercher dans les archives est le site http://groups.google.com qui fonctionne comme un moteur de recherche ;
• on tentera de trouver la charte du groupe si elle existe et la lire ;
• certains groupes sont modérés, c'est-à-dire qu'un groupe de personnes filtre votre message avant de le poster sur le groupe. Le filtrage a pour but de vérifier l'adéquation du contenu avec le thème du groupe. Par conséquent votre message n'apparaîtra pas immédiatement sur le groupe, inutile donc de le reposter !

Le mieux est sans doute de se renseigner précisément sur l'usage des news en consultant des documents destinés aux nouveaux utilisateurs, par exemple http://UsenetFR.free.fr/BU.htm. 

Les listes de diffusion (ou mailing lists) ont un caractère plus confidentiel puisqu'il faut explicitement s'abonner auprès d'un serveur pour recevoir les messages traitant d'un thème donné. Lorsqu'on envoie un message à la liste, tous les adhérents le reçoivent également ; le principe est donc différent du fonctionnement des news.

On pourra trouver des listes de discussions traitant de points particuliers de LINUX par exemple :

• linux-8086 - for the 8086 systems
• linux-admin
• linux-kernel - General kernel discussion
• linux-kernel-announce
• linux-sound
• …

plus de soixante listes référencées sur http://www.linux.org/docs/lists.html.

Pour s'abonner, il faut envoyer un mail poli au gentil robot qui manage tout ça à : majordomo@vger.kernel.org. Le corps du message doit contenir le mot subscribe (s'abonner) suivi du nom de la liste. Sans s'abonner on pourra consulter les archives des messages, par exemple sur :

• http://www.tux.org/hypermail
• http://news.gmane.org  

La majorité des logiciels suivant le modèle open source dispose d'une page web dite home page. Sur cette page se trouvent une description du logiciel, des documentations pour l'utiliser et/ou l'installer, et la dernière version à télécharger. Outre les moteurs de recherche généraux, on pourra consulter :

• http://freecode.com/ : donnant des infos quotidiennes sur les nouveaux projets et disposant d'un moteur de recherche ;
• http://sourceforge.net/ : hébergeant plusieurs projets de logiciels libres, dispose également d'un outil de recherche.

Le terme Faq pour frequently asked question est parfois traduit par « foire(121) aux questions ». Certaines personnes collectent donc les questions fréquemment posées par les « p'tits nouveaux » et les « Grands Anciens » et, de ce fait, les réponses fréquemment données pour écrire des compendiums extrêmement riches en informations, astuces et autres indices pour le débutant (et le confirmé aussi parfois). Une recherche sur le Ouèbe avec votre moteur de recherche préféré avec votre question et le mot-clé Faq pourrait vous permettre d'atteindre le nirvana assez rapidement. Vous trouverez sur les sites :

• http://www.linuxdoc.org/FAQ/Linux-FAQ/index.html
• http://www.linuxdoc.org/FAQ/

la Faq officielle de LINUX et celles de quelques-uns des logiciels connexes.  

Même s'il s'agit de documents très techniques, il peut être utile de connaître l'existence des RFC (request for comments). Ces documents maintenus par l'IETF (Internet Engineering Task Force(122)) décrivent les standards utilisés sur le réseau Internet. Chacun de ces documents est identifié par un numéro et passe de l'état de brouillon (draft) à l'état de standard après un processus de correction. On retrouvera parmi les RFC la description des protocoles réseau que nous utilisons quotidiennement (HTTP, SMTP pour le mail, etc.).