API: libpacemaker: Add function for listing resource agents.

This is the same functionality as "crm_resource --list-agents", but in a
pair of public and private functions. crm_resource has then been
modified to just call the private function instead of doing this on its
own.

Ref T44