NOMBRE¶

getdomainname, setdomainname - obtiene/asigna el nombre del dominio

BIBLIOTECA¶

Biblioteca Estándar C (libc, -lc)

SINOPSIS¶

#include <unistd.h>

int getdomainname(size_t size;
                  char name[size], size_t size);
int setdomainname(size_t size;
                  const char name[size], size_t size);

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 size 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 el vector de caracteres name, que tiene un tamaño de size bytes. Si el nombre de dominio terminado en nulo requiere más de len bytes, getdomainname() devuelve los primeros len bytes (glibc) o genera 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

size era negativo o demasiado grande.

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() en libc: name es NULL o name tiene una longitud igual o mayor que size 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¶

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.

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.