Skip to content

Commit

Permalink
proccontrol: make -s require a target
Browse files Browse the repository at this point in the history
Require a command to exec or a pid to target and update usage and the
manpage to make this more clear.

It makes no sense to invoke a procctl(2) command on the current process
only to exit.  Users are sometimes confused about how proccontrol works
and think it effects their shell environment when invoked without a
target.  Disallowing this nonsensical behavior and clarifiying usage
will hopefully reduce confusion.

Reviewed by:	kib
Differential Revision:	https://reviews.freebsd.org/D46422

(cherry picked from commit 70174ef)
(cherry picked from commit 5cbb98c)
  • Loading branch information
brooksdavis authored and bsdjhb committed Aug 26, 2024
1 parent 40a7a13 commit 36925d6
Show file tree
Hide file tree
Showing 2 changed files with 17 additions and 8 deletions.
9 changes: 6 additions & 3 deletions usr.bin/proccontrol/proccontrol.1
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.Dd October 5, 2023
.Dd August 23, 2024
.Dt PROCCONTROL 1
.Os
.Sh NAME
Expand All @@ -35,9 +35,12 @@
.Sh SYNOPSIS
.Nm
.Fl m Ar mode
.Op Fl s Ar control
.Op Fl q
.Fl s Ar control
.Fl p Ar pid | command
.Nm
.Fl m Ar mode
.Fl q
.Op Fl p Ar pid | command
.Sh DESCRIPTION
The
.Nm
Expand Down
16 changes: 11 additions & 5 deletions usr.bin/proccontrol/proccontrol.c
Original file line number Diff line number Diff line change
Expand Up @@ -98,11 +98,15 @@ str2pid(const char *str)
static void __dead2
usage(void)
{

fprintf(stderr, "Usage: proccontrol -m (aslr|protmax|trace|trapcap|"
"stackgap|nonewprivs|wxmap"KPTI_USAGE LA_USAGE CHERI_REVOKE_USAGE
CHERI_C18N_USAGE
") [-q] [-s (enable|disable)] [-p pid | command]\n");
fprintf(stderr, "Usage:\n");
fprintf(stderr, " proccontrol -m mode -s (enable|disable) "
"(-p pid | command)\n");
fprintf(stderr, " proccontrol -m mode -q [-p pid]\n");
fprintf(stderr, "Modes: "
"aslr|protmax|trace|trapcap|stackgap|nonewprivs|wxmap"
KPTI_USAGE LA_USAGE
CHERI_REVOKE_USAGE CHERI_C18N_USAGE
"\n");
exit(1);
}

Expand Down Expand Up @@ -183,6 +187,8 @@ main(int argc, char *argv[])
usage();
pid = getpid();
} else if (pid == -1) {
if (!query)
usage();
pid = getpid();
}

Expand Down

0 comments on commit 36925d6

Please sign in to comment.