NOMBRE

       gethostname, sethostname - obtiene/asigna el nombre del host

SINOPSIS

       #include <unistd.h>

       int gethostname(char *name, size_t len);
       int sethostname(const char *name, size_t len);

DESCRIPCIÓN

       Estas  funciones  se  usan  para  obtener  o  cambiar  el nombre del host del proceso actual.  La función
       gethostname() devuelve un nombre de host acabado en NULL (establecido anteriormente por sethostname()) en
       el array name que tiene una longitud de len bytes.  En el caso en que el nombre de host acabado  en  NULL
       no  quepa,  no se devuelve un error, pero se trunca el nombre de host. Queda sin especificar si el nombre
       de host truncado terminará en NULL.

VALOR DEVUELTO

       En caso de éxito devuelve un 0. En caso de error,devuelve un -1, y errno se asigna apropiadamente.

ERRORES

       EINVAL len es negativo o, para sethostname, len es mas largo que el máximo de tamaño permitido,  o,  para
              gethostname  en  Linux/i386,  len es mas corto que el tamaño actual.  (In this last case glibc 2.1
              uses ENAMETOOLONG.)

       EPERM  Para sethostname, realizar la llamada no hace falta estar como superusuario.

       EFAULT name es una dirección inválida.

CONFORME A

       SVr4, 4.4BSD   (esta  función  apareció  por  primera  vez  en  4.2BSD).   POSIX  1003.1-2001  especifica
       gethostname pero no sethostname.

FALLOS

       Para  muchas  combinaciones  núcleo  Linux / libc gethostname devolverá un error en lugar de un nombre de
       host truncado.

OBSERVACIONES

       SUSv2 garantiza que `Los nombres de host están limitados a 255 bytes'.  POSIX 1003.1-2001  garantiza  que
       `Los nombres de host (sin incluir el carácter NULL del final) están limitados a HOST_NAME_MAX bytes'.

VÉASE TAMBIÉN

       getdomainname(2), setdomainname(2), uname(2)

Linux 2.5.0                                     15 Diciembre 2001                                 GETHOSTNAME(2)