IGETINTFSESS(3)
HP-UX
NAME
igetintfsess − Returns the interface session associated with given device session.
SYNOPSIS
#include <sicl.h>
INST igetintfsess (INST id);
DESCRIPTION
The igetintfsess function takes the device session specified by id and returns a new INST id that refers to an interface session associated with the interface that the device is on.
Most SICL applications will take advantage of the benefits of device sessions and not want to bother with interface sessions. Since some functions only work on device sessions and others only work on interface sessions, occasionally it is necessary to perform functions on an interface session, when only a device session is available for use. An example is to perform an interface clear (see iclear) from within an SRQ handler (see ionsrq).
In addition, multiple calls to igetintfsess with the same id will return the same interface session each time. This makes this function useful as a filter, taking a device session in and returning an interface session.
RETURN VALUE
igetintfsess returns (0) if successful, or a non-zero error code if an error was encountered.
ERRORS
igetintfsess fails under the following circumstances, and sets the return value to one of the following:
[I_ERR_NORSRC] Out of system resources
[I_ERR_NOINTF] Interface is not active
[I_ERR_NODEV] Device is not active
[I_ERR_BADID] The INST id is invalid
[I_ERR_BADADDR] Invalid address (device/interface doesn’t exist)
SEE ALSO
AUTHOR
igetintfsess was developed by HP.
Hewlett-Packard Company — September 29, 1999