From 978f8d93006f17c4ca3089ef90d1dfeee7e20a3f Mon Sep 17 00:00:00 2001 From: Poul-Henning Kamp Date: Sun, 19 Sep 1999 08:36:03 +0000 Subject: Add a version number field to the jail(2) argument so that future changes can be handled intelligently. --- lib/libc/sys/jail.2 | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) (limited to 'lib/libc/sys') diff --git a/lib/libc/sys/jail.2 b/lib/libc/sys/jail.2 index 7ff8dce51fb7..00aae7e6803a 100644 --- a/lib/libc/sys/jail.2 +++ b/lib/libc/sys/jail.2 @@ -28,12 +28,16 @@ system call sets up a jail and locks the current process in it. The argument is a pointer to a structure describing the prison: .Bd -literal -offset indent struct jail { - char *path; - char *hostname; - u_int32_t ip_number; + u_int32_t version; + char *path; + char *hostname; + u_int32_t ip_number; }; .Ed .Pp +.Dq Li version +defines the version of the API in use. It should be set to zero at this time. +.Pp The .Dq Li path pointer should be set to the directory which is to be the root of the @@ -70,6 +74,13 @@ it will show a field near the end of the line, either as a single hyphen for a process at large, or the hostname currently set for the prison for jailed processes. .Sh ERRORS +.Fn jail +will fail if: +.Bl -tag -width EWOULDBLOCK +.It Bq Er EINVAL +The version number of the argument is not correct. +.El +Further .Fn Jail calls .Xr chroot 2 -- cgit v1.3