MANPATH(5) /etc/man_db.conf MANPATH(5) NOME manpath - formata o arquivo /etc/man_db.conf DESCRICAO O arquivo de configuracao do manpath e usado pelos utilitarios de pagina de manual para avaliar os caminhos man dos usuarios em tempo de execucao, para indicar quais hierarquias de pagina de manual (caminhos man) devem ser tratadas como hierarquias do sistema e para atribui-las a diretorios para ser usados para armazenar arquivos cat. Se a variavel de ambiente $MANPATH ja estiver definida, as informacoes contidas em /etc/man_db.conf nao a sobrescreverao. CAMINHO DE PESQUISA Por padrao, o man-db examina o $PATH do usuario. Para cada path_element encontrado, ele adiciona manpath_element ao caminho de pesquisa. Se nao houver nenhuma linha MANPATH_MAP no arquivo de configuracao para um determinado path_element, ele adicionara todos os path_element/../man, path_element/man, path_element/../share/man e path_element/share/man que existem como diretorios ao caminho de pesquisa. Em seguida, ele adiciona quaisquer entradas MANDATORY_MANPATH do arquivo de configuracao ao caminho de pesquisa. Por fim, se a opcao --systems for usada ou a variavel de ambiente $SYSTEM for definida, isso devera consistir em uma sequencia de nomes de sistemas operacionais separados por virgulas ou dois pontos. Isso funciona como um modelo, expandindo o caminho de pesquisa mais uma vez para permitir o acesso as paginas de manual de outros sistemas operacionais: para cada nome de sistema, man-db procura esse nome como um subdiretorio de cada entrada no caminho de busca e o adiciona ao caminho de pesquisa final, se existir. Um nome de sistema man insere o caminho de pesquisa normal sem subdiretorios. Por exemplo, se o caminho de pesquisa fosse /usr/share/man:/usr/local/man e $SYSTEM estiver definido como newOS:man, o caminho de busca final seria /usr/share/man/newOS:/usr/share/man:/usr/local/man/newOS: /usr/local/man. A variavel de ambiente $MANPATH substitui os caminhos de pesquisa padrao das paginas de manual do man-db. A maioria dos usuarios nao precisa defini-la. Sua sintaxe e semelhante a da variavel de ambiente $PATH: consiste em uma sequencia de nomes de diretorios separados por dois pontos. Ela substitui o caminho de pesquisa padrao descrito acima. Se $MANPATH estiver definido, manpath exibe seu valor em vez de determina-lo dinamicamente. Se $MANPATH for prefixado por um caractere de dois pontos, entao o valor de variavel e anexado a lista determinada a partir do conteudo dos arquivos de configuracao. Se o caractere de dois pontos vem ao final do valor na variavel, entao a lista determinada e anexada ao conteudo da variavel. Se o valor da variavel contiver dupla de caractere de dois pontos (::), entao a lista determinada e inserida no meio do valor, entre dois caracteres de dois pontos. FORMATO Os seguintes tipos de campos sao atualmente reconhecidos: # comentario Linhas em branco ou aquelas iniciando com uma cerquilha (#) serao tratadas como comentarios ou ignoradas. MANDATORY_MANPATH manpath_element Linhas nesta forma indicam caminhos man que toda $MANPATH gerada automaticamente deve conter. Isso geralmente incluira /usr/man. MANPATH_MAP path_element manpath_element Linhas nesta forma configuram mapeamentos de $PATH para $MANPATH. Para cada path_element localizado no $PATH do usuarios, manpath_element sera adicionado ao $MANPATH. MANDB_MAP manpath_element [ catpath_element ] Linhas nesta forma indicam quais caminhos man devem ser tratados como caminhos man do sistema e, opcionalmente, onde seus arquivos cat devem ser armazenados. Esse tipo de campo e particularmente importante se man e um programa setuid, como (quando no arquivo de configuracao de sistema /etc/man_db.conf em vez do arquivo de configuracao per-usuario .manpath) ele indica quais hierarquias de pagina de manual devem ser acessadas como o usuario setuid e qual como usuario invocador. As hierarquias de pagina de manual do sistema geralmente sao aquelas armazenadas sob /usr tal como /usr/man, /usr/local/man e /usr/X11R6/man. Se paginas cat de um manpath_element em particular nao devem ser armazenadas ou devem ser armazenadas na localizacao traducional, catpath_element pode ser omitido. Colocacao de cat tradicional seria impossivel para hierarquias de paginas de manual montadas como somente leituras e, por causa disso, e possivel especificar qualquer hierarquia valida de diretorios para seu armazenamento. Para observar Linux FSSTND, a palavra-chave FSSTND pode ser usada no lugar de um diretorio real. Infelizmente, e necessario especificar todos os caminhos de arvore man do sistema, incluindo caminhos alternativos do sistema operacional, tais como /usr/man/sun e quaisquer caminhos localidade NLS tais como /usr/man/de_DE.88591. Como a informacao e analisada linha por linha na ordem escrita, e necessario para qualquer caminho man que e um subdiretorio de uma outra hierarquia ser listado primeiro, do contrario uma correspondencia incorreta sera feita. Uma exemplo disso e que /usr/man/de_DE.88591 deve vir antes de /usr/man. DEFINE valor da chave Linhas nesta forma definem diversas variaveis de configuracao; veja o arquivo de configuracao padrao para aquelas variaveis usadas pelos utilitarios paginacao de manual. Eles incluem caminhos de padrao para programas variados (tais como grep e tbl) e conjuntos padroes de argumentos daqueles programas. SECTION secao ... Linhas nesta forma definem a ordem na qual secoes de manual devem ser pesquisadas. Caso nao ha diretivas SECTION no arquivo de configuracao, o padrao e: SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7 Se multiplas diretivas SECTION forem fornecidas, suas listas de secoes serao concatenadas. Se uma extensao em particular nao estiver nessa lista (digamos, 1mh), ela sera exibida com o resto da secao a qual ela pertence. O efeito disso e que voce apenas precisa listar explicitamente extensoes se voce deseja forcar uma ordem em particular. As secoes com extensoes geralmente devem ser adjacente as suas secoes principais (ex.: "1 1mh 8 ..."). SECTIONS e aceito como um nome alternativo para essa diretiva. MINCATWIDTH largura Se a largura do terminal e menor que largura, paginas cat nao serao criadas (se estiverem faltando) ou exibidas. O padrao e 80. MAXCATWIDTH largura Se a largura do terminal e maior que largura, paginas cat nao serao criadas (se estiverem faltando) ou exibidas. O padrao e 80. CATWIDTH largura Se largura e diferente de zero, paginas cat sempre serao formatadas para um terminal da largura fornecida, independente da largura usada para o terminal. Isso substitui MINCATWIDTH e MAXCATWIDTH. NOCACHE Essa opcao evita que man(1) crie paginas cat automaticamente. PROBLEMAS A menos que as regras acima sejam seguidas e observadas com muita atencao, os utilitarios de paginacao de manual nao funcionarao como desejado. 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)