mir/criu
2
0
Fork 0
mirror of https://github.com/checkpoint-restore/criu synced 2025-08-22 09:58:09 +00:00
Code Issues Releases Wiki Activity
criu/include/image.h

86 lines
2.2 KiB
C
Raw Normal View History

hdrs: Fixup reinclusion preprocessor constants Make them look like __CR_<smth>_H__ with sed -e '1,2s/#\(ifndef\|define\) _\?_\?\(CR_\)\?/#\1 __CR_/' -e '1,2s/_H_\?_\?.*$/_H__/' on every header file. Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2012-12-24 15:36:14 +04:00
#ifndef __CR_IMAGE_H__
#define __CR_IMAGE_H__
Initial commit Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2011-09-23 12:00:45 +04:00
headers: image.h -- Drop asm/types.h inclusion This header consists of a number of constants and a few macro helper. No need to make it asm/types.h dependant. Instead only include <stdbool.h> for bool definition as required by forward fdinfo_per_id (I think this declaration should live in somewhere else place, not sure where yet, so I left it untouched). Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-04-01 19:27:34 +04:00
#include <stdbool.h>
Initial commit Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2011-09-23 12:00:45 +04:00
headers: image.h -- Drop asm/types.h inclusion This header consists of a number of constants and a few macro helper. No need to make it asm/types.h dependant. Instead only include <stdbool.h> for bool definition as required by forward fdinfo_per_id (I think this declaration should live in somewhere else place, not sure where yet, so I left it untouched). Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-04-01 19:27:34 +04:00
#include "compiler.h"
crtools: move pid_rst_prio to pid.h crtools.h is too heavy to be included in many sources Signed-off-by: Andrey Vagin <avagin@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-11-06 17:21:13 +04:00
#include "servicefd.h"
image: Move image descriptors to own files Move image object descriptors to own image-desc file(s). This allow to reuse the code in other tools. I had to move show declarations to cr-show.h as well. Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-05-28 22:12:06 +04:00
#include "image-desc.h"
image.h: Include fcntl.h No all distros (Rpi) provide O_PATH definition, so include fcntl.h here thus we don't hit compilation problem like | CC image.o | image.c: In function ‘open_image_at’: | image.c:187:29: error: ‘O_PATH’ undeclared (first use in this function) Reported-by: Pavel Emelyanov <xemul@parallels.com> Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2014-03-14 17:57:00 +04:00
#include "fcntl.h"
image: Move magic numbers to magic.h This allows to reuse magic numbers outside of crtools code. Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-03-05 02:24:30 +04:00
#include "magic.h"
netns: Ifaddrs dump and restore Just run the ip addr save and ip addr restore respectively. Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2012-08-02 08:26:43 +04:00
Initial commit Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2011-09-23 12:00:45 +04:00
#define PAGE_IMAGE_SIZE 4096
#define PAGE_RSS 1
crtools: Take MINCORE_ANON pages into account Reduce the pages-xxx.img file size significantly (from 2.1M to ~100K for simple counter test) by not dumping private file pages, that have not yet changed from its file prototype. If you'll have problems with it, just let me know and comment the definition of PAGE_ANON not to block your work. This uses the implemented earlier flag from mincore. Signed-off-by: Pavel Emelyanov <xemul@parallels.com> Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2011-11-25 18:04:36 +04:00
#define PAGE_ANON 2
Initial commit Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2011-09-23 12:00:45 +04:00
files: Support dumping/restoring of completely unlinked files Completely unlinked file is the one with n_link count being zero. Such files only allow to read their contents and carry with us. In order to dump this thing I introduce the "path remap" technology. For reg file a remapping entry is dumped which describes, that at restore stage before opening a regfile->path this path should be linked to some other name and then (after open) unlinked. For completely unlinked files the remap path would be a path to a "ghost" file, i.e. a file which is created only at the time of restore and which is removed completely at the end of it. Partially unlinked files (i.e. those having n_link != 0, but a path by which we see them in someone's fd is not accessible) should be handled in another way. Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2012-04-13 17:54:36 +04:00
/*
* Top bit set in the tgt id means we've remapped
* to a ghost file.
*/
#define REMAP_GHOST (1 << 31)
unix: Add comments about icons and external sockets Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-09-10 12:24:11 +04:00
/*
* By-default, when dumping a unix socket, we should dump its peer
* as well. Which in turn means, we should dump the task(s) that have
* this peer opened.
*
* Sometimes, we can break this rule and dump only one end of the
* unix sockets pair, and on restore time connect() this end back to
* its peer.
*
* So, to resolve this situation we mark the peers we don't dump
* as "external" and require the --ext-unix-sk option.
*/
sockets: Restore unconnected dgram sockets v7 In case if dgram socket peer is not connected back we can try to resolve peer by name. For security reason this happens only if '-x' option is passed at checkpoint and restore time. In particular this is needed for programs which do use dgram socket to send messages to /dev/log. Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2012-04-19 11:48:00 +04:00
#define USK_EXTERN (1 << 0)
unix: Handle service socket on dump and restore Service connection is actually an 'external' one from unix sockets engine POV, but we don't want to dump it as such. Thus, we explicitly find one and dump it as half-closed connection. On restore we push an artificial message into it to report to the program that the dump-request was served, but the program is restored. Signed-off-by: Ruslan Kuprieiev <kupruser@gmail.com> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-09-13 13:44:15 +04:00
#define USK_SERVICE (1 << 1)
unix: add ability to set callbacks for external sockets (v5) We don't know a state behind an external socket. It depends on logic of the program, which handles this socket. This patch adds ability to load a library with callbacks for dumping and restoring external sockets. This patch introduces two callbacks cr_plugin_dump_unix_sk and cr_plugin_restore_unix_sk. If a callback can not handle a socket, it must return -ENOTSUP. The main questions, what kind of information should be tranfered in these callbacks. Pls, think a few minutes about that and send me your opinion. v2: Use uflags instread of adding a new field v3: clean up v4: Unsuitable callbacks return -ENOTSUP. v5: set USK_CALLBACK, if a socket was dumped by callback. Signed-off-by: Andrey Vagin <avagin@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-12-19 21:35:01 +04:00
#define USK_CALLBACK (1 << 2)
sockets: Restore unconnected dgram sockets v7 In case if dgram socket peer is not connected back we can try to resolve peer by name. For security reason this happens only if '-x' option is passed at checkpoint and restore time. In particular this is needed for programs which do use dgram socket to send messages to /dev/log. Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2012-04-19 11:48:00 +04:00
util: Drop redundant vma_area->vma.status assignment Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2011-11-15 13:37:17 +04:00
#define VMA_AREA_NONE (0 << 0)
image: Drop redundant VMA_FORCE_WRITE Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2011-11-15 11:57:24 +04:00
#define VMA_AREA_REGULAR (1 << 0) /* Dumpable area */
#define VMA_AREA_STACK (1 << 1)
#define VMA_AREA_VSYSCALL (1 << 2)
#define VMA_AREA_VDSO (1 << 3)
#define VMA_FORCE_READ (1 << 4) /* VMA changed to be readable */
#define VMA_AREA_HEAP (1 << 5)
#define VMA_FILE_PRIVATE (1 << 6)
#define VMA_FILE_SHARED (1 << 7)
#define VMA_ANON_SHARED (1 << 8)
#define VMA_ANON_PRIVATE (1 << 9)
Initial commit Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2011-09-23 12:00:45 +04:00
dump: support SYSV IPC vma This patch introduces the following changes: 1) introduces new flag VMA_AREA_SYSVIPC to mark corresponding vma entries. 2) enhance task /proc/<pid>/maps parsing to obtain first 5 letters of mapped file. If device major file belong to ins equal to 0 (tmpfs) and it's name starts with "/SYSV", then this mapping is considered as SYSV IPC and corresponding vma entry status is updated with VMA_AREA_SYSVIPC flag. 3) omit dumping of mapping pages for SYSV IPC vmas. Signed-off-by: Stanislav Kinsbursky <skinsbursky@openvz.org> Acked-by: Pavel Emelyanov <xemul@parallels.com> Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org>
2012-02-14 20:19:49 +03:00
#define VMA_AREA_SYSVIPC (1 << 10)
packet: Support mmap-ing of packet sockets Three parts. Proc: open of map_files' link doesn't work on sockets. We fstatat it and check that it's a socket (it will be packet), then save the socket inode on vma_area. Dump: we resolve socket inode to socket id and save it on vma. We use id, not inode, since on restore we'll have to mmap some opened file, not just abstract socket with inode. Restore: when reading vma-s we just need to find out on what fd the respective packet socket is opened (i.e. -- no map-and-close sockets supported by now) and dup() it to let restorer mmap it back. All this make it possible to c/r the tcpdump tool! Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2012-11-02 16:00:18 +03:00
#define VMA_AREA_SOCKET (1 << 11)
dump: support SYSV IPC vma This patch introduces the following changes: 1) introduces new flag VMA_AREA_SYSVIPC to mark corresponding vma entries. 2) enhance task /proc/<pid>/maps parsing to obtain first 5 letters of mapped file. If device major file belong to ins equal to 0 (tmpfs) and it's name starts with "/SYSV", then this mapping is considered as SYSV IPC and corresponding vma entry status is updated with VMA_AREA_SYSVIPC flag. 3) omit dumping of mapping pages for SYSV IPC vmas. Signed-off-by: Stanislav Kinsbursky <skinsbursky@openvz.org> Acked-by: Pavel Emelyanov <xemul@parallels.com> Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org>
2012-02-14 20:19:49 +03:00
mm: mark VM_IO and VM_PFNMAP VMA-s as unsupported vmsplice doesn't work for such VMA-s. This flags is set in a kernel function remap_pfn_range() (remap kernel memory to userspace), which is widely used by device drivers to provide direct access to a device memory. Reported-by: J F <jgmb45@gmail.com> Cc: Cyrill Gorcunov <gorcunov@openvz.org> Signed-off-by: Andrey Vagin <avagin@openvz.org> Acked-by: Cyrill Gorcunov <gorcunov@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2014-05-19 23:02:00 +04:00
#define VMA_UNSUPP (1 << 12) /* Unsupported VMA */
cr: Task creds support Dumping is simple. All but secbits can be read from proc, secbits are got from parasite. Restoring is a bit tricky -- when you change anything on kernel cred's struct it performs sophisticated checks and can change some more stuff than requested, so the creds restoration procedure is carefully commented step-by-step. Another thing to mention is that creds are restored after everything else, i.e. right before performing final threads sync and sigreturns. This is done to avoid potential problems with insufficient caps for restoring other stuff (e.g. CAP_DAC_OVERRIDE or zero euid is most likely required for opening any image file and the notorious control /proc/sys/kernel/ns_last_pid, which in turn is performed till the very last moment). Signed-off-by: Pavel Emelyanov <xemul@parallels.com> Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org>
2012-01-27 21:43:32 +04:00
#define CR_CAP_SIZE 2
Restore task's command line as well Note binary format for core file is changed. Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2011-10-01 13:24:34 +04:00
#define TASK_COMM_LEN 16
Initial commit Signed-off-by: Cyrill Gorcunov <gorcunov@gmail.com>
2011-09-23 12:00:45 +04:00
ctrools: Rewrite task/threads stopping engine is back This commit brings the former "Rewrite task/threads stopping engine" commit back. Handling it separately is too complex so better try to handle it in-place. Note some tests might fault, it's expected. --- Stopping tasks with STOP and proceeding with SEIZE is actually excessive -- the SEIZE if enough. Moreover, just killing a task with STOP is also racy, since task should be given some time to come to sleep before its proc can be parsed. Rewrite all this code to SEIZE task and all its threads from the very beginning. With this we can distinguish stopped task state and migrate it properly (not supported now, need to implement). This thing however has one BIG problem -- after we SEIZE-d a task we should seize it's threads, but we should do it in a loop -- reading /proc/pid/task and seizing them again and again, until the contents of this dir stops changing (not done now). Besides, after we seized a task and all its threads we cannot scan it's children list once -- task can get reparented to init and any task's child can call clone with CLONE_PARENT flag thus repopulating the children list of the already seized task (not done also) This patch is ugly, yes, but splitting it doesn't help to review it much, sorry :( Signed-off-by: Pavel Emelyanov <xemul@parallels.com> Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org>
2012-02-01 19:45:31 +04:00
#define TASK_ALIVE 0x1
#define TASK_DEAD 0x2
image: Stopped tasks are supported, fix comments Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-11-15 00:27:45 +04:00
#define TASK_STOPPED 0x3
restore: add interface for creating helper tasks (v3) They will be used for restoring sid. For example, if a session group leader is absent, a helper process is created with this id and it will die after restoring all other tasks. Before this patch restore failed if anyone exited. Now we should skip helpers, which exited successfully. It's a bit tricky. All children are collected in sigchld_handler, but we have a point, where we want to wait all helpers. For that waitpit is used and ECHLD is ignored, because it signs that a helper exited and has been waited in sigchld_handler. v2: check that me isn't NULL in the sig handler v3: move code about waiting helpers in a separate function Signed-off-by: Andrey Vagin <avagin@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2012-06-22 00:38:00 +04:00
#define TASK_HELPER 0x4
img: Extend task image with state and exit code Introduce 3 states we will have to work with: * alive for tasks sleeping or running * dead for zombies * stopped for stopped tasks. We cannot distinguish tasks in this state now, but with freezer cgroup this will become possible Signed-off-by: Pavel Emelyanov <xemul@parallels.com> Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org>
2012-01-22 20:24:04 +04:00
crtools: move CR_PARENT_LINK to image.h Signed-off-by: Andrey Vagin <avagin@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-11-05 12:33:04 +04:00
#define CR_PARENT_LINK "parent"
files: dump fdinfo per files_id instead of pid A few processes can share one fdtable. Signed-off-by: Andrey Vagin <avagin@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-01-11 18:16:25 +04:00
extern bool fdinfo_per_id;
ns: replace pid on id in per-namespace files Signed-off-by: Andrey Vagin <avagin@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-09-30 17:16:51 +04:00
extern bool ns_per_id;
files: dump fdinfo per files_id instead of pid A few processes can share one fdtable. Signed-off-by: Andrey Vagin <avagin@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-01-11 18:16:25 +04:00
image: Don't unlink image we're dumping into We want to write into empty image files, so we unlink them before dumping into. Let's O_TRUNC it instead. Signed-off-by: Pavel Emelyanov <xemul@parallels.com> Acked-by: Andrew Vagin <avagin@parallels.com>
2014-02-14 16:47:02 +04:00
#define O_DUMP (O_RDWR | O_CREAT | O_TRUNC)
crtools: don't include image.h in crtools.h Signed-off-by: Andrey Vagin <avagin@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-11-06 14:34:30 +04:00
#define O_SHOW (O_RDONLY)
#define O_RSTR (O_RDONLY)
image: open_image_at -- Add O_OPT flag This allows us to distinguish the situation where image to be opened is missing but optional, thus no error message should be printed. Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2014-03-13 16:06:37 +04:00
#define O_OPT (O_PATH)
crtools: don't include image.h in crtools.h Signed-off-by: Andrey Vagin <avagin@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-11-06 14:34:30 +04:00
image: add dir parameter to open_image_dir() Signed-off-by: Ruslan Kuprieiev <kupruser@gmail.com> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-11-15 23:04:27 +04:00
extern int open_image_dir(char *dir);
crtools: don't include image.h in crtools.h Signed-off-by: Andrey Vagin <avagin@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-11-06 14:34:30 +04:00
extern void close_image_dir(void);
headers: Add extern specificator to functions We really have a mess of extern/non-extern declaration of functions in our headers. Always use extern for unification purpose. Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-11-15 14:04:48 +04:00
extern int open_image_at(int dfd, int type, unsigned long flags, ...);
crtools: don't include image.h in crtools.h Signed-off-by: Andrey Vagin <avagin@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-11-06 14:34:30 +04:00
#define open_image(typ, flags, ...) open_image_at(get_service_fd(IMG_FD_OFF), typ, flags, ##__VA_ARGS__)
headers: Add extern specificator to functions We really have a mess of extern/non-extern declaration of functions in our headers. Always use extern for unification purpose. Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-11-15 14:04:48 +04:00
extern int open_pages_image(unsigned long flags, int pm_fd);
extern int open_pages_image_at(int dfd, unsigned long flags, int pm_fd);
extern void up_page_ids_base(void);
crtools: don't include image.h in crtools.h Signed-off-by: Andrey Vagin <avagin@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2013-11-06 14:34:30 +04:00
headers: Unify include guards (in comments) and a few fixes - fix names in comments - add empty lines where needed - fix rbtree.h - fix syscall-types.h Signed-off-by: Cyrill Gorcunov <gorcunov@openvz.org> Signed-off-by: Pavel Emelyanov <xemul@parallels.com>
2012-12-25 22:40:24 +04:00
#endif /* __CR_IMAGE_H__ */
Reference in New Issue Copy Permalink