ethIpcStackAttach(2K)

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

NAME

ethIpcStackAttach- attach an IPC stack to an Ethernet device

SYNOPSIS

#include <ddi/net/netFrame.h>
#include <iom/ipcStackAttach.h>

int ethIpcStackAttach(const *device);

FEATURES

IOM_IPC, IPC_REMOTE

DESCRIPTION

If the IOM_IPC feature is set to true, the IOM actor includes an IPC stack. ethIpcStackAttach() attaches the IPC stack to an Ethernet device handled by the IOM.

ethIpcStackAttach() should be executed only after the corresponding Ethernet device is up and running and has been assigned an IP address.

ethIpcStackAttach() works by causing the IOM to scan its network its ifnet interfaces until it finds the interface attached to the corresponding Ethernet hardware device. Once that interface is found, it processes IPC traffic. If device is NULL, the first IOM Ethernet network interface is used.

Once attached, the IPC stack cannot be detached. Furthermore, the IPC stack may only be attached to a single Ethernet hardware device.

RETURN VALUES

Upon successful completion, ethIpcStackAttach() returns 0; otherwise it returns -1 and sets errno to indicate the error.

ERRORS

[EACCES]

ethIpcStackAttach() was called by a user actor.

Only supervisor actors can invoke ethIpcStackAttach().

[ENODEV]

No network interface attached to device was found.

[EINVAL]

The IPC stack could not be correctly initialized.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

C_INIT(1M)

ChorusOS 4.0  Last Revised December 1999

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