NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO
#include <lap/chLap.h>int svLapBind(KnLapDesc * lapdesc, char * name, unsigned int options);
LAPBIND
The svLapBind (2K) system call binds the lap descriptor pointed to by lapdesc with the symbolic name pointed to by name .
name points to a null-terminated string of K_LAPNAMEMAX characters at most (not including the null-terminating character).
If the K_LAP_PROTECTED option is set in the options parameter, the binding will only be visible to trusted threads (e.g. threads executing in user actors will get an error from lapResolve (2K) on this name).
The svLapUnbind (2K) system call removes the lap binding associated to name .
The lapResolve (2K) system call initializes the lap descriptor pointed to by lapdesc with the lap descriptor bound to name . lapResolve (2K) will block until a lap descriptor is bound to name , except if the K_LAP_NOBLOCK option is set in options , in which case the call returns immediatly with an error.
svLapBind and svLapUnbind are restricted to SUPERVISOR threads.
On success, these calls return K_OK. Otherwise, a negative error code is returned.
The calling thread has been aborted in lapResolve (2K).
The name given to svLapBind (2K) is already in use.
The lapdesc or name arguments of lapResolve points to the outside of the caller's address space.
The name given to svLapUnbind (2K) is not bound to any lap, or the name given to lapResolve (2K) is not bound to any lap, and the K_LAP_NOBLOCK option is set.
The name given to svLapBind (2K), svLapUnbind (2K) or lapResolve (2K) is too long. [K_ENOMEM] The system is out of resources.
lapResolve (2K) is called by a non trusted thread to resolve a name which has been bound with the K_LAP_PROTECTED option.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO