NAME

catdasp_setciphers - set DASP encryption algorithms

SYNOPSIS

#include <cat/dasp.h>

int catdasp_setciphers(catdasp_info *info, int ciphermask);

DESCRIPTION

This function sets the set of algorithms to be used for data stream encryption. This is relevant only for the ALLTAK protocols.

By default the strongest available cipher will be used. The ciphermask argument should be an ORed combination of any of the following:

CAT_STRONG_CIPHERS
Use strong ciphers that may be subject to export control, if available. In an export version of the SDK, this bit would have no effect.

CAT_EXPORT_CIPHERS
Use exportable ciphers.

CAT_NULL_CIPHER
Support authentication with no line encryption. The network data is still packed into SSL frames. This cipher should normally not be used.

CAT_REQUIRE_CIPHERS
Make the function return an error if any of the requested ciphers are unavailable.

CAT_DEFAULT_CIPHERS
Equivalent to (CAT_STRONG_CIPHERS | CAT_EXPORT_CIPHERS), that is, ``use the strongest cipher available''.

Unavailable ciphers are ignored (unless CAT_REQUIRE_CIPHERS is set).

The function returns CAT_OK if successful. If all requested ciphers are unavailable, the function returns an error code.

SEE ALSO

cat, catdasp

catssl_setciphers