Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 18 Jun 2020 18:07:54 +0000
From:      bugzilla-noreply@freebsd.org
To:        bugs@FreeBSD.org
Subject:   [Bug 247386] Description of the last argument of procctl is confusing
Message-ID:  <bug-247386-227@https.bugs.freebsd.org/bugzilla/>

next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D247386

            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@FreeBSD.org
          Reporter: paulf@free.fr
                CC: doc@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.=20

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 t=
o 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.

--=20
You are receiving this mail because:
You are the assignee for the bug.=



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-247386-227>