man.bsd.lv manual page server

Manual Page Search Parameters

GETDOMAINNAME(3) Library Functions Manual GETDOMAINNAME(3)

getdomainname, setdomainnameget/set domain name of current host

library “libc”

#include <unistd.h>

int
getdomainname(char *name, int namelen);

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

() returns the standard domain name for the current processor, as previously set by (). The parameter namelen specifies the size of the name array. The returned name is null-terminated unless insufficient space is provided.

() 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.

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.

The following errors may be returned by these calls:

[]
The name or namelen parameter gave an invalid address.
[]
The caller tried to set the hostname and was not the super-user.

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

The getdomainname() function call appeared in 4.2BSD.

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

May 6, 1994 DragonFly-5.6.1