From 8bd6fc0a98539e50d96fe4b499be40c06ca63f5e Mon Sep 17 00:00:00 2001 From: anonymous Date: Fri, 27 Jun 2003 22:56:31 +0000 Subject: Initial revision --- doc/injail_man.html | 46 ++++++++++++++++++++++ doc/jailer_man.html | 109 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 155 insertions(+) create mode 100755 doc/injail_man.html create mode 100755 doc/jailer_man.html (limited to 'doc') diff --git a/doc/injail_man.html b/doc/injail_man.html new file mode 100755 index 0000000..6854e73 --- /dev/null +++ b/doc/injail_man.html @@ -0,0 +1,46 @@ + + +
+
+
+
+
+

DESCRIPTION

+     The injail utility returns a result which indicates the jailed status of
+     the current process environment.
+
+
+
+

DIAGNOSTICS

+     The injail utility exits with one of the following values:
+     0       the process is running in a jail.
+     1       the process is not running in a jail.
+     2       an error prevented determining if the process is running in a
+             jail.
+
+
+
+

BUGS

+     injail uses kvm_getprocs(3) to determine process status. Anything which
+     could cause a failure in either kvm_open(3) or kvm_getprocs(3) can cause
+     this to fail as well. There aught to be a cleaner way.
+
+
+
+

AUTHOR

+      James E. Quick <jq@quick.com>
+
+
+
+

SEE ALSO

+     jailer(8), jail(8), kvm(3)
+
+FreeBSD 4.6                      May 28, 2002                      FreeBSD 4.6
+
+
+
+Man(1) output converted with +man2html +
+ + diff --git a/doc/jailer_man.html b/doc/jailer_man.html new file mode 100755 index 0000000..229d297 --- /dev/null +++ b/doc/jailer_man.html @@ -0,0 +1,109 @@ + + +
+
+
+
+

SYNOPSIS

+       jailer [ console-file ]
+
+
+
+

DESCRIPTION

+       jailer  manages  the  startup  and shutdown of a jail from
+       within the jail. It also  manages  the  jails  console  by
+       linking /dev/console inside the jail to a log file.
+
+       To use, replace the '/bin/sh /etc/rc' portion of your jail
+       startup command with jailer. For example instead of:
+
+        jail /jails/myjail host 10.0.1.1 /bin/sh /etc/rc
+
+       use:
+
+        jail /jails/myjail host 10.0.1.1 /usr/local/sbin/jailer
+
+
+       jailer will start the jail by  running  /etc/rc  and  then
+       remain  running  as  a  daemon inside the jail waiting for
+       signals to perform shutdown or restarts.
+
+       A shutdown is performed by first running /etc/rc.shutdown,
+       and  then  killing  all  the  processes  still  running. A
+       restart is a combination of the above.
+
+
+       The following signals have special meaning to the jailer:
+
+       HUP    Causes jailer to restart the jail. If the  jail  is
+              not running at the time it is simply started.
+
+       QUIT   Initiates  a jail shutdown.  jailer remains running
+              after processing the request.
+
+       TERM   Same as QUIT but also quits jailer.  No  more  pro-
+              cesses will be left running inside the jail.
+
+
+
+
+

JAIL CONSOLE MANAGEMENT

+       A  normal  jail  has  no console perse, and dmesg(8) reads
+       straight from the  host  kernel  message  buffer.   jailer
+       changes this to provide a virtual console for the jail.
+
+       On  jailer startup the file /var/log/console is created or
+       truncated.  /dev/console is then hard linked to  the  con-
+       sole file.
+
+       Along  with  the  jailer  distribution  you'll  find a new
+       dmesg(8) which  just  reads  from  /dev/console.   Replace
+       /sbin/dmesg(8) with this new executable and you're set.
+
+
+
+
+

OPTIONS

+       console-file
+              Overrides the default location of the  console  log
+              file, usually /var/log/console
+
+
+
+
+

FILES

+       /var/log/console
+              Virtual console file.
+
+
+
+
+

BUGS

+       Virtual  jail  consoles  don't  work with FreeBSD 5.0 yet.
+       This is due to devfs(8)
+
+       shutdown(8) doesn't work with the halt and reboot scripts.
+
+
+
+
+

AUTHOR

+       Nate Nielsen <nielsen@memberwebs.com>
+
+
+
+
+

SEE ALSO

+       jail(8), halt(8), reboot(8), dmesg(8)
+
+
+
+Version 1.2                  May 2002                   JAILER(8)
+
+
+
+Man(1) output converted with +man2html +
+ + -- cgit v1.2.3