DragonFly On-Line Manual Pages

KHTTPDIGEST_VALIDATE(3)                     DragonFly Library Functions Manual

NAME
     khttpdigest_validate - validate an HTTP digest request

LIBRARY
     library "libkcgi"

SYNOPSIS
     #include <stdint.h>
     #include <kcgi.h>

     int
     khttpdigest_validate(struct kreq *req, const char *password);

DESCRIPTION
     The khttpdigest_validate function validates the given password with the
     HTTP digest-authorised request req as returned by khttp_parse(3) or
     khttp_fcgi_parse(3).  It fully implements all components of the digest:
     QOP, MD5 types, etc.  It does not check that the URI component of the
     digest matches that of the request, as these values are known to be
     mutable.

RETURN VALUES
     khttpdigest_validate will return zero if validation failed, less than
     zero if the request was not properly set up for HTTP digest validation,
     or greater than zero if the validation succeeded.

SEE ALSO
     kcgi(3), khttp_fcgi_parse(3), khttp_parse(3), khttpbasic_validate(3)

AUTHORS
     The khttpdigest_validate function was written by Kristaps Dzonsons
     <kristaps@bsd.lv>.

DragonFly 6.5-DEVELOPMENT       January 7, 2016      DragonFly 6.5-DEVELOPMENT