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(size_t size;
                         char name[size], size_t size);
       int setdomainname(size_t size;
                         const char name[size], size_t size);

   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()  sets the domain name to the value given in the
       character array name.  The size argument specifies the number of bytes
       in name.  (Thus, name does not require a terminating null byte.)

       getdomainname()  returns the null-terminated domain name in the
       character array name, which has a size of size bytes.  If the
       null-terminated domain name requires more than len bytes,
       getdomainname()  returns the first len bytes (glibc) or gives an error
       (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 size was negative or too large.

       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 For getdomainname()  under libc: name is NULL or name is equal
              or longer than size 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
       Nenhum.

HISTORICO
       Since Linux 1.0, the limit on the size of a domain name, including the
       terminating null byte, is 64 bytes.  In older kernels, it was 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.18           8 fevereiro 2026               getdomainname(2)