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 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 , Ricardo C.O.Freitas e Rafael Fontenelle . Esta traducao e uma documentacao livre; leia a Licenca Publica Geral GNU Versao 3 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 . Linux man-pages 6.8 2 maio 2024 getdomainname(2)