Index for Section 9r

Alphabetical listing for P

Bottom of page

putctl1(9r)
NAME
  putctl1 - Puts a control message with a 1-byte parameter on a queue

SYNOPSIS
  #include <sys/stream.h>

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

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).

  parameter
      Specifies a 1-byte parameter.

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

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

  Programmer's Guide: STREAMS

Index for Section 9r

Alphabetical listing for P

Top of page