.\" -*- coding: UTF-8 -*-
.\" Copyright 1993, Rickard E. Faith <faith@cs.unc.edu>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH getdomainname 2 "8 fevereiro 2026" "Linux man\-pages 6.18" 
.SH NOME
getdomainname, setdomainname \- obtém/define o nome de domínio NIS
.SH BIBLIOTECA
Biblioteca C Padrão (\fIlibc\fP,\ \fI\-lc\fP)
.SH SINOPSE
.nf
\fB#include <unistd.h>\fP
.P
\fBint getdomainname(\fPsize_t size;
\fB                  char \fP\fIname\fP\fB[\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB);\fP
\fBint setdomainname(\fPsize_t size;
\fB                  const char \fP\fIname\fP\fB[\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB);\fP
.fi
.P
.RS -4
Requisitos de macro de teste de recursos para o glibc (consulte
\fBfeature_test_macros\fP(7)):
.RE
.P
\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
.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.
.P
\fBsetdomainname\fP()  sets the domain name to the value given in the character
array \fIname\fP.  The \fIsize\fP argument specifies the number of bytes in
\fIname\fP.  (Thus, \fIname\fP does not require a terminating null byte.)
.P
\fBgetdomainname\fP()  returns the null\-terminated domain name in the character
array \fIname\fP, which has a size of \fIsize\fP bytes.  If the null\-terminated
domain name requires more than \fIlen\fP bytes, \fBgetdomainname\fP()  returns the
first \fIlen\fP bytes (glibc) or gives an error (libc).
.SH "VALOR DE RETORNO"
Em caso de sucesso, zero é retornado. Em caso de erro, \-1 é retornado, e
\fIerrno\fP é definido para indicar o erro.
.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
\fIsize\fP was negative or too large.
.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)).
.P
\fBgetdomainname\fP() pode falhar com os seguinte erros:
.TP 
\fBEINVAL\fP
For \fBgetdomainname\fP()  under libc: \fIname\fP is NULL or \fIname\fP is equal or
longer than \fIsize\fP bytes.
.SH VERSÕES
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 PADRÕES
.\" But they appear on most systems...
Nenhum.
.SH 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.
.SH "VEJA TAMBÉM"
\fBgethostname\fP(2), \fBsethostname\fP(2), \fBuname\fP(2), \fButs_namespaces\fP(7)
.PP
.SH 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>.
.
.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 .