.\" -*- coding: UTF-8 -*- .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" 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 "30 março 2023" "Linux man\-pages 6.05.01" .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 \fP .PP \fBint getdomainname(char *\fP\fInome\fP\fB, size_t \fP\fIcomp\fP\fB);\fP \fBint setdomainname(const char *\fP\fInome\fP\fB, size_t \fP\fIcomp\fP\fB);\fP .fi .PP .RS -4 Requisitos de macro de teste de recursos para o glibc (consulte \fBfeature_test_macros\fP(7)): .RE .PP \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. .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. 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 \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 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... None. .SH 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. .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 , 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 .