Seth Woolley's Man Viewer

getdomainname(2) - getdomainname, setdomainname, getdomainname, setdomainname - get/set domain name - man 2 getdomainname

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

GETDOMAINNAME(2)           Linux Programmer's Manual          GETDOMAINNAME(2)



NAME
       getdomainname, setdomainname - get/set(7,n,1 builtins) domain name

SYNOPSIS
       #include <unistd.h>

       int getdomainname(char *name, size_t len);
       int setdomainname(const char *name, size_t len);

DESCRIPTION
       These  functions are used to access(2,5) or to change the domain name of the
       current processor.  If the NUL-terminated  domain  name  requires  more
       than  len  bytes,  getdomainname returns the first len bytes (glibc) or
       returns an error(8,n) (libc).

RETURN VALUE
       On success, zero is returned.  On error(8,n), -1 is returned, and  errno  is
       set(7,n,1 builtins) appropriately.

ERRORS
       EFAULT For setdomainname: name pointed outside of user address space.

       EINVAL For  getdomainname  under  libc:  name is NULL or name is longer
              than len bytes.

       EINVAL For setdomainname: len was negative or too large.

       EPERM  For setdomainname: the caller is unprivileged (Linux:  does  not
              have the CAP_SYS_ADMIN capability).

CONFORMING TO
       POSIX does not specify these calls.

SEE ALSO
       gethostname(2), sethostname(2), uname(1,2)(2)



Linux 2.6.7                       2004-06-17                  GETDOMAINNAME(2)

References for this manual (incoming links)