IXTRIG(3)

HP-UX

NAME

ixtrig − sends a trigger to all devices on a specified interface.

SYNOPSIS

#include <sicl.h>
int ixtrig(
           INST id,
           unsigned long which;
          );

DESCRIPTION

ixtrig performs an interface trigger which is sent to all devices on the interface specified by id.

id is an INST identifier for a session obtained from an iopen(3) call. This routine only works on interface sessions.

The which parameter chooses what type of interface trigger to perform (some interfaces support several triggers.) The which parameter is a bit mask whose value is interface specific. However, all interfaces support the following standard trigger:

I_TRIG_STD

It is up to the particular interface to decide how to implement this trigger as well as other interface specfic triggers.

For HP-IB, I_TRIG_STD is defined to do a broadcast GET. Note that for HP-IB, I_TRIG_STD is the only value defined for which.

For VXI, I_TRIG_STD is defined to fire one or more of the VXI trigger lines. Which line is fired is determined by the system configuration. There are additional values defined for the which parameter for VXI. Any or all of these may be passed to the ixtrig command. They each cause the appropriate trigger line to fire:

I_TRIG_TTL0

I_TRIG_TTL1

I_TRIG_TTL2

I_TRIG_TTL3

I_TRIG_TTL4

I_TRIG_TTL5

I_TRIG_TTL6

I_TRIG_TTL7

I_TRIG_ECL0

I_TRIG_ECL1

I_TRIG_ECL2

RETURN VALUE

ixtrig returns (0) for success and a non-zero error code otherwise.

AUTHOR

ixtrig was developed by HP.