lapInvoke(2K)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

NAME

lapInvoke- invoke a lap handler

SYNOPSIS

#include <lap/chLap.h>

int lapInvoke(KnLapDesc *lapdesc, void *arg);

DESCRIPTION

The lapInvoke(2K) system call invokes a lap handler in the context of the calling thread (see svLapCreate(2K) for a description of the exact invocation semantics). The lap considered here is represented by its lap descriptor pointed to by lapdesc.

The lap handler is called with two parameters: the arg argument and the cookie specified at lap creation time (see svLapCreate(2K)).

RETURN VALUES

On success, lapInvoke(2K) returns K_OK, otherwise a negative error code is returned.

ERRORS

[K_EFAIL]

The lap was created with the K_LAP_SAFE option and the lap has been deleted when the invocation is in progress.

[K_EFAIL]

The lap was created with the K_LAP_SETJMP option and a failure occured during the lap invocation.

[K_EFAULT]

Some of the provided data are outside the current actor's address space.

[K_EINVAL]

The lap was created with the K_LAP_SAFE option and it has been deleted. lapInvoke(2K) is called from user mode and the invoked lap was not created with the K_LAP_SAFE option.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

svLapCreate(2K), svLapDelete(2K)

ChorusOS 5.0  Last Revised December 1999

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO