NAME

hpib_eoi_ctl − control EOI mode for HP-IB file

SYNOPSIS

int hpib_eoi_ctl (eid, flag);
int eid, flag;

DESCRIPTION

Hpib_eoi_ctl enables you to turn EOI mode on or off.  Eid is an entity identifier of an open HP-IB raw device file obtained from an open(2), dup(2), fcntl(2), or creat(2) call.  Flag is an integer which, if non-zero, enables EOI mode, and otherwise disables it. 

EOI mode causes the last byte of all subsequent write  operations to be written out with the EOI line asserted,  signifying  the end of the data transmission.  By default, EOI mode is disabled when the device file is opened. 

Entity ids for the  same  device file  obtained  by  separate open(2) requests have  their own  EOI modes  associated with them.  Entity ids for  the same  device file obtained by dup(2) or inherited by a fork(2)  request share the same EOI mode.  In the  latter case,  if one  process  enables EOI mode,  then EOI mode is in  effect for all  such  entity ids. 

RETURN VALUE

Hpib_eoi_ctl returns a 0 (zero) if  successful, or −1 if an error was encountered. 

ERRORS

Hpib_eoi_ctl fails under any of 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 device file [ENOTTY]. 

HARDWARE DEPENDENCIES

Series 800
EOI mode is enabled when the device file is first opened.

EOI mode is associated with a given device.  Therefore, multiple opens of the same device share EOI mode. 

AUTHOR

Hpib_eoi_ctl was developed by HP. 

Hewlett-Packard Company  —  Version B.1,  May 11, 2021