NAME    [Toc]    [Back]

       putctl - STREAMS: Puts a control message on a queue

SYNOPSIS    [Toc]    [Back]

       #include <sys/stream.h>

       int putctl(
               queue_t *queue_pointer,
               int type );

ARGUMENTS    [Toc]    [Back]

       Specifies  a  pointer to the queue to which the message is
       to be sent. The typedef queue_t is an alternate  name  for
       struct  queue_entry  *.  Specifies a message type (must be
       control and not a data type).

DESCRIPTION    [Toc]    [Back]

       The putctl interface tests the type argument to make  sure
       a  data  type was not specified. It then attempts to allocate
 a message block. The putctl interface fails if a message
  block cannot be allocated or if the type argument is
       M_DELAY, M_PROTO, or M_PCPROTO.

NOTES    [Toc]    [Back]

       The putctl  interface  calls  the  putctl_comm  interface,
       which  actually  performs  the work of sending the control
       message.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, putctl returns  the  value  1.
       The  putctl  interface  fails if a message block cannot be
       allocated or if the type argument is M_DELAY, M_PROTO,  or
       M_PCPROTO.

SEE ALSO    [Toc]    [Back]

       Kernel Interfaces: datamsg(9r), putctl1(9r)



                                                       putctl(9r)