1.\"	$OpenBSD: logresolve.8,v 1.10 2007/05/31 19:20:24 jmc Exp $
2.\" ====================================================================
3.\" The Apache Software License, Version 1.1
4.\"
5.\" Copyright (c) 2000-2003 The Apache Software Foundation.  All rights
6.\" reserved.
7.\"
8.\" Redistribution and use in source and binary forms, with or without
9.\" modification, are permitted provided that the following conditions
10.\" are met:
11.\"
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\"
15.\" 2. Redistributions in binary form must reproduce the above copyright
16.\"    notice, this list of conditions and the following disclaimer in
17.\"    the documentation and/or other materials provided with the
18.\"    distribution.
19.\"
20.\" 3. The end-user documentation included with the redistribution,
21.\"    if any, must include the following acknowledgment:
22.\"       "This product includes software developed by the
23.\"        Apache Software Foundation (http://www.apache.org/)."
24.\"    Alternately, this acknowledgment may appear in the software itself,
25.\"    if and wherever such third-party acknowledgments normally appear.
26.\"
27.\" 4. The names "Apache" and "Apache Software Foundation" must
28.\"    not be used to endorse or promote products derived from this
29.\"    software without prior written permission. For written
30.\"    permission, please contact apache@apache.org.
31.\"
32.\" 5. Products derived from this software may not be called "Apache",
33.\"    nor may "Apache" appear in their name, without prior written
34.\"    permission of the Apache Software Foundation.
35.\"
36.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
37.\" WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
38.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
39.\" DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
40.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
41.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
42.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
43.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
44.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
45.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
46.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
47.\" SUCH DAMAGE.
48.\" ====================================================================
49.\"
50.\" This software consists of voluntary contributions made by many
51.\" individuals on behalf of the Apache Software Foundation.  For more
52.\" information on the Apache Software Foundation, please see
53.\" <http://www.apache.org/>.
54.\"
55.\" Portions of this software are based upon public domain software
56.\" originally written at the National Center for Supercomputing Applications,
57.\" University of Illinois, Urbana-Champaign.
58.\"
59.Dd $Mdocdate: March 19 2008 $
60.Dt LOGRESOLVE 8
61.Os
62.Sh NAME
63.Nm logresolve
64.Nd resolve hostnames for IP addresses in Apache logfiles
65.Sh SYNOPSIS
66.Nm logresolve
67.Op Fl c
68.Op Fl s Ar filename
69\*(Lt
70.Ar access_log
71\*(Gt
72.Ar access_log.new
73.Sh DESCRIPTION
74.Nm
75is a post-processing program to resolve IP addresses in
76.Xr httpd 8 Ns 's
77access logfiles.
78To minimize impact on the nameserver,
79.Nm
80has its very own internal hash-table cache.
81This means that each IP number will only be looked up the first time it
82is found in the log file.
83.Pp
84The following options are supported:
85.Bl -tag -width "-s filenameXX"
86.It Fl c
87This causes
88.Nm
89to apply some DNS checks:
90after finding the hostname from the IP address, it looks up the IP
91addresses for the hostname and checks that one of them matches the
92original address.
93.It Fl s Ar filename
94Specifies the
95.Ar filename
96to record statistics.
97.El
98.Sh SEE ALSO
99.Xr httpd 8 ,
100.Xr rotatelogs 8
101