NAME
locale
—
get locale-specific
information
SYNOPSIS
locale |
[-a | -m ] |
locale |
-k list
[prefix] |
locale |
[-ck ] [keyword ...] |
DESCRIPTION
Thelocale
utility is supposed to provide most locale
specific information to the standard output.
When locale
is invoked without arguments,
it will print out a summary of the current locale environment, subject to
the environment settings and internal status.
When locale
is invoked with the
keyword arguments, and no options are specified, it
will print out the values of all keywords specified, using the current
locale settings.
The following options are available:
-a
- Print names of all available locales. While looking for locales,
locale
will respect thePATH_LOCALE
environment variable, and use it instead of the system's default locale directory. -c
- Print the category name for all selected keywords. If no keywords are selected, print the category name for all defined keywords.
-k
- Print the names and values of all selected keywords. If no keywords are selected, print the names and values of all defined keywords.
-m
- Print names of all available charmaps.
IMPLEMENTATION NOTES
The special (FreeBSD specific) keyword
list
can be used to retrieve the human readable list
of all available keywords. If so, a prefix string can be defined to limit
the amount of keywords returned.
EXIT STATUS
The locale
utility exits 0 on
success, and >0 if an error occurs.
SEE ALSO
STANDARDS
The locale
utility conforms to
IEEE Std 1003.1-2004 (“POSIX.1”). The
LC_CTYPE
, LC_MESSAGES
and
NLSPATH
environment variables are not
interpreted.
BUGS
Since FreeBSD does not support
charmaps
in their POSIX meaning, locale
emulates the
-m
option using the CODESETs listing of all
available locales.