The libutil pidfile(3) routines are useful, but provide only an interface for creating pid files. For software that wants to read and extract a pid from a pid file, there is no public interface. However, the private (static) function pidfile_read() in pidfile.c would provide such an interface. It need only be made externally visible and documented. Fix: Remove "static" from definition in pidfile.c. Add pidfile_read() prototype to libutil.h. Add pidfile_read() doc to pidfile.3.
Not quite five years since I wrote this and I was finally going to fix it when I re-read what I wrote, why I needed it, and re-examined the API. I realize now that the existing API is sufficient, so I'm going to close this bug.