NAME

hpib_status_wait − wait until the requested status condition becomes true

SYNOPSIS

int hpib_status_wait (eid, status);
int eid,status;

DESCRIPTION

Hpib_status_wait enables you to wait until a specific condition  has  occurred before  returning.  Eid is an entity identifier of an open HP-IB raw bus device file obtained from an open(2), dup(2), fcntl(2), or creat(2) call.  Status is an integer specifying what information is returned.  The possible values for status and their associated meanings are:

Status Meaning

  1 Wait until the SRQ line is enabled. 

  4 Wait until this channel is the active controller. 

  5 Wait until this channel is addressed as talker. 

  6 Wait until this channel is addressed as listener. 

The  wait  is subject to the current timeout in effect. If a timeout occurs before the  desired  condition  occurs,  the  function returns with an error. 

RETURN VALUE

Hpib_status_wait returns zero when the  condition  requested becomes true. A value of −1 is returned if an error occurs. A −1 is also  returned if a  timeout  occurs before the desired condition becomes true. 

ERRORS

Hpib_status_wait fails under the following circumstances, and sets errno (see errno(2)) to the value in square brackets:

­[EBADF] eid does not refer to an open file. 

­[ENOTTY] eid does not refer to an HP-IB raw bus device file. 

­[EIO] a timeout occurred. 

­[EINVAL] status contains an invalid value. 

AUTHOR

Hpib_status_wait was developed by the Hewlett-Packard Company. 

Hewlett-Packard Company  —  May 11, 2021