Man - Linux Command

homme-acdfFhkKtwW --chemin -m système -p chaîne -C config_file -M pathlist -P téléavertisseur -S section_list section prénom …

Les options

-C fichier_configuration

Spécifiez le fichier de configuration à utiliser. la valeur par défaut est/etc/man.config. (Voirman.conf(5).)

-M chemin

Spécifiez la liste des répertoires dans lesquels rechercher des pages de manuel. Séparez les répertoires avec des deux points. Une liste vide revient à ne pas spécifier-M du tout. VoirCHEMIN DE RECHERCHE POUR PAGES MANUELLES.

-P pager

Spécifiez le pager à utiliser. Cette option annule laMANPAGER variable d’environnement, qui à son tour remplace laPAGER variable. Par défaut,homme les usages/ usr / bin / less -isr.

-S section_list

La liste est une liste de sections du manuel à rechercher, séparées par des points. Cette option annule laMANSECTvariable d'environnement.

-une

Par défaut,homme quittera après avoir affiché la première page de manuel trouvée. Utiliser cette option forcehomme pour afficher toutes les pages de manuel qui correspondentprénom,pas seulement le premier.

-c

Reformatez la page de manuel source, même s'il existe une page de chat à jour. Cela peut avoir un sens si la page de chat a été formatée pour un écran avec un nombre de colonnes différent, ou si la page préformatée est corrompue.

-ré

N'affichez pas réellement les pages de manuel, mais imprimez des gobs d'informations de débogage.

-RÉ

Afficher et imprimer les informations de débogage.

-F

Équivalent àquel est.

-F ou--preformat

Format seulement - ne pas afficher.

-h

Imprimez un message d'aide d'une ligne et quittez.

-k

Équivalent àà propos.

-K

Recherchez la chaîne spécifiée dans * toutes * les pages de manuel. Attention: c'est probablement très lent! Cela aide de spécifier une section. (Juste pour donner une idée approximative, sur ma machine, cela prend environ une minute par 500 pages de manuel.)

-m système

Spécifiez un autre ensemble de pages de manuel à rechercher en fonction du nom du système donné.

-p chaîne

Spécifiez la séquence de préprocesseurs à exécuter avantnroff outroff. Toutes les installations n'auront pas un ensemble complet de pré-processeurs. Certains des préprocesseurs et les lettres utilisées pour les désigner sont: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), voir (r). Cette option annule laMANROFFSEQ variable d'environnement.

-t

Utilisation/ usr / bin / groff -Tps -mandoc pour formater la page de manuel, en passant la sortie àstdout. La sortie de/ usr / bin / groff -Tps -mandoc peut avoir besoin d'être passé à travers un filtre ou un autre avant d'être imprimé.

-wou --path

N'affichez pas réellement les pages de manuel, mais imprimez les emplacements des fichiers qui seraient formatés ou affichés. Si aucun argument n’est donné: affiche (sur stdout) la liste des répertoires recherchés parhomme pour les pages de manuel. Simanpath est un lien avec man, alors "manpath" est équivalent à "man --path".

-W

Comme -w, mais les noms de fichiers à imprimer sont un par ligne, sans information supplémentaire. Ceci est utile dans les commandes shell telles queman -aW man | xargs ls -l

Pages CAT

Man essaiera de sauvegarder les pages de manuel formatées, afin de gagner du temps de formatage la prochaine fois que ces pages seront nécessaires. Traditionnellement, les versions formatées des pages dans DIR / manX sont enregistrées dans DIR / catX, mais d’autres mappages allant de man dir à cat dir peuvent être spécifiés dans/etc/man.config. Aucune page de chat n'est enregistrée lorsque le répertoire de chat requis n'existe pas. Aucune page de chat n'est enregistrée lorsqu'elle est formatée pour une longueur de ligne différente de 80. Aucune page de chat n'est enregistrée lorsque man.conf contient la ligne NOCACHE.

