gopenmax - set/get/reset the number of open file descriptors for GIO streams.

SYNOPSIS

#include "gio.h"
int gopenmax(GIO_OPEN_MAX_OPTION option, ...);

DESCRIPTION

This function provides a way for the application to set, get, or reset the maximum number of open file descriptors allowed within the GIO library. This is not a hard limit. It simply determines the point a which GFILE streams marked for file descriptor caching (as determined by a leading "c" in the type argument to gopen, or greopen) become candidates for temporary closing. Of these the stream with the least recently used file descriptor is selected for closing. If no such stream exists the GIO library will try to open new files anyway until a process or system limit is reached.

The argument option may be one of the following enumeration values: 

GIO_OPEN_MAX_GET    Return the current limit.

GIO_OPEN_MAX_SET    Set and return the new limit as
                    specified by the second argument,
                    a positive value of type int.

GIO_OPEN_MAX_INCR   Add to (or subtract from) the
                    current limit according to the
                    second argument, a positive 
                    (or negative) value of type int.
                    Return the new limit.

GIO_OPEN_MAX_RESET  Reset the limit to its default
                    value and return it. (This default
                    varies among operating systems.)

RETURN VALUE

The function returns the limit on open file descriptors after applying any changes requested by the arguments. If there is an error the function returns a negative value.

FILES

$DDSROOT/include/gio.h
$DDSROOT/lib/$TARCH/libgio.a

AUTHOR

T. A. Griffin, (Jan 1997)