Line 1: |
Line 1: |
− | '''libcriu''' is a C API for CRIU, which is a simple wrapper around our [[RPC]]. Although you can use [[RPC]] directly, libcriu is a wrapper providing the interface that is much easier to use from C code. Note that [[RPC]] is supported in the first place, and if you want the most recent set of features you should probably use [[RPC]] directly. | + | '''libcriu''' is a C API for CRIU, a simple wrapper around our [[RPC]]. Although you can use [[RPC]] directly, libcriu is a wrapper providing the interface that is much easier to use from C code. Note that [[RPC]] is supported in the first place, and if you want the most recent set of features you should probably use [[RPC]] directly. |
| | | |
| == Introduction == | | == Introduction == |
Line 6: |
Line 6: |
| | | |
| To create a library <code>lib/libcriu.so</code>, run <code>make</code> in the main directory. | | To create a library <code>lib/libcriu.so</code>, run <code>make</code> in the main directory. |
− |
| |
− | The library is not thread- and fork- safe.
| |
| | | |
| == Preparation == | | == Preparation == |
Line 24: |
Line 22: |
| Use <code>criu_set_*</code> functions to setup dump/restore options. | | Use <code>criu_set_*</code> functions to setup dump/restore options. |
| | | |
− | <pre> | + | <source lang="c"> |
| void criu_set_pid(int pid); | | void criu_set_pid(int pid); |
| void criu_set_images_dir_fd(int fd); /* must be set for dump/restore */ | | void criu_set_images_dir_fd(int fd); /* must be set for dump/restore */ |
Line 35: |
Line 33: |
| void criu_set_log_level(int log_level); | | void criu_set_log_level(int log_level); |
| void criu_set_log_file(char *log_file); | | void criu_set_log_file(char *log_file); |
− | </pre> | + | </source> |
| + | |
| + | {{Note|This set of calls is not thread safe! For thread safety the same calls with _local suffix should be used}} |
| | | |
| If no pid is set on dump, CRIU will dump the calling process itself. | | If no pid is set on dump, CRIU will dump the calling process itself. |
Line 42: |
Line 42: |
| {{Note|<code>images_dir_fd</code> is '''required''' at dump/restore, all other options might be left unset. | | {{Note|<code>images_dir_fd</code> is '''required''' at dump/restore, all other options might be left unset. |
| The client must open directory for/with images by itself and set <code>images_dir_fd</code> to the opened directory fd. | | The client must open directory for/with images by itself and set <code>images_dir_fd</code> to the opened directory fd. |
− | CRIU will open /proc/<client's_pid>/fd/<images_dir_fd>, so it will work even if the client is in another namespace.}} | + | CRIU will open <code>/proc/''client_pid''/fd/''images_dir_fd''</code>, so it will work even if the client is in another namespace.}} |
| | | |
| The logic of setting request is the same as when setting options in console. Here is an example: | | The logic of setting request is the same as when setting options in console. Here is an example: |
| | | |
− | #criu restore -D /path/to/imgs_dir -v4 -o restore.log | + | # criu restore -D /path/to/imgs_dir -v4 -o restore.log |
| | | |
| is equal to: | | is equal to: |
− | <pre> | + | <source lang="c"> |
| criu_init_opts(); | | criu_init_opts(); |
| criu_set_service_address("/path/to/criu/service/socket"); | | criu_set_service_address("/path/to/criu/service/socket"); |
Line 60: |
Line 60: |
| | | |
| criu_restore(); | | criu_restore(); |
− | </pre> | + | </source> |
| | | |
| == Operations == | | == Operations == |
Line 78: |
Line 78: |
| int criu_restore(void); | | int criu_restore(void); |
| | | |
− | === restore as child === | + | === restore as a child === |
− | This one is special. It will fork and exec criu swrk(Service WoRKer) to allow restoring process as a caller child. Calling "exec" implies some restrictions, as, for example, one should make sure, that criu binary is present in PATH and has [[Security suid bit]] set. | + | |
| + | This one is special. It will fork and exec criu swrk (Service WoRKer) to allow restoring process as a caller child. Calling "exec" implies some restrictions, as, for example, one should make sure, that criu binary is present in PATH and has suid bit set (see [[Usage#Security]]). |
| | | |
| int criu_restore_child(void); | | int criu_restore_child(void); |
Line 130: |
Line 131: |
| == Examples == | | == Examples == |
| | | |
− | You could find example of using libcriu at [http://git.criu.org/?p=criu.git;a=tree;f=test/libcriu test/libcriu]. | + | You could find example of using libcriu at [https://github.com/xemul/criu/tree/master/test/others/libcriu test/others/ibcriu]. |
| | | |
| [[Category: API]] | | [[Category: API]] |
| + | [[Category: Outdated]] |