setdomainname(3) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
GETDOMAINNAME(3)          NetBSD Programmer's Manual          GETDOMAINNAME(3)


NAME

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


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

     If the call succeeds a value of 0 is returned.  If the call fails, a val-
     ue of -1 is returned and an error code is placed in the global location
     errno.


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)


BUGS

     Host names are limited to MAXHOSTNAMELEN (from <sys/param.h>) characters,
     currently 256.


HISTORY

     The getdomainname function call appeared in 4.2BSD.

4.2 Berkeley Distribution         May 6, 1994                                1