69 lines
1.8 KiB
Groff
69 lines
1.8 KiB
Groff
.TH GEOIPUPDATE 1 "5 Oct 2010"
|
|
.UC 4
|
|
.SH NAME
|
|
geoipupdate \- a program for updating the MaxMind GeoIP databases
|
|
.SH SYNOPSIS
|
|
geoipupdate [\-v] [\-f licensefile]
|
|
.SH DESCRIPTION
|
|
geoipupdate automatically updates the GeoIP database for GeoIP
|
|
subscribers. It connects to the MaxMind GeoIP Update server
|
|
and checks for an updated database. If it finds an updated
|
|
database, then it downloads it, uncompresses it, and installs it.
|
|
If you are running a firewall, it requires that the DNS and
|
|
HTTP (80) ports be open.
|
|
.PP
|
|
For example
|
|
.PP
|
|
.I geoipupdate \-v
|
|
.PP
|
|
Performs the update in verbose mode.
|
|
.PP
|
|
.SH OPTIONS
|
|
.IP "\-v"
|
|
Verbose mode, prints out the steps that geoipupdate takes.
|
|
.IP "\-d"
|
|
Specify a custom directory target to install the GeoIP datafile(s). By default geoipupdate installs to DATADIR
|
|
.IP "\-f"
|
|
Specifies the configuration file that contains the license key.
|
|
Defaults to CONF_DIR/GeoIP.conf
|
|
.SH USAGE
|
|
Typically you'll want to write a weekly crontab that will run geoipupdate.
|
|
Below is a sample crontab that runs geoipupdate on each Wednesday at noon:
|
|
.PP
|
|
.RS
|
|
# top of crontab
|
|
.PP
|
|
MAILTO=your@email.com
|
|
.PP
|
|
0 12 * * 3 BIN_DIR/geoipupdate
|
|
.PP
|
|
# end of crontab
|
|
.RE
|
|
To use with a proxy server, set the http_proxy environment variable.
|
|
E.g.
|
|
.RS
|
|
export http_proxy="http://proxy-hostname:port"
|
|
.RE
|
|
.SH RETURN CODES
|
|
geoipupdate returns 0 on success, 1 on error.
|
|
.SH FILES
|
|
.PP
|
|
.I CONF_DIR/GeoIP.conf
|
|
.PP
|
|
Configuration file for GeoIP, should contain license key.
|
|
.SH AUTHOR
|
|
Written by T.J. Mather
|
|
.SH "REPORTING BUGS"
|
|
Report bugs to <support@maxmind.com>
|
|
.SH COPYRIGHT
|
|
Copyright © 2011 MaxMind LLC
|
|
|
|
This is free software; see the source for copying conditions.
|
|
There is NO warranty; not even for MERCHANTABILITY
|
|
or FITNESS FOR A PARTICULAR PURPOSE.
|
|
.SH "SEE ALSO"
|
|
Visit <http://www.maxmind.com/app/products> to
|
|
sign up for a GeoIP subscription.
|
|
.PP
|
|
geoiplookup(1), crontab(5)
|