(BSD System Compatibility)
gethostname(3bsd)
gethostname, sethostname --
get/set name of current host
Synopsis
/usr/ucb/cc [flag . . . ] file . . .
int gethostname(char *name, int namelen);
int sethostname(char *name, int namelen);
Description
These routines are provided for compatibility with applications originally
written for BSD systems; new or ported applications should use
the equivalent System V routines instead.
See
gethostname(3C).
gethostname
returns the standard host name for the current processor, as previously set by
sethostname.
The parameter
namelen
specifies the size of the array pointed to by
name.
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 privileged user and
is normally used only when the system is bootstrapped.
Return values
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
errno.
Errors
The following error may be returned by these calls:
EFAULT-
The
name
or
namelen
parameter gave an
invalid address.
EPERM-
The caller was not the privileged user.
Note: this error only applies to
sethostname.
References
``BSD system libraries and header files'' in Programming with system calls and libraries
cc(1bsd),
ld(1bsd),
gethostid(3bsd),
uname(2)
Notices
Host names are limited to
MAXHOSTNAMELEN
characters, currently 256.
(See the
param.h header file.)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004