HP-UX

NAME

iopen, iclose − will establish/close sessions for user applications

SYNOPSIS

#include <sicl.h>
INST iopen (char *addr);
 
int iclose (INST id);

DESCRIPTION

Iopen creates a session and returns a pointer to a data structure used by the library.  The addr parameter is used to specify which device, interface, or commander with which to communicate. 

Iclose routine will close a session.  Once this routine is called, the value given in the id parameter is no longer a valid INST pointer and may not be used again.  This routine will return 0 if successful, or non-zero if an error occurred. 

RETURN VALUE

The iopen returns a valid INST id if successful.  If a session cannot be established at this time, a ((INST)0) is returned. 

The iclose returns 0 if successful, or a non-zero error code if an error was encountered. 

ERRORS

The iopen fails under the following circumstances, and sets the error condition to one of the following values:
 

­[I_ERR_SYNTAX] addr has a syntax error

­[I_ERR_SYMNAME] Symbolic name given is invalid

­[I_ERR_NORSRC] Out of system resources

­[I_ERR_NOINTF] Inteface is not active

­[I_ERR_NODEV] Device is not active

The iclose 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

Iopen, iclose were developed by HP. 

Hewlett-Packard Company  —  September 29, 1999