gnutls_fips140_set_mode(3)

1gnutls_fips140_set_mode(3)          gnutls          gnutls_fips140_set_mode(3)
2
3
4

NAME

6       gnutls_fips140_set_mode - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       void gnutls_fips140_set_mode(gnutls_fips_mode_t mode, unsigned flags);
12

ARGUMENTS

14       gnutls_fips_mode_t mode
15                   the FIPS140-2 mode to switch to
16
17       unsigned flags
18                   should be zero or GNUTLS_FIPS140_SET_MODE_THREAD
19

DESCRIPTION

21       That  function  is not thread-safe when changing the mode with no flags
22       (globally), and should be called prior to  creating  any  threads.  Its
23       behavior with no flags after threads are created is undefined.
24
25       When  the  flag  GNUTLS_FIPS140_SET_MODE_THREAD  is specified then this
26       call will change the FIPS140-2 mode for this particular thread and  not
27       for  the  whole process. That way an application can utilize this func‐
28       tion to set and reset mode for specific operations.
29
30       This function never fails but will be a no-op if used when the  library
31       is  not  in  FIPS140-2 mode. When asked to switch to unknown values for
32       mode or to  GNUTLS_FIPS140_SELFTESTS  mode,  the  library  switches  to
33       GNUTLS_FIPS140_STRICT mode.
34

SINCE

36       3.6.2
37

REPORTING BUGS

39       Report bugs to <bugs@gnutls.org>.
40       Home page: https://www.gnutls.org
41
42

COPYRIGHT

44       Copyright © 2001-2020 Free Software Foundation, Inc., and others.
45       Copying  and  distribution  of this file, with or without modification,
46       are permitted in any medium  without  royalty  provided  the  copyright
47       notice and this notice are preserved.
48