kFsCache.h@ 3324

Last change on this file since 3324 was 3199, checked in by bird, 7 years ago
kmk,kWorker: Catch output from kWorker processes when --output-sync isn't 'none'.
Property svn:eol-style set to `native` Property svn:keywords set to `Id`
File size: 21.2 KB

Line
1	/* $Id: kFsCache.h 3199 2018-03-28 18:56:21Z bird $ */
2	/** @file
3	* kFsCache.c - NT directory content cache.
4	*/
5
6	/*
7	* Copyright (c) 2016 knut st. osmundsen <[email protected]>
8	*
9	* Permission is hereby granted, free of charge, to any person obtaining a
10	* copy of this software and associated documentation files (the "Software"),
11	* to deal in the Software without restriction, including without limitation
12	* the rights to use, copy, modify, merge, publish, distribute, sublicense,
13	* and/or sell copies of the Software, and to permit persons to whom the
14	* Software is furnished to do so, subject to the following conditions:
15	*
16	* The above copyright notice and this permission notice shall be included
17	* in all copies or substantial portions of the Software.
18	*
19	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20	* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21	* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22	* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23	* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
24	* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
25	* IN THE SOFTWARE.
26	*
27	* Alternatively, the content of this file may be used under the terms of the
28	* GPL version 2 or later, or LGPL version 2.1 or later.
29	*/
30
31	#ifndef ___lib_nt_kFsCache_h___
32	#define ___lib_nt_kFsCache_h___
33
34
35	#include <k/kHlp.h>
36	#include "ntstat.h"
37	#ifndef NDEBUG
38	# include <stdarg.h>
39	#endif
40
41
42	/** @def KFSCACHE_CFG_UTF16
43	* Whether to compile in the UTF-16 names support. */
44	#define KFSCACHE_CFG_UTF16 1
45	/** @def KFSCACHE_CFG_SHORT_NAMES
46	* Whether to compile in the short name support. */
47	#define KFSCACHE_CFG_SHORT_NAMES 1
48	/** @def KFSCACHE_CFG_PATH_HASH_TAB_SIZE
49	* Size of the path hash table. */
50	#define KFSCACHE_CFG_PATH_HASH_TAB_SIZE 99991
51	/** The max length paths we consider. */
52	#define KFSCACHE_CFG_MAX_PATH 1024
53	/** The max ANSI name length. */
54	#define KFSCACHE_CFG_MAX_ANSI_NAME (256*3 + 16)
55	/** The max UTF-16 name length. */
56	#define KFSCACHE_CFG_MAX_UTF16_NAME (256*2 + 16)
57	/** Enables locking of the cache and thereby making it thread safe. */
58	#define KFSCACHE_CFG_LOCKING 1
59
60
61
62	/** Special KFSOBJ::uCacheGen number indicating that it does not apply. */
63	#define KFSOBJ_CACHE_GEN_IGNORE KU32_MAX
64
65
66	/** @name KFSOBJ_TYPE_XXX - KFSOBJ::bObjType
67	* @{ */
68	/** Directory, type KFSDIR. */
69	#define KFSOBJ_TYPE_DIR KU8_C(0x01)
70	/** Regular file - type KFSOBJ. */
71	#define KFSOBJ_TYPE_FILE KU8_C(0x02)
72	/** Other file - type KFSOBJ. */
73	#define KFSOBJ_TYPE_OTHER KU8_C(0x03)
74	/** Caching of a negative result - type KFSOBJ.
75	* @remarks We will allocate enough space for the largest cache node, so this
76	* can metamorph into any other object should it actually turn up. */
77	#define KFSOBJ_TYPE_MISSING KU8_C(0x04)
78	///** Invalidated entry flag. */
79	//#define KFSOBJ_TYPE_F_INVALID KU8_C(0x20)
80	/** @} */
81
82	/** @name KFSOBJ_F_XXX - KFSOBJ::fFlags
83	* @{ */
84	/** Use custom generation.
85	* @remarks This is given the value 1, as we use it as an index into
86	* KFSCACHE::auGenerations, 0 being the default. */
87	#define KFSOBJ_F_USE_CUSTOM_GEN KU32_C(0x00000001)
88
89	/** Whether the file system update the modified timestamp of directories
90	* when something is removed from it or added to it.
91	* @remarks They say NTFS is the only windows filesystem doing this. */
92	#define KFSOBJ_F_WORKING_DIR_MTIME KU32_C(0x00000002)
93	/** NTFS file system volume. */
94	#define KFSOBJ_F_NTFS KU32_C(0x80000000)
95	/** Flags that are automatically inherited. */
96	#define KFSOBJ_F_INHERITED_MASK KU32_C(0xffffffff)
97	/** @} */
98
99
100	#define IS_ALPHA(ch) ( ((ch) >= 'A' && (ch) <= 'Z') \|\| ((ch) >= 'a' && (ch) <= 'z') )
101	#define IS_SLASH(ch) ((ch) == '\\' \|\| (ch) == '/')
102
103
104
105
106	/** Pointer to a cache. */
107	typedef struct KFSCACHE *PKFSCACHE;
108	/** Pointer to a core object. */
109	typedef struct KFSOBJ *PKFSOBJ;
110	/** Pointer to a directory object. */
111	typedef struct KFSDIR *PKFSDIR;
112	/** Pointer to a directory hash table entry. */
113	typedef struct KFSOBJHASH *PKFSOBJHASH;
114
115
116
117	/** Pointer to a user data item. */
118	typedef struct KFSUSERDATA *PKFSUSERDATA;
119	/**
120	* User data item associated with a cache node.
121	*/
122	typedef struct KFSUSERDATA
123	{
124	/** Pointer to the next piece of user data. */
125	PKFSUSERDATA pNext;
126	/** The key identifying this user. */
127	KUPTR uKey;
128	/** The destructor. */
129	void (*pfnDestructor)(PKFSCACHE pCache, PKFSOBJ pObj, PKFSUSERDATA pData);
130	} KFSUSERDATA;
131
132
133	/**
134	* Storage for name strings for the unlikely event that they should grow in
135	* length after the KFSOBJ was created.
136	*/
137	typedef struct KFSOBJNAMEALLOC
138	{
139	/** Size of the allocation. */
140	KU32 cb;
141	/** The space for names. */
142	char abSpace[1];
143	} KFSOBJNAMEALLOC;
144	/** Name growth allocation. */
145	typedef KFSOBJNAMEALLOC *PKFSOBJNAMEALLOC;
146
147
148	/**
149	* Base cache node.
150	*/
151	typedef struct KFSOBJ
152	{
153	/** Magic value (KFSOBJ_MAGIC). */
154	KU32 u32Magic;
155	/** Number of references. */
156	KU32 volatile cRefs;
157	/** The cache generation, see KFSOBJ_CACHE_GEN_IGNORE. */
158	KU32 uCacheGen;
159	/** The object type, KFSOBJ_TYPE_XXX. */
160	KU8 bObjType;
161	/** Set if the Stats member is valid, clear if not. */
162	KBOOL fHaveStats;
163	/** Unused flags. */
164	KBOOL abUnused[2];
165	/** Flags, KFSOBJ_F_XXX. */
166	KU32 fFlags;
167
168	/** Hash value of the name inserted into the parent hash table.
169	* This is 0 if not inserted. Names are only hashed and inserted as they are
170	* first found thru linear searching of its siblings, and which name it is
171	* dependens on the lookup function (W or A) and whether the normal name or
172	* short name seems to have matched.
173	*
174	* @note It was ruled out as too much work to hash and track all four names,
175	* so instead this minimalist approach was choosen in stead. */
176	KU32 uNameHash;
177	/** Pointer to the next child with the same name hash value. */
178	PKFSOBJ pNextNameHash;
179	/** Pointer to the parent (directory).
180	* This is only NULL for a root. */
181	PKFSDIR pParent;
182
183	/** The directory name. (Allocated after the structure.) */
184	const char *pszName;
185	/** The length of pszName. */
186	KU16 cchName;
187	/** The length of the parent path (up to where pszName starts).
188	* @note This is valuable when constructing an absolute path to this node by
189	* means of the parent pointer (no need for recursion). */
190	KU16 cchParent;
191	#ifdef KFSCACHE_CFG_UTF16
192	/** The length of pwszName (in wchar_t's). */
193	KU16 cwcName;
194	/** The length of the parent UTF-16 path (in wchar_t's).
195	* @note This is valuable when constructing an absolute path to this node by
196	* means of the parent pointer (no need for recursion). */
197	KU16 cwcParent;
198	/** The UTF-16 object name. (Allocated after the structure.) */
199	const wchar_t *pwszName;
200	#endif
201
202	#ifdef KFSCACHE_CFG_SHORT_NAMES
203	/** The short object name. (Allocated after the structure, could be same
204	* as pszName.) */
205	const char *pszShortName;
206	/** The length of pszShortName. */
207	KU16 cchShortName;
208	/** The length of the short parent path (up to where pszShortName starts). */
209	KU16 cchShortParent;
210	# ifdef KFSCACHE_CFG_UTF16
211	/** The length of pwszShortName (in wchar_t's). */
212	KU16 cwcShortName;
213	/** The length of the short parent UTF-16 path (in wchar_t's). */
214	KU16 cwcShortParent;
215	/** The UTF-16 short object name. (Allocated after the structure, possibly
216	* same as pwszName.) */
217	const wchar_t *pwszShortName;
218	# endif
219	#endif
220
221	/** Allocation for handling name length increases. */
222	PKFSOBJNAMEALLOC pNameAlloc;
223
224	/** Pointer to the first user data item */
225	PKFSUSERDATA pUserDataHead;
226
227	/** Stats - only valid when fHaveStats is set. */
228	BirdStat_T Stats;
229	} KFSOBJ;
230
231	/** The magic for a KFSOBJ structure (Thelonious Sphere Monk). */
232	#define KFSOBJ_MAGIC KU32_C(0x19171010)
233
234
235	/**
236	* Directory node in the cache.
237	*/
238	typedef struct KFSDIR
239	{
240	/** The core object information. */
241	KFSOBJ Obj;
242
243	/** Child objects. */
244	PKFSOBJ *papChildren;
245	/** The number of child objects. */
246	KU32 cChildren;
247	/** The allocated size of papChildren. */
248	KU32 cChildrenAllocated;
249
250	/** Pointer to the child hash table. */
251	PKFSOBJ *papHashTab;
252	/** The mask shift of the hash table.
253	* Hash table size is a power of two, this is the size minus one.
254	*
255	* @remarks The hash table is optional and populated by lookup hits. The
256	* assumption being that a lookup is repeated and will choose a good
257	* name to hash on. We've got up to 4 different hashes, so this
258	* was the easy way out. */
259	KU32 fHashTabMask;
260
261	/** Handle to the directory (we generally keep it open). */
262	#ifndef DECLARE_HANDLE
263	KUPTR hDir;
264	#else
265	HANDLE hDir;
266	#endif
267	/** The device number we queried/inherited when opening it. */
268	KU64 uDevNo;
269
270	/** The last write time sampled the last time the directory was refreshed.
271	* @remarks May differ from st_mtim because it will be updated when the
272	* parent directory is refreshed. */
273	KI64 iLastWrite;
274
275	/** Set if populated. */
276	KBOOL fPopulated;
277	/** Set if it needs re-populated. */
278	KBOOL fNeedRePopulating;
279	} KFSDIR;
280
281
282	/**
283	* Lookup errors.
284	*/
285	typedef enum KFSLOOKUPERROR
286	{
287	/** Lookup was a success. */
288	KFSLOOKUPERROR_SUCCESS = 0,
289	/** A path component was not found. */
290	KFSLOOKUPERROR_PATH_COMP_NOT_FOUND,
291	/** A path component is not a directory. */
292	KFSLOOKUPERROR_PATH_COMP_NOT_DIR,
293	/** The final path entry is not a directory (trailing slash). */
294	KFSLOOKUPERROR_NOT_DIR,
295	/** Not found. */
296	KFSLOOKUPERROR_NOT_FOUND,
297	/** The path is too long. */
298	KFSLOOKUPERROR_PATH_TOO_LONG,
299	/** Unsupported path type. */
300	KFSLOOKUPERROR_UNSUPPORTED,
301	/** We're out of memory. */
302	KFSLOOKUPERROR_OUT_OF_MEMORY,
303
304	/** Error opening directory. */
305	KFSLOOKUPERROR_DIR_OPEN_ERROR,
306	/** Error reading directory. */
307	KFSLOOKUPERROR_DIR_READ_ERROR,
308	/** UTF-16 to ANSI conversion error. */
309	KFSLOOKUPERROR_ANSI_CONVERSION_ERROR,
310	/** ANSI to UTF-16 conversion error. */
311	KFSLOOKUPERROR_UTF16_CONVERSION_ERROR,
312	/** Internal error. */
313	KFSLOOKUPERROR_INTERNAL_ERROR
314	} KFSLOOKUPERROR;
315
316
317	/** Pointer to an ANSI path hash table entry. */
318	typedef struct KFSHASHA *PKFSHASHA;
319	/**
320	* ANSI file system path hash table entry.
321	* The path hash table allows us to skip parsing and walking a path.
322	*/
323	typedef struct KFSHASHA
324	{
325	/** Next entry with the same hash table slot. */
326	PKFSHASHA pNext;
327	/** Path hash value. */
328	KU32 uHashPath;
329	/** The path length. */
330	KU16 cchPath;
331	/** Set if aboslute path. */
332	KBOOL fAbsolute;
333	/** Index into KFSCACHE:auGenerationsMissing when pFsObj is NULL. */
334	KU8 idxMissingGen;
335	/** The cache generation ID. */
336	KU32 uCacheGen;
337	/** The lookup error (when pFsObj is NULL). */
338	KFSLOOKUPERROR enmError;
339	/** The path. (Allocated after the structure.) */
340	const char *pszPath;
341	/** Pointer to the matching FS object.
342	* This is NULL for negative path entries? */
343	PKFSOBJ pFsObj;
344	} KFSHASHA;
345
346
347	#ifdef KFSCACHE_CFG_UTF16
348	/** Pointer to an UTF-16 path hash table entry. */
349	typedef struct KFSHASHW *PKFSHASHW;
350	/**
351	* UTF-16 file system path hash table entry. The path hash table allows us
352	* to skip parsing and walking a path.
353	*/
354	typedef struct KFSHASHW
355	{
356	/** Next entry with the same hash table slot. */
357	PKFSHASHW pNext;
358	/** Path hash value. */
359	KU32 uHashPath;
360	/** The path length (in wchar_t units). */
361	KU16 cwcPath;
362	/** Set if aboslute path. */
363	KBOOL fAbsolute;
364	/** Index into KFSCACHE:auGenerationsMissing when pFsObj is NULL. */
365	KU8 idxMissingGen;
366	/** The cache generation ID. */
367	KU32 uCacheGen;
368	/** The lookup error (when pFsObj is NULL). */
369	KFSLOOKUPERROR enmError;
370	/** The path. (Allocated after the structure.) */
371	const wchar_t *pwszPath;
372	/** Pointer to the matching FS object.
373	* This is NULL for negative path entries? */
374	PKFSOBJ pFsObj;
375	} KFSHASHW;
376	#endif
377
378
379	/** @def KFSCACHE_LOCK
380	* Locks the cache exclusively. */
381	/** @def KFSCACHE_UNLOCK
382	* Counterpart to KFSCACHE_LOCK. */
383	#ifdef KFSCACHE_CFG_LOCKING
384	# define KFSCACHE_LOCK(a_pCache) EnterCriticalSection(&(a_pCache)->u.CritSect)
385	# define KFSCACHE_UNLOCK(a_pCache) LeaveCriticalSection(&(a_pCache)->u.CritSect)
386	#else
387	# define KFSCACHE_LOCK(a_pCache) do { } while (0)
388	# define KFSCACHE_UNLOCK(a_pCache) do { } while (0)
389	#endif
390
391
392	/** @name KFSCACHE_F_XXX
393	* @{ */
394	/** Whether to cache missing directory entries (KFSOBJ_TYPE_MISSING). */
395	#define KFSCACHE_F_MISSING_OBJECTS KU32_C(0x00000001)
396	/** Whether to cache missing paths. */
397	#define KFSCACHE_F_MISSING_PATHS KU32_C(0x00000002)
398	/** @} */
399
400
401	/**
402	* Directory cache instance.
403	*/
404	typedef struct KFSCACHE
405	{
406	/** Magic value (KFSCACHE_MAGIC). */
407	KU32 u32Magic;
408	/** Cache flags. */
409	KU32 fFlags;
410
411	/** The default and custom cache generations for stuff that exists, indexed by
412	* KFSOBJ_F_USE_CUSTOM_GEN.
413	*
414	* The custom generation can be used to invalidate parts of the file system that
415	* are known to be volatile without triggering refreshing of the more static
416	* parts. Like the 'out' directory in a kBuild setup or a 'TEMP' directory are
417	* expected to change and you need to invalidate the caching of these frequently
418	* to stay on top of things. Whereas the sources, headers, compilers, sdk,
419	* ddks, windows directory and such generally doesn't change all that often.
420	*/
421	KU32 auGenerations[2];
422	/** The current cache generation for missing objects, negative results, ++.
423	* This comes with a custom variant too. Indexed by KFSOBJ_F_USE_CUSTOM_GEN. */
424	KU32 auGenerationsMissing[2];
425
426	/** Number of cache objects. */
427	KSIZE cObjects;
428	/** Memory occupied by the cache object structures. */
429	KSIZE cbObjects;
430	/** Number of lookups. */
431	KSIZE cLookups;
432	/** Number of hits in the path hash tables. */
433	KSIZE cPathHashHits;
434	/** Number of hits walking the file system hierarchy. */
435	KSIZE cWalkHits;
436	/** Number of child searches. */
437	KSIZE cChildSearches;
438	/** Number of cChildLookups resolved thru hash table hits. */
439	KSIZE cChildHashHits;
440	/** The number of child hash tables. */
441	KSIZE cChildHashTabs;
442	/** The sum of all child hash table sizes. */
443	KSIZE cChildHashEntriesTotal;
444	/** Number of children inserted into the hash tables. */
445	KSIZE cChildHashed;
446	/** Number of collisions in the child hash tables. */
447	KSIZE cChildHashCollisions;
448	/** Number times a object name changed. */
449	KSIZE cNameChanges;
450	/** Number times a object name grew and needed KFSOBJNAMEALLOC.
451	* (Subset of cNameChanges) */
452	KSIZE cNameGrowths;
453
454	/** The root directory. */
455	KFSDIR RootDir;
456
457	#ifdef KFSCACHE_CFG_LOCKING
458	/** Critical section protecting the cache. */
459	union
460	{
461	# ifdef _WINBASE_
462	CRITICAL_SECTION CritSect;
463	# endif
464	KU64 abPadding[2 * 4 + 4 * sizeof(void *)];
465	} u;
466	#endif
467
468	/** File system hash table for ANSI filename strings. */
469	PKFSHASHA apAnsiPaths[KFSCACHE_CFG_PATH_HASH_TAB_SIZE];
470	/** Number of paths in the apAnsiPaths hash table. */
471	KSIZE cAnsiPaths;
472	/** Number of collisions in the apAnsiPaths hash table. */
473	KSIZE cAnsiPathCollisions;
474	/** Amount of memory used by the path entries. */
475	KSIZE cbAnsiPaths;
476
477	#ifdef KFSCACHE_CFG_UTF16
478	/** Number of paths in the apUtf16Paths hash table. */
479	KSIZE cUtf16Paths;
480	/** Number of collisions in the apUtf16Paths hash table. */
481	KSIZE cUtf16PathCollisions;
482	/** Amount of memory used by the UTF-16 path entries. */
483	KSIZE cbUtf16Paths;
484	/** File system hash table for UTF-16 filename strings. */
485	PKFSHASHW apUtf16Paths[KFSCACHE_CFG_PATH_HASH_TAB_SIZE];
486	#endif
487	} KFSCACHE;
488
489	/** Magic value for KFSCACHE::u32Magic (Jon Batiste). */
490	#define KFSCACHE_MAGIC KU32_C(0x19861111)
491
492
493	/** @def KW_LOG
494	* Generic logging.
495	* @param a Argument list for kFsCacheDbgPrintf */
496	#if 1 /def NDEBUG - enable when needed! /
497	# define KFSCACHE_LOG(a) do { } while (0)
498	#else
499	# define KFSCACHE_LOG(a) kFsCacheDbgPrintf a
500	void kFsCacheDbgPrintfV(const char *pszFormat, va_list va);
501	void kFsCacheDbgPrintf(const char *pszFormat, ...);
502	#endif
503
504
505	KBOOL kFsCacheDirEnsurePopuplated(PKFSCACHE pCache, PKFSDIR pDir, KFSLOOKUPERROR *penmError);
506	KBOOL kFsCacheDirAddChild(PKFSCACHE pCache, PKFSDIR pParent, PKFSOBJ pChild, KFSLOOKUPERROR *penmError);
507	PKFSOBJ kFsCacheCreateObject(PKFSCACHE pCache, PKFSDIR pParent,
508	char const pszName, KU16 cchName, wchar_t const pwszName, KU16 cwcName,
509	#ifdef KFSCACHE_CFG_SHORT_NAMES
510	char const pszShortName, KU16 cchShortName, wchar_t const pwszShortName, KU16 cwcShortName,
511	#endif
512	KU8 bObjType, KFSLOOKUPERROR *penmError);
513	PKFSOBJ kFsCacheCreateObjectW(PKFSCACHE pCache, PKFSDIR pParent, wchar_t const *pwszName, KU32 cwcName,
514	#ifdef KFSCACHE_CFG_SHORT_NAMES
515	wchar_t const *pwszShortName, KU32 cwcShortName,
516	#endif
517	KU8 bObjType, KFSLOOKUPERROR *penmError);
518	PKFSOBJ kFsCacheLookupA(PKFSCACHE pCache, const char pszPath, KFSLOOKUPERROR penmError);
519	PKFSOBJ kFsCacheLookupW(PKFSCACHE pCache, const wchar_t pwszPath, KFSLOOKUPERROR penmError);
520	PKFSOBJ kFsCacheLookupRelativeToDirA(PKFSCACHE pCache, PKFSDIR pParent, const char *pszPath, KU32 cchPath, KU32 fFlags,
521	KFSLOOKUPERROR penmError, PKFSOBJ ppLastAncestor);
522	PKFSOBJ kFsCacheLookupRelativeToDirW(PKFSCACHE pCache, PKFSDIR pParent, const wchar_t *pwszPath, KU32 cwcPath, KU32 fFlags,
523	KFSLOOKUPERROR penmError, PKFSOBJ ppLastAncestor);
524	PKFSOBJ kFsCacheLookupWithLengthA(PKFSCACHE pCache, const char pchPath, KSIZE cchPath, KFSLOOKUPERROR penmError);
525	PKFSOBJ kFsCacheLookupWithLengthW(PKFSCACHE pCache, const wchar_t pwcPath, KSIZE cwcPath, KFSLOOKUPERROR penmError);
526	PKFSOBJ kFsCacheLookupNoMissingA(PKFSCACHE pCache, const char pszPath, KFSLOOKUPERROR penmError);
527	PKFSOBJ kFsCacheLookupNoMissingW(PKFSCACHE pCache, const wchar_t pwszPath, KFSLOOKUPERROR penmError);
528
529	/** @name KFSCACHE_LOOKUP_F_XXX - lookup flags
530	* @{ */
531	/** No inserting new cache entries.
532	* This effectively prevent directories from being repopulated too. */
533	#define KFSCACHE_LOOKUP_F_NO_INSERT KU32_C(1)
534	/** No refreshing cache entries. */
535	#define KFSCACHE_LOOKUP_F_NO_REFRESH KU32_C(2)
536	/** @} */
537
538	KU32 kFsCacheObjRelease(PKFSCACHE pCache, PKFSOBJ pObj);
539	KU32 kFsCacheObjReleaseTagged(PKFSCACHE pCache, PKFSOBJ pObj, const char *pszWhere);
540	#ifndef NDEBUG /* enable to debug object release. */
541	# define kFsCacheObjRelease(a_pCache, a_pObj) kFsCacheObjReleaseTagged(a_pCache, a_pObj, __FUNCTION__)
542	#endif
543	KU32 kFsCacheObjRetain(PKFSOBJ pObj);
544	PKFSUSERDATA kFsCacheObjAddUserData(PKFSCACHE pCache, PKFSOBJ pObj, KUPTR uKey, KSIZE cbUserData);
545	PKFSUSERDATA kFsCacheObjGetUserData(PKFSCACHE pCache, PKFSOBJ pObj, KUPTR uKey);
546	KBOOL kFsCacheObjGetFullPathA(PKFSOBJ pObj, char *pszPath, KSIZE cbPath, char chSlash);
547	KBOOL kFsCacheObjGetFullPathW(PKFSOBJ pObj, wchar_t *pwszPath, KSIZE cwcPath, wchar_t wcSlash);
548	KBOOL kFsCacheObjGetFullShortPathA(PKFSOBJ pObj, char *pszPath, KSIZE cbPath, char chSlash);
549	KBOOL kFsCacheObjGetFullShortPathW(PKFSOBJ pObj, wchar_t *pwszPath, KSIZE cwcPath, wchar_t wcSlash);
550
551	KBOOL kFsCacheFileSimpleOpenReadClose(PKFSCACHE pCache, PKFSOBJ pFileObj, KU64 offStart, void *pvBuf, KSIZE cbToRead);
552
553	PKFSCACHE kFsCacheCreate(KU32 fFlags);
554	void kFsCacheDestroy(PKFSCACHE);
555	void kFsCacheInvalidateMissing(PKFSCACHE pCache);
556	void kFsCacheInvalidateAll(PKFSCACHE pCache);
557	void kFsCacheInvalidateCustomMissing(PKFSCACHE pCache);
558	void kFsCacheInvalidateCustomBoth(PKFSCACHE pCache);
559	KBOOL kFsCacheSetupCustomRevisionForTree(PKFSCACHE pCache, PKFSOBJ pRoot);
560	KBOOL kFsCacheInvalidateDeletedDirectoryA(PKFSCACHE pCache, const char *pszDir);
561
562	#endif

Note: See TracBrowser for help on using the repository browser.

source: kBuild/trunk/src/lib/nt/kFsCache.h@ 3324

Download in other formats: