Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
GETDOMAINNAME(3)	    Library Functions Manual	      GETDOMAINNAME(3)

NAME
       getdomainname,  setdomainname --	get/set	the NIS	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
       The getdomainname() function returns the	standard NIS domain  name  for
       the  current  host,  as previously set by setdomainname().  The namelen
       argument	specifies the size of the name array.  The  returned  name  is
       null-terminated unless insufficient space is provided.

       The  setdomainname()  function sets the NIS domain name of the host ma-
       chine to	be name, which has length namelen.  This call is restricted to
       the super-user and is normally used  only  when	the  system  is	 boot-
       strapped.

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  argument gave	an invalid ad-
			  dress.

       [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 appeared in	4.2BSD.

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

FreeBSD	13.4			  May 6, 1994		      GETDOMAINNAME(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=setdomainname&manpath=FreeBSD+13.4-RELEASE+and+Ports>

home | help