1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84
|
.TH units_cur 1 "February 27, 2026" units
.SH NAME
units_cur \- update currency information for \fBunits\fP(1)
.SH SYNOPSIS
.B units_cur
.RI [ options ]
.RI [< currency_file >
.RI [< crypto_file >
.RI [< metals_file >
.RI [< cpi_file >]]]]
.SH DESCRIPTION
.B units_cur
updates the currency information, crypto prices, precious metal
prices, and consumer price index data for units.
.SH OPTIONS
If a
.I file
is specified as argument, the updated information will be written
there instead of in the default file (see below). Specifying
.B \-
causes the updated information to be written to standard output.
Specifying
.B .
causes the file to be skipped.
.TP
.B \-h
shows help information and exits.
.TP
.BR \-c ", " \-\-crypto " " coingecko | packetizer
sets the crypto data source (default: coingecko).
.TP
.BR \-V ", " \-\-version
displays the
.B units_cur
version.
.TP
.BR \-v ", " \-\-verbose
displays details when fetching currency data.
.TP
.BR \-s ", " \-\-source " " exchangerate_api | floatrates | eubank | fixer | openexchangerates
sets the currency data source (default: exchangerate_api).
.TP
.BR \-b ", " \-\-base " " \fIbase\fP
sets the base currency (when allowed by the data source).
.I base
should be a three-letter ISO currency code such as USD. The specified
currency will be the primitive currency unit used by \fBunits\fP. Only
the floatrates source supports this option.
.TP
.BR \-k ", " \-\-key " " \fIkey\fP
sets the API key for sources that require it.
.TP
.BR \-\-blskey " " \fIbls_key\fP
sets the BLS key for fetching CPI data.
.SH FILES
.IP /var/lib/units/currency.units
Default currency information.
.IP /var/lib/units/crypto.units
Default crypto prices.
.IP /var/lib/units/metal_prices.units
Default precious metal prices.
.IP /var/lib/units/cpi.units
Default consumer price index data.
.SH SEE ALSO
.BR units (1)
.SH AUTHORS
.B units
was written by Adrian Mariano <adrianm@gnu.org>.
This manual page was written by Stephen Kitt <skitt@debian.org>, for
the Debian GNU/Linux system (but may be used by others).
It was last modified for
.B units_cur
version 5.1
.RB ( units
version 2.26).
|