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(char *nombre, size_t len);
       int setdomainname(const char *nombre, size_t len);

   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
       These functions are used to access or to change the NIS domain name of
       the host system.  More precisely, they operate on the NIS domain name
       associated with the calling process's UTS namespace.

       setdomainname()  sets the domain name to the value given in the
       character array name.  The len argument specifies the number of bytes
       in name.  (Thus, name does not require a terminating null byte.)

       getdomainname()  returns the null-terminated domain name in the
       character array name, which has a length of len bytes.  If the
       null-terminated domain name requires more than len bytes,
       getdomainname()  returns the first len bytes (glibc) or gives an 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 len era demasiado grande o menor que 0.

       EPERM  The caller did not have the CAP_SYS_ADMIN capability in the user
              namespace associated with its UTS namespace (see namespaces(7)).

       getdomainname() puede dar fallos con los siguientes errores:

       EINVAL Para getdomainname() bajo libc: name es NULL o name tiene mas de
              len bytes.

VERSIONES
       On most Linux architectures (including x86), there is no
       getdomainname() system call; instead, glibc implements getdomainname()
       as a library function that returns a copy of the domainname field
       returned from a call to uname(2).

ESTANDARES
       None.

HISTORIAL
       Since Linux 1.0, the limit on the length of a domain name, including
       the terminating null byte, is 64 bytes.  In older kernels, it was 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.06 31 Octubre 2023               getdomainname(2)