UFFS compilation under Microsoft Windows¶

This documentation has been tested under Microsoft Windows XP.

Software requirements¶

• Microsoft Visual Studio 2008 pro edition + SP1: http://msdn.microsoft.com/en-us/vstudio/default.aspx
• CMake >= 2.6: http://www.cmake.org/cmake/resources/software.html
• Git for Microsoft Windows: http://code.google.com/p/msysgit/
• Dokan: http://dokan-dev.net/en/download/
• NSIS (if you want to build an install package): http://nsis.sourceforge.net/Download

Optional¶

• Zlib http://gnuwin32.sourceforge.net/packages/zlib.htm

Get UFFS¶

• Open Git Bash.
• Go to a directory without spaces in the path, for example, to be in C:\, do:
  $ cd /c/
• Extract UFFS repository by typing this following:
  git clone git://git.uffs.org/uffs.git
• Enter in the uffs directory:
  $ cd uffs

Compiling¶

• Create a build folder in UFFS directory
  $ mkdir build

• Open a command prompt in UFFS directory then type:
  $ cd build
$ cmake -G [vs compiler version] -DCMAKE_BUILD_TYPE=[Release|Debug] ..

• where [vs compiler version] depends on the Visual Studio version

  Visual Studio 6 = Generates Visual Studio 6 project files.
Visual Studio 7 = Generates Visual Studio .NET 2002 project files.
Visual Studio 7 .NET 2003 = Generates Visual Studio .NET 2003 project files.
Visual Studio 8 2005 = Generates Visual Studio .NET 2005 project files.
Visual Studio 8 2005 Win64 = Generates Visual Studio .NET 2005 Win64 project files.
Visual Studio 9 2008 = Generates Visual Studio 9 2008 project files.
Visual Studio 9 2008 Win64 = Generates Visual Studio 9 2008 Win64 project files.

• For example, if you are using Microsoft Windows 2008, type:
  $ cmake -G "Visual Studio 9 2008" -DCMAKE_BUILD_TYPE=Release ..
  or, if you want to compile in debug mode:
  $ cmake -G "Visual Studio 9 2008" -DCMAKE_BUILD_TYPE=Debug ..

To build the solution, you have two possibilities: the graphical way and the command line.

• Graphical: open the solution, then build all through the graphical user interface of Microsoft Visual Studio.

• Command line: open a Microsoft Visual Studio Command prompt (in Microsoft Visual Studio 2008, All Programs > Microsoft Visual Studio 2008 > Visual Studio Tools), then:
  > cd C:\uffs\build
> Devenv SolutionName /build SolnConfigName [/project ProjName [/projectconfig ProjConfigName]]
  example:
  > Devenv "C:\uffs\build\uffs.sln" /build Release
  or
  > Devenv "C:\uffs\build\uffs.sln" /build Debug
  if you want to build in Debug mode.

• To clean the solution in command line:
  > Devenv /clean SolnConfigName SolutionName [/project ProjName] [/projectconfig ProjConfigName]
  example:
  > Devenv "C:\uffs\build\uffs.sln" /clean Release
  or
  > Devenv "C:\uffs\build\uffs.sln" /clean Debug
  to clean the Debug build.

Creating a package¶

Under Git Bash, in your build directory:
$ cpack