annotate lib/xgetdomainname.h @ 9982:a4502ab3c8d6

Oops, fix mistake in third-to-last commit.
author Bruno Haible <bruno@clisp.org>
date Sat, 26 Apr 2008 19:42:00 +0200
parents bbbbbf4cd1c5
children b5e42ef33b49
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4731
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 /* xgetdomainname.h -- Return the NIS domain name, without size limitations.
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
2 Copyright (C) 1992, 1996, 2000, 2001, 2003 Free Software Foundation, Inc.
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
4 This program is free software: you can redistribute it and/or modify
4731
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
5 it under the terms of the GNU General Public License as published by
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
6 the Free Software Foundation; either version 3 of the License, or
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
7 (at your option) any later version.
4731
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 This program is distributed in the hope that it will be useful,
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
12 GNU General Public License for more details.
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
13
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
14 You should have received a copy of the GNU General Public License
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
15 along with this program. If not, see <http://www.gnu.org/licenses/>. */
4731
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
16
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
17 #ifndef _XGETDOMAINNAME_H
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
18 #define _XGETDOMAINNAME_H
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20 /* Return the NIS domain name of the machine, in malloc'd storage.
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21 WARNING! The NIS domain name is unrelated to the fully qualified host name
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22 of the machine. It is also unrelated to email addresses.
4734
e73a97963451 Fix comment.
Bruno Haible <bruno@clisp.org>
parents: 4731
diff changeset
23 WARNING! The NIS domain name is usually the empty string or "(none)" when
e73a97963451 Fix comment.
Bruno Haible <bruno@clisp.org>
parents: 4731
diff changeset
24 not using NIS.
4731
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
25 If malloc fails, exit.
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
26 Upon any other failure, set errno and return NULL. */
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
27 extern char *xgetdomainname (void);
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
28
d160b0c1905e New modules 'xgetdomainname'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
29 #endif /* _XGETDOMAINNAME_H */