Refactor: libcrmcommon: best practices for internal watchdog-related 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.