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

last updated: 11/2/99