NAME

hpib_status_wait − wait until the requested status condition becomes true

SYNOPSIS

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

HP-UX COMPATIBILITY

Level: Device I/O Library − HP-UX/EXTENDED

Origin: HP

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. 

HARDWARE DEPENDENCIES

Series 500:
When an hpip_status_wait is in progress, all other bus activity is held off until it has completed. Therefore, it is strongly recommended that a timeout be in effect before all hpib_status_wait calls. 

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. 

DIAGNOSTICS

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

eid does not refer to an open file [EBADF];

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

a timeout occured [EIO];

status contains an invalid value [EINVAL]. 

Hewlett-Packard  —  last mod. May 11, 2021