Index for Section 9r

Alphabetical listing for I

Bottom of page

insq(9r)
NAME
  insq - STREAMS: Inserts a STREAMS message into a queue

SYNOPSIS
  #include <sys/stream.h>

  int insq(
	  queue_t *message_queue,
	  MBLKP message,
	  MBLKP message_to_be_inserted );

ARGUMENTS
  message_queue
      Specifies a pointer to the message queue that contains the message
      passed to the message argument. The typedef queue_t is an alternate
      name for struct queue_entry *.

  message
      Specifies the enqueued message before which the new message is to be
      inserted. The typedef MBLKP is an alternate name for typedef struct
      msgb *.

  message_to_be_inserted
      Specifies the message to be inserted. The typedef MBLKP is an alternate
      name for typedef struct msgb *.

DESCRIPTION
  The insq interface inserts a STREAMS message into a queue. The message to
  be inserted (the message_to_be_inserted argument) is placed in the queue
  (the message_queue argument) immediately before the message associated with
  the message argument. If the message argument is NULL, insq places the new
  message at the end of the queue. The interface ignores the queue class of
  the new message and it updates all flow-control parameters. The insq
  interface also enables the service procedure unless the QNOENB flag bit is
  set.

CAUTIONS
  If the message argument is non-NULL, it must point to a message on the
  queue or a system panic could occur.

RETURN VALUES
  Upon successful completion, insq returns the value 1. On failure, it
  returns the value zero (0).

SEE ALSO
  Programmer's Guide: STREAMS

Index for Section 9r

Alphabetical listing for I

Top of page