grpPortRemove(2K)

NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO

NAME

grpPortInsert, grpPortRemove- insert a port into a port group; remove a port from a port group

SYNOPSIS

#include <ipc/chIpc.h>

int grpPortInsert(KnCap * groupcap, KnUniqueId * portui);
int grpPortRemove(KnCap * groupcap, KnUniqueId * portui);

FEATURES

IPC

DESCRIPTION

grpPortInsert inserts the port, the name of which is given by portui into the port group, the capability of which is pointed to by groupcap.

grpPortRemove removes the port, the name of which is given by portui from the port group, the capability of which is pointed to by groupcap.

RETURN VALUE

Upon successful completion a value of 0 is returned. Otherwise, a negative error code is returned. grpPortInsert returns 0 if the port was already in the port group.

ERRORS

[K_EINVAL]

groupcap is an invalid port group capability, or there was an attempt to remove a port from a port group to which it did not belong.

[K_EUNKNOWN]

portui is an invalid port name.

[K_EFAULT]

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

[K_ENOMEM]

The system is out of resources.

[K_EPRIV]

The current thread is neither a supervisor thread nor a thread of a system actor, and attempts to insert a port or remove a port in a system static group.

RESTRICTIONS

The port and the current actor must be located on the same site.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

grpAllocate(2K)

ChorusOS 5.0  Last Revised December 1999

NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO