NOMBRE¶

getdomainname, setdomainname - obtiene/asigna el nombre del dominio

BIBLIOTECA¶

Biblioteca Estándar C (libc, -lc)

SINOPSIS¶

#include <unistd.h>

int getdomainname(char *nombre, size_t len);
int setdomainname(const char *nombre, size_t len);

getdomainname(), setdomainname():

    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)

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.

setdomainname() establece el nombre de dominio con el valor dado en el vector de caracteres name. El argumento len especifica el número de bytes en name. (Por lo tanto, name no requiere un byte nulo de terminación).

getdomainname() devuelve el nombre de dominio terminado en nulo en la matriz de caracteres name, que tiene una longitud de len bytes. Si el nombre de dominio terminado en nulo requiere más de len bytes, getdomainname() devolverá los primeros len bytes (glibc) o generará un error (libc).

VALOR DEVUELTO¶

En caso de éxito se devuelve cero. En caso de error se devuelve -1, y errno se configura para indicar el error.

ERRORES¶

setdomainname() puede dar fallos con los siguientes errores:

EFAULT

name apuntaba afuera del espacio de direcciones del usuario.

EINVAL

len era demasiado grande o menor que 0.

EPERM

El emisor no tenía la capacidad CAP_SYS_ADMIN en el espacio de nombres de usuario asociado a su espacio de nombres UTS (consulte namespaces(7)).

getdomainname() puede dar fallos con los siguientes errores:

EINVAL

Para getdomainname() bajo libc: name es NULL o name tiene más de len bytes.

VERSIONES¶

En la mayoría de las arquitecturas Linux (incluidas x86), no existe una llamada de sistema getdomainname(); en su lugar, glibc implementa getdomainname() como una función de biblioteca que retorna una copia del campo domainname devuelto por una llamada a uname(2).

ESTÁNDARES¶

Ninguno.

HISTORIAL¶

A partir de Linux 1.0, el límite de longitud de un nombre de dominio, incluyendo el byte nulo de terminación, es de 64 bytes. En núcleos anteriores, era de 8 bytes.

VÉASE TAMBIÉN¶

gethostname(2), sethostname(2), uname(2), uts_namespaces(7)

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>

Esta traducción es documentación libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org.