summaryrefslogtreecommitdiff
path: root/src/jstart.8
blob: b589d27769aa8db67cba9b042dafcbc9c555caf8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
.\" Process this file with 
.\" groff -mdoc -Tascii jstart.8
.\"
.Dd April, 2004
.Dt jstart 8
.Os jstart 
.Sh NAME
.Nm jstart
.Nd start a jail
.Sh SYNOPSIS
.Nm
.Ar path
.Ar hostname
.Ar ip-number
.Op Ar command ...
.Sh DESCRIPTION
The 
.Nm 
utility starts a jail. It is a more secure replacement for the
.Xr jail 8
command. See the 
.Xr jail 8 
man page for details on how to setup a jail, and jail concepts. 
.Pp
.Nm
purges down the environment before running the command inside the
jail in order to prevent information leakage into the jail. If this
is not desired, then use the 
.Xr jail 8
command.
.Sh OPTIONS
.Bl -tag -width ".Fl u Ar ip-number"
.It Ar path
Directory which is to be the root of the jail.
.It Ar hostname
Hostname of the prison.
.It Ar ip-number
IP number assigned to the prison.
.It Ar command
Optional command to be executed inside the jail. When not specified
this defaults to
.Pa "/bin/sh /etc/rc"
.El
.Sh NOTES
.Nm 
always runs as root, and runs 
.Em command
as root. If this is not desired, use 
.Xr jail 8 
with the
.Fl u 
option.
.Pp
The command called must be owned by root in order to be executed.
.Pp
The environment is purged properly before running the scripts in the 
jail in order to prevent unwanted information from leaking into the
jail.
.Sh FILES
.Pa /etc/rc
.Sh SEE ALSO
.Xr jail 2 ,
.Xr jail 8 ,
.Xr jails 8 
.Sh AUTHOR
.An Nate Nielsen Aq nielsen@memberwebs.com