getdomainname(2)              System Calls Manual             getdomainname(2)

NOME
       getdomainname, setdomainname - obtem/define o nome de dominio NIS

BIBLIOTECA
       Biblioteca C Padrao (libc, -lc)

SINOPSE
       #include <unistd.h>

       int getdomainname(char *nome, size_t comp);
       int setdomainname(const char *nome, size_t comp);

   Requisitos de macro de teste de recursos para o glibc (consulte
   feature_test_macros(7)):

       getdomainname(), setdomainname():
           Desde o glibc 2.21:
               _DEFAULT_SOURCE
           No glibc 2.19 e 2.20:
               _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
           Ate e incluindo o glibc 2.19:
               _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

DESCRICAO
       Essas funcoes sao usadas para acessar ou alterar o nome de dominio NIS
       do sistema host. Mais precisamente, eles operam no nome de dominio NIS
       associado ao espaco de nome UTS do processo de chamada.

       setdomainname() define o nome do dominio para o valor fornecido na
       matriz de caracteres nome. O argumento comp especifica o numero de
       bytes em nome. (Portanto, nome nao requer um byte nulo de terminacao.)

       getdomainname() retorna o nome de dominio com terminacao nula na matriz
       de caracteres nome. a qual possui o comprimento de comp bytes. Se o
       nome do dominio com terminacao nula precisar de mais que comp bytes,
       getdomainname() retorna os primeiros comp bytes (glibc) ou um erro
       (libc).

VALOR DE RETORNO
       Em caso de sucesso, zero e retornado. Em caso de erro, -1 e retornado,
       e errno e definido para indicar o erro.

ERROS
       setdomainname() pode falhar com os seguintes erros:

       EFAULT nome aponta para fora do espaco de enderecos.

       EINVAL comp era negativo ou muito grande.

       EPERM  O chamador nao tinha a capacidade CAP_SYS_ADMIN no espaco de
              nome de usuario associada ao seu espaco de nome UTS (consulte
              namespaces(7)).

       getdomainname() pode falhar com os seguinte erros:

       EINVAL Para getdomainname(), na libc: nome e NULL ou nome ser maior que
              comp bytes.

VERSOES
       Na maioria das arquiteturas Linux (incluindo x86), nao ha chamada de
       sistema getdomainname(); em vez disso, o glibc implementa
       getdomainname() como uma funcao de biblioteca que retorna uma copia do
       campo domainname retornada de uma chamada para uname(2).

PADROES
       None.

HISTORICO
       Desde o Linux 1.0, o limite para o comprimento de um nome de dominio,
       incluindo o byte nulo final, e de 64 bytes. Nos kernels antigos, eram 8
       bytes.

VEJA TAMBEM
       gethostname(2), sethostname(2), uname(2), uts_namespaces(7)

TRADUCAO
       A traducao para portugues brasileiro desta pagina man foi criada por
       Andre Luiz Fassone <lonely_wolf@ig.com.br>, Ricardo C.O.Freitas
       <english.quest@best-service.com> e Rafael Fontenelle
       <rafaelff@gnome.org>.

       Esta traducao e uma documentacao livre; leia a Licenca Publica Geral
       GNU Versao 3 <https://www.gnu.org/licenses/gpl-3.0.html> ou posterior
       para as condicoes de direitos autorais.  Nenhuma responsabilidade e
       aceita.

       Se voce encontrar algum erro na traducao desta pagina de manual, envie
       um e-mail para a lista de discussao de tradutores
       <debian-l10n-portuguese@lists.debian.org>.

Linux man-pages 6.06            31 outubro 2023               getdomainname(2)