# salt.modules.localemod

Module for managing locales on POSIX-like systems.

salt.modules.localemod.avail(locale)

  Check if a locale is available.

  New in version 2014.7.0.

  CLI Example:

      salt '*' locale.avail 'en_US.UTF-8'

salt.modules.localemod.gen_locale(locale, **kwargs)

  Generate a locale. Options:

  New in version 2014.7.0.

  Parameters:

    locale -- Any locale listed in /usr/share/i18n/locales or /usr/share/i18n/SUPPORTED for Debian and Gentoo based distributions, which require the charmap to be specified as part of the locale when generating it.

  verbose

    Show extra warnings about errors that are normally ignored.

  CLI Example:

      salt '*' locale.gen_locale en_US.UTF-8
      salt '*' locale.gen_locale 'en_IE.UTF-8 UTF-8'    # Debian/Gentoo only

salt.modules.localemod.get_locale()

  Get the current system locale

  CLI Example:

      salt '*' locale.get_locale

salt.modules.localemod.list_avail()

  Lists available (compiled) locales

  CLI Example:

      salt '*' locale.list_avail

salt.modules.localemod.set_locale(locale)

  Sets the current system locale

  CLI Example:

      salt '*' locale.set_locale 'en_US.UTF-8'