unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Page:
Section:
Apropos / Subsearch:
optional field

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



NAME
       getdomainname, setdomainname - get/set domain name

SYNOPSIS
       #include <&lt;unistd.h>&gt;

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

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       getdomainname(), setdomainname(): _BSD_SOURCE || (_XOPEN_SOURCE &&
       _XOPEN_SOURCE < 500)

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

RETURN VALUE
       On  success,  zero is returned.  On error, -1 is returned, and errno is
       set 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(2)

COLOPHON
       This page is part of release 3.05 of the Linux  man-pages  project.   A
       description  of  the project, and information about reporting bugs, can
       be found at http://www.kernel.org/doc/man-pages/.



Linux                             2007-07-26                  GETDOMAINNAME(2)