Set the name of the current host
#include <unistd.h> int sethostname( const char * name, size_t namelen );
- The name that you want to use for the host machine. Hostnames are limited to MAXHOSTNAMELEN characters (defined in <sys/param.h>).
- The length of the name.
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The sethostname() function sets the name of the host machine to be name. Only the superuser can call this function; this is normally done only at boot time.
|This function sets the value of the _CS_HOSTNAME configuration string, not that of the HOSTNAME environment variable.|
- An error occurred (errno is set).
- Either name or namelen gave an invalid address.
- Although the caller wasn't the superuser, it tried to set the hostname.
This function is restricted to the superuser, and is normally used only at boot time.