.\" Copyright (c) 1983 The Regents of the University of California.
.\" %sccs.include.redist.man%
.\" @(#)gethostname.3 6.6 (Berkeley) %G%
gethostname, sethostname \- get/set name of current host
gethostname(name, namelen)
sethostname(name, namelen)
returns the standard host name for the current processor, as
specifies the size of the
array. The returned name is null-terminated unless insufficient
sets the name of the host machine to be
This call is restricted to the super-user and
is normally used only when the system is bootstrapped.
If the call succeeds a value of 0 is returned. If the call
fails, then a value of \-1 is returned and an error code is
placed in the global location \fIerrno\fP.
The following errors may be returned by these calls:
The \fIname\fP or \fInamelen\fP parameter gave an
The caller tried to set the hostname and was not the super-user.
Host names are limited to MAXHOSTNAMELEN (from
characters, currently 64.