NAME
arena_set_activate
SYNOPSIS
#include <charm.h>
typedef void (*ActivateFn)(int);
Status arena_set_activate( int arena_id, Cap arena_cap, ActivateFn ep )
PARAMETERS
arena_id specifies the arena whose activation point is being set.
arena_cap a management capability for the arena being managed.
ep specifies the function called on activation.
DESCRIPTION
The arena_set_activate() function is used to specify the address of a function to be called when an arena is activated. The specified function is called when the arena is first activated and is passed the arena id as a parameter.
The address of the entry-point must be a valid code address in user space.
RETURN VALUES
Upon the successful completion, the arena_set_activate( ) function returns [SUCCEED].
ERRORS
[NO_SUCH_ARENA] The arena_id parameter is not valid (out of range).
[ARENA_CAP_INVALID] The arena_cap parameter specifies a capability that does not match the current authorisation capability associated with the arena.
[ILLEGAL_ENTRY_POINT] Entry point specified is not a legal code address. All entry points must be <= the kernel constant max_user_va.
RELATED INFORMATION