URL https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk

Subversion Repositories openrisc_2011-10-31

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [fileio-synchronization.html] - Blame information for rev 314

Go to most recent revision | Details | Compare with Previous | View Log


<!-- Copyright (C) 2003 Red Hat, Inc.                                -->
<!-- This material may be distributed only subject to the terms      -->
<!-- and conditions set forth in the Open Publication License, v1.0  -->
<!-- or later (the latest version is presently available at          -->
<!-- http://www.opencontent.org/openpub/).                           -->
<!-- Distribution of the work or derivative of the work in any       -->
<!-- standard (paper) book form is prohibited unless prior           -->
<!-- permission is obtained from the copyright holder.               -->
<HTML
><HEAD
><TITLE
>Synchronization</TITLE
><meta name="MSSmartTagsPreventParsing" content="TRUE">
<META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="eCos Reference Manual"
HREF="ecos-ref.html"><LINK
REL="UP"
TITLE="File System Support Infrastructure"
HREF="fileio.html"><LINK
REL="PREVIOUS"
TITLE="Directories"
HREF="fileio-directories.html"><LINK
REL="NEXT"
TITLE="Initialization and Mounting"
HREF="fileio-mounting.html"></HEAD
><BODY
CLASS="CHAPTER"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>eCos Reference Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="fileio-directories.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="fileio-mounting.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="CHAPTER"
><H1
><A
NAME="FILEIO-SYNCHRONIZATION">Chapter 24. Synchronization</H1
><P
>The FILEIO infrastructure provides a synchronization mechanism for
controlling concurrent access to filesystems. This allows existing
filesystems to be ported to eCos, even if they do not have their own
synchronization mechanisms. It also allows new filesystems to be
implemented easily without having to consider the synchronization
issues.</P
><P
>The infrastructure maintains a mutex for each entry in each of
the main tables: filesystem table, mount table and file table. For
each class of operation each of these mutexes may be locked before the
corresponding filesystem operation is invoked.</P
><P
>The synchronization protocol required by a filesystem is described
by the <TT
CLASS="STRUCTFIELD"
><I
>syncmode</I
></TT
> field of the filesystem
table entry. This is a combination of the following flags:</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="LITERAL"
>CYG_SYNCMODE_FILE_FILESYSTEM</TT
></DT
><DD
><P
>Lock the filesystem table entry mutex
during all filesystem level operations.</P
></DD
><DT
><TT
CLASS="LITERAL"
>CYG_SYNCMODE_FILE_MOUNTPOINT</TT
></DT
><DD
><P
>Lock the mount table entry mutex
during all filesystem level operations.</P
></DD
><DT
><TT
CLASS="LITERAL"
>CYG_SYNCMODE_IO_FILE</TT
></DT
><DD
><P
>Lock the file table entry mutex during all
I/O operations.</P
></DD
><DT
><TT
CLASS="LITERAL"
>CYG_SYNCMODE_IO_FILESYSTEM</TT
></DT
><DD
><P
>Lock the filesystem table entry mutex during all I/O operations.</P
></DD
><DT
><TT
CLASS="LITERAL"
>CYG_SYNCMODE_IO_MOUNTPOINT</TT
></DT
><DD
><P
>Lock the mount table entry mutex during all I/O operations.</P
></DD
><DT
><TT
CLASS="LITERAL"
>CYG_SYNCMODE_SOCK_FILE</TT
></DT
><DD
><P
>Lock the file table entry mutex during all socket operations.</P
></DD
><DT
><TT
CLASS="LITERAL"
>CYG_SYNCMODE_SOCK_NETSTACK</TT
></DT
><DD
><P
>Lock the network stack table entry mutex during all socket operations.</P
></DD
><DT
><TT
CLASS="LITERAL"
>CYG_SYNCMODE_NONE</TT
></DT
><DD
><P
>Perform no locking at all during any operations.</P
></DD
></DL
></DIV
><P
>The value of the <TT
CLASS="STRUCTFIELD"
><I
>syncmode</I
></TT
> field in the
filesystem table entry will be copied by the infrastructure to the
open file object after a successful <TT
CLASS="FUNCTION"
>open()</TT
> operation.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="fileio-directories.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ecos-ref.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="fileio-mounting.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Directories</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="fileio.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Initialization and Mounting</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

Line No.	Rev	Author	Line
1	28	unneback	`<!-- Copyright (C) 2003 Red Hat, Inc. -->`
2			`<!-- This material may be distributed only subject to the terms -->`
3			`<!-- and conditions set forth in the Open Publication License, v1.0 -->`
4			`<!-- or later (the latest version is presently available at -->`
5			`<!-- http://www.opencontent.org/openpub/). -->`
6			`<!-- Distribution of the work or derivative of the work in any -->`
7			`<!-- standard (paper) book form is prohibited unless prior -->`
8			`<!-- permission is obtained from the copyright holder. -->`
9			`<HTML`
10			`><HEAD`
11			`><TITLE`
12			`>Synchronization</TITLE`
13			`><meta name="MSSmartTagsPreventParsing" content="TRUE">`
14			`<META`
15			`NAME="GENERATOR"`
16			`CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+`
17			`"><LINK`
18			`REL="HOME"`
19			`TITLE="eCos Reference Manual"`
20			`HREF="ecos-ref.html"><LINK`
21			`REL="UP"`
22			`TITLE="File System Support Infrastructure"`
23			`HREF="fileio.html"><LINK`
24			`REL="PREVIOUS"`
25			`TITLE="Directories"`
26			`HREF="fileio-directories.html"><LINK`
27			`REL="NEXT"`
28			`TITLE="Initialization and Mounting"`
29			`HREF="fileio-mounting.html"></HEAD`
30			`><BODY`
31			`CLASS="CHAPTER"`
32			`BGCOLOR="#FFFFFF"`
33			`TEXT="#000000"`
34			`LINK="#0000FF"`
35			`VLINK="#840084"`
36			`ALINK="#0000FF"`
37			`><DIV`
38			`CLASS="NAVHEADER"`
39			`><TABLE`
40			`SUMMARY="Header navigation table"`
41			`WIDTH="100%"`
42			`BORDER="0"`
43			`CELLPADDING="0"`
44			`CELLSPACING="0"`
45			`><TR`
46			`><TH`
47			`COLSPAN="3"`
48			`ALIGN="center"`
49			`>eCos Reference Manual</TH`
50			`></TR`
51			`><TR`
52			`><TD`
53			`WIDTH="10%"`
54			`ALIGN="left"`
55			`VALIGN="bottom"`
56			`><A`
57			`HREF="fileio-directories.html"`
58			`ACCESSKEY="P"`
59			`>Prev</A`
60			`></TD`
61			`><TD`
62			`WIDTH="80%"`
63			`ALIGN="center"`
64			`VALIGN="bottom"`
65			`></TD`
66			`><TD`
67			`WIDTH="10%"`
68			`ALIGN="right"`
69			`VALIGN="bottom"`
70			`><A`
71			`HREF="fileio-mounting.html"`
72			`ACCESSKEY="N"`
73			`>Next</A`
74			`></TD`
75			`></TR`
76			`></TABLE`
77			`><HR`
78			`ALIGN="LEFT"`
79			`WIDTH="100%"></DIV`
80			`><DIV`
81			`CLASS="CHAPTER"`
82			`><H1`
83			`><A`
84			`NAME="FILEIO-SYNCHRONIZATION">Chapter 24. Synchronization</H1`
85			`><P`
86			`>The FILEIO infrastructure provides a synchronization mechanism for`
87			`controlling concurrent access to filesystems. This allows existing`
88			`filesystems to be ported to eCos, even if they do not have their own`
89			`synchronization mechanisms. It also allows new filesystems to be`
90			`implemented easily without having to consider the synchronization`
91			`issues.</P`
92			`><P`
93			`>The infrastructure maintains a mutex for each entry in each of`
94			`the main tables: filesystem table, mount table and file table. For`
95			`each class of operation each of these mutexes may be locked before the`
96			`corresponding filesystem operation is invoked.</P`
97			`><P`
98			`>The synchronization protocol required by a filesystem is described`
99			`by the <TT`
100			`CLASS="STRUCTFIELD"`
101			`><I`
102			`>syncmode</I`
103			`></TT`
104			`> field of the filesystem`
105			`table entry. This is a combination of the following flags:</P`
106			`><P`
107			`></P`
108			`><DIV`
109			`CLASS="VARIABLELIST"`
110			`><DL`
111			`><DT`
112			`><TT`
113			`CLASS="LITERAL"`
114			`>CYG_SYNCMODE_FILE_FILESYSTEM</TT`
115			`></DT`
116			`><DD`
117			`><P`
118			`>Lock the filesystem table entry mutex`
119			`during all filesystem level operations.</P`
120			`></DD`
121			`><DT`
122			`><TT`
123			`CLASS="LITERAL"`
124			`>CYG_SYNCMODE_FILE_MOUNTPOINT</TT`
125			`></DT`
126			`><DD`
127			`><P`
128			`>Lock the mount table entry mutex`
129			`during all filesystem level operations.</P`
130			`></DD`
131			`><DT`
132			`><TT`
133			`CLASS="LITERAL"`
134			`>CYG_SYNCMODE_IO_FILE</TT`
135			`></DT`
136			`><DD`
137			`><P`
138			`>Lock the file table entry mutex during all`
139			`I/O operations.</P`
140			`></DD`
141			`><DT`
142			`><TT`
143			`CLASS="LITERAL"`
144			`>CYG_SYNCMODE_IO_FILESYSTEM</TT`
145			`></DT`
146			`><DD`
147			`><P`
148			`>Lock the filesystem table entry mutex during all I/O operations.</P`
149			`></DD`
150			`><DT`
151			`><TT`
152			`CLASS="LITERAL"`
153			`>CYG_SYNCMODE_IO_MOUNTPOINT</TT`
154			`></DT`
155			`><DD`
156			`><P`
157			`>Lock the mount table entry mutex during all I/O operations.</P`
158			`></DD`
159			`><DT`
160			`><TT`
161			`CLASS="LITERAL"`
162			`>CYG_SYNCMODE_SOCK_FILE</TT`
163			`></DT`
164			`><DD`
165			`><P`
166			`>Lock the file table entry mutex during all socket operations.</P`
167			`></DD`
168			`><DT`
169			`><TT`
170			`CLASS="LITERAL"`
171			`>CYG_SYNCMODE_SOCK_NETSTACK</TT`
172			`></DT`
173			`><DD`
174			`><P`
175			`>Lock the network stack table entry mutex during all socket operations.</P`
176			`></DD`
177			`><DT`
178			`><TT`
179			`CLASS="LITERAL"`
180			`>CYG_SYNCMODE_NONE</TT`
181			`></DT`
182			`><DD`
183			`><P`
184			`>Perform no locking at all during any operations.</P`
185			`></DD`
186			`></DL`
187			`></DIV`
188			`><P`
189			`>The value of the <TT`
190			`CLASS="STRUCTFIELD"`
191			`><I`
192			`>syncmode</I`
193			`></TT`
194			`> field in the`
195			`filesystem table entry will be copied by the infrastructure to the`
196			`open file object after a successful <TT`
197			`CLASS="FUNCTION"`
198			`>open()</TT`
199			`> operation.</P`
200			`></DIV`
201			`><DIV`
202			`CLASS="NAVFOOTER"`
203			`><HR`
204			`ALIGN="LEFT"`
205			`WIDTH="100%"><TABLE`
206			`SUMMARY="Footer navigation table"`
207			`WIDTH="100%"`
208			`BORDER="0"`
209			`CELLPADDING="0"`
210			`CELLSPACING="0"`
211			`><TR`
212			`><TD`
213			`WIDTH="33%"`
214			`ALIGN="left"`
215			`VALIGN="top"`
216			`><A`
217			`HREF="fileio-directories.html"`
218			`ACCESSKEY="P"`
219			`>Prev</A`
220			`></TD`
221			`><TD`
222			`WIDTH="34%"`
223			`ALIGN="center"`
224			`VALIGN="top"`
225			`><A`
226			`HREF="ecos-ref.html"`
227			`ACCESSKEY="H"`
228			`>Home</A`
229			`></TD`
230			`><TD`
231			`WIDTH="33%"`
232			`ALIGN="right"`
233			`VALIGN="top"`
234			`><A`
235			`HREF="fileio-mounting.html"`
236			`ACCESSKEY="N"`
237			`>Next</A`
238			`></TD`
239			`></TR`
240			`><TR`
241			`><TD`
242			`WIDTH="33%"`
243			`ALIGN="left"`
244			`VALIGN="top"`
245			`>Directories</TD`
246			`><TD`
247			`WIDTH="34%"`
248			`ALIGN="center"`
249			`VALIGN="top"`
250			`><A`
251			`HREF="fileio.html"`
252			`ACCESSKEY="U"`
253			`>Up</A`
254			`></TD`
255			`><TD`
256			`WIDTH="33%"`
257			`ALIGN="right"`
258			`VALIGN="top"`
259			`>Initialization and Mounting</TD`
260			`></TR`
261			`></TABLE`
262			`></DIV`
263			`></BODY`
264			`></HTML`
265			`>`

Browse

Tools

Subversion Repositories openrisc_2011-10-31

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [fileio-synchronization.html] - Blame information for rev 314