2 votes

Commandes générales pour obtenir de l'aide et/ou de la documentation sur les utilitaires de ligne de commande dans le terminal sous MacOS ?

Certaines interfaces de ligne de commande ou certains utilitaires de ligne de commande donnent quelques documentation complète ou de l'aide lorsque --help est ajouté au nom de la commande, par exemple git :

git --help
# shows comprehensive help docs

D'autres montrent uniquement la commande et ses arguments (c'est tout), par exemple grep :

grep --help
usage: grep [-abcDEFGHhIiJLlmnOoqRSsUVvwxZ] [-A num] [-B num] [-C[num]]
    [-e pattern] [-f file] [--binary-files=value] [--color=when]
    [--context[=num]] [--directories=action] [--label] [--line-buffered]
    [--null] [pattern] [file ...]

Et d'autres donnent une certaine assistance, mais seulement parce que --help n'est pas reconnue comme une option légale, par exemple ls :

ls --help
ls: illegal option -- -
usage: ls [-@ABCFGHLOPRSTUWabcdefghiklmnopqrstuwx1%] [file ...]

et netstat :

netstat --help
netstat: illegal option -- -
Usage:  netstat [-AaLlnW] [-f address_family | -p protocol]
    netstat [-gilns] [-f address_family]
    netstat -i | -I interface [-w wait] [-abdgRtS]
    netstat -s [-s] [-f address_family | -p protocol] [-w wait]
    netstat -i | -I interface -s [-f address_family | -p protocol]
    netstat -m [-m]
    netstat -r [-Aaln] [-f address_family]
    netstat -rs [-s]

Question

Existe-t-il un ou plusieurs moyens sûrs d'obtenir de la documentation ou de l'aide sur une CLI ou un utilitaire sans avoir à chercher sur Google (par exemple, à partir du site Web de la Commission européenne) ? sur le terminal) ? J'essaie actuellement --help o -h Mais j'aimerais savoir s'il y a d'autres choses à essayer (en toute sécurité) avant d'aller sur Google.

10voto

David Anderson Points 30783

Avez-vous entendu parler de l'utilisation du man commande. Par exemple : man ls o man grep . Vous pouvez obtenir une documentation complète sur man en entrant man man .

Certaines des clés de base utilisées par le man sont les f pour avancer, la touche b pour revenir en arrière et la touche q pour quitter.

Essayez d'utiliser la souris pour mettre la commande en surbrillance, puis faites un clic droit sur le texte en surbrillance et sélectionnez Open man page . Voir l'exemple ci-dessous.

Note : Le texte mis en évidence ne peut pas contenir d'espaces.

Certaines commandes sont intégrées. Cela signifie que la commande fait partie du shell actuel. Si vous utilisez la commande zsh (qui est l'interpréteur de commandes par défaut de MacOS), vous devrez alors saisir man zshbuiltins pour la documentation.

1voto

trashgod Points 119

Pensez également à utiliser apropos pour "chercher le whatis base de données pour les chaînes de caractères" qui peut aider à trouver la bonne commande.

Utilisez le -t option de man de "formater la page du manuel" de manière à ce que Preview.app peut afficher :

man -t apropos | open -f -a Preview.app

image

1voto

Abramodj Points 1771

Une action analogue pour obtenir une page de manuel, décrite dans la réponse de @David Anderson, ci-dessus, peut être effectuée avec une fonction shell qui exploite l'URL spéciale, x-man-page et le open commande. Cela permet de visualiser les pages de manuel dans une session de terminal sans reprendre la fenêtre du terminal à partir de laquelle la commande man a été demandé. A la place, une nouvelle fenêtre sera ouverte pour afficher le contenu de la page de manuel.

Avec bash ajoutez ceci à votre ~/.bashrc avec zsh ajouter la même chose à ~/.zshrc :

function xmanpage ()
{
    if [ $#   -eq 1 ]; then
        open x-man-page://$1;
    elif [ $# -eq 2 ]; then
        open x-man-page://$1/$2;
    fi
}

Si seul un nom est passé à la fonction, la page de manuel de la section 1 (commandes utilisateur) est retournée. Pour sélectionner les man-pages d'une autre section, spécifiez le numéro de section de l'objet, suivi du nom qui vous intéresse. Par exemple, pour voir la stat informations sur les commandes :

xmanpage stat

Et pour voir le stat les détails de l'appel système de la section 2 des pages de manuel, faites :

xmanpage 2 stat

LesApples.com

LesApples est une communauté de Apple où vous pouvez résoudre vos problèmes et vos doutes. Vous pouvez consulter les questions des autres utilisateurs d'appareils Apple, poser vos propres questions ou résoudre celles des autres.

Powered by:

X