[Bug 247386] Description of the last argument of procctl is confusing

[bugzilla-noreply at freebsd.org]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=247386

            Bug ID: 247386
           Summary: Description of the last argument of procctl is
                    confusing
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Manual Pages
          Assignee: bugs at FreeBSD.org
          Reporter: paulf at free.fr
                CC: doc at FreeBSD.org

The man page gives the following signature

int     procctl(idtype_t idtype, id_t id, int cmd,      void *arg);

(note the name of the last argument, 'arg').

In the following descriptions 'arg' is used for PROC_ASLR_CTL,
PROC_ASLR_STATUS, PROC_SPROTECT. 

PROC_REAP_ACQUIRE seems not to use the 4th argument.

Then the 7 following descriptions starting with PROC_REAP_STATUS use 'data'

PROC_PDEATHSIG_STATUS switches back to 'arg'. And the last two are 'data'
again.

I see that syscalls.master calls the last argument 'data', so there seems to be
a mix of the signature given in the man page and the one in syscalls.master.

I think that it would be clearer to use 'arg' consistently.

-- 
You are receiving this mail because:
You are on the CC list for the bug.