Difference between revisions of "Memory dumping and restoring"

From CRIU
Jump to navigation Jump to search
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== How it works now ==
+
This article describes how CRIU dumps and restores processes' memory. For memory image file formats, see [[memory dumps]].
 +
 
 +
== Basic C/R ==
  
 
=== Dumping ===
 
=== Dumping ===
Line 7: Line 9:
 
* /proc/pid/smaps file and /proc/pid/map_files/ directory with links are used to determine
 
* /proc/pid/smaps file and /proc/pid/map_files/ directory with links are used to determine
 
** memory areas in use by task
 
** memory areas in use by task
** file is mapped (if any)
+
** mapped files (if any)
 
** shared memory "identifier" to resolve the MAP_SHARED areas
 
** shared memory "identifier" to resolve the MAP_SHARED areas
 
* /proc/pid/pagemap file that reveals important flags
 
* /proc/pid/pagemap file that reveals important flags
Line 13: Line 15:
 
** ''anonymoys'' for the MAP_FILE | MAP_PRIVATE mapping indicate that the page in question is already COW-ed from the file's. Not-anonymous pages are not dumped as they are still in sync with the file
 
** ''anonymoys'' for the MAP_FILE | MAP_PRIVATE mapping indicate that the page in question is already COW-ed from the file's. Not-anonymous pages are not dumped as they are still in sync with the file
 
** ''soft-dirty'' bit is used by [[memory changes tracking]]
 
** ''soft-dirty'' bit is used by [[memory changes tracking]]
* Ptrace SEIZE that is used to grab pages from task's VM into pipe (with vmsplice)
+
* Ptrace SEIZE, used to grab pages from task's VM into a pipe (with vmsplice)
  
The latter step deserves some better explanation. So in order to drain memory from task we first generate the bitmap of pages needed to be dumped (using the smaps, map_files and pagemap from proc). Then we create a set of pipe-s to put pages into. Then we infect the process with [[parasite code]] which, in turn, gets the pipes and <code>vmsplice</code>-s the required pages into it. Then we <code>splice</code> the pages from pipes into image files.
+
The last step deserves a more detailed explanation. In order to drain memory from a task, we first generate the bitmap of pages needed to be dumped (using the smaps, map_files and [[pagemap cache]] filled from proc). Next, we create a set of pipes to put pages into. Then we infect the process with [[parasite code]], which, in turn, gets the pipes and <code>vmsplice</code>s the required pages into it. Finally, we <code>splice</code> the pages from pipes into [[memory dumps|image files]].
  
 
=== Restoring ===
 
=== Restoring ===
  
This one depends only on the /proc/pid/map_files/ to restore the shmem regions -- tasks just open some other's link and map it to create shmem region. The pages restoration just writes page data "in place".
+
Restoring is pretty straightforward. During restore, CRIU morphs itself into a target task. Two things worth mentioning before diving into explanation of steps.
 +
 
 +
;[[COW]]
 +
:Anonymous private mappings might have pages shared between tasks till they get COW-ed. To restore this CRIU pre-restores those pages before forking the child processes and <code>mremap</code>-s them in the [[restorer context|final stage]].
 +
 
 +
;[[Shared memory]]
 +
:Those areas are implemented in the kernel by supporting a pseudo file on a hidden tmpfs mount. So on restore we just determine who will create the shared are and who will attach to it (see the [[postulates]]). Then the creator <code>mmap</code>-s the region and the others open the /proc/pid/map_files/ link. However, on the recent kernels, we use the new <code>memfd</code> system call that does similar thing but works for user namespaces. Briefly -- creator creates the memfd, all the others get one via /proc/pid/fd link which is not that strict as compared to the map_files.
 +
 
 +
Having said that, the restore of memory is done in the following steps:
 +
 
 +
; Open images and read in VMAs
 +
: Open all the mm.img, read mappings in, resolve shared memory segments and check whether we need to special-care mapped files.
 +
 
 +
; Fork and pre-mmap
 +
