putbq(9f) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

putbq(9f)

putbq(9F)                      Kernel Functions                      putbq(9F)

NAME
       putbq - place a message at the head of a queue

SYNOPSIS
       #include <sys/stream.h>

       int putbq(queue_t *q, mblk_t *bp);

INTERFACE LEVEL
       Architecture independent level 1 (DDI/DKI).

PARAMETERS
       q     Pointer to the queue.


       bp    Pointer to the message block.


DESCRIPTION
       The putbq() function places a message at the beginning of the appropri‐
       ate  section  of  the message queue. There are always sections for high
       priority and ordinary messages. If other priority bands are used,  each
       will  have  its own section of the queue, in priority band order, after
       high priority messages and before ordinary  messages.  putbq()  can  be
       used  for ordinary, priority band, and high priority messages. However,
       unless precautions are taken, using putbq() with a high  priority  mes‐
       sage  is likely to lead to an infinite loop of putting the message back
       on the queue, being rescheduled, pulling it off, and  putting  it  back
       on.


       This  function  is usually called when bcanput(9F) or canput(9F) deter‐
       mines that the message cannot be passed on to the  next  stream  compo‐
       nent.  The flow control parameters are updated to reflect the change in
       the queue's status. If QNOENB is not set, the service  routine  is  en‐
       abled.

RETURN VALUES
       The putbq() function returns 1 upon success and 0 upon failure.


       Upon failure, the caller should call freemsg(9F) to free the pointer to
       the message block.

CONTEXT
       The putbq() function can be called from user, interrupt, or kernel con‐
       text.

EXAMPLES
       See the bufcall(9F) function page for an example of putbq().

SEE ALSO
       bcanput(9F), bufcall(9F), canput(9F), getq(9F), putq(9F)


       Writing Device Drivers in Oracle Solaris 11.4


       STREAMS Programming Guide

Oracle Solaris 11.4               16 Jan 2006                        putbq(9F)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3