Debian Codegraph @

doc/functions/gnutls_store_pubkey

raw
1
2
3
4
5 @deftypefun {int} {gnutls_store_pubkey} (const char * @var{db_name}, gnutls_tdb_t @var{tdb}, const char * @var{host}, const char * @var{service}, gnutls_certificate_type_t @var{cert_type}, const gnutls_datum_t * @var{cert}, time_t @var{expiration}, unsigned int @var{flags})
6 @var{db_name}: A file specifying the stored keys (use NULL for the default)
7
8 @var{tdb}: A storage structure or NULL to use the default
9
10 @var{host}: The peer's name
11
12 @var{service}: non-NULL if this key is specific to a service (e.g. http)
13
14 @var{cert_type}: The type of the certificate
15
16 @var{cert}: The data of the certificate
17
18 @var{expiration}: The expiration time (use 0 to disable expiration)
19
20 @var{flags}: should be 0.
21
22 This function will store a raw public-key or a public-key provided via
23 a raw (DER-encoded) certificate to the list of stored public keys. The key
24 will be considered valid until the provided expiration time.
25
26 The @code{tdb} variable if non-null specifies a custom backend for
27 the storage of entries. If it is NULL then the
28 default file backend will be used.
29
30 Unless an alternative @code{tdb} is provided, the storage format is a textual format
31 consisting of a line for each host with fields separated by '|'. The contents of
32 the fields are a format-identifier which is set to 'g0', the hostname that the
33 rest of the data applies to, the numeric port or host name, the expiration
34 time in seconds since the epoch (0 for no expiration), and a base64
35 encoding of the raw (DER) public key information (SPKI) of the peer.
36
37 As of GnuTLS 3.6.6 this function also accepts raw public keys.
38
39 @strong{Returns:} On success, @code{GNUTLS_E_SUCCESS} (0) is returned, otherwise a
40 negative error value.
41
42 @strong{Since:} 3.0.13
43 @end deftypefun