getdomainname

TriggerTek Logo
abcdefghijklmnopqrstuvwxyz_
GETDOMAINNAME(2)	  Linux Programmer’s Manual	     GETDOMAINNAME(2)



NAME
       getdomainname, setdomainname - get/set 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 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 (libc).

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

ERRORS
       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 was not the superuser.

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

CONFORMING TO
       POSIX does not specify these calls.

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



Linux 2.0			  1997-08-25		     GETDOMAINNAME(2)