From 6a2f098e72e71437154ec00506e8e736aa8e1026 Mon Sep 17 00:00:00 2001 From: Soccera1 <129828376+Soccera1@users.noreply.github.com> Date: Tue, 28 Jul 2026 15:54:54 +1000 Subject: Add docs --- man/runcon.1 | 87 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100644 man/runcon.1 (limited to 'man/runcon.1') diff --git a/man/runcon.1 b/man/runcon.1 new file mode 100644 index 0000000..6058bcd --- /dev/null +++ b/man/runcon.1 @@ -0,0 +1,87 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH RUNCON "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +runcon \- run command with specified security context +.SH SYNOPSIS +.B runcon +[\fI\,CONTEXT COMMAND \/\fR[\fI\,ARG\/\fR]...] +.br +.B runcon +[\fI\,-c\/\fR] [\fI\,-u USER\/\fR] [\fI\,-r ROLE\/\fR] [\fI\,-t TYPE\/\fR] [\fI\,-l RANGE\/\fR] \fI\,COMMAND \/\fR[\fI\,ARG\/\fR]... +.SH DESCRIPTION +.\" This page is derived from GNU Coreutils documentation. +This page documents BNU, an independent Bun implementation compatible with +GNU Coreutils 9.11. +Run COMMAND with completely-specified CONTEXT, or with current or +transitioned security context modified by one or more of LEVEL, +ROLE, TYPE, and USER. +.PP +If none of \fI-c\fR, \fI-t\fR, \fI-u\fR, \fI-r\fR, or \fI-l\fR, is specified, +the first argument is used as the complete context. Any additional +arguments after \fICOMMAND\fR are interpreted as arguments to the +command. +.PP +Only carefully-chosen contexts are likely to run successfully. +.PP +Run a program in a different SELinux security context. +With neither CONTEXT nor COMMAND, print the current security context. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +CONTEXT +Complete security context +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#runcon-c'\fB\-c, \-\-compute\fP\X'tty: link' +compute process transition context before modifying +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#runcon-t'\fB\-t, \-\-type=\,TYPE\fP\X'tty: link'\/\fR +type (for same role as parent) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#runcon-u'\fB\-u, \-\-user=\,USER\fP\X'tty: link'\/\fR +user identity +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#runcon-r'\fB\-r, \-\-role=\,ROLE\fP\X'tty: link'\/\fR +role +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#runcon-l'\fB\-l, \-\-range=\,RANGE\fP\X'tty: link'\/\fR +levelrange +.TP +\X'tty: link https://www.gnu.org/software/coreutils/runcon#runcon--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/runcon#runcon--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.SS "Exit status:" +.TP +125 +if the runcon command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +\- +the exit status of COMMAND otherwise +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Russell Coker. +.br +Adapted for BNU; the BNU implementation is independent. +.SH "REPORTING BUGS" +Report BNU bugs at . +.br +For upstream GNU Coreutils, see . +.SH COPYRIGHT +Copyright \(co 2026 Free Software Foundation, Inc. +.br +This manual page was adapted for BNU in 2026. +License GPLv3+: GNU GPL version 3 or later . +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Upstream documentation +.br +BNU documentation is available locally via: info \(aq(bnu) runcon invocation\(aq -- cgit v1.3