Man page - setdomainname(2)

Packages contains this manual

Available languages:

en fr pt_BR es pl ja ru ro de

Manual

getdomainname

NOME
BIBLIOTECA
SINOPSE
DESCRIÇÃO
VALOR DE RETORNO
ERROS
VERSÕES
PADRÕES
HISTÓRICO
VEJA TAMBÉM
TRADUÇÃO

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

getdomainname () retorna o nome de domínio com terminação nula na matriz de caracteres nome . a qual possui o comprimento de comp bytes. Se o nome do domínio com terminação 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 é 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

comp 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: nome é NULL ou nome ser maior que comp 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

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.

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