Index for Section 9r

Alphabetical listing for P

Bottom of page

putctl(9r)
NAME
  putctl - STREAMS: Puts a control message on a queue

SYNOPSIS
  #include <sys/stream.h>

  int putctl(
	  queue_t *queue_pointer,
	  int type );

ARGUMENTS
  queue_pointer
      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 *.

  type
      Specifies a message type (must be control and not a data type).

DESCRIPTION
  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
  The putctl interface calls the putctl_comm interface, which actually
  performs the work of sending the control message.

RETURN VALUES
  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
  Kernel Interfaces: datamsg(9r), putctl1(9r)

Index for Section 9r

Alphabetical listing for P

Top of page