                            ===========
                              BXTOOLS
                            Version 2.x
                            ===========


Copyright (c) 1997-1998, MENSK Technologies Corporation.
All Rights Reserved.
www.MENSK.com
www.NT2000.com
info@mensk.com
                           Introduction.
                           =============

What is BXTOOLS?
---------------
BXTOOLS is a native 32-bit Windows NT Console mode program,
that combines features of XCOPY, PKZIP, PKUNZIP and other file
and directory management tools in a single program.
BXTOOLS are perfect for batch mode file and directory copying, 
processing, data compression and backup needs.
                  
BXTOOLS features:
-----------------
*  -  Extended NT-aware copy operation: 
      -  Can copy file and directory security attributes and permissions.
      -  Can copy extended attributes, OLE structured storage, 
         NTFS alternate data streams(if applicable) together with
         files.
*  -  Capability to create and manage PKZIP (2.04g) - compatible ZIP archives.
      -  Support for extra compression. 
      -  Support for encryption and password protection of archives. 
      -  Long filenames support. 
      -  Capability to compress and extract NTFS specific file
         and directory attributes, including permissions and security 
         attributes. Great for compressed backups of NTFS volumes, directories
         and files.
*  -  Possibility to specify multiple filespecs to include or exclude from
      operation.
*  -  Possibility to specify range of filesizes to include or exclude from
      operation.
*  -  Secure file wipe and erase. Can do either fast file wipe and erase 
      or U.S. Government DoD 5220.22-M secure file erase with no possibility
      to recover or undelete erased file data or to recover filenames.
      No you may be sure, that no prying eyes will access you confidential
      data and sensitive information files.
*  -  Advanced file listing capabilities.
*  -  GREP, advanced file search capabilities.


What BXTOOLS does better, than other tools?
------------------------------------------
*  -  BXTOOLS is better, than XCOPY:
      -  BXTOOLS supports multiple file specifications to include or exclude
         from operation.
      -  BXTOOLS supports range of filesizes to include or exclude from 
         operation.
      -  BXTOOLS can copy directory and file permissions and security
         attributes.
*  -  BXTOOLS is better, than utilities, that supports PKZIP compression:
      -  BXTOOLS is the only utility, that support PKZIP 2.04g compression
         format AND can compress and extract file and directory permissions
         and security attributes.
*  -  BXTOOLS is the native 32bit Windows NT console mode application.
*  -  BXTOOLS supports environment variable as part of directory or filename.
*  -  BXTOOLS was designed and written from scratch specifically for Windows NT.
*  -  BXTOOLS was built and tested using the latest 32-bit development tools.
*  -  BXTOOLS supports fixed, removable, network and other types of drives.
*  -  BXTOOLS supports UNC naming conventions.
*  -  BXTOOLS supports long filenames.
*  -  BXTOOLS is a Year 2000 compliant software.


                           Installation
                           ============

Installation procedure is rather simple and straight forward.
Create a separate directory for BXTOOLS and extract BXT*.ZIP
file. Main BXTOOLS executable file is BX.EXE
BX.EXE  /?  - gives brief help.
BX.EXE  /?? - gives detailed help.
Note: You must read carefully and fully accept license agreement before 
      using the product. License agreement is in file: LICENSE.TXT


                           Command line parameters:
                           ========================

*  -  List files:                                                                    
   BX  /dir     source_dir_or_files [incl_spec] [:excl_spec]                   
                [/s /[:]minsize=NNN /[:]maxsize=XXX /cls /quiet]               

*  -  Search for string in files:                                                    
   BX  /grep    pattern  source_dir_or_files [incl_spec] [:excl_spec]          
                [/s /c /[:]minsize=NNN /[:]maxsize=XXX /cls /quiet]            

*  -  Copy files:                                                                    
   BX  /xcopy   source_dir_or_files target_dir_or_file [incl_spec] [:excl_spec]
                [/s /xa /overall /wipetarget /[:]minsize=NNN /[:]maxsize=XXX]  
                [/noask /cls /quiet]                                           

*  -  Compress files:                                                                
   BX  /zip     source_dir_or_files target_zip_file [incl_spec] [:excl_spec]   
                [/compression=N /password=xxx /[:]minsize=NNN /[:]maxsize=XXX] 
                [/s /xa /noask /cls /quiet /tempdir=DIR]                       

*  -  Extract (decompress) files:                                                    
   BX  /unzip   source_zip_file target_dir [incl_spec] [:excl_spec]            
                [/xa /password=xxx /noask /cls /quiet /tempdir=DIR]            

*  -  Delete files:                                                                  
   BX  /del     source_dir_or_files [incl_spec] [:excl_spec] [/wipe[!]]        
                [/s /[:]minsize=NNN /[:]maxsize=XXX /noask /cls /quiet]        

*  -  Erase directory tree:                                                         
   BX  /deltree dirname [/noask] [/cls] [/wipe[!]]                             

