svn commit: r344594 - head/usr.bin/proccontrol

[Rodney W. Grimes]

> Author: kib
> Date: Tue Feb 26 17:46:19 2019
> New Revision: 344594
> URL: https://svnweb.freebsd.org/changeset/base/344594
> 
> Log:
>   proccontrol(1) man page.
>   
>   Reviewed by:	0mp
>   Sponsored by:	The FreeBSD Foundation
>   Differential revision:	https://reviews.freebsd.org/D19308
> 
> Added:
>   head/usr.bin/proccontrol/proccontrol.1   (contents, props changed)
> Modified:
>   head/usr.bin/proccontrol/Makefile
> 
> Modified: head/usr.bin/proccontrol/Makefile
> ==============================================================================
> --- head/usr.bin/proccontrol/Makefile	Tue Feb 26 17:41:41 2019	(r344593)
> +++ head/usr.bin/proccontrol/Makefile	Tue Feb 26 17:46:19 2019	(r344594)
> @@ -2,6 +2,5 @@
>  
>  PROG=   proccontrol
>  WARNS?=	6
> -MAN=
>  
>  .include <bsd.prog.mk>
> 
> Added: head/usr.bin/proccontrol/proccontrol.1
> ==============================================================================
> --- /dev/null	00:00:00 1970	(empty, because file is newly added)
> +++ head/usr.bin/proccontrol/proccontrol.1	Tue Feb 26 17:46:19 2019	(r344594)
> @@ -0,0 +1,123 @@
> +.\" Copyright (c) 2019 The FreeBSD Foundation, Inc.
> +.\" All rights reserved.

I thought the foundation updated all its templates and contracts
such that the All rights reserved was no longer needed?

Ed?

> +.\"
> +.\" This documentation was written by
> +.\" Konstantin Belousov <kib at FreeBSD.org> under sponsorship
> +.\" from the FreeBSD Foundation.
> +.\"
> +.\" Redistribution and use in source and binary forms, with or without
> +.\" modification, are permitted provided that the following conditions
> +.\" are met:
> +.\" 1. Redistributions of source code must retain the above copyright
> +.\"    notice, this list of conditions and the following disclaimer.
> +.\" 2. Redistributions in binary form must reproduce the above copyright
> +.\"    notice, this list of conditions and the following disclaimer in the
> +.\"    documentation and/or other materials provided with the distribution.
> +.\"
> +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
> +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
> +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
> +.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
> +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
> +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
> +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
> +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
> +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
> +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
> +.\" SUCH DAMAGE.
> +.\"
> +.\" $FreeBSD$
> +.\"
> +.Dd February 22, 2019
> +.Dt PROCCONTROL 1
> +.Os
> +.Sh NAME
> +.Nm proccontrol
> +.Nd Control some process execution aspects
> +.Sh SYNOPSIS
> +.Nm
> +.Fl m Ar mode
> +.Op Fl s Ar control
> +.Op Fl q
> +.Fl p Ar pid | command
> +.Sh DESCRIPTION
> +The
> +.Nm
> +command modifies the execution parameter of existing process
> +specified by the
> +.Ar pid
> +argument, or starts execution of the new program
> +.Ar command
> +with the execution parameter set for it.
> +.Pp
> +Which execution parameter is changed, selected by the mandatory
> +parameter
> +.Ar mode .
> +Possible values for
> +.Ar mode
> +are:
> +.Bl -tag -width trapcap
> +.It Ar aslr
> +Control the Address Space Layout Randomization.
> +Only applicable to the new process spawned.
> +.It Ar trace
> +Control the permission for debuggers to attach.
> +.It Ar trapcap
> +Controls the signalling of capability mode access violations.
> +.El
> +.Pp
> +The
> +Ar control
> +specifies if the selected
> +.Ar mode
> +should be enabled or disabled.
> +Possible values are
> +.Ar enable
> +and
> +.Ar disable ,
> +with the default value being
> +.Ar enable
> +if not specified.
> +See
> +.Xr procctl 2
> +for detailed description of each mode effects and interaction with other
> +process control facilities.
> +.Pp
> +The
> +.Op Fl q
> +switch makes the utility query and print the current setting for
> +the selected mode.
> +.Sh EXIT STATUS
> +.Ex -std
> +.Sh EXAMPLES
> +.Bl -bullet
> +.It
> +To disable debuggers attachment to the process 1020, execute
> +.Dl "proccontrol -m trace -s disable -p 1020"
> +.It
> +To execute the
> +.Xr uniq 1
> +program in a mode where capability access violations cause
> +.Dv SIGTRAP
> +delivery, do
> +.Dl "proccontrol -m trapcap uniq"
> +.It
> +To query the current ASLR enablement mode for the running
> +process 1020, do
> +.Dl "proccontrol -m aslr -q -p 1020"
> +.El
> +.Sh SEE ALSO
> +.Xr kill 2 ,
> +.Xr procctl 2 ,
> +.Xr ptrace 2
> +.Sh HISTORY
> +The
> +.Nm
> +command appeared in
> +.Fx 10.0 .
> +.Sh AUTHORS
> +The
> +.Nm
> +command and this manual page were written by
> +.An Konstantin Belousov Aq Mt kib at freebsd.org
> +under sponsorship from The FreeBSD Foundation.
> 
> 

-- 
Rod Grimes                                                 rgrimes at freebsd.org