Sets the name of the current host.
Standard C Library (libc.a)
int sethostname ( Name, NameLength)
char *Name;
int NameLength;
The sethostname subroutine sets the name of a host machine. Only programs with a root user ID can use this subroutine.
The sethostname subroutine allows a calling process with root user authority to set the internal host name of a machine on a network.
All applications containing the sethostname subroutine must be compiled with _BSD set to a specific value. Acceptable values are 43 and 44. In addition, all socket applications must include the BSD libbsd.a library.
Name | Specifies the name of the host machine. |
NameLength | Specifies the length of the Name array. |
Upon successful completion, the system returns a value of 0.
If the sethostname subroutine is unsuccessful, the subroutine handler performs the following functions:
The sethostname subroutine is unsuccessful if any of the following errors occurs:
Error | Description |
---|---|
EFAULT | The Name parameter or NameLength parameter gives an address that is not valid. |
EPERM | The calling process did not have an effective root user ID. |
The gethostid subroutine, gethostname subroutine, sethostid subroutine.
Sockets Overview and Understanding Network Address Translation in AIX 5L Version 5.2 Communications Programming Concepts.