Changes

With the --action-script command line option, CRIU can call your action scripts (also known as hooks) at various stages of dumping/restoring. Hooks can be one of

With the <code>--action-script</code> command line option, CRIU can call your action scripts (also known as hooks) at various stages of dumping/restoring. The following hooks are available:

;network-lock

;<code>network-lock</code>

: request to lock a container network (used by Docker and [[LXC]])

: request to lock a container network (used by Docker and [[LXC]])

;network-unlock

;<code>network-unlock</code>

: requested to unlock a container network (used by Docker and [[LXC]])

: requested to unlock a container network (used by Docker and [[LXC]])

;post-dump

;<code>post-dump</code>

: called when CRIU finished dumping tasks before unfreezing them

: called when CRIU finished dumping tasks before unfreezing them

;post-restore

;<code>post-restore</code>

: called when CRIU has finished restoring tasks before unlocking the network

: called when CRIU has finished restoring tasks before unlocking the network

;setup-namespaces

;<code>setup-namespaces</code>

: called when the root task is alive and new set of namespaces is created to set them up

: called when the root task is alive and new set of namespaces is created to set them up

These hooks are added with the <code>--action-script ''shell-code-to-execute''</code> option. When called, the <code>CRTOOLS_SCRIPT_ACTION</code> environment is set to a value determining which type of action is performed.

These hooks are added with the --action-script shell-code-to-execute option. When called, the CRTOOLS_SCRIPT_ACTION environment is set to a value determining which type of action is performed.

== RPC ==

== RPC ==

In case of RPC, action scripts are implemented as notifications -- once CRIU service wants to execute a script it sends an RPC message to caller and waits for it to respond with <code>criu_req</code> message having <code>notify_success = true</code>.

In case of RPC, action scripts are implemented as notifications. Once CRIU service wants to execute a script, it sends an RPC message to the caller and waits for it to respond with <code>criu_req</code> message having <code>notify_success = true</code>.

== Library ==

== Library ==

When using a library one can setup a callback using the <code>criu_set_notify</code> routine.

When using a library, one can set up a callback using the <code>criu_set_notify</code> routine.

[[Category:HOWTO]]

[[Category:HOWTO]]

[[Category:API]]

[[Category:API]]