Table of Contents

Name

sjtest -- test a sysjail for correctness

Synopsis

sjtest [-p path] [-s path] [-t test] file ...

Description

The sjtest utility tests a prison for proper operation. It's intended to be run either fully from within a jail (with the -t flag) or the host environment. When run without -t, sjtest executes a series of jails, each with a function to be tested. The system halts on the first instance of failure. When run with -t, one test fixture is executed.

This is a development utility and shouldn't be used lightly. If used incorrectly, this can hose your host environment.

-p path
Specify the full path of the sysjail(1) binary. If not specified, defaults to ./sysjail.

-s path
Specify the full path of the sjtest(1) binary. If not specified, defaults to ./sjtest.

-t test
Specify a test to run (within a prison). Test names correspond to the relevant system call (or group). This option should not be used in a non-jail context. See the sjtest.c source file for possible tests.

Return Values

The sjtest utility returns 0 on success or 1 on failure. Failure may leave the hosting system in an inconsistent state.

See Also

sysjail(1) , jail(1) , sysjail(3) , sjls(1) , jls(1)

Authors

The sjtest utility was written by Kristaps Dzonsons for the bsd.lv project.

Table of Contents