norma_set_special_port

Function - Set node-specific special port.

SYNOPSIS

kern_return_t   norma_set_special_port
                (host_priv_t                          host_priv,
                 int                                 which_port,
                 mach_port_t                       special_port);

Macro forms:

#include<mach/norma_special_ports.h>

kern_return_t   norma_set_device_port
                (host_priv_t                          host_priv,
                 mach_port_t                       special_port);

kern_return_t   norma_set_host_port
                (host_priv_t                          host_priv,
                 mach_port_t                       special_port);

kern_return_t   norma_set_host_priv_port
                (host_priv_t                          host_priv,
                 int                                       node,
                 mach_port_t                       special_port);

kern_return_t   norma_set_nameserver_port
                (host_priv_t                          host_priv,
                 mach_port_t                       special_port);

PARAMETERS

host_priv

[in host-control send right] The host for which to set the special port. Currently, this must be the per-node host control port.

node

[in scalar] The index of the node for which the port is to be set.

which_port

[in scalar] The index of the special port to be set. Valid values are:

NORMA_DEVICE_PORT

[device-master send right] The device master port for the node.

NORMA_HOST_PORT

[host-name send right] The host name port for the node.

NORMA_HOST_PRIV_PORT

[host-control send right] The host control port for the node.

NORMA_NAMESERVER_PORT

[name-server send right] The registered name server port for the node.

special_port

[in norma-special send right] Send right to the new special port.

DESCRIPTION

The norma_set_special_port function sets the special port belonging to node on host_priv.

Each node maintains a (small) set of node specific ports. The device master port, host name, and host control ports are maintained by the kernel. The kernel also permits a small set of server specified node specific ports; the name server port is an example and is given (by convention) an assigned special port index.

RETURN VALUES

Only generic errors apply.

RELATED INFORMATION

Functions: mach_host_self, norma_get_special_port.