Fix CVE-2017-6891 in minitasn1 code
[platform/upstream/gnutls.git] / doc / functions / gnutls_store_pubkey
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 the provided (raw or DER-encoded) certificate to 
23 the list of stored public keys. The key will be considered valid until 
24 the provided expiration time.
25
26 The  @code{store} 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 @strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
31 negative error value.
32
33 @strong{Since:} 3.0.13
34 @end deftypefun