.TH "globus_gass_cache.h" 3 "Version 10.3" "globus_gass_cache" \" -*- nroff -*-
.ad l
.nh
.SH NAME
globus_gass_cache.h \- GASS Cache API\&.  

.SH SYNOPSIS
.br
.PP
\fC#include 'globus_common\&.h'\fP
.br
\fC#include <sys/param\&.h>\fP
.br

.SS "Macros"

.in +1c
.ti -1c
.RI "#define \fBGLOBUS_GASS_CACHE_MODULE\fP   (&globus_i_gass_cache_module)"
.br
.RI "module_descriptor "
.in -1c
.SS "Typedefs"

.in +1c
.ti -1c
.RI "typedef struct globus_i_gass_cache_t * \fBglobus_gass_cache_t\fP"
.br
.RI "GASS Cache Handle\&. "
.in -1c
.SS "Functions"

.in +1c
.ti -1c
.RI "int \fBglobus_gass_cache_open\fP (const char *cache_directory_path, \fBglobus_gass_cache_t\fP *cache_handle)"
.br
.RI "Open a GASS Cache\&. "
.ti -1c
.RI "int \fBglobus_gass_cache_close\fP (\fBglobus_gass_cache_t\fP *cache_handle)"
.br
.RI "Close a cache handle\&. "
.ti -1c
.RI "int \fBglobus_gass_cache_add\fP (\fBglobus_gass_cache_t\fP cache_handle, const char *url, const char *tag, globus_bool_t create, unsigned long *timestamp, char **local_filename)"
.br
.RI "Add a tag to an URL in the cache\&. "
.ti -1c
.RI "int \fBglobus_gass_cache_add_done\fP (\fBglobus_gass_cache_t\fP cache_handle, const char *url, const char *tag, unsigned long timestamp)"
.br
.RI "Complete adding a cache entry and unlock it\&. "
.ti -1c
.RI "int \fBglobus_gass_cache_query\fP (\fBglobus_gass_cache_t\fP cache_handle, const char *url, const char *tag, globus_bool_t wait_for_lock, unsigned long *timestamp, char **local_filename, globus_bool_t *is_locked)"
.br
.RI "Query the GASS Cache\&. "
.ti -1c
.RI "int \fBglobus_gass_cache_delete_start\fP (\fBglobus_gass_cache_t\fP cache_handle, const char *url, const char *tag, unsigned long *timestamp)"
.br
.RI "Remove a cache tag\&. "
.ti -1c
.RI "int \fBglobus_gass_cache_delete\fP (\fBglobus_gass_cache_t\fP cache_handle, const char *url, const char *tag, unsigned long timestamp, globus_bool_t is_locked)"
.br
.RI "Remove one instance of the tag from the cache entry's tag list\&. "
.ti -1c
.RI "int \fBglobus_gass_cache_cleanup_tag\fP (\fBglobus_gass_cache_t\fP cache_handle, const char *url, const char *tag)"
.br
.RI "Remove a tag from a cache entry\&. "
.ti -1c
.RI "int \fBglobus_gass_cache_cleanup_tag_all\fP (\fBglobus_gass_cache_t\fP cache_handle, char *tag)"
.br
.RI "Remove a tag from all cache entries
.PP
Remove all instances of the tag from the cache entry's tag list\&. If there are no more tags in the tag list, then remove this cache entry and delete the associated local cache file\&. If the cache entry is locked with the same tag as is passed to this function, then the entry is unlocked after removing the tags\&. Otherwise, the cache entry's lock is left untouched\&. "
.ti -1c
.RI "int \fBglobus_gass_cache_mangle_url\fP (const \fBglobus_gass_cache_t\fP cache_handle, const char *url, char **mangled_url, int *length)"
.br
.RI "Convert a URL to a string suitable as a file path\&. "
.ti -1c
.RI "int \fBglobus_gass_cache_mangle_tag\fP (const \fBglobus_gass_cache_t\fP cache_handle, const char *tag, char **mangled_tag, int *length)"
.br
.RI "Convert a tag to a string suitable as a file path\&. "
.ti -1c
.RI "int \fBglobus_gass_cache_get_dirs\fP (const \fBglobus_gass_cache_t\fP cache_handle, const char *url, const char *tag, char **global_root, char **local_root, char **tmp_root, char **log_root, char **global_dir, char **local_dir)"
.br
.RI "Get the set of directories used by a GASS Cache\&. "
.ti -1c
.RI "int \fBglobus_gass_cache_get_cache_dir\fP (const \fBglobus_gass_cache_t\fP cache_handle, char **cache_dir)"
.br
.RI "Get the GASS Cache's root directory\&. "
.ti -1c
.RI "int \fBglobus_gass_cache_get_cache_type_string\fP (const \fBglobus_gass_cache_t\fP cache_handle, char **cache_type)"
.br
.RI "Get the type of GASS Cache directory layout\&. "
.ti -1c
.RI "const char * \fBglobus_gass_cache_error_string\fP (int error_code)"
.br
.RI "Look up the error string corresponding to a GASS Cache error\&. "
.in -1c
.SH "Detailed Description"
.PP 
GASS Cache API\&. 


.SH "Author"
.PP 
Generated automatically by Doxygen for globus_gass_cache from the source code\&.