Manual del programador de Linux (2)
22 julio 1995
 

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.  

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.
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.1 no define estas funciones, pero ISO/IEC 9945-1:1990 las menciona en B.4.4.1.  

FALLOS

Otras implementaciones de gethostname devuelven en caso de éxito len bytes incluso si name es mas largo. Linux/Alpha obedece a este comportamiento. Linux/i386, sin embargo, devuelve EINVAL en este caso (a partir de las bibliotecas libc6 2.0.4).  

NOTAS

Sobre Linux/Alpha, gethostname es una llamada al sistema. Sobre Linux/i386, gethostname está implementada en el ámbito de bibliotecas mediante la llamada uname(2).  

VÉASE TAMBIÉN

getdomainname

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

Nuevo comentario