home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / s / safpak15.zip / SAFEPACK.DOC < prev    next >
Text File  |  1993-03-09  |  44KB  |  973 lines

  1.                                  S A F E P A C K
  2.                                  ===============
  3.  
  4.                            The SAFE Disk Defragmenter
  5.  
  6.  
  7.                             User Manual - Version 1.5
  8.  
  9.  
  10.                                     CONTENTS
  11.                                     ========
  12.  
  13.        Introduction  . . . . . . . . . . . . . . . . . . . . . . . .    2
  14.  
  15.        Why May Your Disk Need to be Defragmented?  . . . . . . . . .    2
  16.  
  17.        Why Safety is Important in a Defragmenter . . . . . . . . . .    3
  18.  
  19.        Requirements & Limitations  . . . . . . . . . . . . . . . . .    4
  20.  
  21.        Usage Procedure for SAFEPACK  . . . . . . . . . . . . . . . .    5
  22.             Swap Files . . . . . . . . . . . . . . . . . . . . . . .    6
  23.  
  24.        SAFEPACK Options  . . . . . . . . . . . . . . . . . . . . . .    6
  25.             Sorting Options  . . . . . . . . . . . . . . . . . . . .    7
  26.             Individual File vs Sub-directory Based Sorting . . . . .    8
  27.             Sorting Optimizations  . . . . . . . . . . . . . . . . .    8
  28.             Directory Sorting  . . . . . . . . . . . . . . . . . . .    9
  29.             Immobile Files . . . . . . . . . . . . . . . . . . . . .    9
  30.             OS/2 Control . . . . . . . . . . . . . . . . . . . . . .   11
  31.             Running from the Command Line Only . . . . . . . . . . .   11
  32.             Miscellaneous Options  . . . . . . . . . . . . . . . . .   12
  33.  
  34.        SAFEPACK Errors . . . . . . . . . . . . . . . . . . . . . . .   13
  35.  
  36.        Registration & Support  . . . . . . . . . . . . . . . . . . .   15
  37.             Payment  . . . . . . . . . . . . . . . . . . . . . . . .   15
  38.  
  39.        Disclaimer - Agreement  . . . . . . . . . . . . . . . . . . .   17
  40.  
  41.                                _______
  42.                           ____|__     |                (R)
  43.                        --|       |    |-------------------
  44.                          |   ____|__  |  Association of
  45.                          |  |       |_|  Shareware
  46.                          |__|   o   |    Professionals
  47.                        -----|   |   |---------------------
  48.                             |___|___|    MEMBER
  49.  
  50.                                    D J Harvey
  51.  
  52.               Copyright (C) 1993 D.J.Harvey.  All Rights Reserved.
  53.  
  54.                        --- SAFEPACK Manual --- Page 1 ---
  55.        Introduction
  56.        ============
  57.  
  58.        SAFEPACK reorganizes the files on a disk, moving them around as
  59.        necessary to ensure that each file occupies a single, contiguous
  60.        block of disk space, improving the effective performance of the
  61.        drive.  Apart from this improvement in speed, many users will
  62.        benefit from the collection together of all the free space on the
  63.        disk, allowing the creation of large, contiguous special files. 
  64.        An example of this is a Windows 3 permanent swap file, and the
  65.        Windows manual suggests that a disk defragmenter be run before
  66.        creating a permanent swap file.  No such program is supplied,
  67.        however, and SAFEPACK is designed to fill this gap.  For the user
  68.        who wishes to fine-tune the organization of the disk, a large
  69.        number of options are provided to control the final arrangement of
  70.        the files.  Those using both DOS & OS/2 will benefit from
  71.        SAFEPACK's ability, safely, to defragment the very fragmented
  72.        hidden files that OS/2 creates on DOS type disks.
  73.  
  74.        As its name implies, SAFEPACK has been designed with data security
  75.        as the most important principle, and it manipulates the disk file
  76.        structures such that they are all valid at all times.  This means
  77.        that no loss of data should occur if the program is interrupted
  78.        while running, whether this be due to user break-in, machine
  79.        malfunction, or even power failure.
  80.  
  81.        SAFEPACK is distributed as 'Shareware', which means that though
  82.        you are free to evaluate and distribute the program, anyone
  83.        intending to make continued use of it must register with the
  84.        author, and pay the appropriate fee, which for a single user is
  85.        nine pounds Sterling.  Credit/charge cards are accepted, removing
  86.        the need for currency conversions.  Full registration details are
  87.        given below, and in the file REGISTER.DOC.
  88.  
  89.  
  90.        Why May Your Disk Need to be Defragmented?
  91.        ==========================================
  92.  
  93.        If you are fully conversant with the problem of disk
  94.        fragmentation, and know exactly why your disk needs to be
  95.        defragmented, you can skip this section, and go to the following
  96.        section on safety.
  97.  
  98.        In order to understand why a program such as this is required, it
  99.        is necessary to understand just a little about how DOS actually
  100.        stores files on a disk.  Although users generally refer to files
  101.        simply by their path & filename, DOS must allocate space for each
  102.        file on the disk, and be able to keep track of where each file is. 
  103.        Is does this by dividing the disk into a number of 'Allocation
  104.        Units' or 'Clusters', normally of 512, 1024, 2048 or 4096 bytes,
  105.        and when a file is written, DOS allocates as many unused clusters
  106.        as are necessary to accommodate it. Where possible, DOS uses
  107.  
  108.                        --- SAFEPACK Manual --- Page 2 ---
  109.        consecutive clusters, as this improves the speed of both reading
  110.        and writing, but this is not always possible, especially after a
  111.        disk has been in use for some time, as the unused clusters may be
  112.        scattered around the disk in locations previously occupied by
  113.        files which have since been deleted.
  114.  
  115.        An example may make this clearer:
  116.  
  117.        Suppose a very small disk with 18 clusters has 6 files, named F1-
  118.        F6 on it, and that they are located as in the following map:
  119.  
  120.        Cluster:  |1  2 |3  4  5 |6  7 |8  9 10 11 12|13 14|15 16|17 18
  121.        File:     | F1  |   F2   | F3  |      F4     | F5  | F6  | FREE
  122.  
  123.        If files F1, F3 & F5 are now deleted, the map becomes:
  124.  
  125.        Cluster:  |1  2 |3  4  5 |6  7 |8  9 10 11 12|13 14|15 16|17 18
  126.        File:     |FREE |   F2   |FREE |      F4     |FREE | F6  | FREE
  127.                                                      
  128.        There are now 8 free allocation units, and if a file requiring 7
  129.        units called F7 were to be written to this disk, it would have to
  130.        be put into the free space, which is spread over the disk, making 
  131.        the new map:
  132.  
  133.        Cluster:  |1  2 |3  4  5 |6  7 |8  9 10 11 12|13 14|15 16|17|18
  134.        File:     | F7  |   F2   | F7  |      F4     | F7  | F6  |F7|FREE
  135.  
  136.        File F7 is now said to be fragmented, making access to it
  137.        significantly slower than if it were in one contiguous section. 
  138.        Over time, similar fragmentation occurs to many of the files on a
  139.        disk, reducing the effective performance of the drive.  This
  140.        process happens slowly, however, so the gradual degradation in
  141.        drive performance is likely to go un-noticed for a long time. 
  142.        SAFEPACK reorganizes the files on the disk, amalgamating the
  143.        scattered parts of each file, restoring the disk to its original
  144.        speed.
  145.  
  146.  
  147.        Why Safety is Important in a Defragmenter
  148.        =========================================
  149.  
  150.        As described above, SAFEPACK moves most of your data from one part
  151.        of your disk to another, and this takes quite a long time
  152.        (typically 2-30 mins depending on machine, disk size etc).  During
  153.        such an interval there is clearly the possibility of a failure of
  154.        either the power supply or of the machine, and it is important to
  155.        consider what would happen to the valuable data on the disk if
  156.        this were to happen.  Some commercial defragmenters can wreck the
  157.        file structure of a disk if they are interrupted, but SAFEPACK has
  158.        been designed, as its name implies, to be tolerant of
  159.        interruptions, and should leave your disk in a fully usable
  160.        condition, even if switched off in the middle.  SAFEPACK achieves
  161.  
  162.                        --- SAFEPACK Manual --- Page 3 ---
  163.        this by ensuring that the file structures are valid at all times
  164.        during the run, and though this may slow the program down
  165.        slightly, what is an extra few minutes running time, compared with
  166.        having to reload your hard disk from scratch?
  167.  
  168.        That said, however, Murphy's law of computers dictates that
  169.        something unforeseen will always happen somewhere at some time,
  170.        and despite my belief in the safety of this program, I would not
  171.        recommend that anyone defragments their hard disk with ANY
  172.        defragmenter, without first taking a full backup.  Backups should
  173.        be taken occasionally anyway, and as there is rarely any great
  174.        urgency to defragment a disk, it would make sense to run SAFEPACK
  175.        immediately after the backup.  Further aspects of data security
  176.        are mentioned in the detailed usage instructions below.
  177.  
  178.  
  179.        Requirements & Limitations
  180.        ==========================
  181.  
  182.        SAFEPACK requires and supports all versions of MS DOS between 2.0
  183.        and 5.0, and all DR DOS up to 6.0.  There is no fixed memory
  184.        requirement other than the size of the program itself, but
  185.        SAFEPACK uses as much conventional memory as possible, and the
  186.        number of files it can handle is proportional to the amount of
  187.        memory available.  Given the normal space of about 550k, SAFEPACK
  188.        can keep track of about 5000 files.  If it does run out of memory
  189.        it will terminate, but in doing so will leave the disk data
  190.        intact.  
  191.  
  192.        It should be possible to defragment any true DOS disk, whether
  193.        floppy or hard (including partitions), and even RAMdisks or non-
  194.        standard media such as 8" floppies, but the following types of
  195.        disk MUST NOT be packed:
  196.  
  197.        a) Network drives 
  198.  
  199.        If it is required to pack a DOS network drive, this should be done
  200.        locally, with the network disabled.
  201.  
  202.        b) Substituted drives
  203.  
  204.        These are virtual drives, which are in fact sub-directories of
  205.        another drive.
  206.  
  207.        c) Drives with proprietary compression methods
  208.  
  209.        Examples of this are Stacker or Superstor, and although
  210.        compression of such disks would normally be safe, it would not be
  211.        of any benefit, and will not be performed by SAFEPACK. 
  212.  
  213.  
  214.  
  215.  
  216.                        --- SAFEPACK Manual --- Page 4 ---
  217.        Usage Procedure for SAFEPACK
  218.        ============================
  219.  
  220.        Although it should be possible to run SAFEPACK safely at any time,
  221.        the following procedure is recommended for maximum data security.
  222.  
  223.        1)   Run CHKDSK to ensure that there are no internal errors in the
  224.             File Allocation Table (FAT) for the drive to be defragmented.
  225.         
  226.             The format of this DOS command is:
  227.  
  228.             CHKDSK drive:  
  229.  
  230.             If all is reported as being well, go on the next stage, but
  231.             if errors are found, they must be corrected before running
  232.             SAFEPACK.  Note that many common errors can easily be
  233.             corrected by running CHKDSK with the /F (for Fix) switch.
  234.  
  235.        2)   The AUTOEXEC.BAT & CONFIG.SYS files, which normally contain
  236.             device drivers and other resident programs should be
  237.             disabled, either by temporarily renaming them and then
  238.             rebooting, or by booting from a floppy drive.
  239.  
  240.             Although not always necessary, this step ensures that there
  241.             are no background programs, or TSRs, which could try to
  242.             access the disk during defragmentation, as this could lead to
  243.             data corruption.  The absence of TSRs will also, normally,
  244.             increase the memory available to SAFEPACK. If you have a disk
  245.             greater than 32 Mbytes, you may receive a warning about
  246.             loading SHARE for large media - this can be ignored for
  247.             running SAFEPACK.  Experienced users may wish make temporary
  248.             modifications to their startup files by placing REM at the
  249.             start of any offending lines.
  250.  
  251.        3)   Run SAFEPACK as a command from the DOS command-line.  It must
  252.             NOT be run from within Windows, or any other multi-tasking
  253.             environment.
  254.  
  255.             The format of the command is
  256.  
  257.             SAFEPACK drive: [options]
  258.  
  259.             where drive is the drive letter of the disk to be
  260.             defragmented, and options are as described below.
  261.  
  262.             Default options exist, which are designed to be suitable for
  263.             the majority of users, including those maximizing their free
  264.             space prior to making a Windows swap file.  The following
  265.             example command line would therefore be appropriate for
  266.             defragmenting drive C:
  267.  
  268.             SAFEPACK C:
  269.  
  270.                        --- SAFEPACK Manual --- Page 5 ---
  271.             Before SAFEPACK commences, a screen will appear, showing the
  272.             drive and options selected, and you are asked to confirm that
  273.             these are correct before defragmentation starts.  This stage
  274.             may be by-passed by use of the /Y- option if you wish to run
  275.             SAFEPACK unattended in a batch file.
  276.  
  277.             While SAFEPACK is running, it will give an indication of its
  278.             progress, but this is intended as a guide only, and is far
  279.             from linear, so do not become alarmed if it appears not to
  280.             change for several minutes.  After two minutes, SAFEPACK
  281.             replaces its normal display by a simplified version, which
  282.             moves around the display area.  This is in order to prevent
  283.             damage to your screen during a prolonged run, and the normal
  284.             screen may be restored at any time by pressing N.
  285.  
  286.             The program may be interrupted at any time by pressing Ctrl-C
  287.             or Ctrl-Break.  If this is done, a message will appear
  288.             acknowledging the break, but the program will tidy-up the
  289.             disk before terminating a few seconds later.
  290.  
  291.        4)   After running SAFEPACK, confirm that the disk's file
  292.             structure remains correct by running CHKDSK again.
  293.  
  294.        Note that some disk caches can become confused after running a
  295.        defragmenter, as not all respond properly to SAFEPACK's request to
  296.        reset the disk.  Therefore, if CHKDSK or a directory listing
  297.        indicate a problem, it can probably be cured by rebooting the
  298.        computer, but if this fails, then the file RECOVER.DOC should be
  299.        consulted for advice.
  300.  
  301.        Swap Files
  302.        ----------
  303.  
  304.        SAFEPACK will automatically leave the swap files created by
  305.        Windows 3 or similar programs alone, and if you do not intend to
  306.        change the size of any such files, their presence may be ignored. 
  307.        If, however, one of the objects of defragmenting your disk is to
  308.        increase the size of a swap file, then it should be deleted before
  309.        running SAFEPACK, and re-created (with its new size) afterwards.
  310.  
  311.  
  312.        SAFEPACK Options
  313.        ================
  314.  
  315.        The command line options available are described in detail below,
  316.        but a quick on-screen summary may be obtained by running SAFEPACK
  317.        with the /H switch.  Most options may be entered on their own to
  318.        activate them, or followed by - to suppress, the default varying
  319.        from one option to another according to likely usage. For example:
  320.  
  321.        /D  would activate directory sorting (default)
  322.        /D- would suppress directory sorting.
  323.  
  324.                        --- SAFEPACK Manual --- Page 6 ---
  325.  
  326.        Sorting Options
  327.        ---------------
  328.  
  329.        Subject to the various restrictions/modifications on sorting
  330.        described below, there are five basic methods used determine the
  331.        final order of the files on the disk.  By default, the files are
  332.        sorted alphabetically, but the method used may be selected by use
  333.        of the following switches:
  334.  
  335.        /N :  Name sorting;
  336.  
  337.        This is the default if no other sorting criterion is specified.
  338.        Files are sorted alphabetically by filename and extension,
  339.        regarded as a single 11 character string.
  340.  
  341.        /E :  Extension sorting
  342.  
  343.        Files are sorted in alphabetical order of extension only.
  344.  
  345.        /L :  Length Sorting 
  346.  
  347.        Files are sorted by length, with the longest being placed first. 
  348.        This is quite a useful option, as it can help to reduce future
  349.        fragmentation. Sub-directories, which do not have a length, are
  350.        placed before the files. 
  351.  
  352.        /A :  Age Sorting
  353.  
  354.        Files are sorted by their ages, the oldest being placed first. 
  355.        Again, this can help to reduce future fragmentation, as it is
  356.        generally newer files that are more likely to be deleted, thereby
  357.        creating free space at the end of the disk rather than at the
  358.        start.
  359.  
  360.        /C :  Current position Sorting
  361.  
  362.        Files are sorted such that the order in which their first cluster
  363.        appears on the disk is as it was before the pack.  This could be
  364.        useful if files are regularly accessed in a particular order, and
  365.        may be faster than the other options.
  366.  
  367.        /R :  Reverse sort
  368.  
  369.        This switch works in conjunction with any of the above sorting
  370.        methods, to reverse the resulting order.
  371.  
  372.        e.g. SAFEPACK C: /L /R
  373.  
  374.        would arrange the files such that the shortest were sorted to the
  375.        start of the disk.
  376.  
  377.  
  378.                        --- SAFEPACK Manual --- Page 7 ---
  379.        Individual File vs Sub-directory Based Sorting
  380.        ----------------------------------------------
  381.  
  382.        /F :  Filesorting
  383.  
  384.        The normal mode of operation of SAFEPACK is to place the files on
  385.        the disk in an order that reflects the hierarchical directory
  386.        structure, each sub-directory being sorted as if it were a file,
  387.        followed by the files it contains.  This method has the advantage
  388.        of speeding access to complicated sub-directory structures, as the
  389.        disk head has to move only short distances between directories and
  390.        the files they contain.  It does, however, mean that the options
  391.        above, such as placing the longest files at the start of the disk,
  392.        are not fully effective, as a long file may end up at the start of
  393.        a directory which is itself towards the end of the disk.  The /F
  394.        (Filesort) switch is therefore provided to sort files on the disk
  395.        by their own characteristics, rather than by their parent
  396.        directories.  Note that if this switch is used with sorting by
  397.        filename, then only the 11 characters of the basic filename &
  398.        extension are used, not the pathname.  This option would probably
  399.        be of most use with the /L (length) or /A (age) options.
  400.  
  401.  
  402.        Sorting Optimizations
  403.        ---------------------
  404.  
  405.        Generally speaking, the closer a file is to the start of the disk,
  406.        the more quickly it can be accessed, and as some files are
  407.        accessed more often than others, it would make sense to place
  408.        these files towards the start of the disk. In the absence of
  409.        precise information on the frequency with which files are
  410.        accessed, three assumptions can be made:
  411.  
  412.        1)   Sub-directories are accessed more commonly than individual
  413.             files within a directory.
  414.  
  415.        2)   Executable files (.EXE & .COM), are accessed more frequently
  416.             than other files.
  417.  
  418.        3)   Files in sub-directories defined in the DOS PATH list, are
  419.             accessed more commonly than others.
  420.  
  421.        By default, all of these assumptions are used in sorting the
  422.        files, so directories in the PATH list are placed towards the
  423.        beginning of the disk, and sub-directories are placed at the start
  424.        of the directories.  These are followed by files with .EXE & .COM
  425.        extensions, followed in turn by the other files, each category
  426.        being arranged according to the main sorting mode selected.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.                        --- SAFEPACK Manual --- Page 8 ---
  433.        These assumptions may be disabled if required as follows:
  434.  
  435.        /X :  Executables/Directories
  436.  
  437.        If this option is set to off (/X-), then files are sorted without
  438.        any priority being given to executable files (.EXE & .COM) or
  439.        directories.
  440.  
  441.  
  442.        /P :  Path
  443.  
  444.        If set to off (/P-), then the DOS path is ignored.
  445.  
  446.        Note that any sorting order for sub-directories may be selected by
  447.        altering the DOS PATH before running SAFEPACK, as it does not have
  448.        to be your normal PATH.  See the DOS manual for details of how to
  449.        change the PATH. This option is automatically disabled if the
  450.        filesorting (/F) switch is used.
  451.  
  452.  
  453.        Directory Sorting
  454.        -----------------
  455.  
  456.        /D :  Directory sorting
  457.  
  458.        SAFEPACK is able to sort the directory entries to reflect the
  459.        order in which files are placed on the disk, and in so doing also
  460.        'packs' the directories to eliminate space occupied by deleted
  461.        files, marginally increasing the speed at which files are
  462.        accessed.  This process is quite distinct from the reorganization
  463.        of the files themselves, and though it is performed by default, it
  464.        can be disabled if required by using the switch /D-.
  465.  
  466.  
  467.        Immobile Files
  468.        --------------
  469.  
  470.        Normally, a program accessing a disk file neither knows, nor cares
  471.        about the exact position of a file on the disk, providing that it
  472.        can be found through its directory entry.  There are, however, a
  473.        few exceptions to this rule, and in these cases SAFEPACK can leave
  474.        the file untouched.  Most files to be left alone are, effectively,
  475.        labelled as immobile by the programs that created them, as they
  476.        have their 'system' and 'hidden' attributes set, and SAFEPACK will
  477.        not attempt to move any files in this category.  Examples of such
  478.        files include the main DOS files IBMBIO.SYS & IBMDOS.SYS (or
  479.        similar) that contain the main operating system, and 386SPART.PAR
  480.        created by Windows when making a permanent swap file.
  481.          
  482.        Apart from these, other necessarily immobile files may have been
  483.        created on the disk as part of copy-protection schemes etc.  The
  484.        vast majority of these will be marked as either hidden or system
  485.  
  486.                        --- SAFEPACK Manual --- Page 9 ---
  487.        (or normally both), and should not, therefore cause any problems,
  488.        but if any others are known, the following options will allow  you
  489.        to indicate any that must remain static.
  490.  
  491.  
  492.        /I :  Immobile files by name
  493.  
  494.        An option of the form /Ifilename ensures that any files on the
  495.        disk with the name 'filename' will not be moved.  Only the actual
  496.        filename, without a pathname, should be quoted, and this will
  497.        immobilize files of that name in any directory.  If no extension
  498.        is given, it is assumed to be blank (i.e. 3 spaces), but
  499.        simplified wildcards are allowed, in that either the filename, or
  500.        extension may be replaced entirely by *. Thus the following
  501.        options are valid:
  502.  
  503.        /IMYFILE.TXT   immobilizes MYFILE.TXT
  504.        /IMYFILE.*     immobilizes all files called MYFILE whatever the
  505.                       extension.
  506.        /I*.SYS        immobilizes all files in all directories with an
  507.                       extension of SYS
  508.  
  509.        /IMY*.TXT would not, however, be valid, as partial wildcards are
  510.        not allowed.
  511.  
  512.        Several /I options may appear on the command line, to immobilize
  513.        different files.
  514.  
  515.  
  516.        /S :  Static files by attribute
  517.  
  518.        By default, files that are have either their hidden or system
  519.        attributes set are regarded by SAFEPACK as being immobile, but any
  520.        set of attributes may be selected as immobile using the /S option.
  521.  
  522.         Note that files which are both 'hidden' AND 'system' will not be
  523.        moved, irrespective of these options.
  524.  
  525.        The format is /Sx[-].., where x is one of the following:
  526.         
  527.        D: Sub-directories
  528.        H: Hidden files
  529.        S: System files
  530.        R: Read-only files
  531.        A: Files with the 'Archive' bit set 
  532.  
  533.        Examples:
  534.  
  535.        /SD       immobilizes all sub-directories
  536.        /SH- /SR  allows hidden files to be moved, but immobilizes all
  537.                  read-only files
  538.  
  539.  
  540.                        --- SAFEPACK Manual --- Page 10 ---
  541.        The above mechanisms should cope well with most varieties of copy
  542.        protection schemes, but in the event of problems with a
  543.        particularly badly behaved program, it should be possible, as a
  544.        last resort, to de-install the program before defragmentation,
  545.        then re-install it after.
  546.  
  547.  
  548.        OS/2 Control
  549.        ------------
  550.  
  551.        If you do not use the OS/2 operating system, this section may
  552.        safely be skipped.
  553.  
  554.        OS/2 can use disks formatted in the MS-DOS manner (called FAT
  555.        volumes), but in order to do so, has to create hidden files
  556.        (called "EA DATA. SF" & "WP ROOT. SF") to hold extra information
  557.        about files for which there is no space in the main directory. 
  558.        The first of these files tends to become excessively fragmented,
  559.        and its presence, if left unmoved, would impede the
  560.        defragmentation of the remainder of the disk.  SAFEPACK can
  561.        therefore regard these files as exceptions to the rule that hidden
  562.        and system files are left alone, and this exception is controlled
  563.        by the /o switch.  By default, this switch is on enabling the
  564.        files to be defragmented, so there is normally no need to use it,
  565.        but should you wish the OS/2 hidden files not to be touched, then
  566.        this can be achieved by adding /o- to the command line.
  567.  
  568.  
  569.        Running from the Command Line Only
  570.        ----------------------------------
  571.  
  572.        /Y :  User Confirmation On/Off
  573.  
  574.        If this option is on, as it is by default, then a screen appears
  575.        before the defragmentation starts, asking the user to press Y to
  576.        confirm the drive and options selected, and a key-press is also
  577.        required at the end of the program.  If this option is disabled,
  578.        using /Y-, then no user input is required during the run, making
  579.        the program suitable for running in a batch file, and in this
  580.        manner, a number of drives may be defragmented with a single
  581.        command.  If this option is used, any errors cause immediate
  582.        termination of the program, rather than prompting for Retry/Abort,
  583.        as would be the normal practice. Those using SAFEPACK in a batch
  584.        files may find the following exit codes useful, as they can be
  585.        tested using the errorlevel function:
  586.  
  587.        0 : Normal completion
  588.        1 : Terminated by user interrupt
  589.        2 : Terminated due to an error
  590.  
  591.  
  592.  
  593.  
  594.                        --- SAFEPACK Manual --- Page 11 ---
  595.        Miscellaneous Options
  596.        ---------------------
  597.  
  598.        /Q :  Quick pack
  599.  
  600.        The normal mode of operation of SAFEPACK is to move all files,
  601.        irrespective of their current positions, to positions based on the
  602.        sorting order as defined by the above options. This method not
  603.        only ensures optimal arrangement of the files, but also ensures
  604.        that all the free space is contiguous, as is advisable before
  605.        creating swap files.  The /Q switch, however, invokes a quicker
  606.        method whereby only those files that are currently fragmented are
  607.        moved.  It is suggested that the /Q switch should not be used for
  608.        the initial packing of a disk, but should be used for most 
  609.        subsequent defragmentation, a complete reorganization, without the
  610.        /Q switch being performed every few months.
  611.  
  612.  
  613.        /B :  Bypass Multitasking Checks
  614.  
  615.        Before starting to defragment a disk, SAFEPACK checks to see
  616.        whether it is being used from within a multi-tasking environment
  617.        such as Windows, MS DOS 5 taskswitcher, or DR DOS TaskMAX, as
  618.        these could be unsafe for defragmentation. Later versions of
  619.        FASTOPEN are also detected. SAFEPACK will normally refuse to
  620.        proceed if one of these environments is identified, but for those
  621.        users who know what they are doing, this option is provided to
  622.        bypass such checks, and to carry on anyway.  Note that some system
  623.        software provides its own protection against such risky procedures
  624.        and may refuse to let SAFEPACK write to the system areas of the
  625.        disk, even if this option is used.
  626.  
  627.        This option is not for the novice - you have been warned!
  628.  
  629.  
  630.        /V :  Verify
  631.  
  632.        DOS has an option to verify all disk writes, by reading back the
  633.        data after it has been written. This procedure increases data
  634.        security at the expense of speed, and is normally controlled by
  635.        the DOS VERIFY command.  By default, SAFEPACK leaves the verify
  636.        switch unaltered, but verification can be selected independently
  637.        for SAFEPACK with the this option, /V turning verification on, and
  638.        /V- turning it off.  In either case, SAFEPACK returns DOS to its
  639.        original status at the end of the program.
  640.  
  641.  
  642.        /M :  Monochrome screen
  643.  
  644.        This option sets the screen colours so that they are more legible
  645.        on monochrome screens.
  646.  
  647.  
  648.                        --- SAFEPACK Manual --- Page 12 ---
  649.        SAFEPACK Errors
  650.        ===============
  651.  
  652.        The majority of SAFEPACK error messages are self-explanatory, and
  653.        most refer to user errors on the command-line such as requesting
  654.        defragmentation of a non-existent disk.  Some, however, require
  655.        more explanation.
  656.  
  657.  
  658.        Multi-tasking environment XXX or FASTOPEN detected
  659.        --------------------------------------------------
  660.  
  661.        It is not safe to defragment a disk from within a multi-tasking
  662.        environment such as Windows, and SAFEPACK contains checks for the
  663.        more common of such environments.  If you encounter this message
  664.        and are running a multi-tasking environment, terminate the multi-
  665.        tasker before re-running SAFEPACK.  If FASTOPEN is found, then it
  666.        is necessary to reboot after removing FASTOPEN from the CONFIG.SYS
  667.        or AUTOEXEC.BAT file. If you really wish to defragment under such
  668.        circumstances and understand what you are doing, or if this error
  669.        occurs without obvious reason, then the checks may be by-passed
  670.        with the /B option.  If this error is reported, no writing to the
  671.        disk will have occurred.
  672.  
  673.  
  674.        Error in the File Allocation Table
  675.        ----------------------------------
  676.  
  677.        SAFEPACK performs a stringent test of the disk's file structure
  678.        before starting to defragment it, and will abort with this message
  679.        if any errors are found, however minor.  Most common errors may be
  680.        fixed by running CHKDSK with the /F switch  - see the DOS manual
  681.        for details.  If this error is reported, no writing to the disk
  682.        will have occurred.
  683.  
  684.  
  685.        Insufficient memory for the program to continue
  686.        -----------------------------------------------
  687.  
  688.        This error is most likely to occur if there are more than about
  689.        5000 files on the disk, or if you have less than 500k of free
  690.        memory.  Under some circumstances, it may be possible to run
  691.        SAFEPACK again with the same options, with success.  The disk
  692.        should remain fully usable after this error, which is a
  693.        'controlled exit'.
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.                        --- SAFEPACK Manual --- Page 13 ---
  703.        Disk read/write errors
  704.        ----------------------
  705.  
  706.        These may be reported under a variety of names such as write
  707.        protect, drive not ready, data error (CRC), seek error, sector not
  708.        found, write fault, read fault, or general failure. If any of
  709.        these errors occur, then there is likely to be a hardware or
  710.        magnetic surface error on the disk concerned, and SAFEPACK will
  711.        ask whether to retry or to abort - the normal ignore option is not
  712.        provided, as misreads of directory sectors could have disastrous
  713.        results.  If you have a utility to check &/or repair bad sectors
  714.        then this should be used, but otherwise it may be best to reformat
  715.        the disk, and restore your backup.  Note that errors of this type
  716.        are not normally detected by CHKDSK.
  717.  
  718.  
  719.        SAFEPACK Internal errors
  720.        ------------------------
  721.  
  722.        SAFEPACK contains several internal error checks to ensure that it
  723.        is functioning correctly, and if any of these fail then it aborts,
  724.        quoting an error number.  These errors should never be seen by
  725.        users, but can be produced if another program is accessing the
  726.        disk at the same time as SAFEPACK, as can occur if it is used
  727.        under a multi-tasking environment with the /B option.  Should an
  728.        internal error be reported, please check your disk with CHKDSK,
  729.        and contact the author, providing as much detail as possible about
  730.        the circumstances. 
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.                        --- SAFEPACK Manual --- Page 14 ---
  757.  
  758.        Registration & Support
  759.        ======================
  760.  
  761.        SAFEPACK is released as shareware, enabling you not only to try
  762.        the program out before paying for it, but also then to acquire the
  763.        right to use it at low cost, as the author is spared the expensive
  764.        overheads of advertising, retail distribution etc.
  765.  
  766.        This means that you are welcome to evaluate the program by trying
  767.        it out on your machine, and may distribute copies of the original
  768.        compressed file to others, but if you find the program of use,
  769.        then you are required to register by paying the appropriate fee. 
  770.  
  771.        In addition to acquisition of the legal right to use the program,
  772.        those who register will also receive:
  773.  
  774.        1)   A copy of a registered version of the program.  If an updated
  775.             version has been produced since your shareware version, then
  776.             this will be sent.  If, however, you already have the latest
  777.             copy, you may choose whether you wish to receive a registered
  778.             copy of the current version, or whether to wait for the next
  779.             update.  If you choose to wait, you will be sent, in the
  780.             meantime, details of how to convert your shareware version to
  781.             a registered copy, thereby replacing the message about
  782.             shareware with your own name.
  783.  
  784.        2)   Support, via any of the methods of contact given below, for
  785.             two years from the date of registration.  During this time I
  786.             will be happy to provide guidance on the use of the program,
  787.             and discuss any problems that users may have.  In the
  788.             unlikely event of a problem being found in the program which
  789.             could have consequences for data security, all registered
  790.             users would be informed as soon as possible.
  791.  
  792.  
  793.        Payment
  794.        -------
  795.  
  796.        The registration fee may be paid either in pounds Sterling, direct
  797.        to the author, or in US$ via either Software excitement or the
  798.        Compuserve on-line registration scheme.  Registration confers
  799.        exactly the same rights and benefits whichever means of payment is
  800.        chosen, and the choice of method is entirely yours.
  801.  
  802.        The registration fee for a single copy of SAFEPACK is 9 pounds
  803.        Sterling or US$16, inclusive of post & packing. 
  804.  
  805.        Site licences are available from the author at considerable
  806.        discount to the rates for single copies, and details are included
  807.        in the file SITE_LIC.DOC 
  808.  
  809.  
  810.                        --- SAFEPACK Manual --- Page 15 ---
  811.        Registration with D J Harvey Software (9 Pounds Sterling)
  812.        ---------------------------------------------------------
  813.  
  814.        Payment can be accepted in any of the following forms:
  815.  
  816.        1)   Credit/Charge Cards
  817.  
  818.             This is probably by far the easiest way for most people to
  819.             pay, especially those outside the UK, as any card with the
  820.             Visa or Mastercard symbols is accepted, irrespective of your
  821.             currency.  Any necessary currency conversions are performed
  822.             by the credit card companies, so you pay in your own
  823.             currency.
  824.  
  825.             To pay by this method, either print and fill in the file
  826.             CCARD.FRM, and post to the address below, or fill in the form
  827.             on your word processor, and send it via Email.
  828.  
  829.        2)   Sterling Cheque
  830.  
  831.             This may be either a standard UK cheque, a Eurocheque,
  832.             Sterling international postal order or a bank draft drawn on
  833.             a British bank, and should be payable to D J Harvey Software. 
  834.             To register by this method, print out and fill-in the file
  835.             CHEQUE.FRM, then send, accompanied by your cheque, to the
  836.             address below.
  837.  
  838.        Registrations and enquiries may be sent either by standard mail,
  839.        or Email as follows:
  840.  
  841.        Mail:          D J Harvey Software,
  842.                       PO Box 14,
  843.                       Cardiff.  CF4 6XW
  844.                       U.K.
  845.        Fax:           +44 222 743029
  846.  
  847.        Compuserve:    100031,627
  848.        Internet:      100031.627@COMPUSERVE.COM
  849.  
  850.  
  851.        Registration via US agents
  852.        --------------------------
  853.  
  854.        1)   Through Software Excitement!
  855.  
  856.             Payment may be made by Visa, MasterCard, Discover, or Checks
  857.             or Money Orders drawn on US funds, and registration is
  858.             accepted by telephone (toll-free), fax, mail or E-mail.
  859.  
  860.             When ordering from Software excitement, please provide (or
  861.             have ready if telephoning), the following information:
  862.  
  863.  
  864.                        --- SAFEPACK Manual --- Page 16 ---
  865.             a)   Product code - this is 'V330' if you wish to be sent a
  866.                  copy of the latest version irrespective of your current
  867.                  copy, or 'V331' if you wish to convert your current copy
  868.                  to registered form, then to receive a copy of the next
  869.                  upgrade when available.
  870.  
  871.             b)   Your current version number (1.5)
  872.  
  873.             c)   Your preferred disk size (3.5" or 5.25").
  874.                                
  875.             Software Excitement!       
  876.             6475 Crater Lake Hwy
  877.             Central Point, OR  97502  
  878.             USA                       
  879.  
  880.             Orders Toll Free:(800)444-5457
  881.             Order Department:(503)826-8082
  882.             Fax:(503)826-8090
  883.             CIS ID :71203,1301
  884.  
  885.  
  886.        2)   Via Compuserve Shareware Registration Service
  887.  
  888.             To register this way, type GO SWREG at any Compuserve prompt,
  889.             and follow the on-screen instructions, quoting the program ID
  890.             as 424 when asked.  Note that this service does not provide
  891.             any information as to your current version and upgrade
  892.             preferences, so you will be sent a copy of the most recent
  893.             version rather than waiting for an upgrade.
  894.  
  895.        Please note that any questions or support requests should be made
  896.        to the author, rather than to the US agents.
  897.  
  898.  
  899.        Disclaimer - Agreement
  900.        ======================
  901.  
  902.        Users of SAFEPACK must accept this disclaimer of warranty: 
  903.  
  904.        "SAFEPACK is supplied as is.  The author disclaims all warranties,
  905.        expressed or implied, including, without limitation, any
  906.        warranties of merchantability and/or fitness for any purpose. The
  907.        author assumes no liability for damages, direct or consequential,
  908.        which may result from the use of SAFEPACK."  
  909.  
  910.        SAFEPACK is a "shareware program" and is provided at no charge to
  911.        the user for evaluation.  Feel free to share it with your friends,
  912.        but please do not give it away altered or as part of another
  913.        system.  The essence of "user-supported" software is to provide
  914.        personal computer users with quality software without high prices,
  915.        and yet to provide incentive for programmers to continue to
  916.        develop new products.  If you find this program useful and
  917.  
  918.                        --- SAFEPACK Manual --- Page 17 ---
  919.        continue to use SAFEPACK after a reasonable trial period, you must
  920.        make a registration payment of nine pounds Sterling to the author. 
  921.  
  922.        The nine pound registration fee will license one copy for use on
  923.        any one computer at any one time.  You must treat this software
  924.        just like a book.  An example is that this software may be used by
  925.        any number of people and may be freely moved from one computer
  926.        location to another, so long as there is no possibility of it
  927.        being used at one location while it's being used at another, just
  928.        as a book cannot be read by two different persons at the same
  929.        time.  Commercial users of SAFEPACK must register and pay for
  930.        their copies of SAFEPACK within 30 days of first use or their
  931.        license is withdrawn.  Site-License arrangements may be made by
  932.        contacting the author.  
  933.  
  934.        Anyone distributing SAFEPACK for any kind of remuneration must
  935.        comply with the requirements set out in the file VENDOR.DOC
  936.        accompanying this program.
  937.  
  938.        All the registered trademarks used herein are registered to
  939.        whoever it is that owns them. This notification is given in lieu
  940.        of any specific list of trademarks and their owners. 
  941.  
  942.        D J Harvey is a member of the Association of Shareware
  943.        Professionals (ASP).  ASP wants to make sure that the shareware
  944.        principle works for you. If you are unable to resolve a
  945.        shareware-related problem with an ASP member by contacting the
  946.        member directly, ASP may be able to help. The ASP Ombudsman can
  947.        help you resolve a dispute or problem with an ASP member, but does
  948.        not provide technical support for members' products.  Please write
  949.        to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or
  950.        send a CompuServe message via CompuServe Mail to ASP Ombudsman
  951.        70007,3536.
  952.                                _______
  953.                           ____|__     |                (R)
  954.                        --|       |    |-------------------
  955.                          |   ____|__  |  Association of
  956.                          |  |       |_|  Shareware
  957.                          |__|   o   |    Professionals
  958.                        -----|   |   |---------------------
  959.                             |___|___|    MEMBER
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.                        --- SAFEPACK Manual --- Page 18 ---
  973.