Tutorial sul comando manpath di Linux per principianti (5 esempi)

Le pagine man in Linux sono il punto di riferimento per il supporto di primo livello quando si tratta di utilità da riga di comando. Come molti di voi sapranno, basta scrivere ‘man [nome-comando]’ e la corrispondente pagina man appare. Ma sapete qual è il percorso in cui queste pagine man vengono cercate?

In questo tutorial, discuteremo di manpath, un’utilità che ti mostra queste informazioni. Ma prima di iniziare con la spiegazione, vale la pena menzionare che tutti gli esempi qui sono stati testati su una macchina Ubuntu 18.04 LTS.

Tutorial su manpath di Linux

Il comando manpath in Linux ti aiuta a determinare il percorso di ricerca per le pagine manuali. Di seguito è riportata la sua sintassi:

manpath [-qgdc?V] [-m system[,...]] [-C file]

Ecco come la pagina man dello strumento lo descrive:

       Se $MANPATH è impostato, manpath visualizzerà semplicemente il suo contenuto e emetterà
       un avviso. Se non lo è, manpath determinerà un percorso di ricerca gerarchico
       per le pagine manuali e visualizzerà i risultati.

       Il percorso delimitato da due punti è determinato utilizzando le informazioni ottenute dal
       file di configurazione man-db - (/etc/manpath.config) e dall'ambiente dell'utente.

Di seguito sono riportati alcuni esempi in stile Q&A che dovrebbero darti una buona idea di come funziona il comando manpath.

D1. Come funziona il comando manpath?

L’uso di base è piuttosto semplice: basta eseguire ‘manpath’ senza alcuna opzione.

manpath

Ad esempio, ecco cosa ha prodotto il comando sopra in output sul mio sistema:

/usr/local/man:/usr/local/share/man:/usr/share/man

Quindi puoi vedere che manpath produce un elenco di percorsi per le pagine manuali separati da due punti.

Nota che puoi usare l’opzione da riga di comando -g nel caso tu voglia produrre un manpath composto da tutti i percorsi denominati ‘global’ all’interno del file di configurazione man-db.

D2. Come avere catpath in output invece di manpath?

Per questo, usa l’opzione da riga di comando -c.

manpath -c

Ecco come la pagina man dello strumento spiega questa operazione:

Una volta determinato il manpath, ogni elemento del percorso viene convertito nel suo catpath relativo.

Ad esempio, ecco l’output prodotto sul mio sistema:

/var/cache/man/oldlocal:/var/cache/man/local:/var/cache/man

D3. Come far stampare a manpath informazioni di debug?

Per questo, usa l’opzione da riga di comando -d.

manpath -d

Ad esempio, ecco l’output che questo comando ha prodotto sul mio sistema:

D’accordo, potresti non usare questa opzione molto frequentemente, ma dovresti almeno esserne a conoscenza nel caso tu debba eseguire il debug dell’output dello strumento.

D4. Come far accedere a manpath ad altre gerarchie manuali di OS?

Per questo, usa l’opzione da riga di comando -m. Ecco come la pagina man dello strumento spiega questa opzione:

-m system[,...], --systems=system[,...]

              Se questo sistema ha accesso ad altre gerarchie manuali di altri sistemi operativi,
              questa opzione può essere utilizzata per includerle nell'output di manpath. Per includere
              le gerarchie delle pagine manuali di NewOS usa l'opzione -m NewOS.

              Il sistema specificato può essere una combinazione di nomi di sistemi operativi delimitati da virgole.
              Per includere le gerarchie delle pagine manuali del sistema operativo nativo,
              il nome del sistema man deve essere incluso nella stringa di argomenti.
              Questa opzione sovrascriverà la variabile di ambiente $SYSTEM.

D5. Come far usare a manpath un file di configurazione personalizzato?

Per impostazione predefinita, manpath recupera informazioni dal seguente file:

/etc/manpath.config

Tuttavia, se lo desideri, puoi costringere manpath a leggere qualsiasi altro file. Questo puoi farlo usando l’opzione da riga di comando -C.

manpath -C NUOVO-PERCORSO-FILE

Conclusione

Se il tuo lavoro da riga di comando Linux comporta la gestione delle pagine man, il comando manpath è uno strumento utile per te. Qui, in questo tutorial, abbiamo discusso la maggior parte delle opzioni da riga di comando di manpath. Per ulteriori informazioni sullo strumento, vai alla sua pagina man.