vtclose

Close the least recently used c-tree Plus virtual file.

Short Name

vtclose()

Type

Utility function

Declaration

  COUNT vtclose()

Description

vtclose() frees an operating system file descriptor by closing the least recently used open c-tree Plus virtual file. In other words, the c-tree Plus virtual file that has not been accessed for the longest period of time will be closed to the operating system, freeing up an operating system file descriptor.

Each time this function is called, c-tree Plus attempts to free one operating system file descriptor.

Note: This function can impose a layer of overhead in Standalone Multi-user systems, especially in heavily loaded network environments. Rather than virtually closing files, it is preferable to increase the number of available operating system file descriptors. This is typically done through the C compiler run-time on non-Unix systems and in the operating system kernel for most Unix systems.

Note: This function is intended for non-server operation, including local library support. If a client side application calls this function, it is ignored so the application does not require special treatment when linking with different c-tree Plus libraries.

Return

vtclose() returns either YES (1) or NO (0). YES signifies a file handle was made available, NO signifies a file handle could not be freed.