146 lines
6.2 KiB
HTML
146 lines
6.2 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of MANPATH</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>MANPATH</H1>
|
|
Section: /etc/manpath.config (5)<BR>Updated: 2020-02-25<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NOME</H2>
|
|
|
|
manpath - formata o arquivo /etc/manpath.config
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIÇÃO</H2>
|
|
|
|
O arquivo de configuração do manpath é usado pelos utilitários de página de
|
|
manual para avaliar os caminhos man dos usuários em tempo de execução, para
|
|
indicar quais hierarquias de página de manual (caminhos man) devem ser
|
|
tratadas como hierarquias do sistema e para atribuí-las a diretórios para
|
|
ser usados para armazenar arquivos cat.
|
|
<P>
|
|
Se a variável de ambiente $<B>MANPATH</B> já estiver definida, as informações
|
|
contidas em /etc/manpath.config não a sobrescreverão.
|
|
<A NAME="lbAD"> </A>
|
|
<H2>FORMATO</H2>
|
|
|
|
Os seguintes tipos de campos são atualmente reconhecidos:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>#</B><I> comentário</I><DD>
|
|
Linhas em branco ou aquelas iniciando com uma cerquilha (<B>#</B>) serão
|
|
tratadas como comentários ou ignoradas.
|
|
<DT id="2"><B>MANDATORY_MANPATH</B><I> manpath_element</I><DD>
|
|
Linhas nesta forma indicam caminhos man que toda $<B>MANPATH</B> gerada
|
|
automaticamente deve conter. Isso geralmente incluirá <I>/usr/man</I>.
|
|
<DT id="3"><B>MANPATH_MAP</B><I> path_element manpath_element</I><DD>
|
|
Linhas nesta forma configuram mapeamentos de $<B>PATH</B> para $<B>MANPATH</B>. Para
|
|
cada <I>path_element</I> localizado no $<B>PATH</B> do usuários, <I>manpath_element</I>
|
|
será adicionado ao $<B>MANPATH</B>.
|
|
<DT id="4"><B>MANDB_MAP </B><I>manpath_element </I>[ <I>catpath_element</I> ]<DD>
|
|
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 é particularmente importante se <B>man</B> é um
|
|
programa setuid, como (quando no arquivo de configuração de sistema
|
|
/etc/manpath.config em vez do arquivo de configuração per-usuário
|
|
.manpath) ele indica quais hierarquias de página de manual devem ser
|
|
acessadas como o usuário setuid e qual como usuário invocador.
|
|
<P>
|
|
As hierarquias de página de manual do sistema geralmente são aquelas
|
|
armazenadas sob <I>/usr</I> tal como <I>/usr/man</I>, <I>/usr/local/man</I> e
|
|
<I>/usr/X11R6/man</I>.
|
|
<P>
|
|
Se páginas cat de um <I>manpath_element</I> em particular não devem ser
|
|
armazenadas ou devem ser armazenadas na localização traducional,
|
|
<I>catpath_element</I> pode ser omitido.
|
|
<P>
|
|
Colocação de cat tradicional seria impossível para hierarquias de páginas de
|
|
manual montadas como somente leituras e, por causa disso, é possível
|
|
especificar qualquer hierarquia válida de diretórios para seu
|
|
armazenamento. Para observar <B>Linux FSSTND</B>, a palavra-chave <B>FSSTND</B> pode
|
|
ser usada no lugar de um diretório real.
|
|
<P>
|
|
Infelizmente, é necessário especificar <B>todos</B> os caminhos de árvore man do
|
|
sistema, incluindo caminhos alternativos do sistema operacional, tais como
|
|
<I>/usr/man/sun</I> e quaisquer caminhos <B>localidade NLS</B> tais como
|
|
<I>/usr/man/de_DE.88591</I>.
|
|
<P>
|
|
Como a informação é analisada linha por linha na ordem escrita, é necessário
|
|
para qualquer caminho man que é um subdiretório de uma outra hierarquia ser
|
|
listado primeiro, do contrário uma correspondência incorreta será feita. Uma
|
|
exemplo disso é que <I>/usr/man/de_DE.88591</I> deve vir antes de <I>/usr/man</I>.
|
|
<DT id="5"><B>DEFINE</B><I> valor da chave</I><DD>
|
|
Linhas nesta forma definem diversas variáveis de configuração; veja o
|
|
arquivo de configuração padrão para aquelas variáveis usadas pelos
|
|
utilitários paginação de manual. Eles incluem caminhos de padrão para
|
|
programas variados (tais como <I>grep</I> e <I>tbl</I>) e conjuntos padrões de
|
|
argumentos daqueles programas.
|
|
<DT id="6"><B>SECTION</B> <I>seção</I> ...<DD>
|
|
<DL COMPACT><DT id="7"><DD>
|
|
Linhas nesta forma definem a ordem na qual seções de manual devem ser
|
|
pesquisadas. Caso não há diretivas <B>SECTION</B> no arquivo de configuração, o
|
|
padrão é:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="8"><DD>
|
|
<PRE>
|
|
SECTION 1 n l 8 3 0 2 5 4 9 6 7</PRE>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Se múltiplas diretivas <B>SECTION</B> forem fornecidas, suas listas de seções
|
|
serão concatenadas.
|
|
<P>
|
|
|
|
Se uma extensão em particular não estiver nessa lista (digamos, 1mh), ela
|
|
será exibida com o resto da seção à qual ela pertence. O efeito disso é que
|
|
você apenas precisa listar explicitamente extensões se você deseja forçar
|
|
uma ordem em particular. As seções com extensões geralmente devem ser
|
|
adjacente às suas seções principais (ex.: "1 1mh 8 ...").
|
|
<P>
|
|
|
|
<B>SECTIONS</B> é aceito como um nome alternativo para essa diretiva.
|
|
</DL>
|
|
|
|
<DT id="9"><B>MINCATWIDTH</B><I> largura</I><DD>
|
|
Se a largura do terminal é menor que <I>largura</I>, páginas cat não serão
|
|
criadas (se estiverem faltando) ou exibidas. O padrão é 80.
|
|
<DT id="10"><B>MAXCATWIDTH</B><I> largura</I><DD>
|
|
Se a largura do terminal é maior que <I>largura</I>, páginas cat não serão
|
|
criadas (se estiverem faltando) ou exibidas. O padrão é 80.
|
|
<DT id="11"><B>CATWIDTH</B><I> largura</I><DD>
|
|
Se <I>largura</I> é diferente de zero, páginas cat sempre serão formatadas para
|
|
um terminal da largura fornecida, independente da largura usada para o
|
|
terminal. Isso geralmente deve estar dentro do intervalo definido por
|
|
<B>MINCATWIDTH</B> e <B>MAXCATWIDTH</B>.
|
|
<DT id="12"><B>NOCACHE</B>
|
|
|
|
|
|
<DD>
|
|
Essa opção evita que <B><A HREF="/cgi-bin/man/man2html?1+man">man</A></B>(1) crie páginas cat automaticamente.
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>PROBLEMAS</H2>
|
|
|
|
A menos que as regras acima sejam seguidas e observadas com muita atenção,
|
|
os utilitários de paginação de manual não funcionarão como desejado. As
|
|
regras são excessivamente complicadas.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="13"><A HREF="#lbAB">NOME</A><DD>
|
|
<DT id="14"><A HREF="#lbAC">DESCRIÇÃO</A><DD>
|
|
<DT id="15"><A HREF="#lbAD">FORMATO</A><DD>
|
|
<DT id="16"><A HREF="#lbAE">PROBLEMAS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:21 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|