Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gnutls_store_pubkey(3)		    gnutls		gnutls_store_pubkey(3)

NAME
       gnutls_store_pubkey - API function

SYNOPSIS
       #include	<gnutls/gnutls.h>

       int  gnutls_store_pubkey(const  char * db_name, gnutls_tdb_t tdb, const
       char * host, const char * service, gnutls_certificate_type_t cert_type,
       const gnutls_datum_t * cert, time_t expiration, unsigned	int flags);

ARGUMENTS
       const char * db_name
		   A file specifying the stored	keys (use  NULL	 for  the  de-
		   fault)

       gnutls_tdb_t tdb
		   A storage structure or NULL to use the default

       const char * host
		   The peer's name

       const char * service
		   non-NULL if this key	is specific to a service (e.g. http)

       gnutls_certificate_type_t cert_type
		   The type of the certificate

       const gnutls_datum_t * cert
		   The data of the certificate

       time_t expiration
		   The expiration time (use 0 to disable expiration)

       unsigned	int flags
		   should be 0.

DESCRIPTION
       This  function will store a raw public-key or a public-key provided via
       a raw (DER-encoded) certificate to the list of stored public keys.  The
       key will	be considered valid until the provided expiration time.

       The   tdb variable if non-null specifies	a custom backend for the stor-
       age of entries. If it is	NULL then the default  file  backend  will  be
       used.

       Unless an alternative  tdb is provided, the storage format is a textual
       format consisting of a line for each host with fields separated by '|'.
       The  contents  of  the  fields  are a format-identifier which is	set to
       'g0', the hostname that the rest	of the data applies  to,  the  numeric
       port  or	 host  name, the expiration time in seconds since the epoch (0
       for no expiration), and a base64	encoding of the	raw (DER)  public  key
       information (SPKI) of the peer.

       As of GnuTLS 3.6.6 this function	also accepts raw public	keys.

RETURNS
       On  success, GNUTLS_E_SUCCESS (0) is returned, otherwise	a negative er-
       ror value.

SINCE
       3.0.13

REPORTING BUGS
       Report bugs to <bugs@gnutls.org>.
       Home page: https://www.gnutls.org

COPYRIGHT
       Copyright (C) 2001-2023 Free Software Foundation, Inc., and others.
       Copying and distribution	of this	file, with  or	without	 modification,
       are  permitted in any medium without royalty provided the copyright no-
       tice and	this notice are	preserved.

SEE ALSO
       The full	documentation for gnutls is maintained as  a  Texinfo  manual.
       If the /usr/local/share/doc/gnutls/ directory does not contain the HTML
       form visit

       https://www.gnutls.org/manual/

gnutls				     3.8.9		gnutls_store_pubkey(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnutls_store_pubkey&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help