miocnak(9f) - osol9

1miocnak(9F)              Kernel Functions for Drivers              miocnak(9F)
2
3
4

NAME

6       miocnak - Negatively acknowledge an M_IOCTL message
7

SYNOPSIS

9       #include <sys/stream.h>
10       #include <sys/strsun.h>
11
12
13
14       void miocnak(queue_t *wq, mblk_t *mp, int count, int error);
15
16

INTERFACE LEVEL

18       Solaris DDI specific (Solaris DDI).
19

PARAMETERS

21       wq       Write  queue associated with the read queue to send the M_IOC‐
22                NAK on.
23
24
25       mp       M_IOCTL message.
26
27
28       count    Value to set the ioc_count of the iocblk(9S) to.
29
30
31       error    Value to set the ioc_error of the iocblk(9S) to.
32
33

DESCRIPTION

35       The miocnak() function converts an M_IOCTL  message  into  an  M_IOCNAK
36       message and sends the resulting message upstream.
37
38
39       To convert the message, miocnak() changes the message type to M_IOCNAK,
40       sets the ioc_count and ioc_error members of the  iocblk(9S)  associated
41       with  mp to the passed-in values, and clears the ioc_rval field.  Since
42       payloads cannot currently be associated with M_IOCNAK  messages,  count
43       must always be zero. If error is passed as zero, EINVAL is assumed.
44

RETURN VALUES

46       None.
47

CONTEXT

49       This function can be called from user, kernel or interrupt context.
50

NOTES

52       Callers must not hold any locks across a miocnak() that can be acquired
53       as part of put(9E) processing.
54