ZCOM C I/F Library Routines
ZREAD (3X)
|
| ZREAD (3X) |
|
NAME |
| zread – Read from ZLU |
|
SYNOPSIS |
|
| |
#include | <zcom/zcomsys.h> |
| |
#include | <zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */ | ||
int32 zread (zap, mode, mhp, ibuf, len, rlen, rstat) | |||
zaddr_type | *zap; |
| |
uint32 |
| mode; |
|
zmhd_type |
| *mhp; |
|
char |
| *ibuf; |
|
int32 |
| len; |
|
int32 |
| *rlen; |
|
int32 |
| *rstat; |
|
DESCRIPTION | Routine zread fetches the next message from the head of a program ZLU | ||
|
| queue. The program has the option to wait (i.e., suspend) if there is no | |
|
| data on the queue specified. The actual length of the data message is | |
|
| returned in rlen. |
|
|
| This routine is similar to zpeek(3X) except it removes the message after | |
|
| fetching it. |
|
|
| The libraries libzcom_c.a and libpthread.a must be linked into the calling | |
|
| program by giving the options | |
Threads |
| This routine may be called from a | |
Considerations | POSIX (1003.1c) kernel threads API package. This routine has the | ||
|
| following characteristics when called by a | |
|
| cancellation point | Thread cancellation can occur when a thread |
|
|
| calls this routine. |
296 | Chapter 4 |