xref: /netbsd/lib/libpuffs/puffs_flush.3 (revision 809ae5f8)
1*809ae5f8Spooka.\"	$NetBSD: puffs_flush.3,v 1.1 2007/01/19 21:10:55 pooka Exp $
2*809ae5f8Spooka.\"
3*809ae5f8Spooka.\" Copyright (c) 2007 Antti Kantee.  All rights reserved.
4*809ae5f8Spooka.\"
5*809ae5f8Spooka.\" Redistribution and use in source and binary forms, with or without
6*809ae5f8Spooka.\" modification, are permitted provided that the following conditions
7*809ae5f8Spooka.\" are met:
8*809ae5f8Spooka.\" 1. Redistributions of source code must retain the above copyright
9*809ae5f8Spooka.\"    notice, this list of conditions and the following disclaimer.
10*809ae5f8Spooka.\" 2. Redistributions in binary form must reproduce the above copyright
11*809ae5f8Spooka.\"    notice, this list of conditions and the following disclaimer in the
12*809ae5f8Spooka.\"    documentation and/or other materials provided with the distribution.
13*809ae5f8Spooka.\"
14*809ae5f8Spooka.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15*809ae5f8Spooka.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16*809ae5f8Spooka.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17*809ae5f8Spooka.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18*809ae5f8Spooka.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19*809ae5f8Spooka.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20*809ae5f8Spooka.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21*809ae5f8Spooka.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22*809ae5f8Spooka.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23*809ae5f8Spooka.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24*809ae5f8Spooka.\" SUCH DAMAGE.
25*809ae5f8Spooka.\"
26*809ae5f8Spooka.Dd January 19, 2007
27*809ae5f8Spooka.Dt PUFFS_FLUSH 3
28*809ae5f8Spooka.Os
29*809ae5f8Spooka.Sh NAME
30*809ae5f8Spooka.Nm puffs_flush
31*809ae5f8Spooka.Nd puffs kernel cache flushing and invalidation routines
32*809ae5f8Spooka.Sh LIBRARY
33*809ae5f8Spooka.Lb libpuffs
34*809ae5f8Spooka.Sh SYNOPSIS
35*809ae5f8Spooka.In puffs.h
36*809ae5f8Spooka.Ft int
37*809ae5f8Spooka.Fn puffs_inval_namecache_dir "struct puffs_usermount *pu" "void *cookie"
38*809ae5f8Spooka.Ft int
39*809ae5f8Spooka.Fn puffs_inval_namecache_all "struct puffs_usermount *pu"
40*809ae5f8Spooka.Sh DESCRIPTION
41*809ae5f8Spooka.Em IMPORTANT NOTE!
42*809ae5f8SpookaThis document describes interfaces which are not yet guaranteed to be
43*809ae5f8Spookastable.
44*809ae5f8SpookaIn case you update your system sources, please recompile everything
45*809ae5f8Spookaand fix complation errors.
46*809ae5f8SpookaIf your sources are out-of-sync, incorrect operation may result.
47*809ae5f8SpookaThe interfaces in this document will most likely be hugely simplified
48*809ae5f8Spookain later versions or made transparent to the implementation.
49*809ae5f8Spooka.Pp
50*809ae5f8SpookaThese routines are used inform the kernel that any information it might
51*809ae5f8Spookahave cached is no longer valid.
52*809ae5f8SpookaCurrently only two are supported.
53*809ae5f8Spooka.Fn puffs_inval_namecache_dir
54*809ae5f8Spookainvalidates the name cache for a given directory.
55*809ae5f8SpookaThe argument
56*809ae5f8Spooka.Va cookie
57*809ae5f8Spookashould describe an existing and valid directory cookie for the file
58*809ae5f8Spookasystem.
59*809ae5f8SpookaSimilarly,
60*809ae5f8Spooka.Fn puffs_inval_namecache_all
61*809ae5f8Spookainvalidates the name cache for the entire file system
62*809ae5f8Spooka(this routine might go away).
63*809ae5f8Spooka.Sh SEE ALSO
64*809ae5f8Spooka.Xr puffs 3
65