tools/elftosb/ReadMe.txt

   1 elftosb 2.x read me
   2 -------------------
   3
   4 Directories
   5
   6 elftosb2 - elftosb 2.x
   7 sbtool - sbtool 1.x
   8 keygen - keygen 1.x
   9 common - source files common between elftosb2, sbtool, and keygen
  10 winsupport - files needed only by the windows build
  11 elftosb - old elftosb 1.x, does not use anything from common
  12 generatekeys - old key generation tool for elftosb 1.x
  13 decrypt - old decryption tool for elftosb 1.x
  14 unittests - old unit tests for elftosb 1.x
  15 test_files - test ELF and Srecord files
  16 old - contains old makefiles for elftosb 1.x
  17
  18 Development
  19
  20 The preferred way to work on elftosb and related tools is to use Xcode on Mac OS X. The
  21 elftosb.xcodeproj directory is an Xcode project "file". It has targets for elftosb,
  22 keygen, sbtool, and an aggregate target that builds all of the above. The main reason
  23 to use Xcode is that the project is set up so that the flex and bison input files are
  24 processed automatically and the output files compiled.
  25
  26 The Windows project and Linux makefile are not configured to build the flex or bison
  27 source files. They simply use the output files copied into the elftosb2 directory.
  28 You can run flex or bison manually to generate these files if you don't want to use Xcode.
  29 If you do use the Xcode project and make changes to the .l or .y files, be sure to copy
  30 the output .cpp files into the elftosb2 directory before you move the changes to either
  31 Windows or Linux.
  32
  33 Building
  34
  35 On Windows, open the .sln file in Microsoft Visual Studio. The solution contains projects
  36 for each of the individual projects, including the old elftosb 1.x and related tools.
  37
  38 For Linux, run 'make all' from within the top level elftosb directory. This will build only
  39 the new elftosb 2.x, sbtool, and keygen. The old makefile to build elftosb 1.x and its
  40 tools is located in the "old" directory.
  41
  42 On Mac OS X just open the .xcodeproj project and build the "Everything" target.
  43
  44
  45