| 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 |