gethostname(2)							gethostname(2)

NAME    [Toc]    [Back]

     gethostname, sethostname -	get/set	name of	current	host

C SYNOPSIS    [Toc]    [Back]

     #include <unistd.h>
     int gethostname (char *name, size_t namelen);
     int sethostname (char *name, int namelen);

DESCRIPTION    [Toc]    [Back]

     Gethostname returns the standard hostname for the current processor, as
     previously	set by sethostname.  The parameter namelen specifies the size
     of	the name array.	 The returned name is null-terminated and truncated if
     insufficient space	is provided.

     Sethostname sets the name of the host machine to be name, which has
     length namelen.  This call	is restricted to the superuser and is normally
     used only when the	system is bootstrapped.

RETURN VALUE    [Toc]    [Back]

     If	the call succeeds a value of 0 is returned.  If	the call fails,	then a
     value of -1 is returned and an error code is placed in the	global
     location errno.

ERRORS    [Toc]    [Back]

     The following errors may be returned by these calls:

     [EFAULT]	    The	name or	namelen	parameter gave an invalid address.

     [EPERM]	    The	caller tried to	set the	hostname and was not the
		    superuser.

     [EINVAL]	    The	namelen	parameter was too large.

SEE ALSO    [Toc]    [Back]

     gethostid(2)

BUGS    [Toc]    [Back]

     Hostnames are limited to MAXHOSTNAMELEN (from <sys/param.h>) characters,
     currently 256.


									PPPPaaaaggggeeee 1111