Previous

Next

Function xn_lcp_want_mru

Sets the MRU value to negotiate.

int xn_lcp_want_mru(int    iface_no, 
                    int    host, 
                    DWORD  opt_val, 
                    int    negotiable);

Parameters

iface_no

Interface number returned by xn_attach.

host

Set negotiation flag for local or remote host (LOCAL_HOST or REMOTE_HOST).

opt_val

Maximum segment size value.

negotiable

TRUE or FALSE; Specifies whether the MRU value is negotiable.

return value

Returns 0 if successful, otherwise SOCKET_ERROR. If an error occurred, call xn_getlasterror and xn_geterror_string to return the error value. Section Error Codes further describes each error.

Possible values for this function are:

This function establishes that the LCP Maximum-Receive-Unit option (maximum segment size) should be requested and then assigns the value to the request.

Call this routine with host set to LOCAL_HOST to request an LCP Maximum-Receive-Unit (maximum segment size). If the value is different from the default value specified in RFC 1172, then the MRU option will be requested. The MRU option will not be requested if the value is the same as the default. If a NAK is received from the remote host, the MRU value in the remote host will be accepted (i.e. sent in the subsequent request) if parameter negotiable is set to TRUE or the NAKed value is less than the requested value. The option will be dropped if the remote host rejects the MRU option requested.

Call this routine with host set to REMOTE_HOST to request an alternative LCP Maximum-Receive-Unit (maximum segment size) if the MRU is not requested by the remote host or if it does not match the desired value. If the value specified is different from the default value specified in RFC 1172, then the alternative MRU option will be requested. If the remote host again requests an MRU value other than the value we sent in the NAK, the action performed will be based upon the parameter negotiable (i.e. if the option is negotiable, the value requested by the remote host will be accepted; if the option is not negotiable, the alternative MRU value will always be set in a configurable NAK in response to requests with a different value).

In order to accept the suggested MRU value from the remote host, call this routine with negotiable set to TRUE. In order to accept the suggested MRU value from the remote host (only if it is less than the desired value) call this function with negotiable set to FALSE.

The option will be dropped after 10 retries if the Configuration-Requests received in response to the Configuration-NAK does not contain the option.

The option value will be accepted after 10 retries if the Configuration-Requests received in response to the Configuration-NAK does not contain the value specified in NAK.

The default is to not request the MRU option.

PPP

Function xn_lcp_want_magic

Function xn_lcp_want_option