lxc-restart(1)

1LXC-RESTART(1)                                                  LXC-RESTART(1)
2
3
4

NAME

6       lxc-restart - restart a container from a file (not implemented yet)
7

SYNOPSIS

9       lxc-restart  [-f config_file][-s KEY=VAL] --statefile=FILE --statefd=FD
10       --name=NAME
11

DESCRIPTION

13       lxc-restart is a command to restart an application from the state  read
14       in the specified FILE, in a container with the identifier NAME.  If the
15       option --pause is specified, the application will be stopped after  the
16       restart  just  before resuming execution. The command lxc-unfreeze will
17       be needed to resume its execution.
18

RESTART OPTIONS

20       -S, --statefile=FILE
21              read the state of the container in this FILE.   This  option  is
22              exclusive with --statefd below.
23
24       -d, --statefd=FD
25              read  the  state  of  the  container in this FD file descriptor.
26              This option is exclusive with above --statefile.
27
28       -p     Pause container processes after restart. The container  will  be
29              stopped until you resume it with the lxc-unfreeze command.
30
31       -f, --rcfile=config_file
32              Specify  the  configuration file to configure the virtualization
33              and isolation functionalities for the container. This  parameter
34              should  be  specified if it was specified for the lxc-execute or
35              lxc-start commands or if the container configuration has  to  be
36              changed  at restart. The latter may fail if the needed resources
37              are not available for the restart. If the container was  created
38              and  configured  with lxc-create, this option is not needed, the
39              configuration will be automatically found.
40
41       -s KEY=VAL
42              Assign value VAL to configuration variable KEY.  This  overrides
43              any assignment done in config_file.
44

COMMON OPTIONS

46       These options are common to most of lxc commands.
47
48       -?, -h, --help
49              Print a longer usage message than normal.
50
51       --usage
52              Give the usage message
53
54       -q, --quiet
55              mute on
56
57       -o, --logfile=FILE
58              Output to an alternate log FILE. The default is no log.
59
60       -l, --logpriority=LEVEL
61              Set  log  priority  to LEVEL. The default log priority is ERROR.
62              Possible values are : FATAL, CRIT, WARN,  ERROR,  NOTICE,  INFO,
63              DEBUG.
64
65              Note  that this option is setting the priority of the events log
66              in the alternate log file. It do not have effect  on  the  ERROR
67              events log on stderr.
68
69       -n, --name=NAME
70              Use  container identifier NAME.  The container identifier format
71              is an alphanumeric string.
72

EXAMPLES

74       To start a new container 123 computing decimals of pi
75
76             lxc-execute -n 123 -- pi1 -d 500000
77             lxc-execute --name=123 -- pi1 -d 500000
78
79
80
81       to checkpoint the same container in dump-death mode
82
83             lxc-checkpoint -n 123 -S /share/123/chkpt1 -k
84             lxc-checkpoint --name=123 --statefile=/share/123/chkpt1 -k
85
86
87
88       and to restart the same container with a different id
89
90             lxc-restart -n 200 -S /share/123/chkpt1
91             lxc-restart --name=200 --statefile=/share/123/chkpt1
92
93
94

NOTES

96       Actually, this command does  not  operate.  Its  description  helps  to
97       define a CLI api for future Checkpoint / Restart solution
98

AUTHOR

106       Daniel Lezcano <daniel.lezcano@free.fr>
107
108
109
110IBM                      Mon Jul 26 17:09:32 UTC 2010           LXC-RESTART(1)