Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/s/sethostname.html on line 1
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/s/sethostname.html on line 1
Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/s/sethostname.html on line 8
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/s/sethostname.html on line 8
Set the name of the current host
#include <unistd.h>
int sethostname( const char * name,
size_t namelen );
- name
- The name that you want to use for the host machine.
Hostnames are limited to MAXHOSTNAMELEN characters (defined in
<sys/param.h>).
- namelen
- The length of the name.
libc
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. |
- 0
- Success.
- -1
- An error occurred
(errno
is set).
- EFAULT
- Either name or namelen gave an
invalid address.
- EPERM
- Although the caller wasn't the superuser, it tried to
set the hostname.
Unix
Safety: | |
Cancellation point |
Yes |
Interrupt handler |
No |
Signal handler |
Yes |
Thread |
Yes |
This function is restricted to
the superuser, and is normally used only at boot time.
gethostname()
Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/s/sethostname.html on line 176
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/s/sethostname.html on line 176