.\" -*- coding: UTF-8 -*- .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\" Modified 1997-08-25 by Nicolás Lichtmaier .\" Modified 2004-06-17 by Michael Kerrisk .\" Modified 2008-11-27 by mtk .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH GETDOMAINNAME 2 "10 outubro 2019" Linux "Manual do Programador do Linux" .SH NOME getdomainname, setdomainname \- obtém/define o nome de domínio NIS .SH SINOPSE \fB#include \fP .PP \fBint getdomainname(char *\fP\fIname\fP\fB, size_t \fP\fIlen\fP\fB);\fP .br \fBint setdomainname(const char *\fP\fIname\fP\fB, size_t \fP\fIlen\fP\fB);\fP .PP .RS -4 Requisitos de macro de teste de recursos para o glibc (consulte \fBfeature_test_macros\fP(7)): .RE .PP .ad l \fBgetdomainname\fP(), \fBsetdomainname\fP(): .nf .\" commit 266865c0e7b79d4196e2cc393693463f03c90bd8 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) .fi .ad .SH 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. .PP \fBsetdomainname\fP() define o nome do domínio para o valor fornecido na matriz de caracteres \fInome\fP. O argumento \fIcomp\fP especifica o número de bytes em \fInome\fP. (Portanto, \fInome\fP não requer um byte nulo de terminação.) .PP \fBgetdomainname\fP() retorna o nome de domínio com terminação nula na matriz de caracteres \fInome\fP. a qual possui o comprimento de \fIcomp\fP bytes. Se o nome do domínio com terminação nula precisar de mais que \fIcomp\fP bytes, \fBgetdomainname\fP() retorna os primeiros \fIcomp\fP bytes (glibc) ou um erro (libc). .SH "VALOR DE RETORNO" Em caso de sucesso, zero é retornado. Caso contrário, \-1 é retornado, e \fIerrno\fP é selecionado adequadamente. .SH ERROS \fBsetdomainname\fP() pode falhar com os seguintes erros: .TP \fBEFAULT\fP \fInome\fP aponta para fora do espaço de endereços. .TP \fBEINVAL\fP \fIcomp\fP era negativo ou muito grande. .TP \fBEPERM\fP O chamador não tinha a capacidade \fBCAP_SYS_ADMIN\fP no espaço de nome de usuário associada ao seu espaço de nome UTS (consulte \fBnamespaces\fP(7)). .PP \fBgetdomainname\fP() pode falhar com os seguinte erros: .TP \fBEINVAL\fP Para \fBgetdomainname\fP(), na libc: \fInome\fP é NULL ou \fInome\fP ser maior que \fIcomp\fP bytes. .SH "DE ACORDO COM" .\" But they appear on most systems... POSIX não especifíca esta chamada. .SH NOTAS 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. .PP Na maioria das arquiteturas Linux (incluindo x86), não há chamada de sistema \fBgetdomainname\fP(); em vez disso, o glibc implementa \fBgetdomainname\fP() como uma função de biblioteca que retorna uma cópia do campo \fIdomainname\fP retornada de uma chamada para \fBuname\fP(2). .SH "VEJA TAMBÉM" \fBgethostname\fP(2), \fBsethostname\fP(2), \fBuname\fP(2), \fButs_namespaces\fP(7) .SH COLOFÃO Esta página faz parte da versão 5.10 do projeto Linux \fIman\-pages\fP. 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/. .PP .SH TRADUÇÃO A tradução para português brasileiro desta página man foi criada por André Luiz Fassone , Ricardo C.O.Freitas e Rafael Fontenelle . . .PP Esta tradução é uma documentação livre; leia a .UR https://www.gnu.org/licenses/gpl-3.0.html Licença Pública Geral GNU Versão 3 .UE ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita. .PP Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para .MT debian-l10n-portuguese@lists.debian.org a lista de discussão de tradutores .ME .