Cygwin

From RFID Guardian

NOTE: Skip this if you don't build on a Windows system.

NOTE: if you plan to build for a BlackFin RFID Guardian, it's easier not to use Cygwin. Please consider using a Linux PC or CoLinux.

Cygwin Setup

Get Cygwin from www.cygwin.com.

• Make sure you have selected file type [Unix/binary], not file type [DOS/text]. All text-based tools under Cygwin get confused by the [DOS/text] file type conversions, because line endings are converted from LF to CR/LF transparently.

Module prerequisites:

• Make sure you have 'development environment' selected, so you have gcc, make, ar, ld, ...

• You need svn, the SubVersion client.

• If you want to build the ACL module or the GP module, make sure you have selected 'flex' and friends in the compiler tools section, and 'perl' in the interpreters section.

• If you need OpenSSL (e.g. for the GP module), make sure you have selected the Cygwin openssl developer modules.

Caveats for Cygwin users

• Please read our ramblings on repository usage, and pay special attention to the note on TortoiseSVN and friends!

• Cygwin users may need the --non-interactive flag for all svn commands.

• The Cygwin command line client svn may display a bug at initial checkout. Some SubVersion working files are reported to have the wrong permissions, and checkout halts. This is a race condition in Cygwin's cooperation with Windows. The fix is straightforward. Move into the top-level directory of the distribution and do

$ svn update

If this helps, good. Else, say the error occurs in '.../mrg-subdir/.svn/.../some-file'. Then throw away the directory mrg-subdir, i.e. the directory immediately above .svn in the path to the error:

$ rm -rf .../mrg-subdir

and do

$ svn update

from the root directory of the checkout. This procedure may have to be iterated a few times

• Whitespace in file names: GNU make notoriously has problems with whitespace in file names. The current solution is to ensure that none of the paths in the checkout directories have any white space. This might typically surface if your user name has a space: /home/Joe\ User/. The fix is to create a directory without whitespace: /home/joe-user/, and checkout there. Under CygWin, there is no restraint at all to create such a directory.