Removes a cache entry from a cache that is associated with a Fast Response Cache Accelerator (FRCA) instance.
FRCA Library (libfrca.a)
#include <frca.h>
int32_t FrcaCacheUnoadFile ( CacheHandle, FrcaHandle, FileSpec);
int32_t CacheHandle;
int32_t FrcaHandle;
frca_filespec_t * FileSpec;
The FrcaCacheUnoadFile subroutine removes a cache entry from an existing cache instance for an previously configured FRCA instance.
| CacheHandle | Identifies the cache instance from which the entry should be removed. |
| FrcaHandle | Identifies the FRCA instance to which the cache instance belongs. |
| FileSpec | Points to a frca_loadfile_t structure, which specifies
characteristics used to identify the cache entry that is to be removed from
the given cache. The structure contains the following members:
uint32_t cacheEntryType; char * fileName; char * virtualHost; char * searchKey;
Note: Structure members do not necessarily appear in this order.
|
Note: The FrcaCacheUnoadFile subroutine succeeds if a cache entry with the same type, file name, virtual host, and search key does not exist. This subroutine fails if the file associated with fileName does not exist or if the calling process does not have sufficient access permissions.
| 0 | The subroutine completed successfully. |
| -1 | The subroutine failed. The global variable errno is set to indicate the specific type of error. |
| EINVAL | The FileSpec parameter is zero or the cacheEntryType component is not set to FCTRL_CET_HTTPFILE or the searchKey component is zero or the fileName is '/' or the fileName is not an absolute path. |
| EFAULT | The FileSpec parameter or one of the components points to an invalid address. |
| EACCES | Access permission is denied on the fileName. |
The FrcaCacheCreate subroutine, the FrcaCacheDelete subroutine, the FrcaCacheLoadFile subroutine, the FrcaCtrlCreate subroutine, the FrcaCtrlDelete subroutine, the FrcaCtrlLog subroutine, the FrcaCtrlStart subroutine, the FrcaCtrlStop subroutine.