DragonFly On-Line Manual Pages

Search: Section:  

GETDOMAINNAME(3)      DragonFly Library Functions Manual      GETDOMAINNAME(3)


NAME

     getdomainname, setdomainname -- get/set domain name of current host


LIBRARY

     Standard C Library (libc, -lc)


SYNOPSIS

     #include <unistd.h>

     int
     getdomainname(char *name, int namelen);

     int
     setdomainname(const char *name, int namelen);


DESCRIPTION

     Getdomainname() returns the standard domain name for the current proces-
     sor, as previously set by setdomainname().  The parameter namelen speci-
     fies the size of the name array.  The returned name is null-terminated
     unless insufficient space is provided.

     Setdomainname() sets the domain name of the host machine to be name,
     which has length namelen.  This call is restricted to the super-user and
     is normally used only when the system is bootstrapped.


RETURN VALUES

     Upon successful completion, the value 0 is returned; otherwise the
     value -1 is returned and the global variable errno is set to indicate the
     error.


ERRORS

     The following errors may be returned by these calls:

     [EFAULT]           The name or namelen parameter gave an invalid address.

     [EPERM]            The caller tried to set the hostname and was not the
                        super-user.


SEE ALSO

     gethostid(3), gethostname(3), sysctl(3)


HISTORY

     The getdomainname() function call appeared in 4.2BSD.


BUGS

     Domain names are limited to MAXHOSTNAMELEN (from <sys/param.h>) charac-
     ters, currently 256.

DragonFly 3.5                     May 6, 1994                    DragonFly 3.5

Search: Section: