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

FreeBSD Manual Pages

  
 
  

home | help
gnutls_privkey_import_ext4(3)	    gnutls	 gnutls_privkey_import_ext4(3)

NAME
       gnutls_privkey_import_ext4 - API	function

SYNOPSIS
       #include	<gnutls/abstract.h>

       int  gnutls_privkey_import_ext4(gnutls_privkey_t	pkey, void * userdata,
       gnutls_privkey_sign_data_func				 sign_data_fn,
       gnutls_privkey_sign_hash_func sign_hash_fn, gnutls_privkey_decrypt_func
       decrypt_fn,	      gnutls_privkey_deinit_func	    deinit_fn,
       gnutls_privkey_info_func	info_fn, unsigned int flags);

ARGUMENTS
       gnutls_privkey_t	pkey
		   The private key

       void * userdata
		   private data	to be provided to the callbacks

       gnutls_privkey_sign_data_func sign_data_fn
		   callback for	signature operations (may be NULL)

       gnutls_privkey_sign_hash_func sign_hash_fn
		   callback for	signature operations (may be NULL)

       gnutls_privkey_decrypt_func decrypt_fn
		   callback for	decryption operations (may be NULL)

       gnutls_privkey_deinit_func deinit_fn
		   a deinitialization function

       gnutls_privkey_info_func	info_fn
		   returns  info about the public key algorithm	(should	not be
		   NULL)

       unsigned	int flags
		   Flags for the import

DESCRIPTION
       This  function  will   associate	  the	given	callbacks   with   the
       gnutls_privkey_t	 type. At least	one of the callbacks must be non-null.
       If a deinitialization function is provided then	flags  is  assumed  to
       contain GNUTLS_PRIVKEY_IMPORT_AUTO_RELEASE.

       Note  that  in contrast with the	signing	function of gnutls_privkey_im-
       port_ext3(), the	signing	functions provided to this function  take  ex-
       plicitly	 the  signature	algorithm as parameter and different functions
       are provided to sign the	data and hashes.

       The  sign_hash_fn is to be called to sign pre-hashed data. The input to
       the  callback  is the output of the hash	(such as SHA256) corresponding
       to the signature	algorithm. For RSA PKCS1 signatures, the signature al-
       gorithm	can  be	 set to	GNUTLS_SIGN_RSA_RAW, and in that case the data
       should be handled as if they were an RSA	PKCS1 DigestInfo structure.

       The  sign_data_fn is to be called to sign data. The input data will  be
       he  data	 to  be	signed (and hashed), with the provided signature algo-
       rithm. This function is	to  be	used  for  signature  algorithms  like
       Ed25519 which cannot take pre-hashed data as input.

       When  both   sign_data_fn and  sign_hash_fn functions are provided they
       must be able to operate on all the supported signature algorithms,  un-
       less prohibited by the type of the algorithm (e.g., as with Ed25519).

       The   info_fn must provide information on the signature algorithms sup-
       ported  by  this	 private   key,	  and	should	 support   the	 flags
       GNUTLS_PRIVKEY_INFO_PK_ALGO,   GNUTLS_PRIVKEY_INFO_HAVE_SIGN_ALGO   and
       GNUTLS_PRIVKEY_INFO_PK_ALGO_BITS.  It must return -1 on unknown flags.

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

SINCE
       3.6.0

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.15	 gnutls_privkey_import_ext4(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_privkey_import_ext4&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help