]> git.ipfire.org Git - people/ms/libloc.git/blob - man/location-downloader.txt
downloader: Check DNS for most recent version
[people/ms/libloc.git] / man / location-downloader.txt
1 = location-downloader(8)
2
3 == NAME
4 location-downloader - Download a location database
5
6 == SYNOPSIS
7 [verse]
8 `location-downloader update`
9
10 == DESCRIPTION
11 The `location-downloader` command updates the local version of the
12 location database.
13
14 == OPTIONS
15
16 --database FILE::
17 -d FILE::
18 The path of the database which is being updated.
19 +
20 If this option is omitted, the system's database will be opened.
21
22 --debug::
23 Enable debugging mode
24
25 == COMMANDS
26
27 'update'::
28 This command will try to update the local database.
29
30 '--help'::
31 Shows a short help text on using this program.
32
33 '--version'::
34 Shows the program's version and exists.
35
36 == EXIT CODES
37 The 'location-downloader' command will normally exit with code zero.
38 If there has been a problem and the requested action could not be performed,
39 the exit code is unequal to zero.
40
41 == HOW IT WORKS
42 The downloader checks a DNS record for the latest version of the database.
43 It will then try to download a file with that version from a mirror server.
44 If the downloaded file is outdated, the next mirror will be tried until we
45 have found a file that is recent enough.
46
47 == BUGS
48 Please report all bugs to the bugtracker at https://bugzilla.ipfire.org/.
49
50 == AUTHORS
51 Michael Tremer