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- 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.6.16		gnutls_store_pubkey(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURNS | SINCE | REPORTING BUGS | COPYRIGHT | SEE ALSO

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

home | help