From f5f4e22e50450c7459800b4ca03894326df236b9 Mon Sep 17 00:00:00 2001
From: Stef Walter <stef@memberwebs.com>
Date: Tue, 18 May 2004 19:09:12 +0000
Subject: - Integrated old jstart into the build - Added manual pages to the
 build

---
 src/Makefile.am |  6 ++++--
 src/jstart.8    | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 70 insertions(+), 2 deletions(-)
 create mode 100644 src/jstart.8

(limited to 'src')

diff --git a/src/Makefile.am b/src/Makefile.am
index 8dc8d62..37d1359 100644
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -1,8 +1,10 @@
-sbin_PROGRAMS = killjail jails
+sbin_PROGRAMS = killjail jails jstart
 killjail_SOURCES = killjail.c getjail.c getjail.h
 killjail_LDADD = -lkvm
 jails_SOURCES = jails.c getjail.c getjail.h
 jails_LDADD = -lkvm
-man_MANS = killjail.8 jails.8
+jstart_SOURCES = jstart.c
+jstart_LDADD = -lkvm
+man_MANS = killjail.8 jails.8 jstart.8
 EXTRA_DIST = $(man_MANS)
 
diff --git a/src/jstart.8 b/src/jstart.8
new file mode 100644
index 0000000..b589d27
--- /dev/null
+++ b/src/jstart.8
@@ -0,0 +1,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
-- 
cgit v1.2.3