Changeset View
Changeset View
Standalone View
Standalone View
doc/gpgme.texi
- This file is larger than 256 KB, so syntax highlighting is disabled by default.
Show First 20 Lines • Show All 2,438 Lines • ▼ Show 20 Lines | |||||
* Text Mode:: Choosing canonical text mode. | * Text Mode:: Choosing canonical text mode. | ||||
* Offline Mode:: Choosing offline mode. | * Offline Mode:: Choosing offline mode. | ||||
* Pinentry Mode:: Choosing the pinentry mode. | * Pinentry Mode:: Choosing the pinentry mode. | ||||
* Included Certificates:: Including a number of certificates. | * Included Certificates:: Including a number of certificates. | ||||
* Key Listing Mode:: Selecting key listing mode. | * Key Listing Mode:: Selecting key listing mode. | ||||
* Passphrase Callback:: Getting the passphrase from the user. | * Passphrase Callback:: Getting the passphrase from the user. | ||||
* Progress Meter Callback:: Being informed about the progress. | * Progress Meter Callback:: Being informed about the progress. | ||||
* Status Message Callback:: Status messages received from gpg. | * Status Message Callback:: Status messages received from gpg. | ||||
* Context Flags:: Additional flags for a context. | |||||
* Locale:: Setting the locale of a context. | * Locale:: Setting the locale of a context. | ||||
* Additional Logs:: Additional logs of a context. | * Additional Logs:: Additional logs of a context. | ||||
@end menu | @end menu | ||||
@node Protocol Selection | @node Protocol Selection | ||||
@subsection Protocol Selection | @subsection Protocol Selection | ||||
@cindex context, selecting protocol | @cindex context, selecting protocol | ||||
▲ Show 20 Lines • Show All 570 Lines • ▼ Show 20 Lines | |||||
The function @code{gpgme_get_status_cb} returns the function that is used to | The function @code{gpgme_get_status_cb} returns the function that is used to | ||||
process status messages from gpg in @var{*statusfunc}, and the first argument | process status messages from gpg in @var{*statusfunc}, and the first argument | ||||
for this function in @var{*hook_value}. If no status message callback is set, | for this function in @var{*hook_value}. If no status message callback is set, | ||||
or @var{ctx} is not a valid pointer, @code{NULL} is returned in both | or @var{ctx} is not a valid pointer, @code{NULL} is returned in both | ||||
variables. | variables. | ||||
@end deftypefun | @end deftypefun | ||||
@node Context Flags | |||||
@subsection Context Flags | |||||
@cindex flags, of a context | |||||
@deftypefun {gpgme_error_t} gpgme_set_ctx_flag @ | @deftypefun {gpgme_error_t} gpgme_set_ctx_flag @ | ||||
(@w{gpgme_ctx_t @var{ctx}}, @ | (@w{gpgme_ctx_t @var{ctx}}, @ | ||||
@w{const char *@var{name}}, @ | @w{const char *@var{name}}, @ | ||||
@w{const char *@var{value}}) | @w{const char *@var{value}}) | ||||
@since{1.7.0} | @since{1.7.0} | ||||
Some minor properties of the context can be controlled with flags set | Some minor properties of the context can be controlled with flags set | ||||
▲ Show 20 Lines • Show All 85 Lines • ▼ Show 20 Lines | |||||
to change the behavior of a @code{GPGME_KEYLIST_MODE_LOCATE} keylisting. | to change the behavior of a @code{GPGME_KEYLIST_MODE_LOCATE} keylisting. | ||||
Valid values are documented in the GnuPG manual and the gpg man page under | Valid values are documented in the GnuPG manual and the gpg man page under | ||||
the option @option{--auto-key-locate}. | the option @option{--auto-key-locate}. | ||||
Requires at least GnuPG 2.1.18. | Requires at least GnuPG 2.1.18. | ||||
Note: Keys retrieved through @code{auto-key-locate} are automatically | Note: Keys retrieved through @code{auto-key-locate} are automatically | ||||
imported in the keyring. | imported in the keyring. | ||||
@item trust-model | |||||
@since{1.11.2} | |||||
Change the trust-model for all GnuPG engine operations. An empty | |||||
string sets the trust-model back to the users default. If the | |||||
trust-model is not supported by GnuPG the behavior is undefined | |||||
and will likely cause all operations to fail. Example: "tofu+pgp". | |||||
This options should be used carefully with a strict version | |||||
requirement. In some versions of GnuPG setting the | |||||
trust-model changes the default trust-model for future operations. | |||||
A change in the trust-model also can have unintended side effects, like | |||||
rebuilding the trust-db. | |||||
@end table | @end table | ||||
This function returns @code{0} on success. | This function returns @code{0} on success. | ||||
@end deftypefun | @end deftypefun | ||||
@deftypefun {const char *} gpgme_get_ctx_flag @ | @deftypefun {const char *} gpgme_get_ctx_flag @ | ||||
(@w{gpgme_ctx_t @var{ctx}}, @ | (@w{gpgme_ctx_t @var{ctx}}, @ | ||||
▲ Show 20 Lines • Show All 5,173 Lines • Show Last 20 Lines |