Refactor: tools: Note that functions in cibsecret call out->err.

With so many functions calling other functions through pointers, it can
be a little difficult to tell when an error has been recorded. So, make
it clear with doc strings on these basic functions.