MANPATH(5) /etc/man_db.conf MANPATH(5) NOME manpath - formato do ficheiro /etc/man_db.conf DESCRICAO O ficheiro de configuracao de manpath e usado pelos utilitarios das paginas do manual para avaliar os manpath do utilizador em tempo de execucao, para indicar quais as hierarquias de paginas do manual (manpaths) devem ser tratadas como hierarquias do sistema e como atribuir-lhes pastas a usar para armazenar ficheiros cat. Se a variavel de ambiente $MANPATH ja estiver definida, a informacao contida em /etc/man_db.conf nao se lhe sobrepoe. CAMINHO DE PROCURA Por pre-definicao, o man-db examina a $PATH do utilizador. Para cada elemento path_element ali encontrado, adiciona manpath_element ao caminho de procura. Se nao houver uma lnha MANPATH_MAP no ficheiro de configuracao para um dado path_element, adiciona todos os path_element/../man, path_element/man, path_element/../share/man, e path_element/share/man que existam como pastas do caminho de procura. Depois, adiciona qualquer entrada MANDATORY_MANPATH do ficheiro de configuracao ao caminho de procura. Finalmente, se a opcao --systems for usada, ou a variavel de ambiente $SYSTEM estiver definida, tal devera consistir numa sequencia de nomes de sistemas operativos, separados por virgulas ou dois pontos. Isto age como modelo, expandindo o caminho de procura mais uma vez para permitir acesso a paginas de manual de outros sistemas operativos: para cada nome de sistema, o man-db procura esse nome como sub-pasta de cada entrada no caminho de procura, e adiciona-a ao caminho de procura final, se existir. Um nome de sistema de man insere o caminho de procura normal sem sub-pastas. Por exemplo, se o caminho de procura tivesse sido /usr/share/man:/usr/local/man, e $SYSTEM estiver definida como newOS:man, o caminho de procura final sera /usr/share/man/newOS: /usr/share/man:/usr/local/man/newOS:/usr/local/man. A variavel de ambiente $MANPATH subsitui os caminhos de procura pre-definidos para paginas do manual do man-db. A maioria dos utilizadores nao tera de a definir. A sua sintaxe e similar a variavel de ambiente $PATH : consiste numa sequencia de nomes de pastas separados por dois pontos. Substitui o caminho de procura pre-definido descrito acima. Se o valor de $MANPATH comecar com dois pontos, o caminho pre-definido de procura e adicionado ao seu inicio. Se o valor de $MANPATH terminar com dois pontos, o caminho de procura pre-definido e adicionado ao seu final. Se o valor de $MANPATH contiver duplos dois pontos (::), o caminho de procura pre-definido e inserido no meio do valor, entre os duplos dois pontos. FORMATO Actualmente sao reconhecidos os seguintes tipos: # comentario Linhas em branco ou comecadas com # serao tratadas como comentarios e ignoradas. MANDATORY_MANPATH manpath_element Linhas desta forma indicam manpaths que todo o $MANPATH gerado automaticamente deve conter. Isto incluira tipicamente /usr/man. MANPATH_MAP path_element manpath_element Linhas desta forma configuram $PATH para mapas $MANPATH. Para cada path_element encontrado no $PATH do utilizador, sera adicionado manpath_element a $MANPATH. MANDB_MAP manpath_element [ catpath_element ] Linhas desta forma indicam que manpaths devem ser tratados como manpaths de sistema e, opcionalmente, onde devem ser armazenados os seus ficheiros cat. Este tipo de campo e particularmente importante se man for um programa setuid, porque (quando no ficheiro de configuracao do sistema /etc/man_db.conf em vez no ficheiro de configuracao .manpath por utilizador) indica quais hierarquias de paginas do manual aceder como utilizador setuid e quais aceder como o utilizador chamador. As hierarquias das paginas de manual do sistema estao habitualmente armazenadas em /usr, tal como /usr/man, /usr/local/man e /usr/X11R6/man. Se as paginas cat de um manpath_element nao devem ser armazenadas ou devem ser armazenadas na localizacao tradicional, catpath_element pode ser omitido. A colocacao tradicional de cat seria impossivel para hierarquias de paginas do manual montadas como so de leitura e, por causa disto, e possivel especificar qualquer hierarquia valida para o seu armazenamento. Para observacao de Linux FSSTND, a palavra-chave FSSTND pode ser usada em vez da pasta real. Infelizmente, e necessario especificar todos os caminhos de sistema de arvores do manual, incluindo caminhos de sistemas operativos alternativos, tais como /usr/man/sun e quaisquer caminhos NLS locale, tais como /usr/man/de_DE.88591. Como a informacao e analisada linha a linha na ordem de escrita, e necessario que qualquer manpath que seja uma sub-hierarquia de outra hierarquia seja listado primeiro, senao sera feita uma correspondencia incorrecta. Um exemplo disto seria que /usr/man/de_DE.88591 tem de vir antes de /usr/man. DEFINE valor de chave Linhas desta forma definem diversas variaveis de configuracao; veja o ficheiro de configuracao predefinido para consultar as variaveis usadas pelos utilitarios das paginas do manual. Incluem caminhos predefinidos para varios programas (tais co grep e tbl) e varios conjuntos predefinidos de argumentos para esses programas. SECTION seccao ... Linhas desta forma definem a ordem em que as seccoes do manual devem ser procuradas. Se nao houver directivas SECTION no ficheiro de configuracao, a predefinicao e: SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7 Se forem indicadas multiplas directivas SECTION, as suas listas de seccoes serao concatenadas. Se uma extensao em particular nao estiver na lista (digamos, 1mh), sera mostrada com o resto da seccao a que pertence. O efeito disto e que so precisa de listar explicitamente extensoes se pretender forcar uma determinada ordem. Seccoes com extensoes devem habitualmente ser adjacentes a sua seccao principal (e.g. "1 1mh 8 ..."). SECTIONS e aceite como nome alternativo para esta directiva. MINCATWIDTH largura Se a largura do terminal for menor que largura, as paginas cat nao serao criadas (se em falta) ou mostradas. A predefinicao e 80. MAXCATWIDTH largura Se a largura do terminal for maior que largura, as paginas cat nao serao criadas (se em falta) ou mostradas. A predefinicao e 80. CATWIDTH largura Se width for nao-zero, as paginas cat serao sempre formatadas para um terminal da largura indicada, independentemente da largura do terminal actualmente em uso. Isto substitui MINCATWIDTH e MAXCATWIDTH. NOCACHE Esta bandeira impede que man(1) crie paginas cat automaticamente. ERROS A nao ser que as regras acima sejam rigorosamente seguidas e observadas, os utilitarios das paginas do manual nao funcionarao como desejavel. As regras sao excessivamente complicadas. https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.13.1 2025-05-02 MANPATH(5)