shishi_authenticator_set_subkey(3)				      shishi					shishi_authenticator_set_subkey(3)

NAME

       shishi_authenticator_set_subkey - API function

SYNOPSIS

       #include <shishi.h>

       int shishi_authenticator_set_subkey(Shishi * handle, Shishi_asn1 authenticator, int32_t subkeytype, const char * subkey, size_t subkeylen);

ARGUMENTS

       Shishi * handle
		   shishi handle as allocated by shishi_init().

       Shishi_asn1 authenticator
		   authenticator as allocated by shishi_authenticator().

       int32_t subkeytype
		   input subkey type to store in authenticator.

       const char * subkey
		   input subkey data to store in authenticator.

       size_t subkeylen
		   size of input subkey data to store in authenticator.

DESCRIPTION

       Store  subkey  value in authenticator.  A subkey is usually created by calling shishi_key_random() using the default encryption type of the
       key from the ticket that is being used.	To save time, you may want to use shishi_authenticator_add_subkey() instead, which calculates  the
       subkey and calls this function in one step.

RETURN VALUE

       Returns SHISHI_OK iff successful.

REPORTING BUGS

       Report bugs to <bug-shishi@gnu.org>.

COPYRIGHT

       Copyright (C) 2002-2010 Simon Josefsson.
       Copying	and  distribution  of  this file, with or without modification, are permitted in any medium without royalty provided the copyright
       notice and this notice are preserved.

SEE ALSO

       The full documentation for shishi is maintained as a Texinfo manual.  If the info and shishi programs are properly installed at your  site,
       the command

	      info shishi

       should give you access to the complete manual.

shishi								       1.0.1					shishi_authenticator_set_subkey(3)