home *** CD-ROM | disk | FTP | other *** search
/ hobbes.nmsu.edu / 2008-06-02_hobbes.nmsu.edu.zip / dos / hpfsds10.zip / hpfsdos.eng < prev    next >
Text File  |  1994-10-16  |  13KB  |  394 lines
  1.  
  2.     +-------------------------------------------------------------------+
  3.     |                                                                   |
  4.     |   HPFSDOS 1.00                                                    |
  5.     |                                                                   |
  6.     |   HPFS file system for DOS (read only)                            |
  7.     |                                                                   |
  8.     |   Copyright (c) 1994 Robert Muchsel                               |
  9.     |                      Hegaublick 2, D-78465 Konstanz, Germany.     |
  10.     |   All rights reserved.                                            |
  11.     |                                                                   |
  12.     +-------------------------------------------------------------------+
  13.  
  14.     Registration information and legal stuff: See the end of this file.
  15.  
  16.  
  17.     Contents
  18.     ========
  19.  
  20.     1. Overview
  21.  
  22.     2. HPFSDOS in Detail
  23.        2.1 Installing and Starting
  24.        2.2 Using and Deinstalling HPFSDOS
  25.        2.3 Hints on Specific Programs
  26.        2.4 Notes for Advanced Users
  27.  
  28.     3. The HCONTROL, HDIR and HCOPY Utilities
  29.        3.1 HCONTROL
  30.        3.2 HDIR
  31.        3.3 HCOPY
  32.  
  33.     4. Error Messages
  34.  
  35.     5. Licence Information, Registering
  36.  
  37.  
  38.  
  39.     1. Overview
  40.     ===========
  41.  
  42.     HPFSDOS integrates your HPFS partitions into the DOS file system
  43.     as read-only drives.
  44.  
  45.     Using HPFSDOS is mere child's play: Type "HPFSDOS", done
  46.     (for optional parameters see below).
  47.  
  48.     When started, the program scans all hard disks for HPFS partitions,
  49.     assigns each partition to a new drive letter and stays resident.
  50.  
  51.     From now on, all DOS and Windows programs will recognize your HPFS
  52.     drives!
  53.  
  54.     For example, you can use the following programs:
  55.  
  56.     * DOS command prompts, including 4DOS
  57.     * DOS programs - Word, Turbo Pascal, Borland C++, dBase, etc.
  58.     * Windows programs - Ami Pro, Maple V, Win32s programs, etc.
  59.     * Utilities - List, FProt, AMIsetup, Scan, PC Tools, etc.
  60.     * Data - ATM font files, Source code, etc.
  61.  
  62.  
  63.  
  64.     2. HPFSDOS in Detail
  65.     ====================
  66.  
  67.     I want to ask you a favor: I tried very hard not to make the
  68.     shareware hints too annoying. There are no restrictions in the
  69.     shareware version except the initial beeps. Please be so kind
  70.     and register the program - development will be continued only if
  71.     the software is successful!
  72.     You'll find the licencing information in the last chapter of this
  73.     documentation. Please hang on and read it right to the end.
  74.  
  75.  
  76.     2.1 Installing and Starting
  77.     ---------------------------
  78.  
  79.     HPFSDOS runs under MSDOS 3.1, 3.2, 3.3, 5.0, 6.x and Novell DOS 7. For
  80.     technical reasons, it will not work under DOS 4.x and DR DOS 3.41.
  81.  
  82.     For a quick test of HPFSDOS, enter
  83.       HPFSDOS
  84.  
  85.     To install HPFSDOS permanently, add the line
  86.       Drive:\Path\HPFSDOS
  87.     to the AUTOEXEC.BAT file on your boot drive, e.g.
  88.       C:\HPFSDOS\HPFSDOS
  89.  
  90.     Please set up the
  91.       TEMP
  92.     and
  93.       TMP
  94.     environment variables to point to a writeable directory, e.g. by adding
  95.     the following to AUTOEXEC.BAT:
  96.       SET TEMP=C:\TEMP
  97.       SET TMP=C:\TEMP
  98.  
  99.     HPFSDOS uses Extended Memory (XMS) to cache access to HPFS drives,
  100.     if XMS is available. You can disable the cache with the 0 parameter:
  101.       HPFSDOS 0
  102.     If you want to set a specific cache size, type
  103.       HPSFDOS Size_in_KB
  104.     e.g. HPFSDOS 2048. The default cache size is 1024 KB.
  105.  
  106.     Note: HPFSDOS needs 1 additional KB of conventional memory per 512 KB
  107.     cache memory. HPFSDOS requires at least 45 KB of conventional memory
  108.     (no cache) and at most 61 KB (8192 KB cache). The default is 47 KB
  109.     (1024 KB cache).
  110.  
  111.     The HPFDOS drive letters might differ from OS/2. Use SWAPDRV X Y to
  112.     swap drive letters (see enclosed documentation SWAPDRV.ENG)!
  113.  
  114.  
  115.     2.2 Using and Deinstalling HPFSDOS
  116.     ----------------------------------
  117.  
  118.     There are limitations regarding HPFSDOS drives:
  119.  
  120.     - Only files with FAT compatible file names (i.e. 8.3) are supported
  121.       (see also HDIR, HCOPY).
  122.     - The HPFS drives are read-only (to protect your valuable data, you
  123.       should never use any other program than OS/2 for writing to HPFS
  124.       drives).
  125.       HPFSDOS drives are like fast CD-ROM drives!
  126.  
  127.     Because of the write protection, not all programs work under HPFSDOS.
  128.  
  129.     In most cases, starting the program from a writeable DOS directory
  130.     suffices. Some programs have special command line parameters (see
  131.     section 2.3).
  132.  
  133.     To remove HPFSDOS from memory, enter
  134.       HCONTROL /U
  135.     This will only work if no program after HPFSDOS has hooked the
  136.     interrupt 2Fh vector.
  137.  
  138.  
  139.     2.3 Hints on Specific Programs
  140.     ------------------------------
  141.  
  142.     DOS session: HPFSDOS doesn't sort directory listings. Add the
  143.                  line "SET DIRCMD=/OGNE" to AUTOEXEC.BAT instead.
  144.  
  145.     Microsoft Windows: Ensure "PagingFile" in the SYSTEM.INI file
  146.                  points to a FAT drive.
  147.  
  148.     Borland C++: Run the program with the /rx parameter, where x is
  149.                  a FAT drive.
  150.  
  151.     Turbo Pascal: Run the program with the /Spath parameter, where path
  152.                  is a FAT directory.
  153.  
  154.  
  155.     2.4 Notes for Advanced Users
  156.     ----------------------------
  157.  
  158.     - HPFSDOS drives claim to be network drives. This is an elegant way to
  159.       disable sector editors, DOS checkdisk and other programs that
  160.       could crash.
  161.  
  162.     - HPFSDOS drives tell DOS their cluster size was 32 KB. Of course, the
  163.       real HPFS cluster size is only 512 Bytes. This lie will allow DOS to
  164.       recognize large 2 GB partitions properly.
  165.  
  166.     - The maximum number of HPFS partitions supported is 10.
  167.  
  168.     - HPFSDOS drives are like CD-ROM drives. The "read only" file attribute
  169.       is forced on and free disk space is reported as 0. HCONTROL /R disables
  170.       the extra read only attribute (writing to the drive is still not
  171.       possible), HCONTROL /F calculates the approximate free space.
  172.  
  173.     - HPFSDOS can read disk cylinders higher than 1024 on machines with BIOS
  174.       support for large hard disks. Please contact the author if you have
  175.       problems with this feature.
  176.  
  177.  
  178.  
  179.     3. The HCONTROL, HDIR and HCOPY Utilities
  180.     =========================================
  181.  
  182.     HDIR and HCOPY run without HPFSDOS. If HPFSDOS is loaded, both programs
  183.     support HPFSDOS drive letters and use the HPFS partition information
  184.     collected by HPFSDOS.
  185.  
  186.  
  187.     3.1 HCONTROL
  188.     ------------
  189.  
  190.     /U  Unload HPFSDOS
  191.  
  192.     /R  Disable extra "read only" file attribute
  193.     /R- Enable
  194.  
  195.     /F  Calculate free disk space
  196.     /F- Set free disk space to 0
  197.  
  198.  
  199.     3.2 HDIR
  200.     --------
  201.  
  202.     HDIR is the DIR command for HPFS drives and supports long file names.
  203.     HPFSDOS is not required!
  204.  
  205.     HDIR Path\SearchPattern [...] /Parameters
  206.  
  207.     Path: If HPFSDOS is loaded, you can simply enter any HPFSDOS drive
  208.     letter, search path, etc. If HPFSDOS is not loaded, you must specify
  209.     a HPFS partition - 0:\ to 9:\.
  210.  
  211.     Search pattern: HDIR supports extended wild cards:
  212.     *      Matches any number (0 or more) of any character.
  213.            This wild card is like the OS/2 *, i.e. *A* is a valid selection
  214.            (under DOS, *A* means *).
  215.     +      Any number (at least one) of any character.
  216.     ?      Matches any single character
  217.     [abc]  Only the characters in the brackets match
  218.     [a-d]  The range of characters a to d matches
  219.     [!abc] The characters in the brackets don't match
  220.     [!a-d] The range of characters does not match
  221.  
  222.     Parameters:
  223.     /A    Selects only files with the specified file attributes. Attributes
  224.           are: A H D S R
  225.           A - in front of an attribute selects files without the specified
  226.           attribute.
  227.           A single /A selects all files.
  228.           Example: /AR-H
  229.     /S    Display contents of the current directory and all of its
  230.           subdirectories.
  231.     /P    Pause after each screen page and wait for a key to be pressed.
  232.  
  233.     Examples:
  234.  
  235.     HDIR D:\OS2\*.PMI
  236.     HDIR D:\*.PMI /S
  237.     HDIR 0:\ /AH
  238.     HDIR 0:\OS2\SYSTEM /D
  239.     HDIR D:\ /S /P
  240.  
  241.     See also: OS/2 help, HELP DIR.
  242.  
  243.  
  244.  
  245.     3.3 HCOPY
  246.     ---------
  247.  
  248.     This program copies files from HPFS partitions to DOS drives. HCOPY
  249.     supports long file names (HPFSDOS is not required).
  250.     When copying files with long file names, the user is asked for a new
  251.     name.
  252.  
  253.     HCOPY Source [DestinationPath] /Parameters
  254.  
  255.     Source: The source must point to a HPFSDOS drive or a HPFS partition
  256.     Wild cards are supported (see HDIR).
  257.  
  258.     Destination path: The destination must be on a DOS drive; if no argument
  259.     is supplied, the current path will be used.
  260.  
  261.     Parameters:
  262.     /P    Prompts for each file.
  263.     /R    Replaces existing files without asking.
  264.     /T    Selects files with specified attributes. See /A in HDIR.
  265.  
  266.     Examples:
  267.  
  268.     HCOPY D:\ c:\hidden /TH
  269.     HCOPY 1:\AmiPro\Docs\* /P
  270.  
  271.  
  272.  
  273.     4. Error messages
  274.     =================
  275.  
  276.     During startup:
  277.  
  278.     "This program requires DOS 3.10 or higher and does not support DOS 4.x!"
  279.  
  280.     "Your operating system has no CDS support (this program won't run under
  281.     OS/2)!"
  282.     - HPFSDOS will not run under OS/2 MDOS. You can use the "DOS from
  283.     drive A:" feature, however.
  284.  
  285.     "Syntax is: HPFSDOS [Size of XMS cache in KB]"
  286.     - HPFSDOS recognizes only a signle number as parameter. Use HCONTROL
  287.     to control other options.
  288.  
  289.     "HPFSDOS is already loaded. Use HCONTROL /U to unload."
  290.  
  291.     "Not enough memory."
  292.     - If you use LOADHIGH, ensure sufficient upper memory is available.
  293.  
  294.     "Sorry, there are no HPFS partitions to install."
  295.     - HPFSDOS cannot find HPFS partitions on your disk drives.
  296.  
  297.     "Error: There is no partition table at disk .., sector ..."
  298.     "Error: The partition signature might be damaged."
  299.     - Please check your disk.
  300.  
  301.     "Error: HPFSDOS supports only 10 HPFS partitions. You don't really
  302.     have that many partitions?"
  303.  
  304.     "Cannot mount all partitions - please increase LASTDRIVE!"
  305.     - To get rid of this problem, add "LASTDRIVE=Z" (or any lower
  306.     value which works) to your CONFIG.SYS.
  307.  
  308.     "Error HPFS001: Boot block is not HPFS!"
  309.     "Error/Warning HPFSxxx: Please run OS/2 CHKDSK!"
  310.     - Please check your disk.
  311.  
  312.     "Warning HPFS011: Drive was improperly stopped. Please run OS/2 CHKDSK!"
  313.     - You didn't shutdown OS/2 properly. There might be some
  314.     inconsistencies in the file system.
  315.  
  316.  
  317.     During operation:
  318.  
  319.     "Access denied."
  320.     - This is no HPFSDOS error, but a DOS or application error. HPFSDOS
  321.     doesn't allow you to create, change or delete files and returns an
  322.     "access denied" error code to the application.
  323.  
  324.  
  325.  
  326.     5. Licence Information, Registering
  327.     ===================================
  328.  
  329.     Developing HPFSDOS has taken much time. I am sure you will recognize
  330.     my work, so there are no limitations in the shareware version.
  331.  
  332.     You may try this program for 30 days. If you want to continue using
  333.     it, you are expected to register. If you don't like HPFSDOS, simply
  334.     DEL it.
  335.  
  336.  >> If you register this version, you'll get the latest version on
  337.  >> floppy disk.
  338.  
  339.     Please use the enclosed order forms to ensure proper processing of
  340.     your order.
  341.  
  342.     Prices (subject to change without notice), per computer:
  343.  
  344.              Country    Base product   Shipping  Total
  345.              -------------------------------------------------
  346.              Germany    DM 28.-        DM 5.-    DM 33.-
  347.              World      DM 28.-        DM 11.-   DM 39.-
  348.                      or US$ 16.50      US$ 6.50  US$ 23.-
  349.  
  350.              NB: DM=Deutsche Mark          5+ copies: inquire!
  351.  
  352.     There is no printed manual available.
  353.  
  354.  
  355.  
  356.     The author
  357.     ----------
  358.  
  359.     Robert Muchsel, Hegaublick 2, D-78465 Konstanz, Germany
  360.     Fax:   +49-7533-3151
  361.     EMail: rmuchsel@iiic.ethz.ch
  362.            Fidonet 2:246/8100.11
  363.  
  364.     I am studying computer science at the Swiss Federal Institute of
  365.     Technology in Zurich, Switzerland.
  366.  
  367.     You might already know my other shareware programs:
  368.       AMIsetup - External setup for AMI BIOS
  369.       CDU8002  - Audio support for Apple CD-150/SC-CD under OS/2
  370.       EFDD     - Use up to 20 floppy disk drives under DOS
  371.  
  372.  
  373.     Important
  374.     ---------
  375.  
  376.     The author disclaims all warranties as to this software, whether
  377.     express or implied, including without limitation any implied warranties
  378.     of merchantability, fitness for a particular purpose, functionality,
  379.     data integrity or protection, in so far as permitted by applicable
  380.     legislation.
  381.  
  382.     All trademarks are property of their respective owners and appear for
  383.     identification purposes only.
  384.  
  385.     You are encouraged to copy and pass on the unregistered shareware
  386.     version of this program, if
  387.     - the program is distributed in its original form
  388.       (complete, unmodified)
  389.     - the distribution fee does not exceed the equivalent of DM 15.-
  390.       (US$ 8.50).
  391.  
  392.  
  393.     16 October 1994
  394.