gethostname(3)     UNIX System V(BSD Compatibility Package)      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.)









10/89                                                                    Page 1