NAME    [Toc]    [Back]

     gethostname, sethostname - get/set name of current host

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <unistd.h>

     int
     gethostname(char *name, size_t namelen);

     int
     sethostname(const char *name, size_t namelen);

DESCRIPTION    [Toc]    [Back]

     gethostname() returns the standard host name 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 unless
     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 super-user and is normally
 used only when the system is bootstrapped.

RETURN VALUES    [Toc]    [Back]

     If the call succeeds a value of 0 is returned.  If the call fails, 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
                        super-user.

SEE ALSO    [Toc]    [Back]

     gethostid(3), sysctl(3), sysctl(8)

STANDARDS    [Toc]    [Back]

     The gethostname() function conforms to X/Open Portability Guide Issue 4.2
     (``XPG4.2'').

HISTORY    [Toc]    [Back]

     The gethostname function call appeared in 4.2BSD.

BUGS    [Toc]    [Back]

     Host names are limited to MAXHOSTNAMELEN (from <sys/param.h>) characters
     including null-termination, currently 256.

BSD                              June 4, 1993                              BSD