Ŀ
 LDZIP v2.25 (C)2000-2003 J.Tigchelaar (http://ldzip.port5.com) 


Description
===========
LDZIP lets you create a ZIP file with long filenames in plain MS-Dos,
Windows 95/98/ME/NT/2000/XP. It supports FAT16, FAT32 and NTFS drives,
and is designed to be an easy and fast way to back up long filenames
when Windows 95/98/ME/NT/2000/XP fails to start. The resulting ZIP file
can be used by any ZIP utility supporting long filenames (WinZIP and so on).

In plain MS-Dos NTFS drives are supported by using NTFSDos Professional.
NTFSDos Professional can be found at http://www.sysinternals.com.

In Windows NT you first need to load LFN/NT version 1.0.
LFN/NT version 1.0 can be found at http://www.mbs.spb.ru/lfnnt.htm.

LDZIP creates a ZIP file with long filenames containing all the files
included by the includelist INCLUDE.LD and excluded by the excludelist
EXCLUDE.LD. Both lists can contain long filenames, short filenames,
wildcards, dos environment variables and an optional /s for subdirectories.

Before use
==========
Prepare the two textfiles below before using LDZIP.

INCLUDE.LD - includelist for LDZIP, can contain long filenames, short
             filenames, wildcards, dos environment variables
             and an optional /s for subdirectories.
EXCLUDE.LD - excludelist for LDZIP, can contain long filenames, short
             filenames, wildcards, dos environment variables
             and an optional /s for subdirectories.
             (Create this file only if you need to exclude files)
             
    To use Dos Environment variables in INCLUDE.LD and EXCLUDE.LD
    add the Dos Environment variable between quotes (see example 6).

Usage
=====
LDZIP <filename> [options]
 
  -a               Save File Access, Creation and Modification time
  -c<compression>  Set compressionlevel 0-9 (3=Default, 9=Best)
  -d               Show filenames while searching
  -i               Include directory structure
  -m<filesize>     Maximum filesize: 0-2000 MB (a=auto detect free space)
  -n               Create only one ZIP file, requires -m option
  -o               Overwrite filename without prompting
  -q               Quiet mode
  -s[<password>]   Scramble with password, prompt if no password specified
  -t[<directory>]  Specify a temporary directory, use the dos environment
                   variable TEMP if no directory is specified
  -x               Create Windows 32-bit self-extracting ZIP file
  -y               Continue creating zip files without asking to insert a new
                   disk if the maximum zip filesize is reached

All options explained:
----------------------
-a               Save Access, Creation and Modification Time
                 In MS-Dos only supported when using NTFS Dos Professional

                 Every file has a Last Access Time, Last Modification Time and
                 a Creation Time. With the -a option these File Times
                 will also be saved in the ZIP archive. Currently only a few
                 ZIP archivers support saving/restoring these filetimes. The
                 only one I know of is Pkzip for Windows (www.pkware.com).
                 To restore these file times you have to set the options right
                 in Pkzip for Windows. Go to Tools - Options - Extract and
                 select the three times by Restore file times.
                 Currently, a created self-extracting archive with ldzip
                 does not support restoring these file times.
                 To restore these file times you need Pkzip for Windows.

-c<compression>  Set compressionlevel 0-9 (3=Default, 9=Best)
                 0 = No compression,   Fastest
                 3 = Good Compression, Fast     (Default)
                 9 = Best Compression, Slow

-d               Show filenames while searching
                 Show filenames while searching for files to add to
                 the zip archive.

-i               Include directory structure
                 Include saving of the directory structure in the ZIP file
                 
-m<filesize>     Maximum filesize: 0-2000 MB (a=detect free space)
                 Create ZIP files with a maximum specified filesize.
                 Ldzip automatically creates a new ZIP file if the maximum
                 filesize is reached, except when -n option is used.
                 Extensions will be .ZIP, .001, .002, .003 and so on...
                 Default maximum filesize: 0 = No Maximum filesize.
                 If you are using the -ma you should also use the -t option
                 to save the temporary files on another drive.

-n               Create only one Zip file, requires -m option.
                 Stops zipping if the maximum filesize is reached for
                 the first ZIP file <filename>.ZIP
                 Useful if you have limited space and still want to create a
                 ZIP file even if it does not contain all the files you wanted.
                 In this case you need to specify the -t option as well,
                 otherwise the temporary files will be saved in the same
                 directory as the ZIP file. With the -t option these temporary
                 files can be saved somewhere else, so only the ZIP file is
                 created in the limited space. Normally if a ZIP file exceeds
                 the limited space, the ZIP file fails.
                 Now, with this option it is possible to save a ZIP file
                 containing all the files it can compress within the maximum
                 ZIP filesize. All the other files will be skipped.

-o               Overwrite filename without prompting
                 If the resulting ZIP file already exists overwrite the
                 ZIP file without asking to overwrite it.

-q               Quiet mode
                 Minimizes text output to the screen

-s<password>     Scramble with password, prompt if no password specified
                 Password protect your ZIP file.
                 
-t<directory>    Use the specified directory to save the temporary files.
                 If no directory is specified use the dos environment variable
                 TEMP. If the dos environment variable TEMP does not exist
                 use the same directory as the filename. Without the -t option
                 the temporary files will be saved in the same directory as
                 the ZIP file. Always use the -t option if the -ma option
                 is used.
                
-x               Create Windows 32-bit self-extracting ZIP file
                 Creates a .EXE file which is able to extract the compressed
                 files. Anyone who wants to extract the compressed files
                 just has to launch the executable (.EXE).
                 There is no need for an additional Unzip utility.
  
-y               Continue creating zip files without asking to insert a new
                 disk if the maximum zip filesize is reached
                 Use this option together with the -m option if you have
                 enough disk space on the destination drive for the complete
                 backup and automatically want to limit your zip files
                 with the maximum zip filesize. Disk changing not possible.


Example 1: LDZIP D:\123456 -m2000

     Create a zip file D:\123456.zip with a maximum filesize of 2000MB (=2GB).
     Automatically creates D:\123456.001, D:\123456.002 and so on
     if the maximum filesize is reached. Warning: if a single file can
     not be zipped below the maximum filesize the file will be skipped.
     The maximum filesize is especially useful if the zip file reaches the
     maximum filesize limit, 2GB or 4GB, of your backup drive. Specify 2000 as
     maximum filesize to limit the zip files to 2GB (=2000MB).
     Because the zip files are broken into pieces between two files, like
     normal zip files, all created zip files can be used by any ZIP utility.
     So, this is NOT "Splitting" or "Multiple Disk Spanning".
     The disadvantage of this method is that if a single file can not be zipped
     below the maximum filesize the file will be skipped.
     If you use a maximum filesize of 2000MB a file with a filesize of at
     least 2GB has a possibility of being skipped if it can not be zipped below
     2GB. In case files are skipped a logfile (D:\123456.log) will be created.
     
     Maximum filesize for a file on a FAT16 drive = 2GB
                                      FAT32 drive = 4GB
                                      NTFS  drive = "unlimited"

Example 2: LDZIP D:\123456

     Create a zip file D:\123456.zip.
     If the maximum filesize limit of the zip file on your backup drive
     (FAT16=2GB, FAT32=4GB) is reached the resulting zip file will fail.
     Try again with a maximum filesize.


Result
======
<filename>.ZIP
<filename>.001 if the maximum filesize for <filename>.ZIP is reached
<filename>.002 if the maximum filesize for <filename>.001 is reached
<filename>.003 if the maximum filesize for <filename>.002 is reached
...and so on...

Requirements - One of the following Operating Systems
=====================================================
Windows 95
Windows 98
Windows ME
Windows NT (requires LFN/NT version 1.0)
Windows 2000
Windows XP
MS-Dos 4.0+                           for FAT16 drives
MS-Dos 7.1+ (Win95 OSR2+)             for FAT32 drives
MS-Dos 7.0+ (Win95+) and NTFSDos Pro  for NTFS drives

Memory requirement
==================
Minimal memory requirement = 258KB (264.192 bytes)

License
=======
See LICENSE.TXT

Contact
=======
WWW:    http://ldzip.port5.com
E-mail: ldzip@myrealbox.com


NTFSDos Professional
====================
  Options:  
    /L:<letter>...        Select drive letters to use
    /C:<size>             Set disk cache size (KB)
    /T=[+|-]hh[:mm[:ss]]  Set timezone info
    /S                    Create a Shell rather than TSR

  Example:
    NTFSPro /T=+2

  WWW: http://www.winternals.com/products/repairandrecovery/ntfsdospro.asp
       http://www.sysinternals.com/ntw2k/freeware/ntfsdospro.shtml


====================================================
Below are some examples of INCLUDE.LD and EXCLUDE.LD
====================================================

Example 1
=========
Suppose we want all files in C:\My Documents including all the subdirectories.
  
     INCLUDE.LD
     ----------
     C:\My Documents\*.* /s

     Delete the file EXCLUDE.LD, we do not want to exclude anything.

     
Example 2
=========
Suppose we want all files in C:\My Documents including all the subdirectories.
The short filename of My Documents is MYDOCU~1.

     INCLUDE.LD
     ----------
     C:\MYDOCU~1\*.* /s

     Delete the file EXCLUDE.LD, we do not want to exclude anything.

     
Example 3
=========
Suppose we want all files in C:\My Documents and C:\Program Files, except the
files in the directory C:\Program Files\Common Files.

     INCLUDE.LD
     ----------
     C:\My Documents\*.* /s
     C:\Program Files\*.* /s

     EXCLUDE.LD
     ----------
     C:\Program Files\Common Files\*.* /s


Example 4
=========
Suppose we want all files of the C: drive, except the directory C:\Windows\Temp
and all the .bak and the .tmp files.

     INCLUDE.LD
     ----------
     C:\*.* /s
     
     EXCLUDE.LD
     ----------
     C:\Windows\Temp\*.* /s
     C:\*.bak /s
     C:\*.tmp /s


Example 5
=========
Suppose we want all files of the C: and D: drive, except the C:\*.bak files.
We do want the *.bak files of all other directories.

     INCLUDE.LD
     ----------
     C:\*.* /s
     D:\*.* /s
     
     EXCLUDE.LD
     ----------
     C:\*.bak


Example 6
=========
This example shows how to use Dos environment variables in your includelist
and excludelist. Insert the Dos environment variable between quotes in the
includelist or excludelist.

Suppose we want to backup all documents of a certain user and all users have
a different subdirectory in C:\My Documents

     Example:   C:\My Documents\Paul
                C:\My Documents\Simon
                
Create the includelist INCLUDE.LD
     
     INCLUDE.LD
     ----------
     C:\My Documents\"USER"\*.* /s

Because USER is between quotes LDZIP changes "USER" with the
Dos Environment variable USER. In general, if a Dos Environment
variable is used, but not set (empty) then the line is skipped.

To backup all documents of Paul just type the following at the command prompt
before launching LDZIP:

    SET USER=Paul
    
To backup all documents of Simon just type the following at the command prompt
before launching LDZIP:

    SET USER=Simon

In both cases the same includelist is used, but by using a Dos Environment
variable it is possible to create backups with different directories.
In the first case LDZIP creates a backup of C:\My Documents\Paul\*.* /s
In the second case LDZIP creates a backup of C:\My Documents\Simon\*.* /s
