Comment trouver et utiliser la documentation sur les systèmes Unix / Linux

À l'heure actuelle, nous pouvons obtenir n'importe quel type de manuel ou de documentation via Internet, mais dans de nombreux cas, les administrateurs n'auront pas d'interface graphique ni même de connexion Internet, ils devront recourir aux ressources locales que le système leur offre. Dans ce sens Linux Ils proposent une immense documentation de commandes, fichiers de configuration, ou bibliothèques en plusieurs langues, il est de notre devoir de savoir chercher et lire quels outils comme la commande help nous proposent, HOMME et INFO.
Utilisation de la commande Aide.
C'est la première ligne d'aide incluse dans les commandes, elles offrent un guide intuitif et basique directement sur le terminal, cette aide est appelée avec l'option --aider. Une sortie commune de cette option est :

 utilisateur @ jcarrillo : ~ $ sed --help

 Utilisation : sed [OPTION]… {script-only-if-no-other-script} [fichier-d'entrée]… -n, --quiet, --silent supprime l'impression automatique de l'espace de motif -e script, --expression = script ajoute le script aux commandes à exécuter -f script-file, --file = script-file ajoute le contenu de script-file aux commandes à exécuter -i [SUFFIX], --in-place [= SUFFIX ] édite les fichiers en place (fait une sauvegarde si l'extension est fournie) -l N, --line-length = N spécifie la longueur de ligne désirée pour la commande `l ' --posix désactive toutes les extensions GNU. -r, --regexp-extended utilisent des expressions régulières étendues dans le script. -s, --separate considère les fichiers comme séparés plutôt que comme un seul long flux continu. -u, --unbuffered charge des quantités minimales de données à partir des fichiers d'entrée et vide les tampons de sortie plus souvent --help affiche cette aide et quitte --version affiche les informations de version et quitte Si non -e, --expression, -f, ou l'option --file est donnée, alors le premier argument non optionnel est pris comme script sed à interpréter. Tous les arguments restants sont des noms de fichiers d'entrée; si aucun fichier d'entrée n'est spécifié, l'entrée standard est lue.

Pages de manuel ou pages de manuel.
[color = rgb (0,0,0)] C'est un outil système créé pour Unix utilisé pour documenter et en savoir plus sur les commandes, les fichiers, les appels système sont toujours mon premier choix lorsque je me souviens d'une commande ou que j'examine des options plus complexes. L'outil est divisé en 8 sections que je vais détailler ci-dessous : [/ color]
[couleur = rgb (0,0,0)] Section [/ couleur] [couleur = rgb (0,0,0)] 1 : [/ couleur][color = rgb (0,0,0)] Commandes générales.[/ color]
[couleur = rgb (0,0,0)] Section [/ couleur] [couleur = rgb (0,0,0)] 2 : [/ couleur][color = rgb (0,0,0)] Appels système.[/ color]
[couleur = rgb (0,0,0)] Section [/ couleur] [couleur = rgb (0,0,0)] 3: [/ couleur][color = rgb (0,0,0)] Bibliothèque de fonctions C. [/ color]
[couleur = rgb (0,0,0)] Section [/ couleur] [couleur = rgb (0,0,0)] 4: [/ couleur][color = rgb (0,0,0)] Fichiers spéciaux (généralement des périphériques, qui peuvent être trouvés dans / dev) et des pilotes. [/ color]
[couleur = rgb (0,0,0)] Section [/ couleur] [couleur = rgb (0,0,0)] 5 : [/ couleur][color = rgb (0,0,0)] Formats de fichiers et conventions.[/ color]
[couleur = rgb (0,0,0)] Section [/ couleur] [couleur = rgb (0,0,0)] 6 : [/ couleur][color = rgb (0,0,0)] Jeux et économiseurs d'écran.[/ color]
[couleur = rgb (0,0,0)] Section [/ couleur] [couleur = rgb (0,0,0)] 7 : [/ couleur][couleur = rgb (0,0,0)] Divers. [/ couleur]
[couleur = rgb (0,0,0)] Section [/ couleur] [couleur = rgb (0,0,0)] 8 : [/ couleur][color = rgb (0,0,0)] Commandes et démons d'administration système.[/ color]
[color = rgb (0,0,0)] Son utilisation est très simple, il suffit de lancer depuis la console.[/ color]

 man "MOT CLE" exemple ---> man man

Si le manuel est trouvé, il sera affiché à l'aide du lecteur moins.

AGRANDIR

[color = rgb (0,0,0)] Les manuels sont divisés en 4 parties : [/ color]
PATATE DOUCENom et description de la commande.
SYNOPSISSyntaxe de commande.
LA DESCRIPTIONExplication détaillée de son fonctionnement.
EXEMPLESSuggestions sur la façon d'utiliser la commande.
VOIR ÉGALEMENTRubriques connexes (généralement dans les pages de manuel).
Le synopsis n'est disponible que pour les commandes, c'est la première chose que nous devons voir et interpréter, par exemple la commande cp propose le synopsis suivant.

[ ] : signifie que son utilisation est facultative.
… : plusieurs options peuvent être utilisées en même temps ou plusieurs fichiers.
Souligné : Il est nécessaire que la commande fonctionne. (Par exemple, la commande cp nécessite une source et une destination).
Pages de manuel en plusieurs sections.
Dans certains cas, un manuel peut contenir des entrées dans plusieurs sections, par exemple

 whatis printf #Arroja printf (1) - formater et imprimer les données printf (3) - conversion de sortie formatée

On voit qu'il y a 2 entrées, une dans la section 1 (Programme utilisateur) et à l'article 3 (Fonctions de la bibliothèque) les 2 sont des entrées de la même commande mais dans un contexte différent en cas de saisie de la section 3 du manuel que nous utilisons

 homme 3 printf

Recherche dans les pages de manuel.
Pour entrer dans un manuel, nous devons entrer son nom exact, cela peut être un problème si nous ne nous en souvenons pas, mais si nous connaissons sa description ou une partie de son nom, nous pouvons utiliser la commande apropos.
Prenons l'exemple de ssh-copie-id, nous ne nous souvenons pas de son nom mais nous savons qu'il est lié à ssh que nous utilisons à propos.

 à propos de ssh 

Le terminal renvoie une liste de manuels liés à ssh avec une description incluant notre objectif le ssh-copie-id.

 clés_autorisées (5) - Démon OpenSSH SSH git-shell (1) - Shell de connexion restreint pour l'accès SSH uniquement à Git rlogin (1) - Client OpenSSH SSH (programme de connexion à distance) rsh (1) - Client OpenSSH SSH (programme de connexion à distance) slogin (1) - Client OpenSSH SSH (programme de connexion à distance) ssh (1) - Client OpenSSH SSH (programme de connexion à distance) ssh-add (1) - ajoute des identités de clé privée à l'agent d'authentification ssh-agent (1) - agent d'authentification ssh-argv0 (1) - remplace l'ancien nom de commande ssh en tant que gestion du nom d'hôte ssh-copy-id (1) - utilise des clés disponibles localement pour autoriser les connexions sur une machine distante ssh-import-id (1) - récupère un ou plusieurs clés publiques d'un serveur de clés publiques et les ajouter au fichier de clés autorisées de l'utilisateur actuel (ou certains… ssh-import-id-gh (1) - récupérer une ou plusieurs clés publiques d'un serveur de clés publiques et les ajouter au fichier de clés_autorisées de l'utilisateur actuel ( ou certains… ssh-import-id-lp (1) - récupère une ou plusieurs clés publiques d'un serveur de clés publiques et les ajoute au curre fichier de clé autorisée de l'utilisateur nt (ou certains… ssh-keygen (1) - génération, gestion et conversion de clé d'authentification ssh-keyscan (1) - collecte de clés publiques ssh ssh-keysign (8) - programme d'aide ssh pour l'authentification basée sur l'hôte ssh- pkcs11-helper (8) - Le programme d'aide ssh-agent pour PKCS # 11 prend en charge ssh_config (5) - Fichiers de configuration du client OpenSSH SSH sshd (8) - Démon OpenSSH SSH sshd_config (5) - Fichier de configuration du démon OpenSSH SSH XAllocClassHint (3) - allouer la structure des conseils de classe et définir ou lire la propriété WM_CLASS d'une fenêtre XClassHint (3) - allouer la structure des conseils de classe et définir ou lire la propriété WM_CLASS d'une fenêtre XGetClassHint (3) - allouer la structure des conseils de classe et définir ou lire la propriété WM_CLASS d'une fenêtre XSetClassHint (3) - allouer la structure des indices de classe et définir ou lire la propriété WM_CLASS d'une fenêtre 

Ajout de PAGES DE MAN.
Dans certains cas, nous avons des manuels dans d'autres endroits, nous pouvons ajouter ces manuels en éditant notre /etc/man.conf et l'ajout du nouvel emplacement par exemple.

 MANPATH / opt / homme

Lecteurs de pages de manuel.
Il peut sembler beaucoup plus pratique de visualiser les pages depuis un navigateur, ou un lecteur PDF dispose de plusieurs alternatives parmi lesquelles il se démarque.
homme2html
Il permet de voir le contenu du manuel depuis le navigateur par défaut, son installation peut se faire depuis les référentiels.

 sudo apt-get install man2html

doc-central
contrairement à homme2html Il n'est pas seulement limité aux pages de manuel, il offre également un support pour les pages d'informations pour les afficher à partir de n'importe quel navigateur Web que vous pouvez installer avec

 sudo apt-get install doc-central

Vinfo
Vous pouvez lire les pages de manuel de l'éditeur Vim avec ce plugin où les étapes d'installation sont détaillées dans son référentiel officiel.

 https://github.com/alx741/vinfo

Pages de manuel en PDF
Vous pouvez envoyer n'importe quel document directement au format PDF en utilisant les outils proposés par Linux.

 homme -t ssh | ps2pdf - ssh-manuel.pdf

La commande Infos
La commande info est la prochaine génération d'aide et est généralement utilisée lorsque les informations man sont trop peu nombreuses ou difficiles à parcourir.
Bien qu'il ait été prévu qu'il remplace les pages de manuel, elles sont actuellement complémentaires les unes des autres, car dans de nombreux cas, les informations contenues dans l'une sont les mêmes que dans l'autre.
Se déplacer dans les pages d'informations
Le programme info a une interface navigable : de nombreuses pages ont des liens vers d'autres pages connexes, très similaires à la façon dont elles ont des pages Web. Les liens sont indiqués par un astérisque (*) suivi du titre du lien, suivi d'un double deux-points (:. Pour suivre les liens, il faut placer le curseur dessus et appuyer sur la touche . Il existe également différentes touches pour se déplacer sur ces pages :

• La touche de tabulation, nous fait traverser les différents liens
• La navigation de base peut être avec les flèches ou les touches Haut de page ou alors Bas de page
• n/p/u Il nous envoie à la page suivante, précédente, ou il nous télécharge un nœud, respectivement parlant.
• s texte à rechercher Recherche le texte spécifié, si nous ne spécifions pas de texte, il recherche la prochaine correspondance du dernier texte recherché.
• quelle nous quittons les pages d'informations.

ConclusionNous avons parlé de plusieurs options qui fonctionnent localement (important en cas de problèmes Internet). et comment filtrer les recherches et trouver des solutions plus rapidement, quel que soit votre niveau, vous devrez toujours les saisir car son contenu est tellement vaste et très changeant que la documentation devrait être notre meilleur outil face aux lacunes mentales.Avez-vous aimé et aidé ce tutoriel ?Vous pouvez récompenser l'auteur en appuyant sur ce bouton pour lui donner un point positif