getCallingPid: document when to use it

Generally for debugging only, not for security reasons.
Needed to be documented for a long time.

Fixes: 383169393
Test: N/A
Change-Id: Id3c4a39832a115c5c20a25475fb28fbe896366c5