]> git.ipfire.org Git - thirdparty/squid.git/blobdiff - lib/getfullhostname.c
SourceFormat Enforcement
[thirdparty/squid.git] / lib / getfullhostname.c
index a6147d097f824acc87d51f2ed71c8fe7981bf460..46766a4f1565ee670dfb09a64598a41a6c67a3d3 100644 (file)
-static char rcsid[] = "$Id: getfullhostname.c,v 1.2 1996/02/23 04:08:26 wessels Exp $";
 /*
- *  getfullhostname.c - Retrieves full DNS name of the current host
+ * Copyright (C) 1996-2015 The Squid Software Foundation and contributors
  *
- *  DEBUG: section  84, level 1         Common utilities hostname processing
- *
- *  Darren Hardy, hardy@cs.colorado.edu, April 1994
- *
- *  ----------------------------------------------------------------------
- *  Copyright (c) 1994, 1995.  All rights reserved.
- *  
- *    The Harvest software was developed by the Internet Research Task
- *    Force Research Group on Resource Discovery (IRTF-RD):
- *  
- *          Mic Bowman of Transarc Corporation.
- *          Peter Danzig of the University of Southern California.
- *          Darren R. Hardy of the University of Colorado at Boulder.
- *          Udi Manber of the University of Arizona.
- *          Michael F. Schwartz of the University of Colorado at Boulder.
- *          Duane Wessels of the University of Colorado at Boulder.
- *  
- *    This copyright notice applies to software in the Harvest
- *    ``src/'' directory only.  Users should consult the individual
- *    copyright notices in the ``components/'' subdirectories for
- *    copyright information about other software bundled with the
- *    Harvest source code distribution.
- *  
- *  TERMS OF USE
- *    
- *    The Harvest software may be used and re-distributed without
- *    charge, provided that the software origin and research team are
- *    cited in any use of the system.  Most commonly this is
- *    accomplished by including a link to the Harvest Home Page
- *    (http://harvest.cs.colorado.edu/) from the query page of any
- *    Broker you deploy, as well as in the query result pages.  These
- *    links are generated automatically by the standard Broker
- *    software distribution.
- *    
- *    The Harvest software is provided ``as is'', without express or
- *    implied warranty, and with no support nor obligation to assist
- *    in its use, correction, modification or enhancement.  We assume
- *    no liability with respect to the infringement of copyrights,
- *    trade secrets, or any patents, and are not responsible for
- *    consequential damages.  Proper use of the Harvest software is
- *    entirely the responsibility of the user.
- *  
- *  DERIVATIVE WORKS
- *  
- *    Users may make derivative works from the Harvest software, subject 
- *    to the following constraints:
- *  
- *      - You must include the above copyright notice and these 
- *        accompanying paragraphs in all forms of derivative works, 
- *        and any documentation and other materials related to such 
- *        distribution and use acknowledge that the software was 
- *        developed at the above institutions.
- *  
- *      - You must notify IRTF-RD regarding your distribution of 
- *        the derivative work.
- *  
- *      - You must clearly notify users that your are distributing 
- *        a modified version and not the original Harvest software.
- *  
- *      - Any derivative product is also subject to these copyright 
- *        and use restrictions.
- *  
- *    Note that the Harvest software is NOT in the public domain.  We
- *    retain copyright, as specified above.
- *  
- *  HISTORY OF FREE SOFTWARE STATUS
- *  
- *    Originally we required sites to license the software in cases
- *    where they were going to build commercial products/services
- *    around Harvest.  In June 1995 we changed this policy.  We now
- *    allow people to use the core Harvest software (the code found in
- *    the Harvest ``src/'' directory) for free.  We made this change
- *    in the interest of encouraging the widest possible deployment of
- *    the technology.  The Harvest software is really a reference
- *    implementation of a set of protocols and formats, some of which
- *    we intend to standardize.  We encourage commercial
- *    re-implementations of code complying to this set of standards.  
- *  
+ * Squid software is distributed under GPLv2+ license and includes
+ * contributions from numerous individuals and organizations.
+ * Please see the COPYING and CONTRIBUTORS files for details.
  */
-#include <stdio.h>
-#include <stdlib.h>
-#include <string.h>
-#include <sys/param.h>
-#include <sys/types.h>
-#include <sys/socket.h>
-#include <netinet/in.h>
-#include <arpa/inet.h>
+
+#include "squid.h"
+#include "getfullhostname.h"
+
+#if HAVE_UNISTD_H
+/* for gethostname() function */
+#include <unistd.h>
+#endif
+#if HAVE_NETDB_H
+/* for gethostbyname() */
 #include <netdb.h>
-#include "util.h"
+#endif
 
+/* for RFC 2181 constants */
+#include "rfc2181.h"
 
-/*
- *  getfullhostname() - Returns the fully qualified name of the current 
- *  host, or NULL on error.  Pointer is only valid until the next call
- *  to the gethost*() functions.
+/* for xstrncpy() - may need breaking out of there. */
+#include "util.h"
+
+/**
+ \retval NULL  An error occured.
+ \retval *    The fully qualified name (FQDN) of the current host.
+ *            Pointer is only valid until the next call to the gethost*() functions.
+ *
+ \todo Make this a squid String result so the duration limit is flexible.
  */
-char *getfullhostname()
+const char *
+getfullhostname(void)
 {
-    struct hostent *hp = NULL;
-    static char buf[SQUIDHOSTNAMELEN + 1];
-    extern int gethostname();  /* UNIX system call */
+    const struct hostent *hp = NULL;
+    static char buf[RFC2181_MAXHOSTNAMELEN + 1];
 
-    if (gethostname(buf, SQUIDHOSTNAMELEN) < 0)
-       return (NULL);
-    if ((hp = gethostbyname(buf)) == NULL)
-       return (buf);
-    return (hp->h_name);
+    if (gethostname(buf, RFC2181_MAXHOSTNAMELEN) < 0)
+        return NULL;
+    /** \todo convert this to a getaddrinfo() call */
+    if ((hp = gethostbyname(buf)) != NULL)
+        xstrncpy(buf, hp->h_name, RFC2181_MAXHOSTNAMELEN);
+    return buf;
 }
+