gethostname(3)         C LIBRARY FUNCTIONS         gethostname(3)



NAME
     gethostname, sethostname - get/set name of current host

SYNOPSIS
     cc [ flag... ] file ... -lucb
     int gethostname(name, namelen)
     char *name;
     int namelen;
     int sethostname(name, namelen)
     char *name;
     int namelen;

DESCRIPTION
     gethostname returns the standard host name for  the  current
     processor,  as previously set by sethostname.  The parameter
     namelen specifies the size of the array pointed to by  name.
     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 privileged user and is normally used  only
     when the system is bootstrapped.

RETURN VALUE
     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
     The following error may be returned by these calls:

     EFAULT         The name or namelen parameter gave an invalid
                    address.

     EPERM          The  caller  was  not  the  privileged  user.
                    Note: this error only applies to sethostname.

SEE ALSO
     gethostid(3) uname(2) in the Programmer's Reference Manual.

NOTES
     Host  names  are  limited  to   MAXHOSTNAMELEN   characters,
     currently 256.  (See the param.h header file.)













             Last change: BSD Compatibility Package             1