home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / DISK / DI103.ZIP / DI.DOC next >
Encoding:
Text File  |  1991-01-20  |  14.1 KB  |  330 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                     DiskInfo
  7.  
  8.                                   Version 1.03
  9.  
  10.  
  11.                       A Disk Information Utility For Ms-Dos
  12.  
  13.  
  14.                     (c) Copyright 1991, by Kenneth R. Doebler
  15.                                All Rights Reserved
  16.  
  17.  
  18.  
  19.                              released January 20, 1991
  20.  
  21.  
  22.  
  23.  
  24.  
  25.      Disclaimer - Agreement
  26.      ----------------------
  27.  
  28.      Users of DiskInfo must accept this disclaimer of warranty:
  29.  
  30.      "DiskInfo is supplied as is.  The author disclaims all warranties,
  31.      expressed or implied, including, without limitation, the warranties
  32.      of merchantability and of fitness for any purpose.  The author
  33.      assumes no liability for damages, direct or consequential, which
  34.      may result from the use of DiskInfo."
  35.  
  36.      DiskInfo is a "shareware program" and is provided at no charge to
  37.      the user for evaluation.  Feel free to share it with your friends,
  38.      but please do not give it away altered or as part of another
  39.      package or system.  The essence of "user-supported" software is to
  40.      provide personal computer users with quality software without high
  41.      prices, and yet to provide incentive for programmers to continue to
  42.      develop new products.
  43.  
  44.      If you find this program useful and find that you are using
  45.      DiskInfo and continue to use DiskInfo after a reasonable trial
  46.      period, I would ordinarily be asking that you make a registration
  47.      payment of some kind.  The registration fee would license one copy
  48.      for use on any one computer at any one time.
  49.  
  50.      Since I am not set up and ready to receive registration payments at
  51.      this time, and since this is the first utility to be released by
  52.      myself, and since this is indeed a fairly simple utility, I am at
  53.      this time waiving the usual registration fee.  However, future
  54.      versions of DiskInfo, as well as other utilities to be released,
  55.      may require a registration payment to license one copy.
  56.  
  57.      Commercial users of DiskInfo must register by contacting Ken
  58.      Doebler within 30 days of first use or their license is withdrawn.
  59.      Site-License arrangements may be made by contacting Ken Doebler.
  60.  
  61.      Anyone distributing DiskInfo for any kind of remuneration must
  62.      first contact Ken Doebler at the address listed at the end of this
  63.      document for authorization.
  64.  
  65.      You are encouraged to pass a copy of DiskInfo along to your friends
  66.      for evaluation, provided that you:
  67.  
  68.         1)  Do not modify or alter the original program or documentation
  69.             files in any way.
  70.  
  71.         2)  Pass along the complete archive with all files included,
  72.             in it's original unaltered form.
  73.  
  74.      Future releases of DiskInfo may require registration.  Registered
  75.      users of DiskInfo and other Software Resource utilities will be
  76.      granted access to special support conferences on The Software
  77.      Resource.
  78.  
  79.  
  80.      DiskInfo Overview
  81.      -----------------
  82.  
  83.      DiskInfo is a simple utility that will display information about
  84.      the current drive or the drive specified on the command line.  The
  85.      information displayed is obtained from the disk's boot sector, or
  86.      more specifically, the BIOS Parameter Block (BPB).
  87.  
  88.      While this is a very simple utility, the information displayed by
  89.      DiskInfo can often be very useful.  DiskInfo can tell you a variety
  90.      of things about a disk, including total disk space, free disk
  91.      space, cluster size, type of media, FAT type, sector and track
  92.      information, and root directory capacity just to mention a few.
  93.  
  94.      DiskInfo was written and compiled using Microsoft's BASIC 7.0 PDS
  95.      (Professional Development System) with a little additional help
  96.      from Microsoft's MASM 5.1.
  97.  
  98.  
  99.      How it works
  100.      ------------
  101.  
  102.      DiskInfo uses DOS Interrupt 25h (Absolute Disk Read) to read the
  103.      disk's boot sector into memory, where it then deciphers most of the
  104.      information it displays.  Prior to doing this, DI also scans your
  105.      root directory to obtain the volume label information and makes a
  106.      call to DOS Interrupt 21h, Function 36h to obtain the amount of
  107.      disk free space available, along with a few other necessary DOS
  108.      calls to determine valid drives and so on.
  109.  
  110.  
  111.      Usage Syntax
  112.      ------------
  113.  
  114.      DiskInfo can be invoked in one of two ways as follows:
  115.  
  116.      1)  DI
  117.  
  118.      2)  DI <drive> or <drive:>
  119.  
  120.      If DiskInfo is invoked without any command line arguments (1) then
  121.      DI will report information on the currently logged (default) drive.
  122.      No other command line arguments are available.  DI will accept all
  123.      valid drive letters, upper or lowercase, from A-Z, with or without
  124.      an appended colon.
  125.  
  126.  
  127.      Information Displayed
  128.      ---------------------
  129.  
  130.      DiskInfo displays a full screen of information about the selected
  131.      disk as described below:
  132.  
  133.  
  134.      Volume Label          : The disk's volume label.  If no volume
  135.                              label is present, DI will display "None"
  136.                              in this field.
  137.      Media Type            : The type of disk, for example, single
  138.                              sided floppy, double sided floppy, fixed
  139.                              disk (hard disk), and so on.
  140.      OEM ID                : The system name field.  This field
  141.                              identifies the manufacturer whose system
  142.                              formatted the disk.  Some manufacturers do
  143.                              not put a name here.
  144.      Total Space           : Total disk space in bytes.
  145.      Space Used            : Allocated disk space occupied by files.
  146.      Space Available       : Free disk space available and unallocated.
  147.      Bytes Per Sector      : Indicates your sector size in bytes.  This
  148.                              should always be 512 for DOS disks.
  149.      Total Disk Sectors    : Indicates the total number of usable
  150.                              sectors on the disk, regardless of whether
  151.                              they are free, used or marked bad by DOS.
  152.                              Usable refers to sectors which are
  153.                              theoretically available to DOS for file
  154.                              allocation.
  155.      Bytes Per Cluster     : Indicates the disk's cluster size in bytes.
  156.                              This value can vary depending upon how the
  157.                              disk was formatted.
  158.      Total Disk Clusters   : Indicates total disk clusters available for
  159.                              file allocation.
  160.      Sectors Per Cluster   : The number of sectors per cluster.  This
  161.                              can vary depending upon the disk format.
  162.      Reserved Sectors      : The number of sectors reserved by DOS and
  163.                              not available for use.
  164.      Sectors Per Track     : The number of sectors per disk track.
  165.      Total Cylinders       : The total number of cylinders (or tracks)
  166.                              on the disk.
  167.      Hidden Sectors        : Total number of hidden sectors on the disk.
  168.      Root Dir Sectors      : The number of sectors allocated to the
  169.                              disk's root directory.  This is fixed and
  170.                              set when the disk is formatted.
  171.      Root Starting Sector  : The starting sector number for the disk's
  172.                              root directory.
  173.      Maximum Root Entries  : The maximum number of directory entries
  174.                              which the root directory can hold.
  175.      Sectors Per FAT       : The size in sectors of one copy of the
  176.                              disk's FAT (File Allocation Table).
  177.      Number Of FATs        : The number of copies of the disk's FAT.
  178.                              This is typically 2, however more copies
  179.                              are possible.
  180.      Total FAT Sectors     : Total number of disk sectors occupied by
  181.                              copies of the FAT.
  182.      Bits Per FAT Entry    : The number of bits in one FAT entry.  This
  183.                              can vary from 12 bits on floppies to 32
  184.                              bits on hard disks running under newer
  185.                              versions of DOS.
  186.      File Data Start Sector: The starting sector number on the disk
  187.                              where files can be stored.  The data area
  188.                              for files immediately follows the disk's
  189.                              boot sector, FAT and root directory.  This
  190.                              is the first sector which is available for
  191.                              file storage on the disk.
  192.      File Data End Sector  : The last sector number of the file storage
  193.                              area on the disk.  This is the highest
  194.                              sector number available for file data.
  195.      Media Descriptor      : This is the media descriptor byte which
  196.                              indicates the type of disk media.  This
  197.                              value is used to determine the Media Type
  198.                              listed in the field above.
  199.      Number Of Heads       : The number of heads for the disk.
  200.      Extended Partition    : Indicates whether this is a DOS Extended
  201.                              Partition larger than 32 Megabytes.  Only
  202.                              possible with DOS 3.31 and above.
  203.      Signature Byte        : If DI detects an Extended Partition and DOS
  204.                              4.0 or higher, then a signature byte for
  205.                              the partition should be present.
  206.      Volume Serial Number  : If DI detects an Extended Parition and DOS
  207.                              4.0 or higher, then a volume serial number
  208.                              for the partition should be present.  This
  209.                              is used as a further means to identify the
  210.                              disk beyond the volume label alone.
  211.  
  212.  
  213.      Miscellaneous Comments
  214.      ----------------------
  215.  
  216.      I am somewhat color blind in that I only have a monochrome monitor
  217.      to work with, so it is entirely possible that the colors DiskInfo
  218.      displays may be a little strange looking.  I will try and remedy
  219.      this situation by doing some testing on CGA and EGA systems in
  220.      other locations, however, at the time of this release, I have not
  221.      been able to do so yet.  Any suggestions relating to colors from
  222.      those of you who enjoy color monitors would be appreciated.
  223.  
  224.      DiskInfo was a relatively small project, and hence did not require
  225.      much in the way of beta testing.  I would, however, like to thank
  226.      the following individuals for their help in doing some last minute
  227.      testing of DiskInfo.  Several bugs were found and squashed and some
  228.      helpful suggestions were made:
  229.  
  230.         David Wurz
  231.         Ross Wentworth
  232.         Basil Groman
  233.         Dave Ransom
  234.  
  235.      My special thanks to Basil Groman for all of his help in tracking
  236.      down and fixing the DOS 4.x large partition related problems.
  237.  
  238.  
  239.      History And Revisions
  240.      ---------------------
  241.  
  242.      Version 1.03
  243.      ------------
  244.  
  245.      o Corrected an error in the display of DOS 4.x Volume Serial
  246.        Numbers.
  247.      o Fixed a bug which caused DiskInfo to display incorrect Total Disk
  248.        Space, Available Space and Total Disk Clusters when used on DOS
  249.        4.x large partitions.
  250.  
  251.  
  252.      Version 1.02
  253.      ------------
  254.  
  255.      o Finally tracked down and fixed a bug which caused error messages
  256.        to be displayed when DiskInfo was used on a DOS 4.x large
  257.        partition.  Hopefully, this will solve all of the reported
  258.        problems relating to reading DOS 4.x disks.
  259.  
  260.  
  261.      Version 1.01
  262.      ------------
  263.  
  264.      o Made a few minor cosmetic adjustments to the colors.
  265.      o Added support for DOS 4.xx and large partitions.  DiskInfo
  266.        should now work with any DOS version from 2.xx thru 5.0 beta.
  267.      o Fixed a bug which was causing lock-ups and other strange error
  268.        messages when used on a partition > 32 MB.
  269.      o Corrected an error in the Media Type displayed for DS 15-SPT
  270.        floppies.
  271.  
  272.  
  273.      Version 1.00 (original release)
  274.      -------------------------------
  275.  
  276.      DiskInfo is a very small utility and one which is an outgrowth of
  277.      a much larger project.  The larger project has been in development
  278.      for well over a year and has since proven to be too cumbersome to
  279.      work with as a single entity.  Therefore, rather than release one
  280.      single large program, I have decided to release several individual
  281.      stand-alone utilities, which may, at some future time, be tied
  282.      together with some type of shell.  DiskInfo is the first in what
  283.      will be an extensive series of Ms-Dos utilities relating to file
  284.      and disk management.
  285.  
  286.      DiskInfo has been tested on several machines with good results,
  287.      however, I would appreciate any feedback or bug reports on it if
  288.      you encounter problems.  Every effort has been made to eliminate
  289.      existing problems, but it is very possible that other things will
  290.      surface when it is tested on a wider variety of machines and
  291.      versions of DOS.  I would appreciate any comments or reports of
  292.      problems that you may have.
  293.  
  294.      Several other utilities are currently in various stages of testing
  295.      and development and some will require further beta testing before
  296.      their public release.  When these utilities are released, they will
  297.      be available on The Software Resource.
  298.  
  299.      The latest version of DiskInfo can always be obtained directly from
  300.      the following source:
  301.  
  302.  
  303.      The Software Resource
  304.      1200-2400 bps
  305.      24 Hours Daily
  306.      (213) 214-2018 (data)
  307.      Fidonet Address: 1:102/330
  308.  
  309.  
  310.      Please direct all comments, bug reports and inquiries to the Sysop
  311.      in the Utilities conference in the Local message areas.  If you are
  312.      a node in Fidonet, I am reachable via netmail at the above address.
  313.  
  314.  
  315.      Other Credits
  316.      -------------
  317.  
  318.      BASIC PDS and MASM are (c) Copyright Microsoft Corporation,
  319.      1981-1990.
  320.  
  321.  
  322.  
  323.  
  324.  
  325.      Ken Doebler
  326.      Torrance, Ca
  327.      January 20, 1991
  328.  
  329.      <End Of Document>
  330.