Refactor: libstonithd: clarify pointer arguments in headers

Mark pointer arguments as const where appropriate, and ensure doxygen blocks
use [in] or [in,out] as appropriate. Also update argument names to correspond
to the implementations.

This is not comprehensive but focuses on functions that have doxygen blocks
in headers under include/ and some functions called by them.