ns_add_status Network Service

Purpose

Adds a status filter for the routing of asynchronous status.

Syntax

#include <sys/cdli.h>
#include <sys/ndd.h>

int ns_add_status (nddp, statfilter, len, ns_statuser) struct ndd * nddp; caddr_t statfilter; int len; struct ns_statuser * ns_statuser;

Parameters

Item	Description
nddp	Specifies a pointer to the ndd structure to which this add request applies.
statfilter	Specifies a pointer to the status filter.
len	Specifies the length, in bytes, of the value of the statfilter parameter.
ns_statuser	Specifies a pointer to an ns_statuser structure that defines this user.

Description

The ns_add_status network service registers a status filter. The add request is passed on to the nd_add_status function of the demuxer for the specified network device driver (NDD). This network service enables the user to receive asynchronous status information from the specified device.

Note: The user's status processing function is specified by the isr field of the ns_statuser structure. The network demuxer calls the user's status processing function directly when asynchronous status information becomes available. Consequently; the status processing function cannot be a scheduled routine. The caller of the ns_add_status network service is responsible for relinquishing status filters before calling the ns_free network service.

Examples

The following example illustrates the ns_add_status network service:

struct ns_statuser   user;
struct ns_com_status   filter;
  
filter.filtertype = NS_STATUS_MASK;
filter.mask = NDD_HARD_FAIL;
filter.sid = 0;
user.isr = status_fn;
user.isr_data = whatever_makes_sense;
  
error = ns_add_status(nddp, &filter, sizeof(filter), &user);

Return Values

Item	Description
0	Indicates the operation was successful.

The network demuxer may supply other return values.