home *** CD-ROM | disk | FTP | other *** search
/ ftp.ncftp.com / ftp.ncftp.com.zip / ftp.ncftp.com / libncftp / older_versions / libncftp-3.1.5-src.tar.gz / libncftp-3.1.5-src.tar / libncftp-3.1.5 / doc / README.txt < prev   
Text File  |  2001-12-08  |  3KB  |  69 lines
  1. Since you have the source distribution, you will need to compile the
  2. libraries before you can install them.
  3.  
  4. UNIX INSTRUCTIONS:
  5. ------------------
  6.  
  7. Go to the ../libncftp directory. There is a script you must run which
  8. will checks your system for certain features, so that the library can
  9. be compiled on a variety of UNIX systems.  Run this script by typing
  10. "./configure" in that directory.  After that, you can look at the
  11. Makefile it made if you like, and then you run "make" to create the
  12. "libncftp.a", "libStrn.a", and "libsio.a" library files.
  13.  
  14. Finally, install the libraries and headers, by doing "make install".
  15.  
  16. View the libncftp.html file for the rest of the documentation.  An easy
  17. way to do that is use a URL of file://Localhost/path/to/libncftp.html
  18. with your favorite browser.
  19.  
  20.  
  21. WINDOWS INSTRUCTIONS:
  22. ---------------------
  23.  
  24. You will need Visual C++ 6.0 or greater to build the library and sample
  25. programs.  This version includes two supplementary libraries which you
  26. must build and link with your applications: a string utility library
  27. (Strn) and a Winsock utility library (sio).
  28.  
  29. Keep the source hierarchy intact, so that the samples and libraries
  30. build without problems.  Each project directory contains a visual studio
  31. project (.dsp and .dsw files), but you don't need to manually build
  32. each project.  Instead, open the "LibNcFTP_ALL.dsw" workspace file
  33. in the ../libncftp directory, and then "Rebuild All" to build all the
  34. libraries and all the samples.
  35.  
  36. View the libncftp.html file for the rest of the documentation.  An easy
  37. way to do that is use a URL of file://Localhost/path/to/libncftp.html
  38. with your favorite browser.  Note that there may be UNIX-specific
  39. instructions which you should ignore.
  40.  
  41. To build your own applications using LibNcFTP, you'll need to make sure
  42. you configure your project to find the header files and library files.
  43.  
  44. Your application may not need to use the sio or Strn libraries directly,
  45. but you still need to link with them.  For example, the "simpleget" sample
  46. uses "..\..\Debug,..\..\..\Strn\Debug,..\..\..\sio\Debug" in the
  47. project option for additional library paths for the linker, and
  48. "kernel32.lib user32.lib gdi32.lib advapi32.lib shell32.lib
  49.  ws2_32.lib Strn.lib sio.lib libncftp.lib" for the list of libraries
  50. to link with.  Note that LibNcFTP uses advapi32.lib and shell32.lib, in
  51. addition to the usual "kernel32.lib user32.lib gdi32.lib".  Of course,
  52. it also needs to link with Winsock (ws2_32.lib).
  53.  
  54. Similarly, you'll need to make sure one of your additional include
  55. directories points to the LibNcFTP directory containing ncftp.h.  The
  56. "simpleget" sample uses "..\.." since it is in a subdirectory of the
  57. library itself.  If you actually use functions from Strn or sio (as
  58. some of the samples do), you'll need to have your project look in
  59. their directories for their headers as well.
  60.  
  61. About Winsock2:  This version of the library was designed for use with
  62. Winsock version 2.  Note that older versions of Windows 95 do not include
  63. Winsock version 2, but can be upgraded by getting the updater from
  64. Microsoft:  http://www.microsoft.com/windows95/downloads/contents/wuadmintools/s_wunetworkingtools/w95sockets2/default.asp
  65.  
  66. However, the library should also work with Winsock 1.1.  That is left as
  67. an exercise to the coder to change the Winsock initialization to use 1.1
  68. and to link with the 1.1 library (wsock32.lib).
  69.