FreeBSD Manual Pages
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, de- fined 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://man.freebsd.org/cgi/man.cgi?query=gethostname&sektion=3c&manpath=SunOS+5.10>