opensolaris man page for gethostname

gethostname(3XNET)				   X/Open Networking Services Library Functions 				gethostname(3XNET)

NAME
       gethostname - get name of current host

SYNOPSIS
       cc [ flag ... ] file ... -lxnet [ library ... ]
       #include <unistd.h>

       int gethostname(char *name, size_t namelen);

DESCRIPTION
       The  gethostname()  function  returns the standard host name for the current machine.  The namelen argument specifies the size of the array
       pointed to by the name argument.  The returned name is null-terminated, except that if namelen is an insufficient length to hold  the  host
       name, then the returned name is truncated and it is unspecified whether the returned name is null-terminated.

       Host names are limited to 255 bytes.

RETURN VALUES
       On successful completion, 0 is returned.  Otherwise, -1 is returned.

ERRORS
       No errors are defined.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       uname(1), gethostid(3C), attributes(5), standards(5)

SunOS 5.11							    10 Jun 2002 						gethostname(3XNET)