getdomainname(2)              System Calls Manual             getdomainname(2)

NOMBRE
       getdomainname, setdomainname - obtiene/asigna el nombre del dominio

BIBLIOTECA
       Biblioteca Estandar 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 Caracteristicas para glibc (vease
   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 version de glibc 2.19 y superiores:
               _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)

DESCRIPCION
       Estas funciones se utilizan para acceder o modificar el nombre de
       dominio NIS del sistema host. Mas 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 numero de
       bytes en name. (Por lo tanto, name no requiere un byte nulo de
       terminacion).

       getdomainname() devuelve el nombre de dominio terminado en nulo en el
       vector de caracteres name, que tiene un tamano de size bytes. Si el
       nombre de dominio terminado en nulo requiere mas de len bytes,
       getdomainname() devuelve los primeros len bytes (glibc) o genera un
       error (libc).

VALOR DEVUELTO
       En caso de exito 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 tenia 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 mayoria de las arquitecturas Linux (incluidas x86), no existe una
       llamada de sistema getdomainname(); en su lugar, glibc implementa
       getdomainname() como una funcion de biblioteca que retorna una copia
       del campo domainname devuelto por una llamada a uname(2).

ESTANDARES
       Ninguno.

HISTORIAL
       Desde Linux 1.0, el limite de tamano de un nombre de dominio,
       incluyendo el byte nulo de terminacion, es de 64 bytes. En nucleos
       anteriores, era de 8 bytes.

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

TRADUCCION
       La traduccion al espanol de esta pagina del manual fue creada por
       Miguel Angel Sepulveda <angel@vivaldi.princeton.edu>, Nicolas
       Lichtmaier <nick@debian.org>, Gerardo Aburruzaga Garcia
       <gerardo.aburruzaga@uca.es> y Marcos Fouces <marcos@debian.org>

       Esta traduccion es documentacion 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 algun error en la traduccion de esta pagina del manual,
       envie un correo electronico a <debian-l10n-spanish@lists.debian.org>.

Paginas de Manual de Linux 6.15  28 Junio 2025                getdomainname(2)