(BSD System Compatibility)
gethostname, sethostname --
get/set name of current host
/usr/ucb/cc [flag . . . ] file . . .
int gethostname(char *name, int namelen);
int sethostname(char *name, int namelen);
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.
returns the standard host name for the current processor, as previously set by
specifies the size of the array pointed to by
The returned name is null-terminated unless insufficient
space is provided.
sets the name of the host machine to be
which has length
This call is restricted to the privileged 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
The following error may be returned by these calls:
parameter gave an
The caller was not the privileged user.
Note: this error only applies to
``BSD system libraries and header files'' in Programming with system calls and libraries
Host names are limited to
characters, currently 256.
param.h header file.)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004