gethostname - phpMan

GETHOSTNAME(2)             Linux Programmer’s Manual            GETHOSTNAME(2)



NAME
       gethostname, sethostname - get/set host name

SYNOPSIS
       #include <unistd.h>

       int gethostname(char *name, size_t len);
       int sethostname(const char *name, size_t len);

DESCRIPTION
       These  functions  are used to access or to change the host name of the current pro-
       cessor.  The gethostname() function returns a NUL-terminated hostname (set  earlier
       by  sethostname())  in  the array name that has a length of len bytes.  In case the
       NUL-terminated hostname does not fit, no error is returned,  but  the  hostname  is
       truncated. It is unspecified whether the truncated hostname will be NUL-terminated.

RETURN VALUE
       On success, zero is returned.  On error, -1 is returned, and errno is set appropri-
       ately.

ERRORS
       EINVAL len  is negative or, for sethostname, len is larger than the maximum allowed
              size, or, for gethostname on Linux/i386, len  is  smaller  than  the  actual
              size.  (In this last case glibc 2.1 uses ENAMETOOLONG.)

       EPERM  For sethostname, the caller was not the superuser.

       EFAULT name is an invalid address.

CONFORMING TO
       SVr4,  4.4BSD   (this function first appeared in 4.2BSD).  POSIX 1003.1-2001 speci-
       fies gethostname but not sethostname.

BUGS
       For many Linux kernel / libc combinations gethostname will return an error  instead
       of returning a truncated hostname.

NOTES
       SUSv2  guarantees  that  ‘Host  names are limited to 255 bytes’.  POSIX 1003.1-2001
       guarantees that ‘Host names (not including the  terminating  NUL)  are  limited  to
       HOST_NAME_MAX bytes’.

SEE ALSO
       getdomainname(2), setdomainname(2), uname(2)



Linux 2.5.0                       2001-12-15                    GETHOSTNAME(2)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/1.3.41 (Unix) PHP/5.2.5 mod_perl/1.30 mod_gzip/1.3.26.1a
Under GNU General Public License
2009-01-09 07:19 @38.103.63.58 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)