: Each task pre-mmaps private anonymous areas and populates them with pages (from pagemap/pages images). Then task forks the child which does the same. It is done in such way in order to make COWed areas actually share the pages they should. On fork() the shared pages become actually shared, as currently this is the only way to make Linux kernel do this.
 +
 
 +
; Open file mappings
 +
: Soon after fork we check which VMA-s are MAP_FILE ones and request the [[files]] engine to open them.
 +
 
 +
; Open shared mappings
 +
: At almost the same place we create an FD for shared anonymous VMA-s.
 +
 
 +
; Dive into [[restorer context]]
 +
: At this stage we strip off all the old CRIU mappings thus making the VM be ready for restored mappings.
 +
 
 +
; Restore mappings in their places
 +
: Anonymous private mappings are <code>mremap</code>-ed from the pre-mapped areas one-by-one, file mappings are created with <code>mmap</code> system call. Anonymous shared mappings are also just mmaped.
  
 
=== Non linear mappings ===
 
=== Non linear mappings ===
  
Currently we don't support non-linear mappings (fail dump if present)
+
Currently we don't support non-linear mappings (so dump fails if such mappings are found).
 +
 
 +
== Advanced C/R ==
 +
 
 +
For things as remote dump, stackable images, and incremental dumps, CRIU supports a more sophisticated memory C/R policies rather than "dump all -- restore all" one. There are several CLI knobs that can be used.
 +
 
 +
* dump action
 +
* pre-dump action
 +
* --track-mem option
 +
** --prev-images-dir option
 +
* --leave-running option
 +
* --page-server option
 +
 
 +
Let's see what all of this means.
 +
 
 +
First of all, the pre-dump action always turns on the <code>--track-mem</code> and the <code>--leave-running</code> options even if they are not specified in the command line. Next, the pre-dump action dumps ''only'' the memory, while the dump one dumps all the state including open files, sockets and other stuff. Having said that, let's see all the possible combinations and what they result in.
 +
 
 +
;dump
 +
:Without any options, dump everything and kill the dumped tasks.
 +
 
 +
;dump --track-mem
 +
:Dump everything, turn on memory changes tracking, and kill tasks after this. As you might have noticed, this is pretty useless combination of options!
 +
 
 +
;dump --leave-running
 +
:Dump everything, and leave the tasks running after dump.
 +
 
 +
;dump --track-mem --leave-running
 +
:Same as above, but turn on memory changes tracking.
 +
 
 +
;dump --track-mem --leave-running --prev-images-dir <path>
 +
:Same as above, but during dump also check whether the page in question is present in parent, and skip dumping it this time.
 +
 
 +
;pre-dump
 +
:Only dump memory, turn on memory changes tracking and leave the tasks running.
 +
 
 +
;pre-dump --prev-images-dir <path>
 +
:Same as above, but check for pages present in parent and skip them.
 +
 
 +
;<pre->dump <options> --page-server
 +
:Send the pages to the page server (e.g. for [[disk-less migration]]). See [[page server]] for more details.
 +
 
 +
== Messing with image files ==
 +
 
 +
[[File:Criu-memory-wflow.png]]
 +
 
 +
== See also ==
 +
 
 +
* [[Memory changes tracking]]
 +
* [[Parasite code]]
 +
* [[Memory dumps]]
 +
* [[COW]]
 +
* [[Shared memory]]
 +
* [[Postulates]]
 +
* [[Disk-less migration]]
 +
* [[Page server]]
  
 
[[Category:Under the hood]]
 
[[Category:Under the hood]]
 +
[[Category:Memory]]
 +
[[Category:Live migration]]
 +
[[Category:Editor help needed]]

Latest revision as of 17:07, 5 February 2019

This article describes how CRIU dumps and restores processes' memory. For memory image file formats, see memory dumps.

Basic C/R[edit]

Dumping[edit]

