NAME    [Toc]    [Back]

       putctl1  -  Puts a control message with a 1-byte parameter
       on a queue

SYNOPSIS    [Toc]    [Back]

       #include <sys/stream.h>

       int putctl1(
               queue_t *queue_pointer,
               int type,
               int parameter );

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).  Specifies a 1-byte parameter.

DESCRIPTION    [Toc]    [Back]

       Like the putctl interface, the putctl1 interface tests the
       type  argument to make sure a data type was not specified.
       It then attempts to allocate a message block. In addition,
       the  putctl1  interface can send a 1-byte parameter in the
       parameter argument. You can use the parameter for any purpose.
  For  example,  you can use this argument to specify
       how long the delay will be when sending  an  M_DELAY  message.
  The putctl1 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  putctl1  interface  calls  the putctl_comm interface,
       which actually performs the work of  sending  the  control
       message.

RETURN VALUES    [Toc]    [Back]

       Upon  successful  completion, putctl1 returns the value 1.
       The putctl1 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: allocb(9r), datamsg(9r), putctl(9r)

       Programmer's Guide: STREAMS



                                                      putctl1(9r)