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