Man - Comando Linux

homem-acdfFhkKtwW --caminho -m sistema -p corda -C config_file -M lista de caminho -P pager -S section_list seção nome …

Opções

-C arquivo_de_configuração

Especifique o arquivo de configuração a ser usado; o padrão é/etc/man.config. (Vejoman.conf(5).)

Caminho -M

Especifique a lista de diretórios para procurar páginas man. Separe os diretórios com dois pontos. Uma lista vazia é a mesma que não especificar-M em absoluto. VejoCAMINHO DE PESQUISA PARA PÁGINAS MANUAIS.

-P pager

Especifique qual pager usar. Esta opção substitui aMANPAGER variável de ambiente, que por sua vez substitui aPAGER variável. Por padrão,homem usa/ usr / bin / less -isr.

-S section_list

List é uma lista separada por dois pontos de seções manuais para pesquisa. Esta opção substitui aMANSECTvariável de ambiente.

-uma

Por padrão,homem sairá depois de exibir a primeira página manual que encontrar. Usando esta opção forçahomem para exibir todas as páginas de manual correspondentesnome,não apenas o primeiro.

-c

Reformate a página do manual de origem, mesmo quando existe uma página de cat up-to-date. Isso pode ser significativo se a página do cat foi formatada para uma tela com um número diferente de colunas ou se a página pré-formatada estiver corrompida.

-d

Na verdade, não exiba as páginas do manual, mas imprima um monte de informações de depuração.

-D

Ambos exibem e imprimem informações de depuração.

-f

Equivalente ao que é.

-F ou--preformat

Somente formato - não é exibido.

-h

Imprima uma mensagem de ajuda de uma linha e saia.

-k

Equivalente aapropos.

-K

Procure a string especificada em * todas as páginas man. Aviso: isso provavelmente é muito lento! Isso ajuda a especificar uma seção. (Só para dar uma ideia aproximada, na minha máquina isso leva cerca de um minuto por 500 páginas man.)

-m sistema

Especifique um conjunto alternativo de páginas man para pesquisar com base no nome do sistema fornecido.

-p string

Especifique a sequência de pré-processadores a serem executados antesnroff outroff. Nem todas as instalações terão um conjunto completo de pré-processadores. Alguns dos pré-processadores e as letras usadas para designá-los são: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), referir (r). Esta opção substitui aMANROFFSEQ variável de ambiente.

-t

Usar/ usr / bin / groff -Tps -mandoc para formatar a página de manual, passando a saída parastdout. A saída de/ usr / bin / groff -Tps -mandoc pode precisar passar por algum filtro ou outro antes de ser impresso.

-Wou - caminho

Na verdade, não exiba as páginas do manual, mas imprima a (s) localização (ões) dos arquivos que seriam formatados ou exibidos. Se nenhum argumento for fornecido: display (no stdout) a lista de diretórios que é pesquisada porhomem para páginas man. E semanpath é um link para o homem, então "manpath" é equivalente a "man - path".

-W

Como -w, mas imprime os nomes dos arquivos um por linha, sem informações adicionais. Isso é útil em comandos shell comohomem -aW homem | xargs ls -l

Páginas CAT

O Man tentará salvar as páginas do manual formatadas, a fim de economizar o tempo de formatação na próxima vez em que essas páginas forem necessárias. Tradicionalmente, as versões formatadas de páginas em DIR / manX são salvas em DIR / catX, mas outros mapeamentos de man dir para cat dir podem ser especificados em/etc/man.config. Nenhuma página de cat é salva quando o diretório de cat obrigatório não existe. Nenhuma página de cat é salva quando é formatada para um comprimento de linha diferente de 80. Nenhuma página de cat é salva quando man.conf contém a linha NOCACHE.

É possível fazerhomem suid para um usuário homem. Então, se um diretório cat tiver o proprietário man e o modo 0755 (somente gravável pelo homem), e os arquivos cat possuírem o proprietário man e os modos 0644 ou 0444 (somente graváveis ​​pelo homem, ou não graváveis), nenhum usuário comum pode alterar o cat pages ou colocar outros arquivos no diretório cat. E sehomem não é feito suid, então um diretório cat deve ter o modo 0777 se todos os usuários puderem deixar páginas de cat.

A opção-c força a reformatação de uma página, mesmo que exista uma página de gato recente.

Caminho de pesquisa para páginas de manual

homem usa um método sofisticado de localizar arquivos de páginas manuais, com base nas opções de invocação e variáveis ​​de ambiente,/etc/man.configarquivo de configuração e algumas convenções e heurísticas internas.

Primeiro de tudo, quando o nome argumento parahomem contém uma barra (/), homem assume que é uma especificação de arquivo em si e não há busca envolvida.

Mas no caso normal, onde nome não contém uma barrahomem procura em uma variedade de diretórios por um arquivo que pode ser uma página de manual para o tópico chamado.

Se você especificar o-M lista de caminho opção, lista de caminho é uma lista separada por dois pontos dos diretórios quehomempesquisas.

Se você não especificar-M mas defina oMANPATH variável de ambiente, o valor dessa variável é a lista dos diretórios quehomem pesquisas.

Se você não especificar uma lista de caminhos explícitos com-M ouMANPATH, homem desenvolve sua própria lista de caminhos com base no conteúdo do arquivo de configuração/etc/man.config. oMANPATH As instruções no arquivo de configuração identificam diretórios específicos para incluir no caminho de pesquisa.

Além disso, oMANPATH_MAPinstruções adicionadas ao caminho de pesquisa, dependendo do caminho de pesquisa do comando (ou seja,CAMINHOvariável de ambiente). Para cada diretório que pode estar no caminho de busca do comando,MANPATH_MAP A instrução especifica um diretório que deve ser adicionado ao caminho de pesquisa dos arquivos de páginas manuais.homem olha para oCAMINHO variável e adiciona os diretórios correspondentes ao caminho de pesquisa do arquivo de páginas de manual. Assim, com o uso adequado deMANPATH_MAP, quando você emite o comandohomem xyz, você obtém uma página de manual para o programa que seria executado se você emitisse o comandoxyz.

Além disso, para cada diretório no caminho de busca do comando (vamos chamá-lo de "diretório de comando") para o qual você faz não tenha umMANPATH_MAPdeclaração,homem procura automaticamente por um diretório de páginas de manual "próximo", ou seja, como um subdiretório no próprio diretório de comando ou no diretório pai do diretório de comando.

Você pode desativar as pesquisas automáticas "por perto" incluindo umaNOAUTOPATH declaração em/etc/man.config.

Em cada diretório no caminho de pesquisa, conforme descrito acima,homem procura por um arquivo chamado tópico . seção , com um sufixo opcional no número da seção e possivelmente um sufixo de compactação. Se ele não encontrar tal arquivo, ele procura em qualquer subdiretório chamadohomem N ougato N Onde N é o número da seção do manual. Se o arquivo estiver em umgato N subdiretório,homem assume que é um arquivo de paginação manual formatado (página cat). De outra forma,homem assume que não está formatado. Em ambos os casos, se o nome do arquivo tiver um sufixo de compressão conhecido.gz), homem assume que é gzipado.

Se você quiser ver onde (ou se)homem encontrar a página de manual para um tópico em particular, use o--caminho(-W) opção.

Importante: Use o homem comando ( % homem ) para ver como um comando é usado em seu computador particular.