summaryrefslogtreecommitdiff
path: root/srcx/jid.8
blob: 638dfaef25aefdc4b7c1b49ecf2c54f89779d67a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
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