#include <cat/gen.h>
int catgen_dbmap(cat_session *sess, const char *givenuser, const char *givenpsw, const char *givendbid, char **newuser, char **newpsw, char **newdbid);
If the call is successful, the supplied pointers (newuser, newpsw, and newdbid), provided they are non-NULL, will be set to point to allocated data. The allocated data must be freed by the caller.
This call must be preceded by a successful call to catgen_checkauth().
One or more of the input parameters givenuser, givenpsw and givendbid can be NULL, in which case they will match any value.