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