Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ ihint(3) — HP-UX Instrument Control Library C.03.01

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

igeterrno(3)

igeterrstr(3)

IHINT(3)

HP-UX

NAME

ihint − tells the driver the users transfer preference

SYNOPSIS

 #include <sicl.h>
 int ihint (INST id, int hint);
 

DESCRIPTION

Ihint tells the driver the users preference for I/O communications.  Hint can be one of the following values:
 

­I_HINT_DONTCARE The user has no preference.  The driver should use whatever mechanism it feels is appropriate.  This is the default action. 

­I_HINT_USEDMA The driver should use DMA if possible and feasible.  If DMA is not available or advisable, then use POLL. 

­I_HINT_USEPOLL The driver should use POLL if possible and feasible. This choice is almost always available.  If not, then the driver will choose between DMA and INTR. 

­I_HINT_USEINTR The driver should use INTR if possible and feasible.  If INTR is not available or advisable, then use POLL. 

­I_HINT_SYSTEM The driver should use whatever mechanism is best suited for improving overall system performance. 

­I_HINT_IO The driver should use whatever mechanism is best suited for improving I/O performance. 

RETURN VALUE

Ihint returns 0 on success, or a non-zero error number if an error occurred. 

ERRORS

Ihint fails under the following circumstances, and sets the return value to one of the following:
 

­[I_ERR_BADID] The INST id is invalid

 

SEE ALSO

igeterrno(3), igeterrstr(3)
 

AUTHOR

ihint was developed by HP. 

Hewlett-Packard Company  —  May 05, 1994

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026