HP UX 11i v1 I/O Cards manual 148

Models: UX 11i v1 I/O Cards

1 298
Download 298 pages 31.75 Kb
Page 148
Image 148

ZCOM C I/F Library Routines

LTQDPUT (3X)

Threads

This routine may be called from a multi-threaded application using the

Considerations

POSIX (1003.1c) kernel threads API package. This routine has the

 

following characteristics when called by a multi-threaded application:

cancellation point

 

Thread cancellation can occur when a thread calls this

 

 

routine.

async-cancel unsafe

 

The calling thread’s cancelability type must be

 

 

PTHREAD_CANCEL_DEFERRED if cancellation is

 

 

enabled.

async-signal unsafe

 

It cannot be called from a signal handler.

fork unsafe

 

It cannot be called by a child process after fork(2) but

 

 

before exec(2).

PARAMETERS

 

 

zap

ZCOM address of the terminal ZLU to store data into.

queue

Terminal data queue number (specifies which data queue

 

is to be used):

 

0

- Sub-packet holding queue (reserved)

 

1

- Data holding queue A

 

2

- Data holding queue B

 

3

- Data holding queue C

 

4

- Data holding queue D

ibuf

Data buffer to be stored.

len

Length in bytes of ibuf.

NOTES

Normally, the data queue number used should be allocated by ZMON (see the man page for zltqueue on how to get a data queue number). There is no queue ownership validation within this routine; it is up to the user to make sure that the queue usage is valid and consistent.

148

Chapter 4

Page 148
Image 148
HP UX 11i v1 I/O Cards manual 148