Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
QUICKJAIL(1)		FreeBSD	General	Commands Manual		  QUICKJAIL(1)

NAME
     quickjail,	quickshell -- Utility to spawn transient single-command	jails

SYNOPSIS
     quickjail [-c] [param=value ...] command=command ...
     quickshell	[-s] path

DESCRIPTION
     The quickjail command is used to create transient single-command jails in
     a reasonably secure manner.

     The key advantage to quickjail over jail(8) is the	model that quickjail
     uses to execute command.  quickjail will fork and execute command in a
     non-persistent jail, while	jail(8)	will mark the jail as persistent and
     remove the	jail when the child process is gone.  For some use-cases, this
     behavior is not ideal as it may potentially leave the jail	behind depend-
     ing on how	the child command exits.

     If	a path param is	specified to quickjail,	then quickjail will chdir(2)
     to	this path before creating the jail with	the same path.

     An	optional flag, -c, is allowed if specified before any other parame-
     ters.  The	-c flag	is otherwise ignored.  This allows quickjail to	main-
     tain an interface compatible with jail(8) for the purposes	of other
     tools, like bectl(8).

     The quickshell command is a simplified interface to quickjail specifi-
     cally for running a shell in the alien path.  It defaults to sh(1), but
     that may be overridden by the QUICKSHELL environment variable.

     If	the -s argument	is supplied to quickshell, then	it will	use the	SHELL
     environment variable instead of QUICKSHELL.

     quickshell	explicitly does	not use	the user's current shell because it is
     assumed that the path we are creating a jail at does not have the user's
     current shell.  This is the common	case for the author of quickshell.

EXAMPLES
     quickjail path=/mnt command=/bin/sh

     quickjail name=qemu0 path=/mnt command=/bin/sh

     quickshell	/mnt

SEE ALSO
     jail(8)

HISTORY
     quickjail was a quick-and-dirty hack to facilitate	the author's testing
     of	qemu usermode emulation.

AUTHORS
     quickjail was written by Kyle Evans <kevans@FreeBSD.org>.

FreeBSD	13.0			 May 25, 2020			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=quickjail&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help