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)