summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-40/man5/locale.conf.5
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-40/man5/locale.conf.5')
-rw-r--r--upstream/fedora-40/man5/locale.conf.5115
1 files changed, 115 insertions, 0 deletions
diff --git a/upstream/fedora-40/man5/locale.conf.5 b/upstream/fedora-40/man5/locale.conf.5
new file mode 100644
index 00000000..531a8d8f
--- /dev/null
+++ b/upstream/fedora-40/man5/locale.conf.5
@@ -0,0 +1,115 @@
+'\" t
+.TH "LOCALE\&.CONF" "5" "" "systemd 255" "locale.conf"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+locale.conf \- Configuration file for locale settings
+.SH "SYNOPSIS"
+.PP
+/etc/locale\&.conf
+.SH "DESCRIPTION"
+.PP
+The
+/etc/locale\&.conf
+file configures system\-wide locale settings\&. It is read at early boot by
+\fBsystemd\fR(1)\&.
+.PP
+The format of
+locale\&.conf
+is a newline\-separated list of environment\-like shell\-compatible variable assignments, ignoring comments and empty lines\&. It is possible to source the configuration from shell scripts, however, beyond mere variable assignments, no shell features are supported, allowing applications to read the file without implementing a shell compatible execution engine\&. See
+\fBos-release\fR(5)
+for a detailed description of the format\&.
+.PP
+Note that the kernel command line options
+\fIlocale\&.LANG=\fR,
+\fIlocale\&.LANGUAGE=\fR,
+\fIlocale\&.LC_CTYPE=\fR,
+\fIlocale\&.LC_NUMERIC=\fR,
+\fIlocale\&.LC_TIME=\fR,
+\fIlocale\&.LC_COLLATE=\fR,
+\fIlocale\&.LC_MONETARY=\fR,
+\fIlocale\&.LC_MESSAGES=\fR,
+\fIlocale\&.LC_PAPER=\fR,
+\fIlocale\&.LC_NAME=\fR,
+\fIlocale\&.LC_ADDRESS=\fR,
+\fIlocale\&.LC_TELEPHONE=\fR,
+\fIlocale\&.LC_MEASUREMENT=\fR,
+\fIlocale\&.LC_IDENTIFICATION=\fR
+may be used to override the locale settings at boot\&.
+.PP
+The locale settings configured in
+/etc/locale\&.conf
+are system\-wide and are inherited by every service or user, unless overridden or unset by individual programs or users\&.
+.PP
+Depending on the operating system, other configuration files might be checked for locale configuration as well, however only as fallback\&.
+.PP
+/etc/locale\&.conf
+can be updated using
+\fBsystemd-localed.service\fR(8)\&.
+\fBlocalectl\fR(1)
+may be used to alter the settings in this file during runtime from the command line\&. Use
+\fBsystemd-firstboot\fR(1)
+to customize them on mounted (but not booted) system images\&.
+.SH "OPTIONS"
+.PP
+The following locale settings may be set using
+/etc/locale\&.conf:
+\fILANG=\fR,
+\fILANGUAGE=\fR,
+\fILC_CTYPE=\fR,
+\fILC_NUMERIC=\fR,
+\fILC_TIME=\fR,
+\fILC_COLLATE=\fR,
+\fILC_MONETARY=\fR,
+\fILC_MESSAGES=\fR,
+\fILC_PAPER=\fR,
+\fILC_NAME=\fR,
+\fILC_ADDRESS=\fR,
+\fILC_TELEPHONE=\fR,
+\fILC_MEASUREMENT=\fR,
+\fILC_IDENTIFICATION=\fR\&. Note that
+\fILC_ALL\fR
+may not be configured in this file\&. For details about the meaning and semantics of these settings, refer to
+\fBlocale\fR(7)\&.
+.SH "EXAMPLE"
+.PP
+\fBExample\ \&1.\ \&German locale with English messages\fR
+.PP
+/etc/locale\&.conf:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+# Custom settings
+
+LANG=de_DE\&.UTF\-8
+LC_MESSAGES=en_US\&.UTF\-8
+.fi
+.if n \{\
+.RE
+.\}
+.SH "SEE ALSO"
+.PP
+\fBsystemd\fR(1),
+\fBlocale\fR(7),
+\fBlocalectl\fR(1),
+\fBsystemd-localed.service\fR(8),
+\fBsystemd-firstboot\fR(1)