summaryrefslogtreecommitdiff
path: root/lib/canon-host.c
diff options
context:
space:
mode:
authorPaul Eggert <eggert@cs.ucla.edu>2006-08-21 07:26:38 +0000
committerPaul Eggert <eggert@cs.ucla.edu>2006-08-21 07:26:38 +0000
commit0f7a044109b860443ecaa4f8a37652b1b4423057 (patch)
treeb5834ed9867213221a2636e0fa7e8da178749a76 /lib/canon-host.c
parent11fd62b0080ce376b26241bd789b7e7390befef6 (diff)
downloadcoreutils-0f7a044109b860443ecaa4f8a37652b1b4423057.tar.xz
Remove from CVS, since the bootstrap script generates them automatically.
Diffstat (limited to 'lib/canon-host.c')
-rw-r--r--lib/canon-host.c90
1 files changed, 0 insertions, 90 deletions
diff --git a/lib/canon-host.c b/lib/canon-host.c
deleted file mode 100644
index e2bd1a773..000000000
--- a/lib/canon-host.c
+++ /dev/null
@@ -1,90 +0,0 @@
-/* Host name canonicalization
-
- Copyright (C) 2005 Free Software Foundation, Inc.
-
- Written by Derek Price <derek@ximbiot.com>.
-
- This program is free software; you can redistribute it and/or
- modify it under the terms of the GNU General Public License as
- published by the Free Software Foundation; either version 2, or (at
- your option) any later version.
-
- This program is distributed in the hope that it will be useful, but
- WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to the Free Software Foundation,
- Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */
-
-#ifdef HAVE_CONFIG_H
-# include <config.h>
-#endif
-
-#include "canon-host.h"
-
-#include "getaddrinfo.h"
-#include "strdup.h"
-
-/* Store the last error for the single-threaded version of this function. */
-static int last_cherror;
-
-/* Single-threaded of wrapper for canon_host_r. After a NULL return, error
- messages may be retrieved via ch_strerror(). */
-char *
-canon_host (const char *host)
-{
- return canon_host_r (host, &last_cherror);
-}
-
-/* Return a malloc'd string containing the canonical hostname associated with
- HOST, or NULL if a canonical name cannot be determined. On NULL return,
- if CHERROR is not NULL, set *CHERROR to an error code as returned by
- getaddrinfo(). Use ch_strerror_r() or gai_strerror() to convert a *CHERROR
- value to a string suitable for error messages.
-
- WARNINGS
- HOST must be a string representation of a resolvable name for this host.
- Strings containing an IP address in dotted decimal notation will be
- returned as-is, without further resolution.
-
- The use of the word "canonical" in this context is unfortunate but
- entrenched. The value returned by this function will be the end result
- of the resolution of any CNAME chains in the DNS. There may only be one
- such value for any given hostname, though the actual IP address
- referenced by this value and the device using that IP address may each
- actually have any number of such "canonical" hostnames. See the POSIX
- getaddrinfo spec <http://www.opengroup.org/susv3xsh/getaddrinfo.html">,
- RFC 1034 <http://www.faqs.org/rfcs/rfc1034.html>, & RFC 2181
- <http://www.faqs.org/rfcs/rfc2181.html> for more on what this confusing
- term really refers to. */
-char *
-canon_host_r (char const *host, int *cherror)
-{
- char *retval = NULL;
- static struct addrinfo hints;
- struct addrinfo *res = NULL;
- int status;
-
- hints.ai_flags = AI_CANONNAME;
- status = getaddrinfo (host, NULL, &hints, &res);
- if (!status)
- {
- retval = strdup (res->ai_canonname);
- if (!retval && cherror)
- *cherror = EAI_MEMORY;
- freeaddrinfo (res);
- }
- else if (cherror)
- *cherror = status;
-
- return retval;
-}
-
-/* Return a string describing the last error encountered by canon_host. */
-const char *
-ch_strerror (void)
-{
- return gai_strerror (last_cherror);
-}