NAME

catboks_route - obtain encryption and authentication status

SYNOPSIS

#include <cat/boks.h>

#define CATBOKS_STATUSLEN 16

int catboks_route(char *route, char encryption_status[16], char auth_status[16]);

DESCRIPTION

This function gets the encryption and authentication status, based on the access route route. The results are stored in encryption_status and auth_status.

Possible values for auth_status include "dasp" to indicate that strong authentication is required.

Return values for encryption_status include "nd2" to request encryption using the ND2 algorithm, "null" to use the encryption protocol with a null algorithm, and "none" to skip encryption. Any other response should be treated as a request to use the strongest available encryption.

RETURN VALUES

The function returns 0 if successful, or a negative code on error.

SEE ALSO

cat, catboks