]> git.ipfire.org Git - location/libloc.git/blob - man/location-downloader.txt
man: Document quiet mode switch
[location/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 --quiet::
23 Enable quiet mode
24
25 --debug::
26 Enable debugging mode
27
28 == COMMANDS
29
30 'update'::
31 This command will try to update the local database.
32 +
33 It will terminate with a return code of zero if the database has been
34 successfully updated. 1 on error, 2 on invalid call and 3 if the
35 database was already the latest version.
36
37 'verify'::
38 Verifies the downloaded database.
39
40 '--help'::
41 Shows a short help text on using this program.
42
43 '--version'::
44 Shows the program's version and exists.
45
46 == EXIT CODES
47 The 'location-downloader' command will normally exit with code zero.
48 If there has been a problem and the requested action could not be performed,
49 the exit code is unequal to zero.
50
51 == HOW IT WORKS
52 The downloader checks a DNS record for the latest version of the database.
53 It will then try to download a file with that version from a mirror server.
54 If the downloaded file is outdated, the next mirror will be tried until we
55 have found a file that is recent enough.
56
57 == BUGS
58 Please report all bugs to the bugtracker at https://bugzilla.ipfire.org/.
59
60 == AUTHORS
61 Michael Tremer