GETHOSTNAME(3) | Library Functions Manual | GETHOSTNAME(3) |
gethostname
, sethostname
—
#include <unistd.h>
int
gethostname
(char
*name, size_t
namelen);
int
sethostname
(const
char *name, size_t
namelen);
gethostname
() returns the standard host name for the
current machine, as previously set by sethostname
().
The parameter namelen specifies the size of the
name array. 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 super-user and
is normally used only when the system is bootstrapped.
gethostname
() or
sethostname
() functions fail, they will set
errno for any of the errors specified for the routine
sysctl(3).
gethostname
() function conforms to
X/Open Portability Guide Issue 4, Version 2
(“XPG4.2”).
gethostname
function call appeared in
4.2BSD.
MAXHOSTNAMELEN
(from
⟨sys/param.h⟩) characters including
null-termination, currently 256.
September 2, 2015 | NetBSD 9.0 |