*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->NetBSD man pages -> setdomainname (3)              



NAME    [Toc]    [Back]

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

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <unistd.h>

     getdomainname(char *name, size_t namelen);

     setdomainname(const char *name, size_t namelen);

DESCRIPTION    [Toc]    [Back]

     getdomainname() returns the standard domain name for the current processor,
 as previously set by setdomainname().  The parameter namelen specifies
 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    [Toc]    [Back]

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

ERRORS    [Toc]    [Back]

     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 domain name and was not
                        the super-user.

SEE ALSO    [Toc]    [Back]

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

HISTORY    [Toc]    [Back]

     The getdomainname function call appeared in 4.2BSD.

BUGS    [Toc]    [Back]

     Domain names are limited to MAXHOSTNAMELEN (from <sys/param.h>) characters
 including null-termination, currently 256.

BSD                               May 6, 1994                              BSD
[ Back ]
 Similar pages
Name OS Title
setdomainname OpenBSD get/set YP domain name of current host
getdomainname FreeBSD get/set the NIS domain name of current host
getdomainname OpenBSD get/set YP domain name of current host
setdomainname FreeBSD get/set the NIS domain name of current host
trimdomain FreeBSD trim the current domain name from a host name
domainname OpenBSD set or print YP domain of current host system
host FreeBSD look up host names using domain server
getdomainname IRIX get/set name of current NIS domain
getdomainname Tru64 get or set name of current domain
setdomainname Tru64 get or set name of current domain
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service