GETHOSTNAME

Section: Manual del programador de Linux (2)
Updated: 22 julio 1995
Index Return to Main Contents

NOMBRE

gethostname, sethostname - obtiene/asigna el nombre del host  

SINOPSIS

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

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

Index

NOMBRE

SINOPSIS

DESCRIPCIÓN

VALOR DEVUELTO

ERRORES

CONFORME A

FALLOS

NOTAS

VÉASE TAMBIÉN

This document was created by man2html, using the manual pages.
Time: 06:16:21 GMT, January 22, 2005