Version: 1.1.3

lcrash - manpage

NAME

lcrash - crash machines of a netkit lab

SYNOPSIS

lcrash [options] [MACHINE-NAME...]

DESCRIPTION

The lcrash command can be used to forcedly shutdown all the virtual machines of a Netkit lab. This roughly corresponds to suddenly unplugging them from the power socket. lcrash uses the vcrash command to stop virtual machines (see vcrash(1)).

If a list of MACHINE-NAMEs is provided, only virtual machines with a matching name and that are part of the lab will be crashed. Otherwise, all the machines of the lab are crashed.

The following options are supported by lcrash:

-d DIRECTORY

Crash the Netkit lab that is located inside DIRECTORY. If no -d option is provided, lcrash assumes that the lab is located in the current directory. The path to the lab directory (being that the current directory or one provided by -d) must never contain spaces.

-F
--keep-fs

This option prevents lcrash from deleting virtual machines (COW) filesystems (.disk files). By default, lcrash removes the filesystem after crashing each virtual machine in order to ensure that virtual machines revert to their original state when the lab is restarted.

Notice that the model filesystem is never removed, regardless of the use of this option. See the README file in the Netkit filesystem package for information about COW and model filesystems.

-k
--kill

There are two different ways of crashing a virtual machine. The first one is to send a special message that tells it to immediately shut down. This is also called the mconsole method. The second one is to simply kill running processes that correspond to the virtual machine.
The mconsole method is usually faster, but may be ineffective if a virtual machine has somewhy frozen (in which case it is unable to receive messages). If it happens to fail, the other method (killing processes) is automatically tried. However, killing processes is considered a last resort.
If the mconsole method fails too often, this option can be used to force lcrash to always kill processes. In general, there should be no need to use it.

-l
--list

Show a list of currently running virtual machines after the lab has been crashed. This is useful to check whether all the hosts have been shut down.

-q
--quick
--quiet

Do not check whether virtual machines have actually crashed. This results in a faster lab shutdown, but some hanging processes may be left behind. If this happens, try crashing the lab again without using this option or use vclean (see vclean(1)). This option also slightly reduces output information.

The following standard options are also supported.

-h
--help

Show usage information.

--version

Print information about the installed Netkit release and the host kernel version and exit. If ''<unavailable>'' is printed instead of a version number, then the corresponding information could not be retrieved (for example because a non-standard Netkit kernel or filesystem is being used).

ENVIRONMENT VARIABLES

All Netkit commands require that the NETKIT_HOME variable contains the name of the directory Netkit is installed in.

Apart from this, lcrash supports no other environment variables.

SEE ALSO

lstart(1), lclean(1), lhalt(1), lrestart(1), linfo(1), ltest(1), vclean(1), vcrash(1), Netkit filesystem README.

AUTHOR

lcrash script: Stefano Pettini, Massimo Rimondini
This man page: Fabio Ricci, Massimo Rimondini

REPORTING BUGS

Report bugs to the Github issues page: https://github.com/netkit-jh/netkit-jh-build/issues

Please follow the recommended templates when reporting bugs.