*  -  View or update license and registration information:                           
   BX  /license                                                                

*  -  Detailed Help:                                                                 
   BX  /??      Use: "BX /?? | more" or view README.TXT for more information.


 source_dir_or_files - Source directory or file(s).                            
 target_dir_or_files - Target directory or file(s).                            
 incl_spec      - File specification(s) to include. Default:"*".             
                  If at least one include spec is specified, than it will      
                  replace default. Any number of include specs may be          
                  specified. *.doc ab??t*.d?* abc.doc  - are all valid specs.  
 :excl_spec     - File specification(s) to exclude from operation.             
                  Every 'exclude' spec must be preceeded by ':'(colon) char.   
                  :*.tmp :*.bak :old*.??? - are all valid exclude specs.       
 /dir           - Search for and display maching files.                        
 /xcopy         - Copy files from source to destination. This function also    
                  copies extended attributes, OLE structured storage, NTFS     
                  alternate data streams(if applicable), and all attributes,   
                  including security attributes of all files and directories.  
 /zip           - Create or update PKZIP-compatible archive file.              
 /unzip         - Extract files from existing PKZIP-compatible archive file.   
 /del           - Delete files.                                                
 /deltree       - Erase directory tree, including all of it's subdirectories   
                  and files.                                                   
 /xa            - Used by: /xcopy, /zip, /unzip.                               
                  This option will preserve NTFS-specific file attributes,     
                  including file and directory permissions, security attributes
                  and NTFS extended file time and date information. /zip and   
                  /unzip will create/use additional archive file with .ZIX     
                  extension to store NTFS, permissions and security data.      
 /wipe          - Wipe file contents before deleting the file (fill with 0's). 
 /wipe!         - Government Wipe. Use DoD 5220.22-M standard to wipe file data
                  Write all 1's, then all 0's. Repeat 3 times. Write 0xF6 once 
                  and verify last write. This option will also: rename file to 
                  random temp name, wipe out unused file slack space, reset    
                  file size to 0 and set file date and time to 01 January 1990 
                  before actual delete operation takes place.                  
 /s             - Include subdirectories in operation. Default: Off.           
 /c             - Case sensitive search. Default: Off. Used by '/grep' only.   
 /overall       - Overwrite all target files with the same name, regardless    
                  of age. Default: Off.  Used by '/xcopy' action.              
                  Default:Off (overwrite only if older).                       
 /wipetarget    - Target directory tree will be erased, before copy            
                  operation occurs. Default:Off. Used by '/xcopy' action.      
 /minsize=NNN                                                                  
 /maxsize=XXX   - Range of file sizes in bytes to be included into the         
                  processing. Default for minsize=0, Default for               
                  maxsize=INFINITE. Files with sizes outside of range          
                  will not be acted upon. /maxsize=INFINITE (default) means    
                  that there is no limit for maximum file size.                
 /:minsize=NNN                                                                 
 /:maxsize=XXX  - Range of filesizes to be excluded from processing.           
                  Files with sizes within this range will not be acted upon.   
 /compression=N - 0...9. 0:no compression(fastest), 9:max compression(default).
 /password=xxx  - String. Password to be used to compress or extract files.    
 /tempdir=DIR   - Fully specified name of directory to be used for temporary   
                  purposes. Default:Use default system temporary directory.    
 /noask         - Do not ask for user confirmations before any actions.        
                  Use with caution! Default:Off(ask).                          
 /cls           - Will clear screen at startup. Default:Off.                   
 /quiet         - Will not print message for every file. Only final            
                  results of operation will be shown.                          
 /license       - View or update license and registration information.         
 /?             - Prints brief help.                                           

Notes: 
      1. Optional paramaters can be mixed in any order.                       
      2. Pressing <ESC> key will abort operation in progress.                 
      3. BXTOOLS supports UNC network names, IP addresses and environment     
         variables to specify source or target directory:                     
         BX /xcopy C:\mydocs \\BackupServer\MyShare\backups\mydocs *.doc /s 
         BX /xcopy \\123.45.6.78\drive_d\backups\mydocs  .\*.doc /s     
      4. Compression engine used by BXTOOLS supports PKZIP 2.04g format, extra
         compression, password encryption, long filenames, NTFS permissions   
         and security attributes.                                             

Examples:                                                                      
  BX /xcopy   c:\mydocs  d:\backup\mydocs /s *.d* *.t?? :*.dot :*.tmp /overall
  BX /xcopy   c:\pics  d:\smallpics /s *.gif *.jpg *.bmp *.pcx /maxsize=50000  
  BX /zip     d:\my\proj f:\my\prj.zip /s *.doc *.c* *.t* :*.tmp /password=xyz
  BX /del     d:\projects *.bak *.tmp *.old /s /wipe                          
  BX /deltree \\BackupServer\MyShare\OLDFILES /s /noask /wipe!
