home *** CD-ROM | disk | FTP | other *** search
/ Programmer's ROM - The Computer Language Library / programmersrom.iso / ada / misc / vlngthio.pro < prev    next >
Encoding:
Text File  |  1988-05-03  |  3.8 KB  |  78 lines
  1. -------- SIMTEL20 Ada Software Repository Prologue ------------
  2. --                                                           -*
  3. -- Unit name    :  VARIABLE_LENGTH_DIRECT_IO
  4. -- Version      :  1.0
  5. -- Author       :  Patrick Kopson 
  6. --              : Texas Instruments  
  7. --              :  
  8. --              :  
  9. -- DDN Address  :  WOODY%TI-EG@CSNET-RELAY
  10. -- Copyright    :  (c) 1985
  11. -- Date created :  01 APR 85
  12. -- Release date :  03 DEC 85
  13. -- Last update  :  03 DEC 85
  14. -- Machine/System Compiled/Run on :  VAX 11/785  VMS 4.1
  15. --                                   DEC Ada
  16. --                                                           -*
  17. ---------------------------------------------------------------
  18. --                                                           -*
  19. -- Keywords     : DIRECT_IO, Varible-Length IO  
  20. ----------------:
  21. --
  22. -- Abstract     :  
  23. --|   This is a package similar to DIRECT_IO that operates on records of
  24. --|   variable length.  The body of this package may use CAIS utilities
  25. --|   in the future.
  26. --|
  27. --|   This package allows the user to write elements of differing lengths to a
  28. --|   single direct access file.  This package can be used to write data
  29. --|   of all types to a single file (with the aid of UNCHECKED_CONVERSION).
  30. --|   The DATA_FILE_IO package in the Ada repository serves as an example of
  31. --|   how this can be accomplished.
  32. --|
  33. --|   This package also reduces the time-per-byte-of-data-transfered by reducing
  34. --|   the number of calls to the run time libraray routines associated with the
  35. --|   predefined generic package DIRECT_IO.  This is accomplished by placing
  36. --|   many incoming records into a large buffer and then writng the entire 
  37. --|   buffer to an external file as a single element (vice versa for reading).
  38. --|   Bytes_Per_Block, the only generic parameter for this package, determines 
  39. --|   the size (in bytes) of this buffer.
  40. ----------------:  
  41. --                                                           -*
  42. ------------------ Revision history ---------------------------
  43. --                                                           -*
  44. -- DATE         VERSION    AUTHOR                  HISTORY
  45. -- 12/3/85      1.0         Patrick Kopson          Initial Release
  46. --                                                           -*
  47. ------------------ Distribution and Copyright -----------------
  48. --                                                           -*
  49. -- This prologue must be included in all copies of this software.
  50. --
  51. -- This software is copyright by the author.
  52. --
  53. -- This software is released to the Ada community.
  54. -- This software is released to the Public Domain (note:
  55. --   software released to the Public Domain is not subject
  56. --   to copyright protection).
  57. -- Restrictions on use or distribution:  NONE
  58. --                                                           -*
  59. ------------------ Disclaimer ---------------------------------
  60. --                                                           -*
  61. -- This software and its documentation are provided "AS IS" and
  62. -- without any expressed or implied warranties whatsoever.
  63. -- No warranties as to performance, merchantability, or fitness
  64. -- for a particular purpose exist.
  65. --
  66. -- Because of the diversity of conditions and hardware under
  67. -- which this software may be used, no warranty of fitness for
  68. -- a particular purpose is offered.  The user is advised to
  69. -- test the software thoroughly before relying on it.  The user
  70. -- must assume the entire risk and liability of using this
  71. -- software.
  72. --
  73. -- In no event shall any person or organization of people be
  74. -- held responsible for any direct, indirect, consequential
  75. -- or inconsequential damages or lost profits.
  76. --                                                           -*
  77. -------------------END-PROLOGUE--------------------------------
  78.