names Interface Reference

import "names.idl";

Public Member Functions
long	register ([in, string, max_is(NAMES_MAX_NAME_LEN)] char *name)
long	register_thread ([in, string, max_is(NAMES_MAX_NAME_LEN)] char *name,[in] l4_threadid_t id)
long	unregister_thread ([in, string, max_is(NAMES_MAX_NAME_LEN)] char *name,[in] l4_threadid_t id)
long	unregister_task ([in] l4_threadid_t id)
long	query_name ([in, string, max_is(NAMES_MAX_NAME_LEN)] char *name,[out] l4_threadid_t *id)
long	query_id ([in] l4_threadid_t id,[out, string, prealloc_client, max_is(NAMES_MAX_NAME_LEN)] char **name)
long	query_nr ([in] int nr,[out, string, prealloc_client, max_is(NAMES_MAX_NAME_LEN)] char **name,[out] l4_threadid_t *id)
void	dump ()

---

Detailed Description

IDL interface of the name server.

---

Member Function Documentation

long names::register

(

[in, string, max_is(NAMES_MAX_NAME_LEN)] char *

name

)

Register thread at names.

Parameters:

name

Name of the thread.

Returns:

0 on error, != 0 on success

long names::register_thread	(	[in, string, max_is(NAMES_MAX_NAME_LEN)] char *	name,
		[in] l4_threadid_t	id
	)

Register arbitrary thread at names.

Parameters:

	name	Name of the thread.
	id	Thread ID of thread to register.

Returns:

0 on error, != 0 on success

long names::unregister_thread	(	[in, string, max_is(NAMES_MAX_NAME_LEN)] char *	name,
		[in] l4_threadid_t	id
	)

Unregister arbitrary thread at names.

Parameters:

	name	Name of the thread.
	id	Thread ID of thread to unregister.

Returns:

0 on error, != 0 on success

long names::unregister_task

(

[in] l4_threadid_t

id

)

Unregister all threads of a task at names.

Parameters:

	name	Name of the thread.
	id	Task of threads to unregister.

Returns:

0 on error, != 0 on success

long names::query_name	(	[in, string, max_is(NAMES_MAX_NAME_LEN)] char *	name,
		[out] l4_threadid_t *	id
	)

Query names for an ID by name.

Parameters:

name

Name to query.

Return values:

id

Thread ID if found.

Returns:

0 on error, != 0 on success

long names::query_id	(	[in] l4_threadid_t	id,
		[out, string, prealloc_client, max_is(NAMES_MAX_NAME_LEN)] char **	name
	)

Query names for a name by ID.

Parameters:

id

ID to query.

Return values:

name

Name if found.

Returns:

0 on error, != 0 on success

long names::query_nr	(	[in] int	nr,
		[out, string, prealloc_client, max_is(NAMES_MAX_NAME_LEN)] char **	name,
		[out] l4_threadid_t *	id
	)

Query names for a name and ID by number.

Parameters:

nr

Number to query.

Return values:

	name	Name if found.
	id	ID if found.

Returns:

0 on error, != 0 on success

void names::dump

(

)

Requests names to dump its internal database.

---

The documentation for this interface was generated from the following file:

• names.idl