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

NAME

6       lxc-checkpoint - checkpoint a running container (not implemented yet)
7

SYNOPSIS

9       lxc-checkpoint --statefile=FILE --statefd=FD --name=NAME  [ -k|-p ]
10

DESCRIPTION

12       lxc-checkpoint  is a command to checkpoint the specified container NAME
13       and dumps its state into the file FILE. If the option --kill is  speci‐
14       fied, the application running in the container will terminate after the
15       checkpoint just before resuming its execution. If the option --pause is
16       specified,  the  application  will be stopped after the checkpoint just
17       before resuming execution. The command  lxc-unfreeze  will  resume  its
18       execution.
19

CHECKPOINT OPTIONS

21       -S, --statefile=FILE
22              write  the  state of the container in this FILE.  This option is
23              exclusive with --statefd below.
24
25       -d, --statefd=FD
26              write the state of the container in  this  FD  file  descriptor.
27              This option is exclusive with above --statefile.
28
29       -k,--kill
30              Kill  container  processes  after  checkpoint. the processes are
31              sent a SIGKILL signal.
32
33              This option is mutually exclusive  with  the  following  --pause
34              option.
35
36       -p,--pause
37              Pause  container  processes after checkpoint. The container will
38              be stopped until you resume it. This option is  mutually  exclu‐
39              sive with previously mentionned --kill option.
40

COMMON OPTIONS

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

EXAMPLES

70       To start a new container 123 computing decimals of pi
71
72             lxc-execute -n 123 -- pi1 -d 500000
73             lxc-execute --name=123 -- pi1 -d 500000
74
75
76
77       to checkpoint the same container in dump-death mode
78
79             lxc-checkpoint -n 123 -S /share/123/chkpt1 -k
80             lxc-checkpoint --name=123 -S /share/123/chkpt1 -k
81
82
83
84       to checkpoint the same container and pause it
85
86             lxc-checkpoint -n 123 -S /share/123/chkpt1 -p
87             lxc-checkpoint --name=123 -S /share/123/chkpt1 -p
88
89
90

NOTES

92       Actually, this command does  not  operate.  Its  description  helps  to
93       define a CLI api for future Checkpoint / Restart solution
94

SEE ALSO

96       lxc(1),  lxc-create(1), lxc-destroy(1), lxc-start(1), lxc-stop(1), lxc-
97       execute(1), lxc-kill(1), lxc-console(1),  lxc-monitor(1),  lxc-wait(1),
98       lxc-cgroup(1),  lxc-ls(1),  lxc-ps(1), lxc-info(1), lxc-freeze(1), lxc-
99       unfreeze(1), lxc.conf(5)
100

AUTHOR

102       Daniel Lezcano <daniel.lezcano@free.fr>
103
104
105
106IBM                      Mon Jul 26 17:09:32 UTC 2010        LXC-CHECKPOINT(1)
Impressum