lxc-restart(1)

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 \FC--pause\F[] 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

\FC-S, --statefile=\F[]FILE
    read the state of the container in this FILE. This option is exclusive with \FC--statefd\F[] below.

\FC-d, --statefd=\F[]FD
    read the state of the container in this FD file descriptor. This option is exclusive with above \FC--statefile\F[].

\FC-p\F[]
    Pause container processes after restart. The container will be stopped until you resume it with the lxc-unfreeze command.

\FC-f, --rcfile=\F[]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.

\FC-s \F[]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.

\FC-?, -h, --help\F[]
    Print a longer usage message than normal.

\FC--usage\F[]
    Give the usage message

\FC-q, --quiet\F[]
    mute on

\FC-P, --lxcpath=\F[]PATH
    Use an alternate container path. The default is /var/lib/lxc.

\FC-o, --logfile=\F[]FILE
    Output to an alternate log FILE. The default is no log.

\FC-l, --logpriority=\F[]LEVEL
    Set log priority to LEVEL. The default log priority is \FCERROR\F[]. Possible values are : \FCFATAL\F[], \FCCRIT\F[], \FCWARN\F[], \FCERROR\F[], \FCNOTICE\F[], \FCINFO\F[], \FCDEBUG\F[]. 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.

\FC-n, --name=\F[]NAME
    Use container identifier NAME. The container identifier format is an alphanumeric string.

EXAMPLES
To start a new container \FC123\F[] computing decimals of pi

\FC
      lxc-execute -n 123 -- pi1 -d 500000
      lxc-execute --name=123 -- pi1 -d 500000
    \F[]

to checkpoint the same container in dump-death mode

\FC
      lxc-checkpoint -n 123 -S /share/123/chkpt1 -k
      lxc-checkpoint --name=123 --statefile=/share/123/chkpt1 -k
    \F[]

and to restart the same container with a different id

\FC
      lxc-restart -n 200 -S /share/123/chkpt1
      lxc-restart --name=200 --statefile=/share/123/chkpt1
    \F[]

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 <\FCdaniel.lezcano@free.fr\F[]>