Il est possible de fairehomme suid à un utilisateur. Ensuite, si un répertoire de chat a le propriétaire man et le mode 0755 (accessible en écriture uniquement à man), et que les fichiers cat ont le propriétaire propriétaire et le mode 0644 ou 0444 (accessible uniquement en écriture à l'homme ou pas du tout en écriture), aucun utilisateur pages de chat ou mettre d'autres fichiers dans le répertoire cat. Sihomme n’est pas faite, alors un répertoire cat devrait avoir le mode 0777 si tous les utilisateurs devaient pouvoir y laisser leurs pages.

L'option-c force le reformatage d'une page, même s'il existe une page de chat récente.

Chemin de recherche pour les pages de manuel

homme utilise une méthode sophistiquée de recherche de fichiers de page de manuel, basée sur les options d’appel et les variables d’environnement,/etc/man.configfichier de configuration, ainsi que certaines conventions et méthodes heuristiques intégrées.

Tout d’abord, quand le prénom argument àhomme contient une barre oblique (/), homme suppose qu'il s'agit d'une spécification de fichier elle-même et qu'aucune recherche n'est impliquée.

Mais dans le cas normal où prénom ne contient pas de barre oblique,homme recherche dans une variété de répertoires un fichier qui pourrait être une page de manuel pour le sujet nommé.

Si vous spécifiez le-M pathlist option, pathlist est une liste de répertoires séparés par deux pointshommerecherches.

Si vous ne spécifiez pas-M mais définir leMANPATH variable d’environnement, la valeur de cette variable est la liste des répertoires quihomme recherches.

Si vous ne spécifiez pas de liste de chemins explicite avec-M ouMANPATH, homme développe sa propre liste de chemins en fonction du contenu du fichier de configuration/etc/man.config. leMANPATH Les instructions du fichier de configuration identifient des répertoires particuliers à inclure dans le chemin de recherche.

En outre, leMANPATH_MAPinstructions s’ajoutent au chemin de recherche en fonction du chemin de recherche de votre commande (c.-à-d. votreCHEMINvariable d'environnement). Pour chaque répertoire pouvant figurer dans le chemin de recherche de la commande, unMANPATH_MAP instruction spécifie un répertoire à ajouter au chemin de recherche pour les fichiers de page de manuel.homme regarde leCHEMIN variable et ajoute les répertoires correspondants au chemin de recherche du fichier de page de manuel. Ainsi, avec le bon usage deMANPATH_MAP, quand vous lancez la commandehomme xyz, vous obtenez une page de manuel du programme qui s’exécuterait si vous exécutiez la commandexyz.

De plus, pour chaque répertoire dans le chemin de recherche de commande (nous l'appellerons un "répertoire de commande") pour lequel vous faites ne pas avoir unMANPATH_MAPdéclaration,homme recherche automatiquement un répertoire de pages de manuel "à proximité", notamment sous la forme d'un sous-répertoire dans le répertoire de commandes proprement dit ou dans le répertoire parent du répertoire de commandes.

Vous pouvez désactiver les recherches automatiques "à proximité" en incluant unNOAUTOPATH déclaration dans/etc/man.config.

Dans chaque répertoire du chemin de recherche, comme décrit ci-dessus,homme recherche un fichier nommé sujet . section , avec un suffixe facultatif sur le numéro de section et éventuellement un suffixe de compression. S'il ne trouve pas un tel fichier, il cherche dans tous les sous-répertoires nomméshomme N ouchat N où N est le numéro de section du manuel. Si le fichier est dans unchat N sous-répertoire,homme suppose qu'il s'agit d'un fichier de page de manuel formaté (page cat). Autrement,homme suppose qu'il est non formaté. Dans les deux cas, si le nom du fichier a un suffixe de compression connu (comme.gz), homme suppose qu'il est gzippé.

Si vous voulez voir où (ou si)homme trouverait la page de manuel pour un sujet particulier, utilisez le--chemin(-w) option.

Important: Utilisez le homme commande ( % homme ) pour voir comment une commande est utilisée sur votre ordinateur.