Client Handling
[Dataspace Manager Server Support Library]


Data Structures

struct  dsmlib_client_desc

Typedefs

typedef struct dsmlib_client_desc dsmlib_client_desc_t

Functions

L4_CV int dsmlib_add_client (dsmlib_ds_desc_t *ds, l4_threadid_t client, l4_uint32_t rights)
 Add client to dataspace.
L4_CV int dsmlib_remove_client (dsmlib_ds_desc_t *ds, l4_threadid_t client)
 Remove dataspace client.
L4_CV int dsmlib_remove_all_clients (dsmlib_ds_desc_t *ds)
 Remove all clients from dataspace.
L4_CV int dsmlib_is_client (const dsmlib_ds_desc_t *ds, l4_threadid_t client)
 Check if someone is a client of a dataspace.
L4_CV int dsmlib_set_rights (const dsmlib_ds_desc_t *ds, l4_threadid_t client, l4_uint32_t rights)
 Set client rights.
L4_CV l4_uint32_t dsmlib_get_rights (const dsmlib_ds_desc_t *ds, l4_threadid_t client)
 Return client rights.
L4_CV int dsmlib_check_rights (const dsmlib_ds_desc_t *ds, l4_threadid_t client, l4_uint32_t rights)
 Check client rights.

Typedef Documentation

Dataspace client descriptor


Function Documentation

L4_CV int dsmlib_add_client ( dsmlib_ds_desc_t ds,
l4_threadid_t  client,
l4_uint32_t  rights 
)

Add client to dataspace.

Parameters:
ds Dataspace descriptor
client Client thread id
rights Rights bit mask (user defined)
Returns:
0 on success, error code otherwise:
  • -L4_EINVAL invalid dataspace descriptor
  • -L4_ENOMEM out of memory allocating client descriptor
Add client to the client list of the dataspace. If the client already exists, the rights are added to the client descriptor.

L4_CV int dsmlib_remove_client ( dsmlib_ds_desc_t ds,
l4_threadid_t  client 
)

Remove dataspace client.

Parameters:
ds Dataspace descriptor
client Client thread id
Returns:
0 on success, error code otherwise:
  • -L4_EINVAL invalid dataspace descriptor
  • -L4_ENOTFOUND client id not found
Remove client from the client list of the dataspace.

L4_CV int dsmlib_remove_all_clients ( dsmlib_ds_desc_t ds  ) 

Remove all clients from dataspace.

Parameters:
ds Dataspace descriptor
Returns:
0 on success, error code otherwise:
  • -L4_EINVAL invalid dataspace descriptor

L4_CV int dsmlib_is_client ( const dsmlib_ds_desc_t ds,
l4_threadid_t  client 
)

Check if someone is a client of a dataspace.

Parameters:
ds Dataspace descriptor
client Client thread id
Returns:
!= 0 if client is a client of the dataspace, 0 otherwise.
Note:
This only checks the client list of the dataspace, not if client is the owner of the dataspace.

L4_CV int dsmlib_set_rights ( const dsmlib_ds_desc_t ds,
l4_threadid_t  client,
l4_uint32_t  rights 
)

Set client rights.

Parameters:
ds Dataspace descriptor
client Client thread id
rights Rights bit mask (user defined)
Returns:
0 on success, error code otherwise:
  • -L4_EINVAL invalid datatspace descriptor
  • -L4_ENOTFOUND client id not found
Set rights for client to rights.

L4_CV l4_uint32_t dsmlib_get_rights ( const dsmlib_ds_desc_t ds,
l4_threadid_t  client 
)

Return client rights.

Parameters:
ds Dataspace descriptor
client Client thread id
Returns:
Rights bit mask, 0 if invalid dataspace descriptor or client id not found
Return rights bit mask for client.

Note:
This function only returns the rights of the client stored in the client list. It does not check if the client is the owner of the dataspace.

L4_CV int dsmlib_check_rights ( const dsmlib_ds_desc_t ds,
l4_threadid_t  client,
l4_uint32_t  rights 
)

Check client rights.

Parameters:
ds Dataspace descriptor
client Client thread id
rights Rights bit mask
Returns:
1 if the client is allowed to perform the requested operations, 0 otherwise
Note:
This function only checks the rights of the client stored in the client list. It does not check if the client is the owner of the dataspace.


Generated on Wed Apr 11 06:38:25 2012 for L4Env Generic Dataspace Manager Interface by  doxygen 1.5.6