lib/xgetdomainname.h

   1 /* xgetdomainname.h -- Return the NIS domain name, without size limitations.
   2    Copyright (C) 1992, 1996, 2000-2001, 2003, 2009-2024 Free Software
   3    Foundation, Inc.
   4
   5    This program is free software: you can redistribute it and/or modify
   6    it under the terms of the GNU General Public License as published by
   7    the Free Software Foundation, either version 3 of the License, or
   8    (at your option) any later version.
   9
  10    This program is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13    GNU General Public License for more details.
  14
  15    You should have received a copy of the GNU General Public License
  16    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
  17
  18 #ifndef _XGETDOMAINNAME_H
  19 #define _XGETDOMAINNAME_H
  20
  21 /* This file uses _GL_ATTRIBUTE_MALLOC.  */
  22 #if !_GL_CONFIG_H_INCLUDED
  23  #error "Please include config.h first."
  24 #endif
  25
  26 #include <stdlib.h>
  27
  28 /* Return the NIS domain name of the machine, in malloc'd storage.
  29    WARNING! The NIS domain name is unrelated to the fully qualified host name
  30             of the machine.  It is also unrelated to email addresses.
  31    WARNING! The NIS domain name is usually the empty string or "(none)" when
  32             not using NIS.
  33    If malloc fails, exit.
  34    Upon any other failure, set errno and return NULL.  */
  35 extern char *xgetdomainname (void)
  36   _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE;
  37
  38 #endif /* _XGETDOMAINNAME_H */