Skip to content

Commit

Permalink
Initial Rev
Browse files Browse the repository at this point in the history 
git-svn-id: https://fat-driver2.tianocore.org/svn/fat-driver2/trunk@2 65ba2f78-6c18-0410-a7b4-885970cf29fa
  • Loading branch information
bbahnsen committed Jul 13, 2006
1 parent 1898842 commit e74fca5
Show file tree
Hide file tree
Showing 3 changed files with 155 additions and 6 deletions.
22 changes: 22 additions & 0 deletions www/fat32license.html
View file
@@ -0,0 +1,22 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>Untitled Document</title>
</head>

<body>
<h3>FAT32 Driver License </h3>
<p>Copyright (c) 2004, Intel Corporation<BR>
All rights reserved.</FONT> <BR>
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:</p>
<ul>
<li>Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. </li>
<li>Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. </li>
<li>Neither the name of Intel nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. </li>
</ul>
<P>THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</P>
<P><B>Additional terms:</B>&nbsp; In addition to the forgoing, redistribution and use of the code is conditioned upon the FAT 32 File System Driver and all derivative works thereof being used for and designed only to read and/or write to a file system that is directly managed by an Extensible Firmware Interface (EFI) implementation or by an emulator of an EFI implementation.</P>
</body>
</html>
Binary file added www/images/stop sign.gif
View file
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
139 changes: 133 additions & 6 deletions www/index.html
View file
@@ -1,8 +1,135 @@
<html>
<head>
<title>Default Project Content</title>
</head>
<body>
This is the default project content.
</body>
<head>
<title>EDK II Fat32 Project Homepage</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<body>
<p><span style="font-size: large; font-weight: bold;">W</span>elcome to the <strong>EDK II FAT-Driver PROJECT</strong>, a project for the EDK II FAT32 File System Driver, which is based on Microsoft's FAT32 File System Driver Specification. The EDK II Fat Driver is separate from the EDK project only because the terms of use of the code are unique, requiring us to keep it in a separate code repository (the terms are basically that code developed using the FAT32 Specification must be associated with EFI). </p>
<p>This project is a <em>subproject</em> of the EDK II project, and is only used to house the FAT32 code respository. All development tools in the EDK project are integrated with this project, so come here only to update the CVS repository or to get access to the latest code snapshots. Use the EDK project to post issues, join mailing lists, participate in discussion forums, etc. In short, consider them one project with two code repositories.</p>
<a name="stop"></a>
<h3>EDK II FAT-Driver News</h3>
<p>
The EDK II FAT-Driver development team is pleased to announce a new <b>&quot;Enhanced&quot;</b> FAT-Driver. This project will now be used to develop and maintain both drivers.
From this point on, the original FAT-Driver will be refererred to as <b>FAT-Driver</b> while the new driver will go by the <b>Enhanced-FAT-Driver</b> name. Both drivers will be
using the same Project Tracer and each have their own <b>module</b> name when creating/modifying TASKs or ENHANCEMENTs. The enhanced-fat-driver is also published under the same
license as the fat-driver2. To view more specific information about the enhanced-fat-driver, go to the <a href="#Enhanced_Fat_Driver">Enhanced-FAT-Driver</a> section.
</p>
<h3>Working with the FAT32 Code</h3>
<p>The FAT-Driver project is sponsored by Intel and released under the BSD License with one additional term. Before using the code please read the license below, paying special attention to the "Additional Terms" section:</p>
<form>
<textarea cols="100" rows="8">Copyright (c) 2004, Intel Corporation
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of Intel nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Additional terms:
In addition to the forgoing, redistribution and use of the code is conditioned upon the FAT 32 File System Driver and all derivative works thereof being used for and designed only to read and/or write to a file system that is directly managed by an Extensible Firmware Interface (EFI) implementation or by an emulator of an EFI implementation.
</textarea>
</form>
<p>To download code, view the <a href="http://fat-driver2.tianocore.org/servlets/ProjectDocumentList?folderID=10&expandFolder=10&folderID=0">directory of code snapshots</a> and choose the version (Official Release or Development Version) you are interested in and simply click on it to start the download process. Join this project if you want to contribute code changes (see the next section for guidance). </p>
<h3>Enhanced-FAT-Driver<a name="Enhanced_Fat_Driver"></a></h3>
<p>
The <b>Enhanced-FAT-Driver</b> is a new implementation of the FAT32 filesystem. It is a near complete rewrite of the original FAT-Driver with over 80% of the code being specific just to the Enhanced-FAT-Driver.
The new driver is faster and takes up only 66% of the original FAT-Driver's memory footprint.
</p>
<h4>What makes the Enhanced-FAT-Driver better?</h4>
<ul>
<li>Better Architecture
<ul>
<li>More modular design thanks to object oriented and hierarchical design</li>
<li>Logic directory approach used in place of the physical directory</li>
<li>Easier to maintain and debug
<li>80% of the code was completely rewritten to make it smaller and faster</li>
</ul>
</li>
<li>Higher Performance
<ul>
<li>A cache mechanism to cache recently opened directories</li>
<li>A more efficient 8.3 name generation algorithm</li>
<li>10x, 100x or even 1000x acceleration when creating thousands files/directories</li>
</ul>
</li>
<li>Smaller Size
<ul>
<li>Simplified the controller name from &quot;FAT File System[FAT16] 200MB&quot; to &quot;FAT File System&quot;</li>
<li>Succinct coding style</li>
<li>2/3 the image size of the original FAT-Driver</li>
</ul>
</li>
</ul>
<h4>So why are there two FAT-Driver implementations in the fat-driver2 project?</h4>
<ul>
<li>Publish the enhanced FAT implementation so that people can try the new implementation with size and performance benefits</li>
<li>Keep the original FAT driver for backward compatibility or avoid potential risk for mature products</li>
</ul>
<h4>Which driver should I use?</h4>
<ul>
<li>Enhanced-FAT-Driver
<ul>
<li>When you need the fastest FAT filesystem driver</li>
<li>When space is crucial</li>
</ul>
</li>
<li>FAT-Driver
<ul>
<li>When you need stability to avoid possible risk of a new implementation</li>
<li>When you prefer to keep the original behavior, such as 8.3 name generation algorithm, complete controller name for each volume</li>
</ul>
</li>
</ul>
<!-- <p>
When making your decision, remember that the Enhanced FAT-Driver is backward compatible with the original FAT-Driver.
It also has a sector allocation mechanism that can make it easier to recover deleted files.
</p> -->
<h4>What does this mean to you?</h4>
<p>
Not much. The source code will be housed in the same repository so there is no need to checkout multiple projects to work on these drivers. The Project Tracker configuration is setup to allow for
concurrent DEFECT, ENHANCEMENT and TASK management for both projects. The only real concern for you is to figure out which driver to use when.
</p>
<h3>Joining the FAT-Driver Project </h3>
<p>To join the FAT-Driver Project simply click on the &quot;Request Project Membership/Role&quot; link above and choose &quot;Observer&quot; as a requested role (that's the default role for all new project members). Upon receipt of your request, the FAT-Driver Maintainer will approve your project membership. Once in the project you'll primarily use the CVS repository located <a href="https://fat-driver2.tianocore.org/source/browse/fat-driver2/">here</a>, or access the FAT32-specific documents located <a href="http://fat-driver2.tianocore.org/servlets/ProjectDocumentList">here</a>. </p>
<h3>Managing Changes to the FAT-Driver Source Code</h3>
<p>Since the FAT32 Driver Code is actually part of the EDK, changes to it are managed within the EDK issue management system. To make it simple for you, the following links have been developed to help the communication between the two projects. From these links you can enter a FAT32 issue, query open FAT32 issues, access the DEV mailing list archive and download the FAT32 source code. </p>
<ul>
<li>Enhanced FAT-Driver
<ul>
<li><a href="http://fat-driver2.tianocore.org/servlets/ProjectDocumentList?folderID=65&expandFolder=65&folderID=65">Latest Enhanced-FAT-Driver Source Code Snapshot (Development Version)</a></li>
<li><a href="http://fat-driver2.tianocore.org/servlets/ProjectDocumentList?folderID=67&expandFolder=67&folderID=67">Latest Enhanced-FAT-Driver Source Code Snapshot (Official Release)</a></li>
<li> <a href="http://edk.tianocore.org/servlets/Scarab/curmodule/16/remcurreport/true/template/IssueList.vm?queryId=177&action=Search&eventSubmit_doSearch=Search&searchscdt=range&cmaxdatetod=18&cmaxdatetod=18&searchatct=1&ammaxdatetod=18&ammaxdatetod=18&searchscit=5&cmindatetod=18&cmindatetod=18&searchamdt=range&searcharct=1&searchacrt=onOrBefore&ammindatetod=18&ammindatetod=18&searchndp=1&searchsp=asc&resultsperpage=25&searchamit=5&intake-grp=attv&intake-grp=search&attv=__11&attv=__103&attv=__125&attv=__122&attv=__105&attv=__106&attv=__107&attv=__50&attv=__109&attv=__22&attv=__13&attv=__121&attv=__23&attv=__104&attv=__102&attv=__24&searchacdt=range&attv__102optids=236&attv__102optids=492&attv__102optids=238&attv__102optids=457&attv__102optids=239&scmaxdatetod=18&scmaxdatetod=18&scmindatetod=18&scmindatetod=18&searchacit=5&searchscrt=onOrBefore&attv__13optids=493&attv__22val=Queries+for+all+open+defects+for+the+Enhanced+FAT-Driver+module&searchamrt=onOrBefore&curmitlistid=326">Query of Open and Active Enhanced-FAT-Driver Project Defects</a></li>
</ul>
</li>
<li>FAT-Driver
<ul>
<li><a href="http://fat-driver2.tianocore.org/servlets/ProjectDocumentList?folderID=11&expandFolder=11&folderID=10">Latest FAT-Driver Source Code Snapshot (Development Version)</a></li>
<li><a href="http://fat-driver2.tianocore.org/servlets/ProjectDocumentList?folderID=12&expandFolder=12&folderID=11">Latest FAT-Driver Source Code Snapshot (Official Release)</a></li>
<li> <a href="http://edk.tianocore.org/servlets/Scarab/curmodule/16/tqk/1/remcurreport/true/template/IssueList.vm/action/Search?nextTemplate=Index.vm&go=139&eventSubmit_doSelectquery=foo">Query of Open and Active FAT-Driver Project Defects</a></li>
</ul>
</li>
<li>General
<ul>
<li><a href="http://edk.tianocore.org/servlets/Scarab/curmodule/16/tqk/1/remcurreport/true/template/IssueList.vm/action/Search?nextTemplate=Index.vm&go=140&eventSubmit_doSelectquery=foo">Query of All FAT-Driver Project Defects</a></li>
<li><a href="http://edk.tianocore.org/servlets/SummarizeList?listName=dev">Archives of the EDK &quot;Dev&quot; Mailing List</a></li>
</ul>
</li>
</ul>
<h3>Other Common Links and Downloads </h3>
<ul><li><a href="http://fat-driver2.tianocore.org/servlets/ProjectMembershipRequest">Request for a FAT-Driver Project Role (initial or promotion)</a> </li>
<li><a href="http://edk.tianocore.org/">Link to the EDK Project Homepage </a></li>
<li><a href="http://community.tianocore.org/">Link to the TianoCore Community Project</a></li>
<li><a href="http://www.tianocore.org/IssueTracking.html">Link to the TianoCore Issue Management Process </a></li>
<li><a href="http://www.microsoft.com/whdc/system/platform/firmware/fatgen.mspx">Link to Microsoft's FAT32 System Driver Specification</a></li>
</ul>
<h3>Project Points of Contact</h3>
<ul>
<li>EDK/FAT-Driver Project Maintainer: Rob Rhoads, Intel Corporation, <a href="mailto:rob.rhoads@intel.com">rob.rhoads@intel.com</a></li>
<li>EDK/FAT-Driver Senior Engineer (US): Andrew Fish, Intel Corporation, <a href="mailto:%20%20andrew.j.fish@intel.com">andrew.j.fish@intel.com</a></li>
<li>EDK/FAT-Driver Senior Engineer (China): Penny Gao, Intel Corporation, <a href="mailto:%20%20penny.gao@intel.com">penny.gao@intel.com</a></li>
</ul>
<p>&nbsp;</p>
</body>
</html>

0 comments on commit e74fca5

Please sign in to comment.