saslcheckapop(29 June 2001) saslcheckapop(29 June 2001)

NAME
       saslcheckapop - Check an APOP challenge/response

SYNOPSIS
       ##iinncclluuddee <>

       iinntt ssaassllcchheecckkaappoopp((ssaassllccoonnnntt **conn,,
                        ccoonnsstt cchhaarr **challenge,,
                        uunnssiiggnneedd challen,,
                        ccoonnsstt cchhaarr **response,,
                        uunnssiiggnneedd resplen));;


DESCRIPTION
       ssaassllcchheecckkaappoopp(())  will  check  an  APOP challenge/response.  APOP is an
       optional POP3 (RFC 1939) authentication command  which  uses  a  shared
       secret (password). The password is stored in the SASL secrets database.
       For information on the SASL shared  secrets  database  see  the  System
       Administrators Guide in the doc/ directory of the SASL distribution.

       If  called with a NNUULLLL challenge,, ssaassllcchheecckkaappoopp(()) will check to see if
       the APOP mechanism is enabled.


RREETTUURRNN VVAALLUUEE
       saslcheckapop returns an integer which corresponds to one of the  fol-
       lowing  codes.  SASLOK  indicates that the authentication is complete.
       All other return codes indicate errors and should either be handled  or
       the  authentication  session  should  be  quit.  See saslerrors(3) for
       meanings of return codes.


CCOONNFFOORRMMIINNGG TTOO
       RFC 2222, RFC 1939

SEE ALSO
       sasl(3), saslerrors(3)



SASL man pages                       SASL         saslcheckapop(29 June 2001)