4.1cBSD/usr/man/man2/gethostname.2

Compare this file to the similar file:
Show the results in this format:
.TH GETHOSTNAME 2 2/12/83
.SH NAME
gethostname, sethostname \- get/set name of current host
.SH SYNOPSIS
.nf
.ft B
gethostname(name, anamelen)
char *name;
int *anamelen;
.PP
.ft B
sethostname(name, namelen)
char *name;
int namelen;
.fi
.SH DESCRIPTION
.I Gethostname
returns the standard host name for the current processor, as
previously set by
.IR sethostname . 
The parameter
.I namelen
specifies the size of the 
.I name
array, and is modified on return to indicate the actual size
of the host name returned.
The name is null-terminated.
.PP
.I Sethostname
sets the name of the host machine to be
.IR name ,
which has length
.IR namelen .
This is normally executed when the system is bootstrapped.
.SH "RETURN VALUE
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 int the global location \fIerrno\fP.
.SH "ERRORS
The following errors may be returned by these calls:
.TP 15
[EFAULT]
The \fIname\fP or \fInamelen\fP parameter gave an
invalid address.
.SH SEE ALSO
gethostid(2)
.SH BUGS
Host names are limited to 255 characters.