Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gethostname(3C)		 Standard C Library Functions	       gethostname(3C)

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

SYNOPSIS
       #include	<unistd.h>

       int gethostname(char *name, int namelen);

       int sethostname(char *name, int namelen);

DESCRIPTION
       The  gethostname() function returns the standard	host name for the cur-
       rent processor, as previously set by sethostname(). The	namelen	 argu-
       ment  specifies	the size of the	array pointed to by name. The returned
       name is null-terminated unless insufficient space is provided.

       The sethostname() function sets the name	of  the	 host  machine	to  be
       name,  which  has  length namelen. This call is restricted to the supe-
       ruser and is normally used only when the	system is bootstrapped.

       Host names are limited to  MAXHOSTNAMELEN  characters,  currently  256,
       defined in the <netdb.h>	header.

RETURN VALUES
       Upon  successful	 completion, gethostname() and sethostname() return 0.
       Otherwise, they return -1 and set errno to indicate the error.

ERRORS
       The gethostname() and sethostname() functions will fail if:

       EFAULT	The name or namelen argument gave an invalid address.

       The sethostname() function will fail if:

       EPERM	The {PRIV_SYS_ADMIN} privilege was not asserted	in the	effec-
		tive set of the	calling	process.

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

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

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

SunOS 5.10			  22 Mar 2004		       gethostname(3C)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=gethostname&sektion=3c&manpath=SunOS+5.10>

home | help