pwcache.3: Explicitly document OOM condition

The pwcache functions allocate memory, and may return NULL pointers if that
allocation fails and the corresponding uid or gid was not found in the local
password database. Document this behavior.

Sponsored by: Dell EMC Isilon