xref: /openbsd/usr.bin/locale/locale.1 (revision cecf84d4)
1.\" $OpenBSD: locale.1,v 1.4 2014/03/24 07:29:22 jmc Exp $
2.\"
3.\" Copyright 2013 Stefan Sperling <stsp@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: March 24 2014 $
18.Dt LOCALE 1
19.Os
20.Sh NAME
21.Nm locale
22.Nd get locale-specific information
23.Sh SYNOPSIS
24.Nm locale
25.Op Fl a | Fl m
26.Sh DESCRIPTION
27If
28.Nm
29is invoked without any arguments, the current locale configuration is shown.
30.Pp
31The options are as follows:
32.Bl -tag -width Ds
33.It Fl a
34Display a list of supported locales.
35.It Fl m
36Display a list of supported character sets.
37.El
38.Sh ENVIRONMENT
39The locale configuration consists of the following environment variables:
40.Pp
41.Bl -tag -width LC_MONETARYXXX -compact
42.It Dv LC_ALL
43Overrides all other LC_* variables below.
44.It Dv LC_COLLATE
45Locale for string collation routines.
46.It Dv LC_CTYPE
47Locale for character set.
48.It Dv LC_MONETARY
49Locale for formatting monetary values.
50.It Dv LC_NUMERIC
51Locale for formatting numbers.
52.It Dv LC_TIME
53Locale for formatting dates and times.
54.It Dv LANG
55Fallback if any of the above is unset.
56.El
57.Sh EXIT STATUS
58.Ex -std locale
59.Sh SEE ALSO
60.Xr setlocale 3
61.Sh STANDARDS
62The
63.Nm
64utility implements a subset of the
65.St -p1003.1-2008
66specification.
67.Sh HISTORY
68The
69.Nm
70utility was first standardized in the
71.St -xpg4 .
72.Pp
73It was rewritten from scratch for
74.Ox 5.4
75during the 2013 Toronto hackathon.
76.Sh AUTHORS
77.An -nosplit
78.An Stefan Sperling Aq Mt stsp@openbsd.org
79with contributions from
80.An Philip Guenther Aq Mt guenther@openbsd.org
81and
82.An Jeremie Courreges-Anglas Aq Mt jca@openbsd.org .
83.Sh BUGS
84The list of supported locales is perpetually incomplete.
85