man 8 fips-mode-setup

FIPS-MODE-SETUP(8)                                          FIPS-MODE-SETUP(8)

NAME
       fips-mode-setup - Check or enable the system FIPS mode.

SYNOPSIS
       fips-mode-setup [COMMAND]

DESCRIPTION
       fips-mode-setup(8) is used to check and control the system FIPS mode.

       When enabling the system FIPS mode, the command completes the
       installation of FIPS modules if needed by calling fips-finish-install
       and changes the system crypto policy to FIPS (unless the policy has
       already been set to FIPS plus subpolicies on top, in which case the
       currently active subpolicies is retained).

       Then the command modifies the boot loader configuration to add fips=1
       and boot=<boot-device> options to the kernel command line.

       When disabling the system FIPS mode the system crypto policy is
       switched to DEFAULT and the kernel command line option fips=0 is set.

OPTIONS
       The following options are available in fips-mode-setup tool.

       o   --enable: Enables the system FIPS mode.

       o   --disable: Undo some of the FIPS-enablement steps. Please note that
           module installation cannot be undone without reformatting of and
           overwriting, at least once, the platform's hard drive or other
           permanent storage media. This option is not meant to be used in
           production, is not supported, and is implemented for testing
           purposes only.

       o   --check: Checks for inconsistently enabled FIPS mode. Exits
           successfully (0) for both consistently-enabled FIPS mode and
           consistently-disabled FIPS mode, returns error code (1) if
           inconsistencies are detected. For checking whether FIPS mode is
           enabled, see --is-enabled below.

       o   --is-enabled: Checks the system FIPS mode status and returns
           failure error code if disabled (2) or inconsistent (1).

       o   --no-bootcfg: The tool will not reconfigure the boot loader, and,
           instead, will print the options that need to be added to the kernel
           command line. Exception: it still attempts executing zipl(8) on
           s390x, as the system might become unbootable otherwise.

FILES
       /proc/sys/crypto/fips_enabled
           The kernel FIPS mode flag.

SEE ALSO
       update-crypto-policies(8), fips-finish-install(8)

AUTHOR
       Written by Toma Mraz.

fips-mode-setup                   01/28/2025                FIPS-MODE-SETUP(8)