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

FreeBSD Manual Pages

  
 
  

home | help
KRB5_C_MAKE_CHECKSUM(3)	    Library Functions Manual   KRB5_C_MAKE_CHECKSUM(3)

NAME
       krb5_c_block_size,	     krb5_c_decrypt,	       krb5_c_encrypt,
       krb5_c_encrypt_length,	krb5_c_enctype_compare,	  krb5_c_get_checksum,
       krb5_c_is_coll_proof_cksum,   krb5_c_is_keyed_cksum,  krb5_c_keylength,
       krb5_c_make_checksum,   krb5_c_make_random_key,	  krb5_c_set_checksum,
       krb5_c_valid_cksumtype,	krb5_c_valid_enctype,  krb5_c_verify_checksum,
       krb5_c_checksum_length -- Kerberos 5 crypto API

LIBRARY
       Kerberos	5 Library (libkrb5, -lkrb5)

SYNOPSIS
       #include	<krb5.h>

       krb5_error_code
       krb5_c_block_size(krb5_context context,		 krb5_enctype enctype,
	   size_t *blocksize);

       krb5_error_code
       krb5_c_decrypt(krb5_context context,	      const krb5_keyblock key,
	   krb5_keyusage usage,	 const krb5_data *ivec,	 krb5_enc_data *input,
	   krb5_data *output);

       krb5_error_code
       krb5_c_encrypt(krb5_context context,	     const krb5_keyblock *key,
	   krb5_keyusage usage,	const krb5_data	*ivec, const krb5_data *input,
	   krb5_enc_data *output);

       krb5_error_code
       krb5_c_encrypt_length(krb5_context context,	 krb5_enctype enctype,
	   size_t inputlen, size_t *length);

       krb5_error_code
       krb5_c_enctype_compare(krb5_context context,	      krb5_enctype e1,
	   krb5_enctype	e2, krb5_boolean *similar);

       krb5_error_code
       krb5_c_make_random_key(krb5_context context,	 krb5_enctype enctype,
	   krb5_keyblock *random_key);

       krb5_error_code
       krb5_c_make_checksum(krb5_context context,    krb5_cksumtype cksumtype,
	   const krb5_keyblock *key,			  krb5_keyusage	usage,
	   const krb5_data *input, krb5_checksum *cksum);

       krb5_error_code
       krb5_c_verify_checksum(krb5_context context,  const krb5_keyblock *key,
	   krb5_keyusage usage,				const krb5_data	*data,
	   const krb5_checksum *cksum, krb5_boolean *valid);

       krb5_error_code
       krb5_c_checksum_length(krb5_context context,  krb5_cksumtype cksumtype,
	   size_t *length);

       krb5_error_code
       krb5_c_get_checksum(krb5_context	context,   const krb5_checksum *cksum,
	   krb5_cksumtype *type, krb5_data **data);

       krb5_error_code
       krb5_c_set_checksum(krb5_context	context,	 krb5_checksum *cksum,
	   krb5_cksumtype type,	const krb5_data	*data);

       krb5_boolean
       krb5_c_valid_enctype(krb5_enctype, etype");

       krb5_boolean
       krb5_c_valid_cksumtype(krb5_cksumtype ctype);

       krb5_boolean
       krb5_c_is_coll_proof_cksum(krb5_cksumtype ctype);

       krb5_boolean
       krb5_c_is_keyed_cksum(krb5_cksumtype ctype);

       krb5_error_code
       krb5_c_keylengths(krb5_context context,		 krb5_enctype enctype,
	   size_t *inlength, size_t *keylength);

DESCRIPTION
       The  functions  starting	with krb5_c are	compat functions with MIT ker-
       beros.

       The krb5_enc_data structure holds and encrypted data.   There  are  two
       public accessible members of krb5_enc_data.  enctype that holds the en-
       cryption	 type of the data encrypted and	ciphertext that	is a krb5_data
       that might contain the encrypted	data.

       krb5_c_block_size() returns the blocksize of the	encryption type.

       krb5_c_decrypt()	decrypts input and store the data in output.  If  ivec
       is NULL the default initialization vector for that encryption type will
       be used.

       krb5_c_encrypt()	 encrypts the plaintext	in input and store the cipher-
       text in output.

       krb5_c_encrypt_length() returns the length the encrypted	data given the
       plaintext length.

       krb5_c_enctype_compare()	compares to encryption types  and  returns  if
       they use	compatible encryption key types.

       krb5_c_make_checksum()  creates a checksum cksum	with the checksum type
       cksumtype of the	data in	data.  key and usage are used if the  checksum
       is a keyed checksum type.  Returns 0 or an error	code.

       krb5_c_verify_checksum()	 verifies  the	checksum of data in cksum that
       was created with	key using the key usage	usage.	verify is set to  non-
       zero  if	the checksum verifies correctly	and zero if not.  Returns 0 or
       an error	code.

       krb5_c_checksum_length()	returns	the length of the checksum.

       krb5_c_set_checksum() sets the krb5_checksum structure given  type  and
       data.	 The	content	   of	 cksum	  should    be	 freeed	  with
       krb5_c_free_checksum_contents().

       krb5_c_get_checksum() retrieves the components  of  the	krb5_checksum.
       structure.   data should	be free	with krb5_free_data().	If some	either
       of data or checksum is not needed for  the  application,	 NULL  can  be
       passed in.

       krb5_c_valid_enctype()  returns	true  if  etype	 is a valid encryption
       type.

       krb5_c_valid_cksumtype()	returns	true if	 ctype	is  a  valid  checksum
       type.

       krb5_c_is_keyed_cksum() return true if ctype is a keyed checksum	type.

       krb5_c_is_coll_proof_cksum() returns true if ctype is a collision proof
       checksum	type.

       krb5_c_keylengths()  return  the	minimum	length (inlength) bytes	needed
       to create a key and the length (keylength) of the resulting key for the
       enctype.

SEE ALSO
       krb5(3),	krb5_create_checksum(3), krb5_free_data(3), kerberos(8)

HEIMDAL				 Nov 17, 2006	       KRB5_C_MAKE_CHECKSUM(3)

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

home | help