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

FreeBSD Manual Pages

  
 
  

home | help
GETHOSTNAME(3)		 BSD Library Functions Manual		GETHOSTNAME(3)

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

LIBRARY
     Standard C	Library	(libc, -lc)

SYNOPSIS
     #include <unistd.h>

     int
     gethostname(char *name, int namelen);

     int
     sethostname(const 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 name array.  The returned name	is null-terminated unless in-
     sufficient	space is provided.

     Sethostname() sets	the name of the	host machine to	be name, which has
     length namelen.  This call	is restricted to the super-user	and is nor-
     mally used	only when the system is	bootstrapped.

RETURN VALUES
     Upon successful completion, the value 0 is	returned; otherwise the
     value -1 is returned and the global variable errno	is set to indicate the
     error.

ERRORS
     The following errors may be returned by these calls:

     [EFAULT]		The name or namelen parameter gave an invalid address.

     [EPERM]		The caller tried to set	the hostname and was not the
			super-user.

SEE ALSO
     gethostid(3), sysctl(3)

BUGS
     Host names	are limited to MAXHOSTNAMELEN (from <sys/param.h>) characters,
     currently 256.  This includes the trailing	NUL.

HISTORY
     The gethostname() function	call appeared in 4.2BSD.

BSD				 June 4, 1993				   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | BUGS | HISTORY

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

home | help