Hornetpathmanquest

Exercice · shell

Lis le manuel avant de taper

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.

Ce qu'est man, l'anatomie d'une page, les sections, les touches. À garder sous la main.

Mémo

Le manuel, en une page

C'est quoi ?

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.

Pourquoi je m'en sers ?

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.

Et quand ça casse ?

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

RubriqueCe qu'on y trouve
NOMle nom, un tiret, une phrase. C'est ce que fouille man -k.
SYNOPSISla forme exacte de la commande. Les crochets entourent le facultatif, les points de suspension signifient « répétable ».
DESCRIPTIONle comportement, en prose. La partie qu'on saute et qu'il faut lire.
OPTIONSchaque drapeau, sa forme courte et sa forme longue.
ETAT DE SORTIEles codes de retour. Indispensable dès qu'on scripte.
EXEMPLESrarement présente, toujours précieuse.
VOIR AUSSIles pages voisines. C'est le fil qu'on tire quand on est perdu.
SectionContenu
1commandes et programmes
2appels système
3fonctions de bibliothèque
4fichiers spéciaux de /dev
5formats de fichier
6jeux
7divers, conventions
8administration système
Espace écran suivant b écran précédent / chercher n occurrence suivante g G début et fin q quitter

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.

manquest — bash 11 pages

Les douze missions

Chaque bonne réponse libère un fragment du flag. Les réponses sont vérifiées dans ton navigateur, rien ne part ailleurs.

0 / 12 résolues
Mission 01 Ouvrir Manipulation

Ta première page

Ouvre ta toute première page de manuel : celle de ls. Tu y trouveras la rubrique NOM (le nom, un tiret, une description d'une ligne), puis SYNOPSIS, puis DESCRIPTION. C'est le plan de toutes les pages que tu liras ensuite.

Mission 02 Ouvrir Lecture

Toujours le même plan

Une page suit toujours la même trame : NOM, SYNOPSIS, DESCRIPTION, puis les autres. Ouvre man man et repère les titres en capitales. Lequel vient juste après DESCRIPTION et détaille les drapeaux ?

Mission 03 Ouvrir Lecture

Le manuel est numéroté

Toujours dans man man, la DESCRIPTION liste les sections du manuel. Laquelle documente les formats de fichier, celle où vit /etc/passwd ?

Mission 04 Viser Manipulation

Le même nom, deux pages

printf est une commande du shell (section 1) et une fonction C (section 3). man printf s'arrête à la première. Affiche la page de la fonction C dans le bac à sable, puis valide.

Mission 05 Viser Lecture

Ce que dit le SYNOPSIS

Tu as la page de printf(3) sous les yeux. Son SYNOPSIS indique le fichier d'en-tête à inclure pour utiliser cette fonction. Lequel ?

Mission 06 Viser Manipulation

Toutes les pages d'un nom

Une option enchaîne toutes les sections d'un même nom au lieu de s'arrêter à la première. Trouve-la dans OPTIONS, puis affiche d'un coup les deux pages nommées hornet.

Mission 07 Chercher Manipulation

Chercher sans connaître le nom

Tu cherches une page qui parle de « ruche », mais tu ne connais aucun nom de commande. Une option fouille les descriptions courtes de toutes les pages installées. Lance cette recherche sur le mot ruche.

Mission 08 Chercher Manipulation

Une page est un fichier

Une page n'est pas magique : c'est un fichier compressé posé sur le disque. Une option de man affiche son chemin au lieu de l'ouvrir. Trouve-la dans OPTIONS, puis applique-la à passwd. Regarde le répertoire de section et l'extension.

Mission 09 Lire Lecture

La bonne page, pas la première

man hornet ouvre la section 1, qui ne documente aucun environnement. Va lire l'autre page, rubrique ENVIRONNEMENT : quelle est la valeur d'usine de HORNET_PASS ?

Mission 10 Lire Lecture

Ce que la page dit d'elle-même

Même rubrique : elle commente ce mot de passe par défaut. « Un mot de passe publié dans une page de manuel n'est pas un secret, c'est ... ». Complète, trois mots.

Mission 11 Dépanner Manipulation

nothing appropriate

Sur une machine fraîche, la recherche par mot-clé répond nothing appropriate alors que les pages existent : l'index des descriptions n'a jamais été construit. La commande qui le reconstruit vit en section 8. Ouvre sa page.

Mission 12 Dépanner Manipulation

La page qui n'existe pas

Tu sais que deux pages parlent de ruche, tu les as trouvées en mission 7. Mais aucune page ne s'appelle ruche. Demande-la quand même et lis le refus : c'est le message que tu verras le plus souvent, et il ne veut pas dire que le sujet n'existe pas.

Le flag

Douze fragments, une phrase

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