Refactor: libcrmcommon: best practices for realpath function

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

In this case, crm_compat_realpath() has been renamed to pcmk__real_path(),
refactored, and moved into io.c, and compat.c has been removed.