gethostname(3BSD)    (BSD System Compatibility)    gethostname(3BSD)


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

       SYNOPSIS
             /usr/ucb/cc [flag . . . ] file . . .
             int gethostname(char *name, int namelen);
             int sethostname(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.

       REFERENCES
             gethostid(3BSD), uname(2)

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








                           Copyright 1994 Novell, Inc.               Page 1