.\" -*- coding: UTF-8 -*-
.\" 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 "28 Junio 2025" "Páginas de Manual de Linux 6.15" 
.SH NOMBRE
getdomainname, setdomainname \- obtiene/asigna el nombre del dominio
.SH BIBLIOTECA
Biblioteca Estándar C (\fIlibc\fP,\ \fI\-lc\fP)
.SH SINOPSIS
.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 Macros de Prueba de Características para glibc (véase
\fBfeature_test_macros\fP(7)):
.RE
.P
\fBgetdomainname\fP(), \fBsetdomainname\fP():
.nf
.\"		commit 266865c0e7b79d4196e2cc393693463f03c90bd8
    A partir de glibc 2.21:
        _DEFAULT_SOURCE
    En glibc 2.19 y 2.20:
        _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
    Para la versión de glibc 2.19 y superiores:
        _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
.fi
.SH DESCRIPCIÓN
Estas funciones se utilizan para acceder o modificar el nombre de dominio
NIS del sistema host. Más precisamente, operan sobre el nombre de dominio
NIS asociado al espacio de nombres UTS del proceso que realiza la llamada.
.P
\fBsetdomainname\fP() establece el nombre de dominio con el valor dado en el
vector de caracteres \fIname\fP. El argumento \fIsize\fP especifica el número de
bytes en \fIname\fP. (Por lo tanto, \fIname\fP no requiere un byte nulo de
terminación).
.P
\fBgetdomainname\fP() devuelve el nombre de dominio terminado en nulo en el
vector de caracteres \fIname\fP, que tiene un tamaño de \fIsize\fP bytes. Si el
nombre de dominio terminado en nulo requiere más de \fIlen\fP bytes,
\fBgetdomainname\fP() devuelve los primeros \fIlen\fP bytes (glibc) o genera un
error (libc).
.SH "VALOR DEVUELTO"
En caso de éxito se devuelve cero. En caso de error se devuelve \-1, y
\fIerrno\fP se configura para indicar el error.
.SH ERRORES
\fBsetdomainname\fP() puede dar fallos con los siguientes errores:
.TP 
\fBEFAULT\fP
\fIname\fP apuntaba afuera del espacio de direcciones del usuario.
.TP 
\fBEINVAL\fP
\fIsize\fP era negativo o demasiado grande.
.TP 
\fBEPERM\fP
El emisor no tenía la capacidad \fBCAP_SYS_ADMIN\fP en el espacio de nombres de
usuario asociado a su espacio de nombres UTS (consulte \fBnamespaces\fP(7)).
.P
\fBgetdomainname\fP() puede dar fallos con los siguientes errores:
.TP 
\fBEINVAL\fP
Para \fBgetdomainname\fP() en libc: \fIname\fP es NULL o \fIname\fP tiene una
longitud igual o mayor que \fIsize\fP bytes.
.SH VERSIONES
En la mayoría de las arquitecturas Linux (incluidas x86), no existe una
llamada de sistema \fBgetdomainname\fP(); en su lugar, glibc implementa
\fBgetdomainname\fP() como una función de biblioteca que retorna una copia del
campo \fIdomainname\fP devuelto por una llamada a \fBuname\fP(2).
.SH ESTÁNDARES
.\" But they appear on most systems...
Ninguno.
.SH HISTORIAL
Desde Linux 1.0, el límite de tamaño de un nombre de dominio, incluyendo el
byte nulo de terminación, es de 64 bytes. En núcleos anteriores, era de 8
bytes.
.SH "VÉASE TAMBIÉN"
\fBgethostname\fP(2), \fBsethostname\fP(2), \fBuname\fP(2), \fButs_namespaces\fP(7)
.PP
.SH TRADUCCIÓN
La traducción al español de esta página del manual fue creada por
Miguel Angel Sepulveda <angel@vivaldi.princeton.edu>,
Nicolás Lichtmaier <nick@debian.org>,
Gerardo Aburruzaga García <gerardo.aburruzaga@uca.es>
y
Marcos Fouces <marcos@debian.org>
.
.PP
Esta traducción es documentación libre; lea la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
o posterior con respecto a las condiciones de copyright.
No existe NINGUNA RESPONSABILIDAD.
.PP
Si encuentra algún error en la traducción de esta página del manual, envíe un
correo electrónico a
.MT debian-l10n-spanish@lists.debian.org
.ME .