-
Notifications
You must be signed in to change notification settings - Fork 142
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #40 from maxmind/greg/fixes
Fix man formatting and stop vendoring our deps
- Loading branch information
Showing
89 changed files
with
165 additions
and
14,485 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
[run] | ||
deadline = "10m" | ||
tests = true | ||
|
||
[linters] | ||
disable-all = true | ||
enable = [ | ||
"deadcode", | ||
"depguard", | ||
"errcheck", | ||
"goconst", | ||
"gocyclo", | ||
"gocritic", | ||
"gofmt", | ||
"golint", | ||
"gosec", | ||
"gosimple", | ||
"ineffassign", | ||
"maligned", | ||
"misspell", | ||
"nakedret", | ||
"staticcheck", | ||
"structcheck", | ||
"typecheck", | ||
"unconvert", | ||
"unparam", | ||
"varcheck", | ||
"vet", | ||
"vetshadow", | ||
] | ||
|
||
# This goes off for MD5 usage, which we use heavily | ||
[[issues.exclude-rules]] | ||
text = "weak cryptographic primitive" | ||
linters = ["gosec"] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,61 +1,85 @@ | ||
# GeoIP.conf | ||
|
||
## NAME | ||
# NAME | ||
|
||
GeoIP.conf - Configuration file for geoipupdate | ||
|
||
## SYNOPSIS | ||
# SYNOPSIS | ||
|
||
This file allows you to configure your `geoipupdate` program to | ||
download GeoIP2, GeoLite2, and GeoIP Legacy databases. | ||
|
||
## DESCRIPTION | ||
# DESCRIPTION | ||
|
||
The file consists of one setting per line. Lines starting with `#` | ||
are comments and will not be processed. All setting keywords are case | ||
sensitive. | ||
|
||
### Required settings: | ||
|
||
* `EditionIDs` - List of database edition IDs. Edition IDs may consist | ||
of letters, digits, and dashes (e.g., "GeoIP2-City", "106"). Note: this | ||
was formerly called `ProductIds`. | ||
|
||
### Optional settings: | ||
|
||
* `AccountID` - Your MaxMind account ID. This was formerly known as | ||
`UserId`. | ||
* `DatabaseDirectory` - The directory to store the database files. If not | ||
set, the default is DATADIR. This can be overridden at run time by the | ||
`-d` command line argument. | ||
* `Host` - The host name of the server to use. The default is | ||
`updates.maxmind.com`. | ||
* `Proxy` - The proxy host name or IP address. You may optionally specify | ||
a port number, e.g., `127.0.0.1:8888`. If no port number is specified, | ||
1080 will be used. | ||
* `ProxyUserPassword` - The proxy user name and password, separated by a | ||
colon. For instance, `username:password`. | ||
* `PreserveFileTimes` - Whether to preserve modification times of files | ||
downloaded from the server. This option is either `0` or `1`. The default | ||
is `0`. | ||
* `LicenseKey` - Your case-sensitive MaxMind license key. | ||
* `LockFile` - The lock file to use. This ensures only one `geoipupdate` | ||
process can run at a time. Note: Once created, this lockfile is not removed | ||
from the filesystem. The default is `.geoipupdate.lock` under the | ||
`DatabaseDirectory`. | ||
|
||
### Deprecated settings: | ||
## Required settings: | ||
|
||
`EditionIDs` | ||
|
||
: List of database edition IDs. Edition IDs may consist | ||
of letters, digits, and dashes (e.g., "GeoIP2-City", "106"). Note: this | ||
was formerly called `ProductIds`. | ||
|
||
## Optional settings: | ||
|
||
`AccountID` | ||
|
||
: Your MaxMind account ID. This was formerly known as `UserId`. | ||
|
||
`DatabaseDirectory` | ||
|
||
: The directory to store the database files. If not set, the default is | ||
DATADIR. This can be overridden at run time by the `-d` command line | ||
argument. | ||
|
||
`Host` | ||
|
||
: The host name of the server to use. The default is `updates.maxmind.com`. | ||
|
||
`Proxy` | ||
|
||
: The proxy host name or IP address. You may optionally specify | ||
a port number, e.g., `127.0.0.1:8888`. If no port number is specified, | ||
1080 will be used. | ||
|
||
`ProxyUserPassword` | ||
|
||
: The proxy user name and password, separated by a colon. For instance, | ||
`username:password`. | ||
|
||
`PreserveFileTimes` | ||
|
||
: Whether to preserve modification times of files downloaded from the | ||
server. This option is either `0` or `1`. The default is `0`. | ||
|
||
`LicenseKey` | ||
|
||
: Your case-sensitive MaxMind license key. | ||
|
||
`LockFile` | ||
|
||
: The lock file to use. This ensures only one `geoipupdate` process can run | ||
at a time. Note: Once created, this lockfile is not removed from the | ||
filesystem. The default is `.geoipupdate.lock` under the | ||
`DatabaseDirectory`. | ||
|
||
## Deprecated settings: | ||
|
||
The following are deprecated and will be ignored if present: | ||
|
||
* `Protocol` | ||
* `SkipPeerVerification` | ||
* `SkipHostnameVerification` | ||
`Protocol` | ||
|
||
`SkipPeerVerification` | ||
|
||
`SkipHostnameVerification` | ||
|
||
# FILES | ||
|
||
## FILES | ||
`GeoIP.conf` | ||
|
||
* `GeoIP.conf` - Default `geoipupdate` configuration file. | ||
: Default `geoipupdate` configuration file. | ||
|
||
## SEE ALSO | ||
# SEE ALSO | ||
|
||
`geoipupdate`(1) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,16 +1,12 @@ | ||
# GEOIPUPDATE | ||
|
||
## NAME | ||
# NAME | ||
|
||
geoipupdate - GeoIP2, GeoLite2, and GeoIP Legacy Update Program | ||
|
||
## SYNOPSIS | ||
# SYNOPSIS | ||
|
||
``` | ||
geoipupdate [-Vvh] [-f CONFIG_FILE] [-d TARGET_DIRECTORY] | ||
``` | ||
geoipupdate [-Vvh] [-f CONFIG_FILE] [-d TARGET_DIRECTORY] | ||
|
||
## DESCRIPTION | ||
# DESCRIPTION | ||
|
||
`geoipupdate` automatically updates GeoIP2, GeoLite2, and GeoIP Legacy | ||
databases. The program connects to the MaxMind GeoIP Update server to | ||
|
@@ -20,72 +16,85 @@ download and install it. | |
If you are using a firewall, you must have the DNS and HTTPS ports | ||
open. | ||
|
||
## OPTIONS | ||
# OPTIONS | ||
|
||
|
||
`-d`, `--database-directory` | ||
|
||
: Install databases to a custom directory. This is optional. If provided, it | ||
overrides any `DatabaseDirectory` set in the configuration file. | ||
|
||
`-f`, `--config-file` | ||
|
||
: The configuration file to use. See `GeoIP.conf` and its documentation for | ||
more information. This is optional. It defaults to CONFFILE. | ||
|
||
`-h`, `--help` | ||
|
||
: Display help and exit. | ||
|
||
`--stack-trace` | ||
|
||
: Show a stack trace on any error message. This is primarily useful for | ||
debugging. | ||
|
||
`-V`, `--version` | ||
|
||
: Display version information and exit. | ||
|
||
`-v`, `--verbose` | ||
|
||
* `-d`, `--database-directory` - Install databases to a custom directory. | ||
This is optional. If provided, it overrides any `DatabaseDirectory` set | ||
in the configuration file. | ||
* `-f`, `--config-file` - The configuration file to use. See GeoIP.conf and | ||
its documentation for more information. This is optional. It defaults to | ||
CONFFILE. | ||
* `-h`, `--help` - Display help and exit. | ||
* `--stack-trace` - Show a stack trace on any error message. This is | ||
primarily useful for debugging. | ||
* `-V`, `--version` - Display version information and exit. | ||
* `-v`, `--verbose` - Enable verbose mode. Prints out the steps that | ||
`geoipupdate` takes. | ||
: Enable verbose mode. Prints out the steps that `geoipupdate` takes. | ||
|
||
## USAGE | ||
# USAGE | ||
|
||
Typically you should run `geoipupdate` weekly. On most Unix-like systems, | ||
this can be achieved by using cron. Below is a sample crontab file that | ||
runs `geoipupdate` on each Wednesday at noon: | ||
|
||
``` | ||
# top of crontab | ||
# top of crontab | ||
|
||
[email protected] | ||
[email protected] | ||
|
||
0 12 * * 3 geoipupdate | ||
0 12 * * 3 geoipupdate | ||
|
||
# end of crontab | ||
# end of crontab | ||
|
||
``` | ||
|
||
To use with a proxy server, update your `GeoIP.conf` file as specified | ||
in the `GeoIP.conf` man page or set the `http_proxy` environment | ||
variable. | ||
|
||
## RETURN CODES | ||
# RETURN CODES | ||
|
||
`geoipupdate` returns 0 on success and 1 on error. | ||
|
||
## FILES | ||
# FILES | ||
|
||
* `GeoIP.conf` - Configuration file for GeoIP Update. See the | ||
`GeoIP.conf` documentation for more information. | ||
|
||
## AUTHOR | ||
# AUTHOR | ||
|
||
Written by William Storey. | ||
|
||
## REPORTING BUGS | ||
# REPORTING BUGS | ||
|
||
Report bugs to [[email protected]](mailto:[email protected]). | ||
|
||
## COPYRIGHT | ||
# COPYRIGHT | ||
|
||
This software is Copyright (c) 2018-2019 by MaxMind, Inc. | ||
|
||
This is free software, licensed under the Apache License, Version 2.0 or | ||
the MIT License, at your option. | ||
|
||
## MORE INFORMATION | ||
# MORE INFORMATION | ||
|
||
Visit [our website](https://www.maxmind.com/en/geoip2-services-and-databases) | ||
to learn more about the GeoIP2 and GeoIP Legacy databases or to sign up | ||
for a subscription. | ||
|
||
## SEE ALSO | ||
# SEE ALSO | ||
|
||
`GeoIP.conf`(5) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.