home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / lvmtlk12.zip / jma_tk.txt next >
Text File  |  2000-12-10  |  3KB  |  89 lines
  1. /*****************************************************************************
  2. *   This program is free software;  you can redistribute it and/or modify
  3. *   it under the terms of the GNU General Public License as published by
  4. *   the Free Software Foundation; either version 2 of the License, or
  5. *   (at your option) any later version.
  6. *
  7. *   This program is distributed in the hope that it will be useful,
  8. *   but WITHOUT ANY WARRANTY;  without even the implied warranty of
  9. *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See
  10. *   the GNU General Public License for more details.
  11. *
  12. *   You should have received a copy of the GNU General Public License
  13. *   along with this program;  if not, write to the Free Software
  14. *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  15. *****************************************************************************/
  16.  
  17. =============================
  18. Welcome to the LVM toolkit !
  19. =============================
  20.  
  21. This toolkit is to be used to write applications or drivers
  22. to interface with the eComStation LVM (logical volume manager).
  23.  
  24. Please note that the API's in LVM are very powerful. 
  25. Its possible if not easy to trash your harddisk volumes and 
  26. partitions with a few API calls. TAKE CARE !!
  27.  
  28. There are also API's to work with BootManager, including 
  29. adding and removing BootManager from the hard disk !!
  30. TAKE CARE !!
  31.  
  32.  
  33. ====The toolkit consists of the following files:================
  34.  
  35. lvm_intr.h        Main include file, use this as API 
  36.             documentation until a read help file 
  37.             is available.
  38. lvm_cons.h        Included by lvm_intr.h
  39. lvm_type.h        Included by lvm_intr.h
  40. lvm_list.h        Included by lvm_intr.h
  41. lvm_gbls.h        Included by lvm_intr.h
  42. lvm.lib            LVM import library, must be specified 
  43.             at link
  44.  
  45. lvm_toolkit.txt        This file
  46.  
  47. lvmtest.cpp        Example program that lists your volumes
  48. lvmtest.cmd        Batch file to build lvmtest.exe
  49.  
  50.  
  51. The library is built using IBM VisualAge C/C++ 3.6 and the lvmtest
  52. uses that compiler. The header files seems to be quite generic but
  53. if you are using another compiler there might be things that you
  54. must modify to get it working.
  55.  
  56.  
  57. ====A few hints:=================================================
  58.  
  59. - Read through the lvm_intr.h to find out what can be done.
  60. - All changes to drives/partitions/volumes must be comitted
  61.   or changes will not be changed when you close your LVM 
  62.   connection (Commit_Changes).
  63. - You must use Open_LVM_Engine, Close_LVM_Engine to connect
  64.   and disconnect from LVM.
  65. - You must deallocate LVM allocated object when you do not 
  66.   use it any more (Free_Engine_Memory)
  67. - The 16 bit functions (for drivers) has NOT been tested.
  68. - Some API's are specific to LVM2. The LVM included in 
  69.   eComStation seems to be LVM1. 
  70.  
  71.  
  72. ====Limitations:=================================================
  73.  
  74. The LVM.DLL in eComStation is copyrighted work owned by 
  75. IBM Corp. The LVM.LIB is probably also copyright IBM Corp.
  76. However the included header files are part of the EVMS project
  77. that is GNU open source. 
  78. Where this leaves any application you write, 
  79. I dont honestly know.
  80.  
  81.  
  82.  
  83. Good luck building LVM applications !
  84.  
  85. December 10, 2000
  86.  
  87. John Martin Alfredsson
  88. jma@jmast.se
  89.