@comment The start of a comment is indicated by the following comment. This
@comment syntax is used by the script funcstxh.sh: @comment function <name>

@comment function sethostname

@node sethostname, resolver
@findex sethostname

@c This file was originally a Linux man page - see the copyright below. It
@c was modified for use in libsocket by Richard Dawe <richdawe@bigfoot.com>.

@c Hey Emacs! This file is -*- nroff -*- source.
@c
@c Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
@c
@c Permission is granted to make and distribute verbatim copies of this
@c manual provided the copyright notice and this permission notice are
@c preserved on all copies.
@c
@c Permission is granted to copy and distribute modified versions of this
@c manual under the conditions for verbatim copying, provided that the
@c entire resulting derived work is distributed under the terms of a
@c permission notice identical to this one
@c 
@c Since the Linux kernel and libraries are constantly changing, this
@c manual page may be incorrect or out-of-date.  The author(s) assume no
@c responsibility for errors or omissions, or for damages resulting from
@c the use of the information contained herein.  The author(s) may not
@c have taken the same level of care in the production of this manual,
@c which is licensed free of charge, as they might when working
@c professionally.
@c 
@c Formatted or processed versions of this manual, if unaccompanied by
@c the source, must acknowledge the copyright and authors of this work.
@c
@c Modified 22 July 1995 by Michael Chastain <mec@duracef.shout.net>:
@c   'gethostname' is real system call on Linux/Alpha.
@c Modified Fri Jan 31 16:30:53 1997 by Eric S. Raymond <esr@thyrsus.com>


@example
#include <unistd.h>
#include <lsck/hostname.h>

int sethostname (const char *name, size_t len);
@end example

@subheading Description

This function is used to change the host name of the current processor.  The
host name is retrieved using @code{gethostname()} (@pxref{gethostname}).  The
domain name component can be retrieved and set using @code{getdomainname()}
and @code{setdomainname()} respectively (@pxref{getdomainname},
@pxref{setdomainname}).

@subheading Return value

On success, zero is returned.  On error, -1 is returned, and
@samp{errno} is set appropriately.

@subheading Errors

@table @samp
@item EINVAL
@var{len} is negative or larger than the maximum allowed size.
@item EPERM
The caller was not the superuser.
@item EFAULT
@var{name} is an invalid address.
@end table

@subheading Portability

@portability !posix, !unix98

@samp{lsck/hostname.h} is particular to libsocket.  On Linux it is defined
in @samp{unistd.h}.

@subheading Example

@example
@end example