LIBGFSHARE(5)          Shamir Secret Sharing in gf(2**8)         LIBGFSHARE(5)

<?><?><?> (NAME)
       libgfshare - <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       #include <libgfshare.h>

       gfshare_rand_func_t gfshare_fill_rand;

       gfshare_rand_func_t gfshare_bad_idea_but_fill_rand_using_random;

       gfshare_ctx *gfshare_ctx_init_enc( unsigned char *sharenrs,
                                          unsigned int   sharecount,
                                          unsigned char  threshold,
                                          unsigned int   size );

       gfshare_ctx *gfshare_ctx_init_dec( unsigned char *sharenrs,
                                          unsigned int   sharecount,
                                          unsigned int   size );

       void gfshare_ctx_free( gfshare_ctx *ctx );

       void gfshare_ctx_enc_setsecret( gfshare_ctx   *ctx,
                                       unsigned char *secret );

       void gfshare_ctx_enc_getshare( gfshare_ctx   *ctx,
                                      unsigned char  sharenr,
                                      unsigned char *share );

       void gfshare_ctx_dec_newshares( gfshare_ctx   *ctx,
                                       unsigned char *sharenrs );

       void gfshare_ctx_dec_giveshare( gfshare_ctx   *ctx,
                                       unsigned char  sharenr,
                                       unsigned char *share );

       void gfshare_ctx_dec_extract( gfshare_ctx   *ctx,
                                     unsigned char *secretbuf );

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> gfshare_fill_rand <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?> unsigned char * <?> <?><?> unsigned int <?><?><?><?><?><?><?>
       <?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>.
       <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?>
       <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       gfshare_bad_idea_but_fill_rand_using_random <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> gfshare_fill_rand <?><?><?><?> <?><?><?><?> <?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> C
       <?><?><?><?> random() <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> srandom() <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       <?><?><?><?> gfshare_ctx_init_enc() <?><?> <?><?><?> <?><?><?><?><?>
       (context) <?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?><?><?> <?><?> <?><?><?><?> sharecount <?><?><?> <?><?> <?><?>
       <?><?><?><?><?> sharenrs <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> size
       <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> threshold <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
       threshold <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       sharecount <?><?><?><?>.

       <?><?><?><?> gfshare_ctx_init_dec() <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?>.
       <?><?> <?><?><?> <?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> size <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>. <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> sharecount <?><?><?> <?><?>
       <?><?> <?><?><?><?><?> sharenrs <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?> gfshare_ctx_free() <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> gfshare<?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?> gfshare_ctx_enc_setsecret() <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.
       secret <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?>.

       <?><?><?><?> gfshare_ctx_enc_getshare() <?><?> <?><?><?> <?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?> share <?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?><?><?> sharenr <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> sharenrs <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?>.

       <?><?><?><?> gfshare_ctx_dec_newshares() <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> sharenrs <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?> gfshare_ctx_dec_giveshare() <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> sharenrs <?><?><?><?><?> <?><?><?> <?><?><?> <?>
       <?><?><?><?><?><?><?> sharenr <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> share <?><?><?><?> <?><?><?>
       <?><?><?>.

       <?><?><?><?> gfshare_ctx_dec_extract() <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> secretbuf <?><?>
       <?><?> mlock() <?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> swap
       <?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?> (ERRORS)
       <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> NULL <?><?><?><?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (AUTHOR)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> Daniel Silverstone.

<?><?><?><?><?> <?><?><?><?><?><?> (REPORTING BUGS)
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> libgfshare
       <?><?> www.launchpad.net <?><?><?><?><?> <?><?><?><?>.

<?><?> <?><?><?> (COPYRIGHT)
       <?><?> <?><?><?> (C) 2006,2015 Daniel Silverstone.
       <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>.
       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> MIT
       (<?><?><?><?><?><?> COPYRIGHT <?><?> <?><?><?><?><?> <?><?><?><?>)
       <?><?><?><?><?><?><?><?> <?><?><?><?>.  <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       gfsplit(1), gfcombine(1), gfshare(7)

2.0.0                              June 2015                     LIBGFSHARE(5)