1*c5a6f78aSpooka.\" $NetBSD: rump.halt.1,v 1.2 2010/12/12 17:15:16 pooka Exp $ 278e5870eSpooka.\" 378e5870eSpooka.\" Copyright (c) 1990, 1991, 1993 478e5870eSpooka.\" The Regents of the University of California. All rights reserved. 578e5870eSpooka.\" 678e5870eSpooka.\" Redistribution and use in source and binary forms, with or without 778e5870eSpooka.\" modification, are permitted provided that the following conditions 878e5870eSpooka.\" are met: 978e5870eSpooka.\" 1. Redistributions of source code must retain the above copyright 1078e5870eSpooka.\" notice, this list of conditions and the following disclaimer. 1178e5870eSpooka.\" 2. Redistributions in binary form must reproduce the above copyright 1278e5870eSpooka.\" notice, this list of conditions and the following disclaimer in the 1378e5870eSpooka.\" documentation and/or other materials provided with the distribution. 1478e5870eSpooka.\" 3. Neither the name of the University nor the names of its contributors 1578e5870eSpooka.\" may be used to endorse or promote products derived from this software 1678e5870eSpooka.\" without specific prior written permission. 1778e5870eSpooka.\" 1878e5870eSpooka.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 1978e5870eSpooka.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 2078e5870eSpooka.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 2178e5870eSpooka.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 2278e5870eSpooka.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 2378e5870eSpooka.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 2478e5870eSpooka.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 2578e5870eSpooka.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 2678e5870eSpooka.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 2778e5870eSpooka.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 2878e5870eSpooka.\" SUCH DAMAGE. 2978e5870eSpooka.\" 3078e5870eSpooka.\" @(#)reboot.8 8.1 (Berkeley) 6/9/93 3178e5870eSpooka.\" 3278e5870eSpooka.Dd December 12, 2010 3378e5870eSpooka.Dt RUMP.HALT 1 3478e5870eSpooka.Os 3578e5870eSpooka.Sh NAME 3678e5870eSpooka.Nm rump.halt 3778e5870eSpooka.Nd halt a rump kernel 3878e5870eSpooka.Sh SYNOPSIS 3978e5870eSpooka.Nm 4078e5870eSpooka.Op Fl dhn 4178e5870eSpooka.Sh DESCRIPTION 4278e5870eSpookaThe 4378e5870eSpooka.Nm 4478e5870eSpookautility exits a rump kernel. 4578e5870eSpookaThe file system cache, if present, is flushed. 4678e5870eSpookaSince a rump kernel does not control its clients, they are not 4778e5870eSpookadirectly affected by 4878e5870eSpooka.Nm . 4978e5870eSpookaHowever, they will be unable to request further services from the 5078e5870eSpookahalted rump kernel. 5178e5870eSpooka.Pp 5278e5870eSpookaThe options are as follows: 5378e5870eSpooka.Bl -tag -width Ds 5478e5870eSpooka.It Fl d 5578e5870eSpookaCreate a core dump. 5678e5870eSpookaThe core file is saved according to standard userland program 5778e5870eSpookacoredump rules, and can be later examined with a debugger. 5878e5870eSpooka.It Fl h 5978e5870eSpookaBy default the process hosting the rump kernel exits. 6078e5870eSpookaUsing this option shuts down rump kernel activity, but does not 6178e5870eSpookacause the hosting process to exit. 6278e5870eSpooka.It Fl n 6378e5870eSpookaDo not flush the file system cache. 6478e5870eSpookaThis option should be used with extreme caution. 6578e5870eSpookaIt can be used if a virtual disk or a virtual processor is virtually on fire. 6678e5870eSpooka.El 6778e5870eSpooka.Sh SEE ALSO 6878e5870eSpooka.Xr rump 3 6978e5870eSpooka.Sh HISTORY 7078e5870eSpookaThe 7178e5870eSpooka.Nm 7278e5870eSpookacommand appeared in 7378e5870eSpooka.Nx 6.0 . 74*c5a6f78aSpooka.Sh CAVEATS 75*c5a6f78aSpookaWhile using 76*c5a6f78aSpooka.Fl h 77*c5a6f78aSpookamakes it impossible to issue further system calls, it does not necessarily 78*c5a6f78aSpookastop all activity in a rump kernel. 79*c5a6f78aSpookaIt is recommended this option is used only for debugging purposes. 80