doc/gsasl-callback-digest-md5.texi

   1 @deftypefn Prototype int (*Gsasl_server_callback_digest_md5) (Gsasl_session_ctx * @var{ctx}, char * @var{username}, char * @var{realm}, char * @var{secrethash})
   2
   3 @var{ctx}:  libgsasl handle.
   4
   5 @var{username}:  input array with authentication identity of user.
   6
   7 @var{realm}:  input array with realm of user.
   8
   9 @var{secrethash}: output array that should contain hash of username,
  10 realm and password as described for the DIGEST-MD5 mechanism.
  11
  12 Type of callback function the application implements.  It should
  13 retrieve the secret hash for the given user in given realm and return
  14 GSASL_OK, or an error such as GSASL_AUTHENTICATION_ERROR if it fails.
  15 The secrethash buffer is guaranteed to have size for the fixed length
  16 MD5 hash.
  17
  18 @end deftypefn