Future

## Future Future — Future Unstable API |

## Synopsis

    void                p11_kit_set_progname                (const char *progname);
    void                p11_kit_be_quiet                    (void);
    const char *        p11_kit_message                     (void);

## Description

API that is not yet stable enough to be enabled by default. In all likelyhood this will be included in the next release. To use this API you must define a MACRO. See the p11-kit.h header for more details.

## Details

### p11_kit_set_progname ()

    void                p11_kit_set_progname                (const char *progname);

Set the program base name that is used by the `enable-in` and `disable-in` module configuration options.

Normally this is automatically calculated from the program's argument list. You would usually call this before initializing p11-kit modules.

`progname` : | the program base name

### p11_kit_be_quiet ()

    void                p11_kit_be_quiet                    (void);

Once this function is called, the p11-kit library will no longer print failure or warning messages to stderr.

### p11_kit_message ()

    const char *        p11_kit_message                     (void);

Gets the failure message for a recently called p11-kit function, which returned a failure code on this thread. Not all functions set this message. Each function that does so, will note it in its documentation.

If the most recent p11-kit function did not fail, then this will return NULL. The string is owned by the p11-kit library and is only valid on the same thread that the failed function executed on.

Returns : | The last failure message, or `NULL`.