---
name: "locale-gen.conf"
section: "5"
platform: "linux"
package: "belocs-locales-bin"
version: "2.4-4"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/locale-gen.conf"
---

# locale-gen.conf(5)

Configuration file for locale-gen

## NAME

locale-gen.conf - Configuration file for locale-gen

## DESCRIPTION

The file  **/etc/belocs/locale-gen.conf** customize how locales generated by **locale-gen** are stored onto disk.

This file is executed by **locale-gen** as a shell fragment, which means that errors in this file can break **locale-gen**. It can contain the following variable definitioos, of the form *\<variable\>=\<value\>*.

## VARIABLES

- **ARCHIVE**=(*yes*\|*no*)

  If set to *yes*, locale data are stored into a single archive **/usr/lib/locale/locale-archive**. Otherwise, locale data are stored in **/usr/lib/locale/\<locale\_name\>/LC\_\*** files. (Default is *no*)

- **PURGE**=(*yes*\|*no*)

  If set to *yes*, locale data are first removed when **locale-gen** is run.  This is the behavior of the **locales** package. (Default is *no*)

- **ALIASES**=*file*

  Specify a file name containing locale aliases.

- **GLIBC\_MAGIC**=(*0x20000828*\|*0x20031115*\|*0x20051014*\|*auto*)

  In order to ensure compatibility between compiled data and GNU libc functions, a magic number is stored in locale data, and if it does not match GNU libc one, locale data are ignored.  Current **locale-gen** program can write compiled data with magic numbers **0x20000828** (for 2.1.96 \<= GNU libc \<= 2.3.2), **0x20031115** (for GNU libc \>= 2.3.3, which is the default in etch) or **0x20031115** (for GNU libc CVS, which is not used yet). If this variable is set to *auto*, a locale is generated by the **localedef** command shipped in GNU libc, and the magic number is extracted from this locale. (Default is *auto*)

## SEE ALSO

[locale-gen(8)](/locale-gen/8.md), [locale.gen(5)](/locale.gen/5.md), [localedef(1)](/localedef/1.md), [locale(1)](/locale/1.md)

## AUTHOR

Denis Barbier \<barbier@debian.org\>
