User`s guide

KwikNet PPP Option
K
A
DAK
235
Description ...continued
Interpretation of parameters
instr and outbuf for each value of opcode
is as follows.
For operation codes KN_PPPAUTH_LPNAME, KN_PPPAUTH_LCNAME and
KN_PPPAUTH_LECNAME, instr and buflen are unused. A pointer to the
local name for the specified authentication protocol is stored at *outbuf.
Note that CHAP and MS-CHAP share a common local name. Hence, if
MS-CHAP is used but CHAP is not used, this function must provide the
CHAP local name when requested. The name is returned for delivery to
the peer.
For operation code KN_PPPAUTH_LPPWD, KN_PPPAUTH_LCSECRET,
KN_PPPAUTH_LECSECRET and KN_PPPAUTH_LM1SECRET, instr and buflen
are unused. A pointer to the local password or secret for the specified
authentication protocol is stored at *outbuf. The PAP password is
returned for delivery to the peer. For the other protocols, the secret will be
used to encrypt the response to the peer's challenge.
For operation code KN_PPPAUTH_PCSECRET, KN_PPPAUTH_PECSECRET and
KN_PPPAUTH_PM1SECRET, instr is a pointer to the peer name which is of
length specified by inlen. Parameter buflen is unused. If the peer's
name matches the peer name for the specified authentication protocol, a
pointer to the peer's secret is stored at *outbuf. It will be used to encrypt
the challenge which was sent to the peer. The result is then compared to
the challenge response from the peer.
! Important note: see restriction on next page !
For operation code KN_PPPAUTH_PPCHECK, instr is a pointer to the PAP
name which is of length specified by inlen. Parameter outbuf is a
pointer to the PAP password provided by the peer for authentication. The
password is of length specified by
buflen. Note that in this special case,
outbuf is a pointer to a character array; it is not a pointer to a pointer.
These parameters must be checked for validity and the result of the check
must be returned to the caller. The input parameters at *instr and
*outbuf must not be modified.
! Important note: see restriction on next page !
For operation code KN_PPPAUTH_PCNAME and KN_PPPAUTH_PECNAME,
instr and buflen are unused. A pointer to the challenge name for the
specified authentication protocol is stored at
*outbuf. Note that CHAP
and MS-CHAP share a common challenge name. Hence, if MS-CHAP is
used but CHAP is not used, this function must provide the CHAP
challenge name when requested. The challenge name is returned for
delivery to the peer in the authentication challenge.
...more