HPlogo HP-UX Reference Volume 4 of 5 > h

hpib_eoi_ctl(3I)

Series 800 Only
» 

Technical documentation

Complete book in PDF

 » Table of Contents

 » Index

NAME

hpib_eoi_ctl() — control EOI mode for HP-IB file (OBSOLETED AT 10.30)

SYNOPSIS

#include <dvio.h>

int hpib_eoi_ctl(int eid, int 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(), dup(), fcntl(), or creat() 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 identifiers for the same device file obtained by separate open() requests have their own EOI modes associated with them. Entity identifiers for the same device file obtained by dup() or inherited by a fork() 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 identifiers.

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.

DEPENDENCIES

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

AUTHOR

hpib_eoi_ctl() was developed by HP.

© Hewlett-Packard Development Company, L.P.