Manuais para a linha de comandos

Man » Manual online do host - documentação online detalhada para a página de manual do host

🌍
host - utilitário de pesquisa DNS

SINTAXE

host [-aACdlnrsTUwv] [-c class] [-N ndots] [-p port] [-R number] [-t type] [-W wait] [-m flag] [
[-4] | [-6] ] [-v] [-V] {name} [server]

DESCRIÇÃO

host é um utilitário simples para realizar pesquisas DNS. Normalmente, é usado para converter nomes em endereços IP e vice-versa. Quando nenhum argumento ou opção é fornecido, host imprime um breve resumo de seus argumentos e opções de linha de comando.

name é o nome de domínio que deve ser pesquisado. Também pode ser um endereço IPv4 decimal pontuado ou um endereço IPv6 delimitado por dois pontos, caso em que host, por padrão, executa uma pesquisa reversa para esse endereço. server é um argumento opcional que é o nome ou endereço IP do servidor de nomes que host deve consultar, em vez do servidor ou servidores listados em /etc/resolv.conf.

OPÇÕES

-4 Esta opção especifica que apenas IPv4 deve ser usado para a consulta. Consulte também a opção -6.

-6 Esta opção especifica que apenas IPv6 deve ser usado para a consulta. Consulte também a opção -4.

-a A opção -a ("tudo") normalmente é equivalente a -v -t ANY. Também afeta o comportamento da opção de lista de zona -l.

-A A opção -A ("quase tudo") é equivalente a -a, exceto que os registros RRSIG, NSEC e NSEC3 são omitidos da saída.

-c class Esta opção especifica a classe de consulta, que pode ser usada para pesquisar registros de recursos HS (Hesiod) ou CH (Chaosnet). A classe padrão é IN (Internet).

-C Esta opção indica que named deve verificar a consistência, o que significa que host consulta os registros SOA para o nome da zona de todos os servidores de nomes autoritativos listados para essa zona. A lista de servidores de nomes é definida pelos registros NS que são encontrados para a zona.

-d Esta opção imprime rastreamentos de depuração e é equivalente à opção verbose -v.

-l Esta opção diz a named para listar a zona, o que significa que o comando host executa uma transferência de zona de zone name e imprime os registros NS, PTR e de endereço (A/AAAA).

Juntas, as opções -l -a imprimem todos os registros na zona.

-N ndots Esta opção especifica o número de pontos (ndots) que devem estar em name para que ele seja considerado absoluto. O valor padrão é aquele definido usando a instrução ndots em /etc/resolv.conf, ou 1 se nenhuma instrução ndots estiver presente. Nomes com menos pontos são interpretados como nomes relativos e são pesquisados nos domínios listados nas diretivas search ou domain em /etc/resolv.conf.

-p port Esta opção especifica a porta para consultar no servidor. O padrão é 53.

-r Esta opção especifica uma consulta não recursiva; definir esta opção limpa o bit RD (recursão desejada) na consulta. Isso significa que o servidor de nomes que recebe a consulta não tenta resolver o nome. A opção -r permite que host imite o comportamento de um servidor de nomes, fazendo consultas não recursivas e esperando receber respostas para essas consultas que possam ser referências para outros servidores de nomes.

-R number Esta opção especifica o número de tentativas para consultas UDP. Se o número for negativo ou zero, o número de tentativas será silenciosamente definido como 1. O valor padrão é 1, ou o valor da opção attempts em /etc/resolv.conf, se definido.

-s Esta opção diz a named para não enviar a consulta para o próximo servidor de nomes se algum servidor responder com uma resposta SERVFAIL, que é o oposto do comportamento normal do resolvedor de stub.

-t type Esta opção especifica o tipo de consulta. O argumento type pode ser qualquer tipo de consulta reconhecido: CNAME, NS, SOA, TXT, DNSKEY, AXFR, etc.

Quando nenhum tipo de consulta é especificado, host seleciona automaticamente um tipo de consulta apropriado. Por padrão, ele procura registros A, AAAA, MX e HTTPS. Se a opção -C for fornecida, as consultas são feitas para registros SOA. Se name for um endereço IPv4 decimal pontuado ou um endereço IPv6 delimitado por dois pontos, host consulta registros PTR.

Se um tipo de consulta IXFR for escolhido, o número de série inicial pode ser especificado anexando um sinal de igual (=), seguido pelo número de série inicial, por exemplo, -t IXFR=12345678.

-T, -U Esta opção especifica TCP ou UDP. Por padrão, host usa UDP ao fazer consultas; a opção -T faz com que ele use uma conexão TCP ao consultar o servidor de nomes. TCP é selecionado automaticamente para consultas que o exigem, como solicitações de transferência de zona (AXFR). As consultas do tipo ANY têm como padrão TCP, mas podem ser forçadas a usar UDP inicialmente por meio de -U.

-m flag Esta opção define a depuração do uso de memória: a flag pode ser record, usage ou trace. A opção -m pode ser especificada mais de uma vez para definir várias flags.

-v Esta opção define a saída detalhada e é equivalente à opção de depuração -d. A saída detalhada também pode ser habilitada definindo a opção debug em /etc/resolv.conf.

-V Esta opção imprime o número da versão e sai.

-w Esta opção define "aguardar para sempre": o tempo limite da consulta é definido como o máximo possível. Consulte também a opção -W.

-W wait Esta opção define o comprimento do tempo limite de espera, indicando que named deve aguardar até wait segundos por uma resposta. Se wait for menor que 1, o intervalo de espera será definido como 1 segundo.

Por padrão, host aguarda 5 segundos para respostas UDP e 10 segundos para conexões TCP. Esses padrões podem ser substituídos pela opção timeout em /etc/resolv.conf.

Consulte também a opção -w.

SUPORTE IDN

Se host foi construído com suporte IDN (nome de domínio internacionalizado), ele pode aceitar e exibir nomes de domínio não ASCII. host converte adequadamente a codificação de caracteres de um nome de domínio antes de enviar uma solicitação a um servidor DNS ou exibir uma resposta do servidor. Para desativar o suporte IDN, defina a variável de ambiente IDN_DISABLE. O suporte IDN é desativado se a variável for definida quando host for executado.

ARQUIVOS

/etc/resolv.conf

VEJA TAMBÉM

dig(1), named(8).

AUTOR

Internet Systems Consortium

DIREITOS AUTORAIS

2025 Internet Systems Consortium