Currently memory dumping depends on 3 big technologies:

  • /proc/pid/smaps file and /proc/pid/map_files/ directory with links are used to determine
    • memory areas in use by task
    • mapped files (if any)
    • shared memory "identifier" to resolve the MAP_SHARED areas
  • /proc/pid/pagemap file that reveals important flags
    • present indicates that the physical page is there. Non-present pages are not dumped.
    • anonymoys for the MAP_FILE | MAP_PRIVATE mapping indicate that the page in question is already COW-ed from the file's. Not-anonymous pages are not dumped as they are still in sync with the file
    • soft-dirty bit is used by memory changes tracking
  • Ptrace SEIZE, used to grab pages from task's VM into a pipe (with vmsplice)

The last step deserves a more detailed explanation. In order to drain memory from a task, we first generate the bitmap of pages needed to be dumped (using the smaps, map_files and pagemap cache filled from proc). Next, we create a set of pipes to put pages into. Then we infect the process with parasite code, which, in turn, gets the pipes and vmsplices the required pages into it. Finally, we splice the pages from pipes into image files.

Restoring[edit]

Restoring is pretty straightforward. During restore, CRIU morphs itself into a target task. Two things worth mentioning before diving into explanation of steps.

COW
Anonymous private mappings might have pages shared between tasks till they get COW-ed. To restore this CRIU pre-restores those pages before forking the child processes and mremap-s them in the final stage.
Shared memory
Those areas are implemented in the kernel by supporting a pseudo file on a hidden tmpfs mount. So on restore we just determine who will create the shared are and who will attach to it (see the postulates). Then the creator mmap-s the region and the others open the /proc/pid/map_files/ link. However, on the recent kernels, we use the new memfd system call that does similar thing but works for user namespaces. Briefly -- creator creates the memfd, all the others get one via /proc/pid/fd link which is not that strict as compared to the map_files.

Having said that, the restore of memory is done in the following steps:

Open images and read in VMAs
Open all the mm.img, read mappings in, resolve shared memory segments and check whether we need to special-care mapped files.
Fork and pre-mmap
Each task pre-mmaps private anonymous areas and populates them with pages (from pagemap/pages images). Then task forks the child which does the same. It is done in such way in order to make COWed areas actually share the pages they should. On fork() the shared pages become actually shared, as currently this is the only way to make Linux kernel do this.
Open file mappings
Soon after fork we check which VMA-s are MAP_FILE ones and request the files engine to open them.
Open shared mappings
At almost the same place we create an FD for shared anonymous VMA-s.
Dive into restorer context
At this stage we strip off all the old CRIU mappings thus making the VM be ready for restored mappings.
Restore mappings in their places
Anonymous private mappings are mremap-ed from the pre-mapped areas one-by-one, file mappings are created with mmap system call. Anonymous shared mappings are also just mmaped.

Non linear mappings[edit]

Currently we don't support non-linear mappings (so dump fails if such mappings are found).

Advanced C/R[edit]

For things as remote dump, stackable images, and incremental dumps, CRIU supports a more sophisticated memory C/R policies rather than "dump all -- restore all" one. There are several CLI knobs that can be used.

  • dump action
  • pre-dump action
  • --track-mem option
    • --prev-images-dir option
  • --leave-running option
  • --page-server option

Let's see what all of this means.

First of all, the pre-dump action always turns on the --track-mem and the --leave-running options even if they are not specified in the command line. Next, the pre-dump action dumps only the memory, while the dump one dumps all the state including open files, sockets and other stuff. Having said that, let's see all the possible combinations and what they result in.

dump
Without any options, dump everything and kill the dumped tasks.
dump --track-mem
Dump everything, turn on memory changes tracking, and kill tasks after this. As you might have noticed, this is pretty useless combination of options!
dump --leave-running
Dump everything, and leave the tasks running after dump.
dump --track-mem --leave-running
Same as above, but turn on memory changes tracking.
dump --track-mem --leave-running --prev-images-dir <path>
Same as above, but during dump also check whether the page in question is present in parent, and skip dumping it this time.
pre-dump
Only dump memory, turn on memory changes tracking and leave the tasks running.
pre-dump --prev-images-dir <path>
Same as above, but check for pages present in parent and skip them.
<pre->dump <options> --page-server
Send the pages to the page server (e.g. for disk-less migration). See page server for more details.

Messing with image files[edit]

Criu-memory-wflow.png

See also[edit]