getdomainname(2)

NOME
getdomainname, setdomainname - obtém/define o nome de domínio NIS

BIBLIOTECA
Biblioteca C Padrão (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)
    Até e incluindo o glibc 2.19:
        _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

DESCRIÇÃO
Essas funções são usadas para acessar ou alterar o nome de domínio NIS do sistema host. Mais precisamente, eles operam no nome de domínio NIS associado ao espaço 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 é retornado. Em caso de erro, -1 é retornado, e errno é definido para indicar o erro.

ERROS
setdomainname() pode falhar com os seguintes erros:

EFAULT
    nome aponta para fora do espaço de endereços.

EINVAL
    size was negative or too large.

EPERM
    O chamador não tinha a capacidade CAP_SYS_ADMIN no espaço de nome de usuário associada ao seu espaço 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.

VERSÕES
Na maioria das arquiteturas Linux (incluindo x86), não há chamada de sistema getdomainname(); em vez disso, o glibc implementa getdomainname() como uma função de biblioteca que retorna uma cópia do campo domainname retornada de uma chamada para uname(2).

PADRÕES
Nenhum.

HISTÓRICO
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 TAMBÉM
gethostname(2), sethostname(2), uname(2), uts_namespaces(7)

TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por André Luiz Fassone <lonely_wolf@ig.com.br>, Ricardo C.O.Freitas <english.quest@best-service.com> e Rafael Fontenelle <rafaelff@gnome.org>.

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 (https://www.gnu.org/licenses/gpl-3.0.html) ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores (debian-l10n-portuguese@lists.debian.org).