NAME¶
lxc-restart - restart a container from a file (not implemented yet)
SYNOPSIS¶
lxc-restart [-f config_file][-s KEY=VAL]
--statefile=FILE --statefd=FD
--name= NAME
DESCRIPTION¶
lxc-restart is a command to restart an application from the state read in
the specified
FILE, in a container with the identifier
NAME. If
the option
--pause is specified, the application will be stopped after
the restart just before resuming execution. The command
lxc-unfreeze
will be needed to resume its execution.
RESTART OPTIONS¶
- -S, --statefile=FILE
- read the state of the container in this FILE. This
option is exclusive with --statefd below.
- -d, --statefd=FD
- read the state of the container in this FD file
descriptor. This option is exclusive with above --statefile.
- -p
- Pause container processes after restart. The container will
be stopped until you resume it with the lxc-unfreeze command.
- -f, --rcfile=config_file
- Specify the configuration file to configure the
virtualization and isolation functionalities for the container. This
parameter should be specified if it was specified for the
lxc-execute or lxc-start commands or if the container
configuration has to be changed at restart. The latter may fail if the
needed resources are not available for the restart. If the container was
created and configured with lxc-create, this option is not needed,
the configuration will be automatically found.
- -s KEY=VAL
- Assign value VAL to configuration variable
KEY. This overrides any assignment done in config_file.
COMMON OPTIONS¶
These options are common to most of lxc commands.
- -?, -h, --help
- Print a longer usage message than normal.
- --usage
- Give the usage message
- -q, --quiet
- mute on
- -o, --logfile=FILE
- Output to an alternate log FILE. The default is no
log.
- -l, --logpriority=LEVEL
- Set log priority to LEVEL. The default log priority
is ERROR. Possible values are : FATAL, CRIT, WARN, ERROR, NOTICE, INFO,
DEBUG.
Note that this option is setting the priority of the events log in the
alternate log file. It do not have effect on the ERROR events log on
stderr.
- -n, --name=NAME
- Use container identifier NAME. The container
identifier format is an alphanumeric string.
EXAMPLES¶
To start a new container 123 computing decimals of pi
lxc-execute -n 123 -- pi1 -d 500000
lxc-execute --name=123 -- pi1 -d 500000
to checkpoint the same container in
dump-death mode
lxc-checkpoint -n 123 -S /share/123/chkpt1 -k
lxc-checkpoint --name=123 --statefile=/share/123/chkpt1 -k
and to restart the same container with a different id
lxc-restart -n 200 -S /share/123/chkpt1
lxc-restart --name=200 --statefile=/share/123/chkpt1
NOTES¶
Actually, this command does not operate. Its description helps to define a CLI
api for future Checkpoint / Restart solution
SEE ALSO¶
lxc(1),
lxc-create(1),
lxc-destroy(1),
lxc-start(1),
lxc-stop(1),
lxc-execute(1),
lxc-kill(1),
lxc-console(1),
lxc-monitor(1),
lxc-wait(1),
lxc-cgroup(1),
lxc-ls(1),
lxc-ps(1),
lxc-info(1),
lxc-freeze(1),
lxc-unfreeze(1),
lxc-attach(1),
lxc.conf(5)
AUTHOR¶
Daniel Lezcano <daniel.lezcano@free.fr>