GETDOMAINNAME(2) Manual do Programador do Linux GETDOMAINNAME(2)

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

#include <unistd.h>

int getdomainname(char *name, size_t len);
int setdomainname(const char *name, size_t len);


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)

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() define o nome do domínio para o valor fornecido na matriz de caracteres name. O argumento len especifica o número de bytes em name. (Portanto, name não requer um byte nulo de terminação.)

getdomainname() retorna o nome de domínio com terminação nula na matriz de caracteres name. a qual possui o comprimento de len bytes. Se o nome do domínio com terminação nula precisar de mais que len bytes, getdomainname() retorna os primeiros len bytes (glibc) ou um erro (libc).

Em caso de sucesso, zero é retornado. Caso contrário, -1 é retornado, e errno é selecionado adequadamente.

setdomainname() pode falhar com os seguintes erros:
EFAULT
name aponta para fora do espaço de endereços.
EINVAL
len era negativo ou muito grande.
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
Para getdomainname(), na libc: name é NULL ou name ser maior que len bytes.

POSIX não especifíca esta chamada.

Desde o Linux 1.0, o limite para o comprimento de um nome de domínio, incluindo o byte nulo final, é de 64 bytes. Nos kernels antigos, eram 8 bytes.

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).

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

Esta página faz parte da versão 5.08 do projeto Linux man-pages. Uma descrição do projeto, informações sobre relatórios de bugs e a versão mais recente desta página podem ser encontradas em https://www.kernel.org/doc/man-pages/.

A tradução para português brasileiro desta página man foi criada por André L. Fassone Canova <lonelywolf@blv.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 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 <debian-l10n-portuguese@lists.debian.org>.

10 outubro 2019 Linux