GETDOMAINNAME
Section: System Calls (2)
Index
Return to Main Contents
BSD mandoc
BSD 4.2
NAME
getdomainname
setdomainname
- get/set name of current host
SYNOPSIS
Fd #include <unistd.h>
Ft int
Fn getdomainname char *name int namelen
Ft int
Fn setdomainname const char *name int namelen
DESCRIPTION
Fn Getdomainname
returns the standard host name for the current processor, as
previously set by
Fn setdomainname .
The parameter
Fa namelen
specifies the size of the
Fa name
array. The returned name is null-terminated unless insufficient
space is provided.
Fn Setdomainname
sets the name of the host machine to be
Fa name ,
which has length
Fa 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 value 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:
- Bq Er EFAULT
-
The
Fa name
or
Fa namelen
parameter gave an
invalid address.
- Bq Er EPERM
-
The caller tried to set the domainname and was not the super-user.
SEE ALSO
gethostid(2)
BUGS
Host names are limited to
MAXHOSTNAMELEN
(from
Ao Pa sys/param.h Ac )
characters, currently 64.
HISTORY
The
function call appeared in
BSD 4.2
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUES
-
- ERRORS
-
- SEE ALSO
-
- BUGS
-
- HISTORY
-
This document was created by
man2html,
using the manual pages.
Time: 00:38:49 GMT, March 26, 2025