gethostname

GETHOSTNAME(2)           Manual del programador de Linux          GETHOSTNAME(2)



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)