home *** CD-ROM | disk | FTP | other *** search
/ Inside Multimedia 1995 July / IMM0795.ISO / share / os2 / docsboot / utility.doc < prev   
Text File  |  1994-11-01  |  14KB  |  281 lines

  1.  
  2.  
  3. ═══════════════════════════════════════════════════════════════════════════════
  4.  
  5.  
  6.                  DocsBoot+ version 0.26ß utilities documentation
  7.                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  8.                  Copyright 1994 Zac Schroff, all rights reserved
  9.  
  10.  
  11. ═══════════════════════════════════════════════════════════════════════════════
  12.  
  13.  
  14.                      Introduction to the DocsBoot+ utilities
  15.                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  16.  
  17.  
  18.           These are several small utilities included with DocsBoot+ for
  19.      your convenience or as debugging help.  None of these are actually
  20.      part of DocsBoot+ itself, so they are grouped together in this
  21.      documentation file instead of in the DocsBoot+ documentation file.
  22.      Each utility has its own section, and all of them are but a couple to
  23.      a few paragraphs in length.
  24.  
  25.           These programs are distributed only as part of the DocsBoot+
  26.      package and are distributed on the same terms as the rest of the
  27.      package.  If you are not familiar with them, here they are (copied
  28.      verbatim from the DOCSBOOT.DOC file)...
  29.  
  30.  
  31. ═══════════════════════════════════════════════════════════════════════════════
  32.  
  33.  
  34.                                   Legal stuff
  35.                                   ~~~~~~~~~~~
  36.  
  37.  
  38.           By using this product (DocsBoot+ and the associated documentation
  39.      and installer program and utilities and the associated documentation),
  40.      you agree to the following terms :
  41.  
  42.                1) Neither the author nor any distributor is to be held
  43.                   liable for any damages of any kind from the use or
  44.                   abuse of this program or its associated products.
  45.  
  46.                2) Neither the author nor any distributor is
  47.                   responsible for any damages caused by unauthorised
  48.                   changes to the program or its associated products.
  49.  
  50.                3) You will not disassemble, decompile, or reverse-
  51.                   engineer the program or its associated products.
  52.  
  53.                4) You will not tamper with the program or its
  54.                   associated products in any way except expressly
  55.                   provided for in the documentation or as implied in
  56.                   the setup and installation facilities.
  57.  
  58.                4) You will only copy and distribute the program and
  59.                   its associated products as expressly provided in the
  60.                   documentation for the program.
  61.  
  62.                5) The sole remedy for any malfunctions of DocsBoot+
  63.                   or damages caused by such are limited to a refund of
  64.                   the cost of the program.
  65.  
  66.                6) There is no warranty on DocsBoot+ or anything which
  67.                   is included with it.
  68.  
  69.      If you do not agree to ALL of these terms, you must not use this
  70.      program or any of the associated products.  If you paid a distributor
  71.      for them, please return them and insist upon a refund.
  72.  
  73.  
  74.  
  75.           Several trademarks from various sources were mentioned somewhere
  76.      in this document.  Here is a listing of the trademarks and their
  77.      owners (any not listed here are still the property of their respective
  78.      owners) :
  79.  
  80.      Trademark                     Owning entity
  81.      ────────────────────────────  ────────────────────────────────────────
  82.      AMI                           American Megatrends Incorporated
  83.      BootManager                   International Business Machines corp.
  84.      CompuServe                    CompuServe corporation[?]
  85.      DR-DOS                        Digital Research corporation
  86.      Digital Research              Digital Research corporation
  87.      DiskManager                   Ontrack research[?]
  88.      DocsBoot, DocsBoot+           Zac Schroff
  89.      DOSWatch                      Zac Schroff
  90.      ExtraDrives                   Zac Schroff
  91.      IBM                           International Business Machines corp.
  92.      International Business Mac... International Business Machines corp.
  93.      Microsoft                     Microsoft corporation
  94.      MS                            Microsoft corporation
  95.      MS-DOS                        Microsoft corporation
  96.      Norton Utilities              Peter Norton, then later Symantec corp.
  97.      Ontrack                       Ontrack research[?]
  98.      OS/2                          International Business Machines corp.
  99.      PC, PC-XT, PC-AT              International Business Machines corp.
  100.      PC-DOS                        International Business Machines corp.
  101.      Toshiba                       Toshiba America corporation
  102.      VersaBoot, VersaBoot II       Zac Schroff
  103.      Windows                       Microsoft corporation
  104.      Windows NT, WinNT             Microsoft corporation
  105.  
  106.  
  107.           Toshiba-DOS is Toshiba's variant on MS-DOS.  It appears to have
  108.      fewer bugs than the Microsoft equivalent, and it gets along with more
  109.      non-standard configurations.  This is probably because Toshiba
  110.      anticipated the strange demands the unique features in some of their
  111.      laptop computers would provide.  I have only tested Toshiba's 3.30 and
  112.      5.00 and found both to be quite good.  I did use Toshiba's 2.11 for a
  113.      short time, but I quickly upgraded to 3.30.  Toshiba's 5.00 seems more
  114.      like MS-DOS 5.00, including certain bugs not present in their 3.30.
  115.  
  116.           Note that ExtraDrives is NOT the product Xtra Drive, which is
  117.      produced by somebody else (of whom I know little).  ExtraDrives is a
  118.      program which allows more than the normal two hard discs to be
  119.      connected to a computer, and Xtra Drive is a hard disc compression
  120.      utility.  Besides, *I* know how to spell.  ;-)
  121.  
  122.           DocsBoot, if anybody is still wondering after reading all this
  123.      about DocsBoot+, was a boot sector for floppy discs which would
  124.      transfer control to some other device (usually the hard disc) when it
  125.      was booted.  This was written because I accidentally left a floppy in
  126.      the drive rather often at one time, and did not like having to
  127.      physically remove it and press a key and wait for another boot try.
  128.      DocsBoot was not very widely released, though it worked perfectly.
  129.      Simpler programs are so much easier to write properly the first time.
  130.  
  131.  
  132. ═══════════════════════════════════════════════════════════════════════════════
  133.  
  134.  
  135.                           The DocsBoot+ NameVol utility
  136.                           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  137.  
  138.  
  139.           Included with DocsBoot+ is a program which will name partitions
  140.      so that they have sensible names on the DocsBoot+ menu.  Typically,
  141.      the DOS or OS/2 command LABEL will do this for a given partition, but
  142.      for some reason, they do not allow certain characters in volume
  143.      labels.  For æsthetic reasons, I like lower case and some special
  144.      symbols in mine (For example `OS/2 Boot') and did not like the limits
  145.      placed by the LABEL command.  Hence, this program.
  146.  
  147.           NameVol will change the name (in the boot sector only, so the
  148.      normal volume label remains the same) of a FAT volume.  It allows any
  149.      special characters which can be placed on the command line, and also
  150.      has the option of simply displaying the labels on all volumes which
  151.      can be labelled.  The labels that NameVol displays (or changes) will
  152.      be the ones displayed in the DocsBoot+ menu.
  153.  
  154.           Note that in order for NameVol to name a partition, that partition
  155.      must be formatted with a DOS or OS/2 version which recognises the
  156.      extended BPB introduced at about the time DOS 4.0x came out.  It this
  157.      is not the case, then NameVol will say that the partition can not be
  158.      named, and will not try.  If you are using a DOS version 4.0x or later,
  159.      or OS/2 version 2.0 or later, and you get this message, you need to back
  160.      up your drive, and reformat the drive with your current DOS or OS/2.
  161.      This will install a boot sector which complies to the extended BPB.
  162.  
  163.  
  164.           To name a partition with NameVol, simply execute the NameVol
  165.      command with the following command line :
  166.  
  167.                NAMEVOL d:name
  168.  
  169.      where `d' is the letter for the drive to be named, and `name' is the
  170.      new name for the volume in the DocsBoot+ menu.  Do not enclose the
  171.      name in quotes.
  172.  
  173.  
  174.           To list the names for all drives which can be named, simply run
  175.      the NameVol program without parameters, like this :
  176.  
  177.                NAMEVOL
  178.  
  179.      It will list all the drives which can be named, and what the name is
  180.      for each one.  If a drive can not be named, it will not be listed.
  181.  
  182.  
  183.           Note that NameVol does not work on OS/2's BootManager partition,
  184.      so if you want to change the name or serial number for that, you will
  185.      have to use a disc editor of some sort.  At this time, the same
  186.      applies for non-FAT filesystems.  Load the boot sector for the
  187.      filesystem to change the name for.  If the byte at offset 0026 (hex)
  188.      in this sector is either 28 (hex) or 29 (hex) then change the bytes
  189.      at 002B..0035 (hex, inclusive) to the name you want displayed for the
  190.      partition (note that characters < 20 (hex) are translated to normal
  191.      uppercase letters).
  192.  
  193.  
  194. ═══════════════════════════════════════════════════════════════════════════════
  195.  
  196.  
  197.                          The DocsBoot+ PartScan Utility
  198.                          ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  199.  
  200.  
  201.           This is a small program which scans the partition tables on all
  202.      your hard discs.  It will operate on all hard discs, not just the
  203.      first two.   However, due to the way it was implemented, it scans each
  204.      disc completely before it continues to the next.  This tends to
  205.      distort the apparent order of partitions.  In order to interpret the
  206.      output properly you will need to keep in mind that DOS and OS/2 (and
  207.      many other operating systems) load all primary partitions first, then
  208.      go back and look for extended partitions.
  209.  
  210.           This is intended mainly for a debugging tool, of whatever worth
  211.      it may appear to be.  I think keeping a copy of the output somewhere
  212.      near the system would be helpful if anything happens to the hard disc
  213.      partition tables.  If you feel that you have some other use for it,
  214.      feel free to experiment.  If you find something that might be helpful
  215.      to others, please write and explain it.
  216.  
  217.           The reason for this little utility being at version 1.10, instead
  218.      of the same version as DocsBoot+ is that I use the code contained in
  219.      here for other purposes, so it is a later version.  Basically, this
  220.      program has been around in one incarnation or another about a year
  221.      longer than DocsBoot+ has.
  222.  
  223.  
  224. ═══════════════════════════════════════════════════════════════════════════════
  225.  
  226.  
  227.                          The DocsBoot+ OS2Fixup Utility
  228.                          ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  229.  
  230.  
  231.           I have included, for the convenience of OS/2 users, a program
  232.      allows OS/2 to be installed on drives other than C: without the use of
  233.      IBM's BootManager (which OS/2 wants before it will do so, though it is
  234.      perfectly capable otherwise).
  235.  
  236.           This program is a small batch job (*.CMD or *.BAT) file which
  237.      will modify the floppy based install.  It will also patch the CD-ROM
  238.      install, but in order to do this, you must have a partition other than
  239.      the one you are installing to with some free space (about 30MB for
  240.      v2.x, and about 45MB for 3.0) to use as a work drive (and an
  241.      installation drive).
  242.  
  243.           This installation patch, unlike the NTFixup utility, has been
  244.      tested reasonably throroughly.  It has been found to work properly on
  245.      OS/2 version 2.x, and 3.0, but I have not tried it on other editions.
  246.  
  247.           The OS2Fixup utility will describe itself if it is run without
  248.      parameters.  Please read the descriptions thoroughly before running it
  249.      on your installation discs.
  250.  
  251.  
  252. ═══════════════════════════════════════════════════════════════════════════════
  253.  
  254.  
  255.                           The DocsBoot+ NTFixup utility
  256.                           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  257.  
  258.  
  259.           I have included, for the convenience of Windows NT users, a
  260.      program which will move NTBoot to the NT partition and patch it so
  261.      that its primary purpose is to boot Windows NT, not as a boot manager.
  262.      Note that this utility will also allow IBM's BootManager to work with
  263.      the NTBoot faculity, making Windows NT installations slightly less
  264.      painful (and NT users probably need every relief they can get!).
  265.  
  266.           However, due to the way NT behaved (or, rather, failed to) on my
  267.      system, THIS PROGRAM HAS NOT BEEN THOROUGHLY TESTED.  I have not had
  268.      the opportunity to test it as I had hoped, nor do I intend to try any
  269.      further experiments with NT until I get a new version or find somebody
  270.      else who does not mind being a test subject.
  271.  
  272.           The NTFixup program describes itself and its operation if you run
  273.      it without parameters.  Please read it thoroughly before running it on
  274.      your Windows NT setup.
  275.  
  276.  
  277. ═══════════════════════════════════════════════════════════════════════════════
  278. [end of file]
  279.  
  280.  
  281.