|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@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})
|
|
Packit Service |
4684c1 |
@var{db_name}: A file specifying the stored keys (use NULL for the default)
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{tdb}: A storage structure or NULL to use the default
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{host}: The peer's name
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{service}: non-NULL if this key is specific to a service (e.g. http)
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{cert_type}: The type of the certificate
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{cert}: The data of the certificate
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{expiration}: The expiration time (use 0 to disable expiration)
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{flags}: should be 0.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
This function will store a raw public-key or a public-key provided via
|
|
Packit Service |
4684c1 |
a raw (DER-encoded) certificate to the list of stored public keys. The key
|
|
Packit Service |
4684c1 |
will be considered valid until the provided expiration time.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
The @code{tdb} variable if non-null specifies a custom backend for
|
|
Packit Service |
4684c1 |
the storage of entries. If it is NULL then the
|
|
Packit Service |
4684c1 |
default file backend will be used.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
Unless an alternative @code{tdb} is provided, the storage format is a textual format
|
|
Packit Service |
4684c1 |
consisting of a line for each host with fields separated by '|'. The contents of
|
|
Packit Service |
4684c1 |
the fields are a format-identifier which is set to 'g0', the hostname that the
|
|
Packit Service |
4684c1 |
rest of the data applies to, the numeric port or host name, the expiration
|
|
Packit Service |
4684c1 |
time in seconds since the epoch (0 for no expiration), and a base64
|
|
Packit Service |
4684c1 |
encoding of the raw (DER) public key information (SPKI) of the peer.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
As of GnuTLS 3.6.6 this function also accepts raw public keys.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS} (0) is returned, otherwise a
|
|
Packit Service |
4684c1 |
negative error value.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@strong{Since:} 3.0.13
|
|
Packit Service |
4684c1 |
@end deftypefun
|