summaryrefslogtreecommitdiff
path: root/srcx/jid.8
diff options
context:
space:
mode:
Diffstat (limited to 'srcx/jid.8')
-rw-r--r--srcx/jid.844
1 files changed, 44 insertions, 0 deletions
diff --git a/srcx/jid.8 b/srcx/jid.8
new file mode 100644
index 0000000..638dfae
--- /dev/null
+++ b/srcx/jid.8
@@ -0,0 +1,44 @@
+.\" Process this file with
+.\" groff -mdoc -Tascii jid.8
+.\"
+.Dd April, 2004
+.Dt jid 8
+.Os jid
+.Sh NAME
+.Nm jid
+.Nd translates jail host names to jail ids and vice versa
+.Sh SYNOPSIS
+.Nm
+.Ar hostname
+.Nm
+.Ar jail-id
+.Sh DESCRIPTION
+.Nm
+translates jail host names to jail ids and vice versa for running jails. When
+called with an integer number as it's argument,
+.Nm
+assumes that it's a jail id and converts it to a host name. When called with
+any other text,
+.Nm
+uses it as a host name and tries to resolve it to a jail id.
+.Sh NOTES
+Jail ids are an integer assigned when a jail starts up. Use
+.Xr jail 8
+or
+.Xr jstart 8
+with a
+.Fl i
+argument to print the jail id for a running jail.
+.Xr jls 8
+will also print jail ids for all jails running on the system.
+.Pp
+It is possible to run two jails with the same host name.
+.Nm
+however always only prints out one jail id for a given jail host name.
+.Sh SEE ALSO
+.Xr jail 2 ,
+.Xr jail 8 ,
+.Xr jls 8 ,
+.Xr jstart 8
+.Sh AUTHOR
+.An Nate Nielsen Aq nielsen@memberwebs.com