home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Basic / wst!blz1.dms / in.adf / docs / rilibdocs.lha / RITrackDiskLib.doc < prev    next >
Encoding:
Text File  |  1994-09-05  |  3.4 KB  |  117 lines
  1. Library Name:
  2.   ritrackdisklib #91
  3.  
  4. Authors:
  5.   ReflectiveImages, 17 Mayles Road, Southsea, Portsmouth, Hampshire, UK PO4 8NP
  6.  
  7. OverView:
  8.   Another Reflective Images Library, pretty down to earth,
  9.  
  10. Authors Docs:
  11.  
  12.  
  13. ============================================
  14. =    T R A C K D I S K    L I B R A R Y    =
  15. ============================================
  16.  
  17. (C)1994 Reflective Images
  18.  
  19. Written by Steve Matty.
  20.  
  21. You can do whatever the hell you like to this library but must still
  22. give me some credit!
  23.  
  24.  
  25. Command List :
  26.  
  27.     success=OpenDisk(unit#)
  28.     MotorOn unit#
  29.     MotorOff unit#
  30.     CloseDisk unit#
  31.     success=ReadSector(unit#,sector#,buffer[,numsectors])
  32.     success=WriteSector(unit#,sector#,buffer[,numsectors])
  33.     success=FormatTrack(unit#,track#,buffer[,numtracks])
  34.     success=WriteBoot(unit#[,bootdata])
  35.  
  36.  
  37. Command : OpenDisk
  38. ---------------------------------------------------------------------------
  39. Modes  : Amiga
  40. Syntax : success=OpenDisk(unit#)
  41.  
  42. This attempts to open unit 'unit#' of the trackdisk.device, for use with
  43. the other commands in this library. A return value of 0 indicates failure,
  44. -1 indicates success.
  45.  
  46.  
  47. Statement : MotorOn
  48. ---------------------------------------------------------------------------
  49. Modes  : Amiga
  50. Syntax : MotorOn unit#
  51.  
  52. This attempts to switch the drive motor on of the previously opened
  53. trackdisk unit (called with OpenDisk). You must call this command
  54. before attempting to ReadSector/WriteSector/FormatTrack/WriteBoot
  55.  
  56.  
  57. Statement : MotorOff
  58. ---------------------------------------------------------------------------
  59. Modes  : Amiga
  60. Syntax : MotorOff unit#
  61.  
  62. This turns the drive motor of 'unit#' off.
  63.  
  64.  
  65. Command : ReadSector
  66. ---------------------------------------------------------------------------
  67. Modes  : Amiga
  68. Syntax : [success=]ReadSector(unit#,sector#,buffer[,numsectors])
  69.  
  70. This attempts to read 'numsectors' sectors from a trackdisk device which
  71. has been opened with OpenDisk and has its Motor On. If numsectors is
  72. omitted then 1 sector is read. The data is read into the memory location
  73. pointed to by 'buffer'.
  74.  
  75. WARNING! Please MAKE SURE the MOTOR is _ON_ otherwise, all hell will break
  76. loose!!!
  77.  
  78.  
  79. Command : WriteSector
  80. ---------------------------------------------------------------------------
  81. Modes  : Amiga
  82. Syntax : [success=]WriteSector(unit#,sector#,buffer[,numsectors])
  83.  
  84. This is the same as ReadSector except........... it writes!
  85. (and no, I am not being lazy by not typing any decent docs)
  86.  
  87.  
  88. Command : FormatTrack
  89. ---------------------------------------------------------------------------
  90. Modes  : Amiga
  91. Syntax : [success=]FormatTrack(unit#,track#,buffer[,numtracks])
  92.  
  93. This does a TD_FORMAT on the specified track number. Buffer should point
  94. to the area of memory which the track should be formatted with. I don't
  95. know why this command exists - but hey, it might come in useful.
  96.  
  97.  
  98. Command : WriteBoot
  99. ---------------------------------------------------------------------------
  100. Modes  : Amiga
  101. Syntax : [success=]WriteBoot(unit#[,buffer])
  102.  
  103. This writes 1kilobyte of data to the bootblock of the specified disk unit.
  104. The optional buffer parameter should point to an area of memory with which
  105. to write the bootblock.
  106.  
  107.  
  108. Statement : CloseDisk
  109. ---------------------------------------------------------------------------
  110. Modes  : Amiga
  111. Syntax : CloseDisk unit#
  112.  
  113. This closes the trackdisk.device of the specified unit#. The Motor is
  114. automatically switched off if it is already on.
  115.  
  116. >>END
  117.