Man page - manpath(5)

Packages contains this manual

Available languages:

en fr pt_BR es it pl pt ko nl da tr sv ja uk id ru ro sr zh_CN de

Manual

MANPATH

NOME
DESCRIZIONE
FORMATO
PROBLEMI

NOME

manpath - formato del file /etc/manpath.config

DESCRIZIONE

Il file di configurazione dei percorsi man è usato dalle utility per le pagine di manuale per stabilire in esecuzione i percorsi man dell’utente, per indicare quali gerarchie di pagine di manuale (percorsi man) devono essere trattati come globali e per assegnare a quest’ultimi delle directory da usare per salvare i cat file.

Se la variabile d’ambiente $ MANPATH è già settata, le informazioni contenute all’interno di /etc/manpath.config non la ridefiniranno.

FORMATO

Attualmente sono riconosciuti i seguenti tipi di campi:
# commento

Righe vuote o che iniziano con un # saranno trattate come commenti ed ignorate.

MANDATORY_MANPATH elemento_percorso_man

Righe di questo tipo indicano percorsi man che ogni $ MANPATH generato automaticamente dovrebbe contenere. Tipicamente include /usr/man .

MANPATH_MAP elemento_percorso elemento_percorso_man

Righe di questo tipo definiscono la mappatura da $ PATH a $ MANPATH . Per ognuno degli elemento_percorso trovati nella variabile $ PATH dell’utente, elemento_percorso_man sarà aggiunto a $ MANPATH .

MANDB_MAP elemento_percorso_man [ elemento_percorso_cat ]

Righe di questo tipo indicano quali percorsi man devono essere trattati come globali e opzionalmente, dove dovrebbero essere salvati i loro file cat. Questo campo è particolarmente importante se man è un programma setuid, in quanto indica a quali gerarchie di pagine di manuale accedere come utente setuid e a quali come l’utente invocante.

Le gerarchie di pagine di manuale sono solitamente quelle immagazzinate sotto a /usr come, ad esempio, /usr/man , /usr/local/man e /usr/X11R6/man .

Se le pagine cat di un particolare elemento_percorso_man non devono essere salvate o sono salvate nelle posizione tradizionale, elemento_percorso_cat può essere omesso.

Posizioni cat tradizionali potrebbero essere impossibili per gerarchie di pagine di manuale montate in sola lettura e a causa di ciò è impossibile specificare una valida gerarchia di directory per il loro salvataggio. Per osservare il Linux FSSTND la parola chiave ‘ FSSTND ’ può essere usata al posto di una reale directory.

Sfortunatamente, è necessario specificare tutti i percorsi man globali, inclusi i percorsi di sistema alternativi come /usr/man/sun o qualsiasi percorso NLS locale come /usr/man/it_IT .

Poiché le informazioni sono analizzate riga per riga nell’ordine in cui sono scritte, è necessario che ognuno dei percorsi man che sia una sotto gerarchia di un’altra gerarchia sia elencato prima, altrimenti sarà fatta una corrispondenza non corretta. Ad esempio /usr/man/it_IT deve venire prima di /usr/man .

PROBLEMI

Finché le suddette regole non sono seguite e osservate precisamente, le utility per le pagine di manuale non funzioneranno correttamente. Le regole sono eccessivamente complicate.