ibrd

Name

ibrd -- read data bytes (board or device)

Synopsis

#include <gpib/ib.h>

int ibrd(int ud, void *buffer, long num_bytes);

Description

ibrd() is used to read data bytes from a device or board. The argument ud can be either a device or board descriptor. Up to num_bytes bytes are read into the user-supplied array buffer. The read may be terminated by a timeout occuring(see ibtmo()), the talker asserting the EOI line, the board receiving the end-of-string character (see ibeos()), receiving a device clear command, or receiving an interface clear.

If ud is a device descriptor, then the library automatically handles addressing the device as talker and the interface board as listener before performing the read.

If ud is a board descriptor, no addressing is performed and the board must be addressed as a listener by the controller-in-charge.

After the ibrd() call, ibcnt and ibcntl are set to the number of bytes read.

Return value

The value of ibsta is returned.