windows.txt

   1 YAZ Compilation guidelines for winNT/95.
   2   $Id: windows.txt,v 1.4 2000-04-17 14:21:38 adam Exp $
   3
   4 This distribution of YAZ includes makefiles that works with Visual
   5 C++ version 5 and 6. The makefile is located in sub directory 'win'.
   6
   7 If you wish to make modifications to the make process you should
   8 edit makefile before proceeding. For example, a DEBUG version of YAZ
   9 can be build by modifying the line 'DEBUG=0' to 'DEBUG=1' in the
  10 makefile.
  11
  12 Run nmake in that directory (in a Command prompt for example). Eg:
  13     >CD \YAZ\WIN
  14     >NMAKE
  15
  16 Make sure that the environment variables PATH, LIB and INCLUDE are
  17 set properly. They *should* be set by the Visual C++ installation.
  18 Programs cl.exe, link.exe and others must be found in the PATH. The
  19 standard includes files, standard libraries must be found in INCLUDE
  20 and LIB respectively.
  21
  22 The following components are build by the nmake process:
  23
  24 yaz.dll - This DLL is made of the source in all sub directories except
  25          for 'client' and 'ztest'. To export public functions
  26          the header files contain the modifier YAZ_EXPORT which is
  27          defined in yconfig.h. The value of this modifier,
  28          __declspec(dllexport), is probably specific to Visual C++.
  29
  30 yaz-client.exe - A Z39.50 client console application. It is linked with
  31          the import library yaz.lib. This application searches for yaz.dll
  32          during runtime.
  33
  34 yaz-ztest.exe - The Z39.50 test server as a console application. It is
  35          linked with the import library yaz.lib. When running yaz-ztest
  36          make sure it is able to find the record test files dummy-records,
  37          dummy-grs, and dummy-words in the current directory.
  38
  39          As an option ztest may be installed as an NT service
  40          (not Windows 95). Use 'ztest -install <otherargs>' to install
  41          it and 'ztest -remove <otherargs>' to remove it again. Since
  42          NT runs the service program in some weird directory, such as
  43          \winnt\system32, it's probably a good idea to use the option
  44          '-w' to change to some other directory. For example
  45
  46             yaz-ztest -install -w d:\proj\yaz\ztest -l ztest.out tcp:@:210
  47
  48          which specifies both working directory (d:\proj\yaz\ztest)
  49          and a log file (ztest.out). The server is started on port 210.
  50
  51 After successful compilation all executables and DLL's are located
  52 in sub YAZ\BIN. Libraries are located in YAZ\LIB.