NAME

       shishi_keys_from_keytab_file - API function

SYNOPSIS

       #include <shishi.h>

       int  shishi_keys_from_keytab_file(Shishi  *  handle, const char * filename, Shishi_keys **
       outkeys);

ARGUMENTS

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

       const char * filename
                   name of file to read.

       Shishi_keys ** outkeys
                   pointer to key set that will be allocated and populated, must  be  deallocated
                   by caller on succes.

DESCRIPTION

       Create  a  new  key  set  populated with keys from a MIT keytab data structure read from a
       file.

       The format of keytab's is proprietary, and this function support  the  0x0501  and  0x0502
       formats.   See the section The MIT Kerberos Keytab Binary File Format in the Shishi manual
       for a description of the reverse-engineered format.

RETURNS

       Returns SHISHI_IO_ERROR if the file cannot be read, SHISHI_KEYTAB_ERROR if the data cannot
       be parsed as a valid keytab structure, and SHISHI_OK on success.

REPORTING BUGS

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

COPYRIGHT

       Copyright © 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.