SAMESTR(D3) SAMESTR(D3)
NAME
SAMESTR - test if next queue is of the same type
SYNOPSIS
#include <sys/stream.h>
#include <sys/ddi.h>
int SAMESTR(queue_t *q);
Arguments
q Pointer to the queue.
DESCRIPTION
The SAMESTR function checks whether the next queue in a stream
(if it exists) is of the same type as the current queue (that
is, both are read queues or both are write queues).
Return Values
SAMESTR returns 1 if the next queue is of the same type as the
current queue. It returns 0 if the next queue does not exist
or if it is not of the same type.
USAGE
This function can be used to determine the point in a
STREAMS-based pipe where a read queue is linked to a write
queue.
In multithreaded drivers, the q argument may not reference
q_next (for example, an argument of q->q_next is erroneous in
a multithreaded driver and is disallowed by the DDI/DKI).
Level
Base or Interrupt.
Synchronization Constraints
Does not sleep.
Driver-defined basic locks, read/write locks, and sleep locks
may be held across calls to this function.
The caller cannot have the stream frozen [see freezestr(D3)]
when calling this function.
Examples
See the put(D2) manual page for an example of SAMESTR.
Copyright 1994 Novell, Inc. Page 1
SAMESTR(D3) SAMESTR(D3)
REFERENCES
OTHERQ(D3)
NOTICES
Portability
All processors
Applicability
ddi: 1, 2, 3, 4, 5, 5mp, 6, 6mp, 7, 7mp
Copyright 1994 Novell, Inc. Page 2