getdomainname(2)

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);

    Requisitos de Macros de Prueba de Características para glibc (véase feature_test_macros(7)):

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.