| jexec.8 (179415) | jexec.8 (185435) |
|---|---|
| 1.\" 2.\" Copyright (c) 2003 Mike Barcroft <mike@FreeBSD.org> 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 9 unchanged lines hidden (view full) --- 18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" SUCH DAMAGE. 25.\" | 1.\" 2.\" Copyright (c) 2003 Mike Barcroft <mike@FreeBSD.org> 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 9 unchanged lines hidden (view full) --- 18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" SUCH DAMAGE. 25.\" |
| 26.\" $FreeBSD: head/usr.sbin/jexec/jexec.8 179415 2008-05-29 17:00:01Z mr $ | 26.\" $FreeBSD: head/usr.sbin/jexec/jexec.8 185435 2008-11-29 14:32:14Z bz $ |
| 27.\" | 27.\" |
| 28.Dd May 26, 2008 | 28.Dd November 29, 2008 |
| 29.Dt JEXEC 8 30.Os 31.Sh NAME 32.Nm jexec 33.Nd "execute a command inside an existing jail" 34.Sh SYNOPSIS 35.Nm 36.Op Fl u Ar username | Fl U Ar username | 29.Dt JEXEC 8 30.Os 31.Sh NAME 32.Nm jexec 33.Nd "execute a command inside an existing jail" 34.Sh SYNOPSIS 35.Nm 36.Op Fl u Ar username | Fl U Ar username |
| 37.Op Fl h Ar hostname | Fl h Ar ip-number | Ar jid 38.Ar command ... | 37.Op Fl n Ar jailname 38.Ar jid command ... |
| 39.Sh DESCRIPTION 40The 41.Nm 42utility executes 43.Ar command | 39.Sh DESCRIPTION 40The 41.Nm 42utility executes 43.Ar command |
| 44inside the jail identified by 45.Ar hostname | 44inside the jail identified by either 45.Ar jailname |
| 46or | 46or |
| 47.Ar ip-number 48or 49.Ar jid . | 47.Ar jid 48or both. |
| 50.Pp | 49.Pp |
| 50If the jail cannot be identified uniquely by the given parameters, 51an error message is printed. 52.Nm 53will also check the state of the jail (once supported) to be 54.Dv ALIVE 55and ignore jails in other states. 56The mandatory argument 57.Ar jid 58is the unique jail identifier as given by 59.Xr jls 8 . 60In case you only want to match on other criteria, give an empty string. 61.Pp |
|
| 51The following options are available: 52.Bl -tag -width indent | 62The following options are available: 63.Bl -tag -width indent |
| 64.It Fl n Ar jailname 65The name of the jail, if given upon creation of the jail. 66This is not the hostname of the jail. |
|
| 53.It Fl u Ar username 54The user name from host environment as whom the 55.Ar command 56should run. 57.It Fl U Ar username 58The user name from jailed environment as whom the 59.Ar command 60should run. 61.El | 67.It Fl u Ar username 68The user name from host environment as whom the 69.Ar command 70should run. 71.It Fl U Ar username 72The user name from jailed environment as whom the 73.Ar command 74should run. 75.El |
| 62.Sh "CAUTIONS" 63Only jid is guaranteed to uniquely identify a jail. 64Hostname or ip-number only work here if matched to one unique jail. | |
| 65.Sh SEE ALSO 66.Xr jail_attach 2 , 67.Xr jail 8 , 68.Xr jls 8 69.Sh HISTORY 70The 71.Nm 72utility was added in 73.Fx 5.1 . | 76.Sh SEE ALSO 77.Xr jail_attach 2 , 78.Xr jail 8 , 79.Xr jls 8 80.Sh HISTORY 81The 82.Nm 83utility was added in 84.Fx 5.1 . |
| 85.Sh BUGS 86If the jail is not identified by 87.Ar jid 88there is a possible race in between the lookup of the jail 89and executing the command inside the jail. 90Giving a 91.Ar jid 92has a similar race as another process can stop the jail and 93start another one after the user looked up the 94.Ar jid . |
|