SETSIZE v1.00 - Quickie Documentation

Simply put, use SETSIZE when you want to

        o Fill a disk to capacity or to any given amount

        o Create extremely compressible files for testing compression
          rates boasted by tape backup software, file transfer
          protocols, or file compression utilities (SETSIZE creates
          files consisting entirely of nulls, or ASCII 0x00).

       o  Software developers:  Use SETSIZE to fill a disk and then make
          sure your programs know how to deal with such a disk during
          the debugging stages of your project.

Usage is simply

        SETSIZE filename [size]

    where 'filename' is the name of the file to create/overwrite, and
    'size' is the desired size of the file in bytes.  If you omit the
    'size' parameter, it defaults to zero.  If you append 'K', 'M' or
    'G' to the size, the size will be taken as kilobytes, megabytes or
    gigabytes, respectively.

    If the file exists, you will be prompted to confirm that you wish to
    overwrite the file.  BE CAREFUL--THIS IS YOUR ONLY WARNING!!

    A DOS errorlevel of 0 will be returned if all goes well.  If there
    are any errors, an errorlevel of 1 will be returned.

Examples:

    You want to create a file that is exactly 1,048,576 bytes in length
    (one megabyte) that you will upload to a BBS in order to test your
    modem's theoretical upper transmission rates:

                setsize modem.tst 1Mb
        or
                setsize modem.tst 1048576

        Remember, compression algorithms work best with data that is
        very homogenous.  A one megabyte file created by SETSIZE
        compresses to a mere 1,032 bytes using PKZip.  Sending such a
        highly compressible file via modem should prove interesting.

    You want to fill a floppy disk to capacity:

                setsize a:foo 2m

        You'll get an error because there isn't 2Mb of space on a
        diskette, but the file FOO will have been created anyway,
        filling up every last bit of space on the disk.

Contact Info:

        Keeping in mind that this is freeware, you're welcome to contact
        me if there are any problems or questions concerning SETSIZE:

                ClarkWehyr Enterprises
                7204 Knobwood Drive Suite E.
                Indianapolis, IN 46260
                (317) 298-7707  Voice
                (317) 298-5391  Fax/BBS

                Robert B. Clark <rclark@iquest.net>

                                  ###