Exercice · shell
Douze missions, un bac à sable man qui répond pour de vrai, et un flag
à reconstituer fragment par fragment. Aucune commande à copier : il n'y a que des
pages à lire.
man est le manuel installé sur la machine. Chaque commande, chaque
format de fichier et chaque fonction C y a sa page, écrite par ceux qui ont
écrit le programme. C'est de la documentation hors ligne, versionnée avec le
logiciel lui-même.
Parce qu'un tutoriel trouvé en ligne parle d'une version, d'une distribution et d'une date qui ne sont pas les tiennes. La page de manuel de ta machine décrit ta machine. Elle est toujours à jour et toujours disponible, même sans réseau.
Trois échecs classiques : Aucune entrée de manuel quand la page
n'est pas installée, nothing appropriate quand l'index n'a jamais été
construit, et la mauvaise page affichée quand deux sections portent le même nom.
Les missions 11 et 12 portent exactement là-dessus.
Anatomie d'une page
| Rubrique | Ce qu'on y trouve |
|---|---|
NOM | le nom, un tiret, une phrase. C'est ce que fouille man -k. |
SYNOPSIS | la forme exacte de la commande. Les crochets entourent le facultatif, les points de suspension signifient « répétable ». |
DESCRIPTION | le comportement, en prose. La partie qu'on saute et qu'il faut lire. |
OPTIONS | chaque drapeau, sa forme courte et sa forme longue. |
ETAT DE SORTIE | les codes de retour. Indispensable dès qu'on scripte. |
EXEMPLES | rarement présente, toujours précieuse. |
VOIR AUSSI | les pages voisines. C'est le fil qu'on tire quand on est perdu. |
| Section | Contenu |
|---|---|
| 1 | commandes et programmes |
| 2 | appels système |
| 3 | fonctions de bibliothèque |
| 4 | fichiers spéciaux de /dev |
| 5 | formats de fichier |
| 6 | jeux |
| 7 | divers, conventions |
| 8 | administration système |
Sur une vraie machine, man passe la page à less : ces touches sont celles de less, pas celles de man. Le bac à sable ci-dessous affiche les pages d'un bloc, sans pagination.
Le bac à sable
Un vrai man miniature. Onze pages, huit commandes reconnues. Commence par help.
Les douze missions
Ouvre la page de ls avec man ls. Tout en haut, la rubrique NOM tient sur une ligne : le nom, un tiret, puis la description courte. Recopie cette description, sans le nom ni le tiret.
La toute première ligne sous NOM, après le tiret.
Fragment 1 sur 12
Une page de manuel suit toujours la même trame : NOM, SYNOPSIS, DESCRIPTION, puis les autres. Ouvre man man et regarde les titres en capitales. Quelle rubrique vient juste après DESCRIPTION et liste les options ?
Les titres de rubrique sont en capitales, collés à la marge gauche.
Fragment 2 sur 12
Toujours dans man man, la DESCRIPTION contient une liste numérotée : ce sont les sections du manuel. Quelle section documente les formats de fichier, celle où vit /etc/passwd ? Réponds par le numéro seul.
Cherche dans la liste la ligne qui cite /etc/passwd.
Fragment 3 sur 12
printf est à la fois une commande du shell (section 1) et une fonction du langage C (section 3). man printf s'arrête à la première trouvée. Ouvre la page de la fonction C et lis son SYNOPSIS : quel fichier d'en-tête faut-il inclure ?
Le numéro de section se place avant le nom : man 3 printf. La réponse est entre chevrons.
Fragment 4 sur 12
Quand un nom existe dans plusieurs sections, une option les enchaîne toutes au lieu de s'arrêter à la première. Trouve-la dans la rubrique OPTIONS de man man, puis applique-la à hornet. Combien de pages portent ce nom ?
C'est l'option qui signifie « all ». Compte les pages affichées.
Fragment 5 sur 12
Parfois on veut seulement savoir à quoi sert une commande, sans ouvrir toute sa page. Une commande dédiée donne cette unique ligne. Utilise-la sur mandb : que dit sa description courte ?
whatis mandb, ou man -f mandb. Recopie ce qui suit le tiret.
Fragment 6 sur 12
Tu cherches une page qui parle de « ruche », mais tu ne connais aucun nom de commande. Trouve dans OPTIONS l'option qui fouille les descriptions courtes de toutes les pages, puis lance-la sur le mot ruche. Combien de pages ressortent ?
C'est l'équivalent de la commande apropos. Compte les lignes.
Fragment 7 sur 12
Une page de manuel n'est pas magique : c'est un fichier sur le disque. Une option de man affiche son chemin sans l'ouvrir. Utilise-la sur passwd. Les chemins se terminent tous par la même extension, celle qui dit que le fichier est compressé. Laquelle ?
man -w passwd. Regarde la toute fin des chemins affichés.
Fragment 8 sur 12
man hornet ouvre la section 1, qui ne documente aucun environnement. Va lire l'autre page et sa rubrique ENVIRONNEMENT : quelle est la valeur d'usine de HORNET_PASS ?
Nomme la section : man 7 hornet.
Fragment 9 sur 12
Toujours dans man 7 hornet, la même rubrique explique pourquoi un mot de passe par défaut publié dans un manuel pose problème. Elle écrit : « n'est pas un secret, c'est ... ». Recopie les trois mots qui terminent la phrase.
Juste sous la valeur d'usine, le paragraphe qui commente.
Fragment 10 sur 12
Sur une machine fraîchement installée, la recherche par mot-clé répond nothing appropriate alors que les pages existent : l'index des descriptions n'a jamais été construit. Ouvre man 8 mandb : quel fichier d'index cette commande produit-elle dans chaque répertoire de section ?
Rubrique DESCRIPTION ou FICHIERS. Le nom seul, sans chemin.
Fragment 11 sur 12
Demande man ruche. Aucune page ne porte ce nom exact, et le manuel te le dit franchement, alors que deux pages parlent pourtant de ruche. Recopie les trois premiers mots du message d'erreur.
Lis le message tel qu'il s'affiche. Il commence par « Aucune ».
Fragment 12 sur 12
Le flag
Aucun fragment récupéré. Chaque mission résolue en libère un morceau, dans l'ordre.
Hornetpath · ManQuest · la règle d'or : comprendre avant de taper