xref: /freebsd/usr.sbin/jail/jail.8 (revision c807777a43ef2b59786fa8a1a35c1f154fd069e5)
1.\"
2.\"----------------------------------------------------------------------------
3.\""THE BEER-WARE LICENSE" (Revision 42):
4.\"<phk@FreeBSD.ORG> wrote this file.  As long as you retain this notice you
5.\"can do whatever you want with this stuff. If we meet some day, and you think
6.\"this stuff is worth it, you can buy me a beer in return.   Poul-Henning Kamp
7.\"----------------------------------------------------------------------------
8.\"
9.\"$FreeBSD$
10.\"
11.Dd April 28, 1999
12.Dt JAIL 8
13.Os FreeBSD 4.0
14.Sh NAME
15.Nm jail
16.Nd imprison process and its descendants
17.Sh SYNOPSIS
18.Nm jail
19.Ar path
20.Ar hostname
21.Ar ip-number
22.Ar command
23.Ar ...
24.Sh DESCRIPTION
25The
26.Nm
27command imprisons a process and all future decendants.
28.Pp
29Please see the
30.Xr jail 2
31man page for further details.
32.Sh EXAMPLES
33This shows how to setup a jail directory tree:
34.Bd -literal
35D=/here/is/the/jail
36cd /usr/src
37make hierarchy DESTDIR=$D
38make obj
39make all
40make install DESTDIR=$D
41cd etc
42make distribution DESTDIR=$D
43cd $D/dev
44sh MAKEDEV jail
45cd $D
46ln -sf dev/null kernel
47.Ed
48.Sh SEE ALSO
49.Xr chroot 2 ,
50.Xr jail 2
51.Sh HISTORY
52The
53.Fn jail
54function call appeared in
55.Fx 4.0 .
56.Sh AUTHORS
57The jail feature was written by Poul-Henning Kamp for
58R&D Associates
59.Dq Li http://www.rndassociates.com/
60who contributed it to FreeBSD.
61