/* * Copyright © 2007 Keith Packard * * Permission to use, copy, modify, distribute, and sell this software and its * documentation for any purpose is hereby granted without fee, provided that * the above copyright notice appear in all copies and that both that copyright * notice and this permission notice appear in supporting documentation, and * that the name of the copyright holders not be used in advertising or * publicity pertaining to distribution of the software without specific, * written prior permission. The copyright holders make no representations * about the suitability of this software for any purpose. It is provided "as * is" without express or implied warranty. * * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE * OF THIS SOFTWARE. */ @RET@ FcBool @FUNC@ FcDirCacheUnlink @TYPE1@ const FcChar8 * @ARG1@ dir @TYPE2@ FcConfig * @ARG2@ config @PURPOSE@ Remove all caches related to <parameter>dir</parameter> @DESC@ Scans the cache directories in <parameter>config</parameter>, removing any instances of the cache file for <parameter>dir</parameter>. Returns FcFalse when some internal error occurs (out of memory, etc). Errors actually unlinking any files are ignored. @@ @RET@ FcBool @FUNC@ FcDirCacheValid @TYPE1@ const FcChar8 * @ARG1@ dir @PURPOSE@ check directory cache @DESC@ Returns FcTrue if <parameter>dir</parameter> has an associated valid cache file, else returns FcFalse @@ @RET@ FcCache * @FUNC@ FcDirCacheLoad @TYPE1@ const FcChar8 * @ARG1@ dir @TYPE2@ FcConfig * @ARG2@ config @TYPE3@ FcChar8 ** @ARG3@ cache_file @PURPOSE@ load a directory cache @DESC@ Loads the cache related to <parameter>dir</parameter>. If no cache file exists, returns NULL. The name of the cache file is returned in <parameter>cache_file</parameter>, unless that is NULL. See also FcDirCacheRead. @@ @RET@ FcCache * @FUNC@ FcDirCacheRescan @TYPE1@ const FcChar8 * @ARG1@ dir @TYPE2@ FcConfig * @ARG2@ config @PURPOSE@ Re-scan a directory cache @DESC@ Re-scan directories only at <parameter>dir</parameter> and update the cache. returns NULL if failed. @SINCE@ 2.11.1 @@ @RET@ FcCache * @FUNC@ FcDirCacheRead @TYPE1@ const FcChar8 * @ARG1@ dir @TYPE2@ FcBool% @ARG2@ force @TYPE3@ FcConfig * @ARG3@ config @PURPOSE@ read or construct a directory cache @DESC@ This returns a cache for <parameter>dir</parameter>. If <parameter>force</parameter> is FcFalse, then an existing, valid cache file will be used. Otherwise, a new cache will be created by scanning the directory and that returned. @@ @RET@ FcCache * @FUNC@ FcDirCacheLoadFile @TYPE1@ const FcChar8 * @ARG1@ cache_file @TYPE2@ struct stat * @ARG2@ file_stat @PURPOSE@ load a cache file @DESC@ This function loads a directory cache from <parameter>cache_file</parameter>. If <parameter>file_stat</parameter> is non-NULL, it will be filled with the results of stat(2) on the cache file. @@ @RET@ void @FUNC@ FcDirCacheUnload @TYPE1@ FcCache * @ARG1@ cache @PURPOSE@ unload a cache file @DESC@ This function dereferences <parameter>cache</parameter>. When no other references to it remain, all memory associated with the cache will be freed. @@