Refactor: libcrmcommon: best practices for internal utility functions

This is part of a project to ensure all internal library functions follow
current naming and copyright guidelines, ensure they have doxygen blocks,
and use the new standard function return codes where appropriate.