From f5f4e22e50450c7459800b4ca03894326df236b9 Mon Sep 17 00:00:00 2001 From: Stef Walter 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 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ srcx/Makefile.am | 4 ++-- 3 files changed, 72 insertions(+), 4 deletions(-) create mode 100644 src/jstart.8 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 diff --git a/srcx/Makefile.am b/srcx/Makefile.am index 3b9e121..3011de8 100644 --- a/srcx/Makefile.am +++ b/srcx/Makefile.am @@ -7,6 +7,6 @@ jails_SOURCES = jails.c util.h util.c jid_SOURCES = jid.c util.h util.c jps_SOURCES = jps.c util.h util.c -# man_MANS = jstart.8 jkill.8 jails.8 jid.8 jps.8 -# EXTRA_DIST = $(man_MANS) +man_MANS = jstart.8 jkill.8 jails.8 jid.8 jps.8 +EXTRA_DIST = $(man_MANS) -- cgit v1.2.3