Manuais para a linha de comandos

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

🌍
hostname - exibe ou define o nome do host do sistema
domainname - exibe ou define o nome do domínio NIS/YP do sistema
ypdomainname - exibe ou define o nome do domínio NIS/YP do sistema
nisdomainname - exibe ou define o nome do domínio NIS/YP do sistema
dnsdomainname - exibe o nome do domínio DNS do sistema

SINTAXE

hostname   [-a|--alias]   [-d|--domain]   [-f|--fqdn|--long]  [-A|--all-fqdns]  [-i|--ip-address]
[-I|--all-ip-addresses] [-s|--short] [-y|--yp|--nis]
hostname [-b|--boot] [-F|--file filename] [hostname]
hostname [-h|--help] [-V|--version]

domainname [nisdomain] [-F file]
ypdomainname [nisdomain] [-F file]
nisdomainname [nisdomain] [-F file]

dnsdomainname

DESCRIÇÃO

Hostname é usado para exibir o nome DNS do sistema e para exibir ou definir seu nome de host ou nome de domínio NIS.

OBTER NOME

Quando chamado sem argumentos, o programa exibe os nomes atuais:

hostname imprimirá o nome do sistema conforme retornado pela função gethostname(2).

domainname imprimirá o nome do domínio NIS do sistema. domainname usa a função gethostname(2), enquanto ypdomainname e nisdomainname usam a getdomainname(2).

dnsdomainname imprimirá a parte do domínio do FQDN (Nome de Domínio Totalmente Qualificado). O FQDN completo do sistema é retornado com hostname --fqdn (mas veja os avisos na seção O FQDN abaixo).

DEFINIR NOME

Quando chamado com um argumento ou com a opção --file, os comandos definem o nome do host ou o nome do domínio NIS/YP. hostname usa a função sethostname(2), enquanto todas as três domainname, ypdomainname e nisdomainname usam setdomainname(2). Observe que isso é efetivo apenas até a próxima reinicialização. Edite /etc/hostname para uma alteração permanente.

Observe que apenas o superusuário pode alterar os nomes.

Não é possível definir o FQDN ou o nome do domínio DNS com o comando dnsdomainname (veja O FQDN abaixo).

O nome do host geralmente é definido uma vez durante a inicialização do sistema em /etc/init.d/hostname.sh (normalmente lendo o conteúdo de um arquivo que contém o nome do host, por exemplo, /etc/hostname).

O FQDN

O FQDN (Nome de Domínio Totalmente Qualificado) do sistema é o nome que o resolvedor(3) retorna para o nome do host, como, ursula.example.com. Geralmente é o nome do host seguido pelo nome do domínio DNS (a parte após o primeiro ponto). Você pode verificar o FQDN usando hostname --fqdn ou o nome do domínio usando dnsdomainname.

Você não pode alterar o FQDN com hostname ou dnsdomainname.

O método recomendado para definir o FQDN é tornar o nome do host um alias para o nome totalmente qualificado usando /etc/hosts, DNS ou NIS. Por exemplo, se o nome do host fosse "ursula", você poderia ter uma linha em /etc/hosts que lê

12.0.1.1    ursula.example.com ursula

Tecnicamente: O FQDN é o nome que getaddrinfo(3) retorna para o nome do host retornado por gethostname(2). O nome do domínio DNS é a parte após o primeiro ponto.

Portanto, depende da configuração do resolvedor (geralmente em /etc/host.conf) como você pode alterá-lo. Geralmente, o arquivo hosts é analisado antes do DNS ou NIS, portanto, é mais comum alterar o FQDN em /etc/hosts.

Se uma máquina tiver várias interfaces de rede/endereços ou for usada em um ambiente móvel, ela pode ter vários FQDNs/nomes de domínio ou nenhum. Portanto, evite usar hostname --fqdn, hostname --domain e dnsdomainname. O endereço IP é sujeito às mesmas limitações, portanto, também deve ser evitado.

OPÇÕES

-a, --alias

Exibe o nome do alias do host (se usado). Esta opção está obsoleta e não deve mais ser usada.

-A, --all-fqdns

Exibe todos os FQDNs da máquina. Esta opção enumera todos os endereços de rede configurados em todas as interfaces de rede configuradas e os traduz em nomes de domínio DNS. Os endereços que não podem ser traduzidos (ou seja, porque não têm uma entrada de IP reverso apropriada) são ignorados. Observe que diferentes endereços podem resolver para o mesmo nome, portanto, a saída pode conter entradas duplicadas. Não faça suposições sobre a ordem da saída.

-b, --boot

Sempre define um nome de host; isso permite que o arquivo especificado por -F seja inexistente ou vazio, caso em que o nome de host padrão localhost será usado se nenhum já estiver definido.

-d, --domain

Exibe o nome do domínio DNS. Não use o comando domainname para obter o nome do domínio DNS, pois ele mostrará o nome do domínio NIS e não o nome do domínio DNS. Use dnsdomainname em vez disso. Veja os avisos na seção O FQDN acima e evite usar esta opção.

-f, --fqdn, --long

Exibe o FQDN (Nome de Domínio Totalmente Qualificado). Um FQDN consiste em um nome de host curto e o nome do domínio DNS. A menos que você esteja usando bind ou NIS para pesquisas de host, você pode alterar o FQDN e o nome do domínio DNS (que faz parte do FQDN) no arquivo /etc/hosts. Veja os avisos na seção O FQDN acima e use hostname --all-fqdns sempre que possível.

-F, --file filename

Lê o nome do host do arquivo especificado. Comentários (linhas que começam com um `#') são ignorados.

-i, --ip-address

Exibe o(s) endereço(s) de rede do nome do host. Observe que isso funciona apenas se o nome do host puder ser resolvido. Evite usar esta opção; use hostname --all-ip-addresses em vez disso.

-I, --all-ip-addresses

Exibe todos os endereços de rede do host. Esta opção enumera todos os endereços configurados em todas as interfaces de rede. A interface de loopback e os endereços IPv6 de link local são omitidos. Ao contrário da opção -i, esta opção não depende da resolução de nomes. Não faça suposições sobre a ordem da saída.

-s, --short

Exibe o nome do host curto. Este é o nome do host cortado no primeiro ponto.

-V, --version

Imprime informações da versão na saída padrão e sai com sucesso.

-y, --yp, --nis

Exibe o nome do domínio NIS. Se um parâmetro for fornecido (ou --file name), o usuário root também poderá definir um novo domínio NIS.

-h, --help

Imprime uma mensagem de uso e sai.

NOTAS

As famílias de endereços que o hostname tenta ao procurar o FQDN, aliases e endereços de rede do host são determinadas pela configuração do resolvedor. Por exemplo, em sistemas GNU Libc, o resolvedor pode ser instruído a tentar pesquisas IPv6 primeiro usando a opção inet6 em /etc/resolv.conf.

ARQUIVOS

/etc/hostname Historicamente, este arquivo deveria conter apenas o nome do host e não o FQDN completo. Atualmente, a maioria dos softwares é capaz de lidar com um FQDN completo aqui. Este arquivo é lido durante a inicialização do sistema pelos scripts de inicialização do sistema para definir o nome do host.

/etc/hosts Normalmente, é aqui que se define o nome do domínio, aliando o nome do host ao FQDN.

AUTORES

Peter Tobias, <_> ypdomainname e nisdomainname usam a getdomainname(2).

dnsdomainname imprimirá a parte do domínio do FQDN (Nome de Domínio Totalmente Qualificado). O FQDN completo do sistema é retornado com hostname --fqdn (mas veja os avisos na seção O FQDN abaixo).