Aide sous Linux
Il est essentiel de trouver de l’aide sous Linux grâce aux pages Manuel, aux fichiers sources et README mais aussi à travers des ressources en ligne.
1. Commandes less et more
less
est une commande Unix permettant de visualiser un fichier texte page par page (sans le modifier). Sa fonction est similaire à la commande more
, mais permet en plus de revenir en arrière ou de rechercher une chaîne. Contrairement à vi
(qui permet aussi de visualiser des fichiers), less
n’a pas besoin de charger entièrement le fichier en mémoire et s’ouvre donc très rapidement même pour consulter de gros fichiers.
Raccourcis dans less
:
-
h
ouhelp
pour l’aide -
/
suivi d’une occurrence pour effectuer une recherche - Barre d’espace : pour avancer d’une page
Exemples :
more /var/log/dmesg
2. Commande man
man
est une commande Unix. Elle permet de visionner le manuel d’une commande du shell. Elle utilise la commande less
. Les raccourcis de navigation sont donc identiques.
Chaque page de manuel fait partie d’une section :
- -1. Commandes utilisateur
- -2 Appels système
- -3 Fonctions de bibliothèque
- -4 Fichiers spéciaux
- -5 Formats de fichier
- -6 Jeux
- -7 Divers
- -8 Administration système
- -9 Interface du noyau Linux
Chaque section possède une page d’introduction qui présente la section, disponible en tapant man <section> intro
.
Pour installer les pages de manuel en français : sudo yum install man-pages-fr
.
3. Appel d’une page manuel
Pour appeler une page de manuel, tout simplement :
man [-s<section>] <nom_de_commande>
Par exemple :
man man
man ls
man 5 passwd
4. Recherche d’une page manuel man -f ou whatis
Une page de manuel peut avoir le même nom et faire partie d’une section différente (la portée de la page est différente). Par exemple :
man -f passwd
affiche ce résultat :
passwd (1) - Modifier le mot de passe d’un utilisateur
passwd (5) - fichier des mots de passe
passwd (1ssl) - compute password hashes
L’option man -f passwd
permet d’effectuer une recherche sur le nom des pages man. La commande whatis passwd
aurait eu le même effet.
5. Contenu d’une page manuel
En en-tête de la page man on trouve le nom de la commande suivie d’un numéro entre parenthèses. Il s’agit du numéro de section.
Une page est composée habituellement de plusieurs sections (au sens interne de la page) :
NOM, SYNOPSIS, CONFIGURATION, DESCRIPTION, OPTIONS, CODE DE RETOUR, VALEUR RENVOYÉE, ERREURS, ENVIRONNEMENT, FICHIERS, VERSIONS, CONFORMITÉ, NOTES, BOGUES, EXEMPLE, AUTEURS et VOIR AUSSI.
Le SYNOPSIS indique brièvement l’interface de la commande ou de la fonction. Pour les commandes, ce paragraphe montre sa syntaxe et ses arguments. Les caractères gras marquent le texte invariable et l’italique indique les arguments remplaçables. Les crochets encadrent les arguments optionnels, les barres verticales (caractère pipe) séparent les alternatives, et les ellipses … signalent les répétitions.
La DESCRIPTION fournit une explication sur ce que la commande, la fonction ou le format représente. Décrit les interactions avec les fichiers et l’entrée standard, ou ce qui est produit sur la sortie standard ou d’erreur. Ne contient pas les détails d’implémentation internes, sauf s’ils sont critique pour comprendre l’interface. Décrit le cas principal, pour les détails sur les options, on utilise le paragraphe OPTIONS.
6. Se déplacer dans une page manuel
Pour se déplacer dans une page manuel, on utilise les raccourcis de less
:
-
G
pour arriver à la fin du document -
gg
pour revenir au début du document -
/motif
pour rechercher lemotif
dans la page
7. Commandes man -k ou apropos
Recherche la description courte et le nom des pages de manuel comportant le mot-clé, utilisé comme une expression rationnelle, puis affiche tout ce qui a été trouvé.
man -k password
La commande apropos
donne l’équivalent :
apropos password
La commande whatis -r
donne également le même résultat.
Man utilise une base donnée pour consulter les descriptions des pages. En cas de pages ou de logiciels ajoutés, il est indiqué de mettre à jour la base de données mandb
:
mandb
8. Commande info
La commande info
a d’abord été fourni avec le paquet Texinfo de GNU en alternative plus exhaustive et documentée que les pages de manuel UNIX et a été porté par la suite sur d’autres systèmes de type Unix.
info info
9. Autres ressources
On peut aussi trouver de l’aide autrement sur un système Linux :
- Option :
-h
ou--help
d’une commande :man --help
- Les fichiers
README
des sources, - dans le dossier
/usr/share/doc
.
10. Manuels et wikis des distributions
- Centos : https://wiki.centos.org/fr
- Ubuntu : https://wiki.ubuntu.com/, https://doc.ubuntu-fr.org/wiki
- ArchLinux : https://wiki.archlinux.fr/, https://wiki.archlinux.org/index.php/Main_page
- Gentoo : https://wiki.gentoo.org/wiki/Main_Page
- OpenWRT : https://wiki.openwrt.org/fr/start