NAME

catinfo_setpath - establish a catinfo search path

SYNOPSIS

#include <cat/cat.h>

int catinfo_setpath(cat_session *sess, char **path);

DESCRIPTION

catinfo_setpath() is used to establish a search path in the info tree for relative lookups using catinfo_get().

sess is the session where the search path will be stored.

path is a NULL-terminated list of strings, where each string represents a context. A subsequent relative lookup will use path[0], path[1], ... , path[n] if a match is not found.

A successful call to catinfo_init() must have been made prior to any call to this function.

catinfo_set() returns 0 if successful or a negative code on error.

SEE ALSO

cat, catinfo