xref: /freebsd/share/man/man9/pseudofs.9 (revision 880a3b451f0020a1d3254a04adeb6908b8e4aa00)
1320adc96SDag-Erling Smørgrav.\"-
2320adc96SDag-Erling Smørgrav.\" Copyright (c) 2001 Dag-Erling Co�dan Sm�rgrav
3320adc96SDag-Erling Smørgrav.\" All rights reserved.
4320adc96SDag-Erling Smørgrav.\"
5320adc96SDag-Erling Smørgrav.\" Redistribution and use in source and binary forms, with or without
6320adc96SDag-Erling Smørgrav.\" modification, are permitted provided that the following conditions
7320adc96SDag-Erling Smørgrav.\" are met:
8320adc96SDag-Erling Smørgrav.\" 1. Redistributions of source code must retain the above copyright
9320adc96SDag-Erling Smørgrav.\"    notice, this list of conditions and the following disclaimer.
10320adc96SDag-Erling Smørgrav.\" 2. Redistributions in binary form must reproduce the above copyright
11320adc96SDag-Erling Smørgrav.\"    notice, this list of conditions and the following disclaimer in the
12320adc96SDag-Erling Smørgrav.\"    documentation and/or other materials provided with the distribution.
13320adc96SDag-Erling Smørgrav.\"
14320adc96SDag-Erling Smørgrav.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15320adc96SDag-Erling Smørgrav.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16320adc96SDag-Erling Smørgrav.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17320adc96SDag-Erling Smørgrav.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18320adc96SDag-Erling Smørgrav.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19320adc96SDag-Erling Smørgrav.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20320adc96SDag-Erling Smørgrav.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21320adc96SDag-Erling Smørgrav.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22320adc96SDag-Erling Smørgrav.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23320adc96SDag-Erling Smørgrav.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24320adc96SDag-Erling Smørgrav.\" SUCH DAMAGE.
25320adc96SDag-Erling Smørgrav.\"
26320adc96SDag-Erling Smørgrav.\" $FreeBSD$
27320adc96SDag-Erling Smørgrav.\"
28880a3b45SChristian Brueffer.Dd April 20, 2007
29320adc96SDag-Erling Smørgrav.Dt PSEUDOFS 9
30320adc96SDag-Erling Smørgrav.Os
31320adc96SDag-Erling Smørgrav.Sh NAME
32320adc96SDag-Erling Smørgrav.Nm pseudofs
338d5d039fSRuslan Ermilov.Nd pseudo file system construction kit
34320adc96SDag-Erling Smørgrav.Sh SYNOPSIS
352754f630SRuslan Ermilov.In fs/pseudofs/pseudofs.h
36320adc96SDag-Erling Smørgrav.\" Insert usage example here
37320adc96SDag-Erling Smørgrav.Sh DESCRIPTION
38320adc96SDag-Erling SmørgravThe
39320adc96SDag-Erling Smørgrav.Nm
40320adc96SDag-Erling Smørgravmodule offers an abstract API for pseudo-file systems such as
41320adc96SDag-Erling Smørgrav.Xr procfs 5
42320adc96SDag-Erling Smørgravand
43320adc96SDag-Erling Smørgrav.Xr linprocfs 5 .
44320adc96SDag-Erling SmørgravIt takes care of all the hairy bits like interfacing with the VFS
4511cee4a6SDag-Erling Smørgravsystem, enforcing access control, keeping track of file numbers, and
4611cee4a6SDag-Erling Smørgravcloning files and directories that are process-specific.
475203edcdSRuslan ErmilovThe consumer module, i.e., the module that implements the actual guts
482754f630SRuslan Ermilovof the file system, needs only provide the directory structure
49320adc96SDag-Erling Smørgrav(represented by a collection of structures declared and initialized by
50320adc96SDag-Erling Smørgravmacros provided by
51320adc96SDag-Erling Smørgrav.Nm )
52320adc96SDag-Erling Smørgravand callbacks that report file attributes or write the actual file
53320adc96SDag-Erling Smørgravcontents into sbufs.
54320adc96SDag-Erling Smørgrav.\" Insert more info here
55320adc96SDag-Erling Smørgrav.Sh SEE ALSO
56320adc96SDag-Erling Smørgrav.Xr linprocfs 5 ,
57880a3b45SChristian Brueffer.Xr linsysfs 5 ,
58320adc96SDag-Erling Smørgrav.Xr procfs 5 ,
59320adc96SDag-Erling Smørgrav.Xr sbuf 9 ,
602754f630SRuslan Ermilov.Xr vnode 9
61320adc96SDag-Erling Smørgrav.Sh HISTORY
62320adc96SDag-Erling SmørgravThe
63320adc96SDag-Erling Smørgrav.Nm
64320adc96SDag-Erling Smørgravmodule appeared in
65320adc96SDag-Erling Smørgrav.Fx 5.0 .
66320adc96SDag-Erling Smørgrav.Sh AUTHORS
67320adc96SDag-Erling SmørgravThe
68320adc96SDag-Erling Smørgrav.Nm
69320adc96SDag-Erling Smørgravmodule and this manual page were written by
70320adc96SDag-Erling Smørgrav.An Dag-Erling Sm\(/orgrav .
71