Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
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 processor.  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 appropriately.

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 specifies 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)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | CONFORMING TO | BUGS | NOTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=gethostname&sektion=2&manpath=Red+Hat+Linux%2fi386+9>

home | help