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

   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

       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 é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  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 más de len bytes.

ESTÁNDARES

       POSIX no especifica estas llamadas.

NOTAS

       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.

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

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⟩.