Man Linux: Main Page and Category List

NAME

       shishi_authenticator_client - API function

SYNOPSIS

       #include <shishi.h>

       int    shishi_authenticator_client(Shishi    *    handle,   Shishi_asn1
       authenticator, char ** client, size_t * clientlen);

ARGUMENTS

       Shishi * handle
                   Shishi library handle create by shishi_init().

       Shishi_asn1 authenticator
                   Authenticator variable to get client name from.

       char ** client
                   pointer  to  newly   allocated   zero   terminated   string
                   containing  principal  name.  May be NULL (to only populate
                   clientlen).

       size_t * clientlen
                   pointer  to  length  of   client   on   output,   excluding
                   terminating zero.  May be NULL (to only populate client).

DESCRIPTION

       Represent  client  principal  name  in Authenticator as zero-terminated
       string.  The string is  allocate  by  this  function,  and  it  is  the
       responsibility  of  the  caller to deallocate it.  Note that the output
       length clientlen does not include the terminating zero.

RETURN VALUE

       Returns SHISHI_OK iff successful.

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.