Russian version below.      .


NTCopy 1.1 - Utility for copying NTFS volumes

CONTENTS

1. Introduction
2. Package Contents
3. Command Line Arguments
4. Exit codes
5. Disclaimer
6. Special Thanks
7. Useful Tip
8. Samples
9. Contact Information


			1. Introduction

This utility was developed in purpose of transferring NTFS volumes
(or directory trees) content with ALL attributes - including multiple
data streams, compression status and especially user access rights -
from one hard disk to another. Neither Explorer nor XCopy does not do
this. NTCopy is a simple Win32 console application. It can copy
directory trees with according attributes and access rights or only
transfer user access rights from one directory tree to another similar
one. This utility provides a log onto standard output so it may be
captured and redirected to file or printer. NTCopy is a bilingual
utility. You can choose between English and Russian but if you don't
choose anything utility provides all dialogs and log messages on both
languages.


			2. Package Contents

README.TXT - this file
NTCopy.exe - the utility described
NTCopy.cpp - C++ source code of the utility
NTCopy.ico - an icon file attached to the EXE file


			3. Command Line Arguments

Since NTCopy is a console application it accepts a command line with a
number of control parameters. The syntax of command line is:

	NTCopy [-option] Source [-option] Destination [-option] [>[>]Log]

Description:

Source		- points to a directory (may be a root directory of a
		volume or even a network directory) that you plan to use
		as a source directory for transfer operation.

Destination	- point to a directory (may be a root directory of a
		volume or even a network directory) that you plan to use
		as a destination directory for transfer operation.

-option		- an optional parameter that is used to control the
		transfer mode. Any options can be placed in any position
		of command line. Options are not case-sensitive.

Log		- sets a name of the file where operation log will be
		stored (by default, the output is directed to the screen).
		The additional character ">" forces the append mode. If
		NTCopy is started using the DOS command prompt the log is
		captured by the system. While running via the Start Menu
		(Start | Run), NTCopy processes an additional parameter
		and redirects the output internally.


Available options:

-l:r|e	- communication language. By default, NTCopy uses both Russian and
	English for dialogs and log messages. Using this option, you can
	choose Russian (by typing "-l:r") or English ("-l:e").

-o:y|n	- processing an existing destination files. If you transfer files
	to the non-empty directory you can encounter an existence of one or
	more destination files. By default, NTCopy prompts you to overwrite
	each file. Using this option you can force to overwrite all
	existing files (by typing "-o:y") or prevents of overwriting any
	file ("-o:n").

-b:a|c	- forces a batch mode. Usually, in case of any error, NTCopy shows
	a dialog box with the respective message and waits for your reply.
	In the batch mode, the runtime error messages stores in the log
	file only. You can preset the soft error processing mode - the
	operation will be either continued ("-b:c") or aborted ("-b:a").

-s	- use this option if you have two similar directory trees and you
	plan to transfer user access rights from one tree to another. This
	option causes NTCopy to skip the file transfer stage and go
	directly to the stage of access rights transfer.

-r	- by default, NTCopy transfers access rights only for files and
	directoies that results to be contain in destination directory and
	does NOT transfer access rights between source and destination
	directory themselves. This option causes NTCopy to transfer access
	rights for "root" directory too.


			6. Exit Codes

While using NTCopy in batch tasks you can check for exit code (or
errorlevel). If no errors occured during operation exit code is zero.
In case of any hard or soft errors exit code is a combination (by
bitwise OR) of these values:
	soft errors (permit to continue the execution)
   1 - path, file or directory not found
   2 - requested type of access to file or directory denied
   4 - destination file already exists (the existing of destination
	directory is not an error)
   8 - incompatible types of source and existing destination objects
	(for example, source is a file but there is an existing
	directory with the same name in target 	directory)
  16 - invalid option in command line
	hard errors (terminate execution immidiately)
  32 - syntax error in command line
  64 - insufficient memory
  96 - unable to obtain necessary privileges
 128 - operating system is not a Windows NT
 256 - the sourec or destination directory resides on the non-NTFS
	volume
 512 - error while creating the log file
1024 - unknown error


			5. Disclaimer

This freeware utility is shipping "as is". You can use or not use it
for your own risk. This utility works under Windows NT and with NTFS
volumes only.
The utility cannot properly operates with the hard links and the
offline files that moved to the long time storage in the Hierarchical
File System.
NTCopy was tested under Windows NT Server 4.0 SP5 and
Windows NT Workstation 4.0 (Russian) SP5.


			6. Special Thanks

Thanks to Mark Russinovich and Bryce Cogswell
(http://www.sysinternals.com/ntinternals.htm) for their know-how about
using of system privileges.
Thanks to Alexander Zorich (http://www.orc.ru/~zalex/) for consulting.


			7. Useful Tip

If you want to transfer whole Windows NT system volume from one hard
disk to another using NTCopy you must boot your computer from special
"service" system disk with minimal installation of Windows NT. This is
required for the free access to the system registry files.


			8. Samples

	ntcopy d:\ e:\ -r

copies the entire disk D: to E:, additionally transferring the user access
rights for the disk root directory (the utility was designed basically for
this operation).


	ntcopy d:\Library\ArtLib e:\ArtLib

copies the d:\Library\ArtLib directory to the e:\ArtLib. The destination
directory must exist. All the files and the subdirectories of ArtLib will
be copied together with the user access rights but the access rights for
the ArtLib will not be transferred. If a shared resource is moved using
this way (you need to delete and re-create the share itself) the users may
encounter a problems while accessing it. Let's suggest that this is a sample
of a wrong command. The right one is:

	ntcopy d:\Library\ArtLib e:\ArtLib -r


	ntcopy d:\WINNT e:\WINNT -s -r

skips the copy stage and sets user access rights for the Windows directory
on the disk E: according to the master pattern stired on disk D:. The
transfer performs only for files and directories that exist in the both
trees. This mode is designed for the special case when you previously
copied the system volumes by the Explorer and wasn't restore system files
protection using the FixACL utility from the Resource Kit Support Tools.
This mode is also useful if you want to copy uncompressed tree to the
compressed directory or conversely. In this case begin with the Explorer
or XCopy and then transfer access rights separately.


	ntcopy c:\Work\MyData \\Server\MyHome\MyData

copies the data from the local disk to the network resource. This is a
sample of a case where using of the -r option is not recommended because
it is cannot be predicted whether the access rights for the target resource
or access rights for the directory shared as this resource will be changed.


			9. Contact Information

Igor G.Panasenko, sysadmin
LANK Ltd., Apatity, Murmansk reg., Russia
mailto:piggy@lank.hypermart.net
http://lank.da.ru/





NTCopy 1.1 -     NTFS



1. 
2.  
3.   
4.  
5. Disclaimer
6. 
7.  
8. 
9.   


			1. 

        NTFS (
 )     -  
 ,  , ,  ,  
 -      .    
 Windows,   XCopy. NTCopy -   
Win32.          
 ,         
      .    
   ,        
   . NTCopy -  .    
      ,     ,
     .


			2.  

README.TXT -  
NTCopy.exe -  
NTCopy.cpp -    C++
NTCopy.ico -      


			3.   

  , NTCopy     
 .     :

	NTCopy [-]  [-]  [-] [>[>]]

:

		-   (     
		   ),   
		     
		.

		-   (     
		   ),    
		 .

-		-  ,   
		.   -  
		     . 
		   .

	-   ,     
		 (     ).
		  ">" ,   
		   .     
		DOS   .   
		  ( | ) NTCopy 
		    
		.


 :

-l:r|e	-  .   NTCopy    
	 .   ,   
	 ("-l:r")   ("-l:e") .

-o:y|n	-      .
	       ,  
	        
	    ,     -. 
	 NTCopy      
	.   ,    
	    ("-o:y")  , ,
	  ("-o:n").

-b:a|c	-    .    
	NTCopy       
	  .       ,
	   ,    
	.   ,     
	  -   ("-b:c")   
	("-b:a").

-s	-     ,    
	       ,  
	  .   , NTCopy 
	        
	.

-r	-   NTCopy       
	,        
	    	.     NTCopy
	      "" .


			6.  

  NTCopy  batch-    
 .     ,  
  .      
    ( )  :
	  (   )
   1 - ,     
   2 -        
   4 -        (
	   )
   8 -       
	(,   ,    
	    )
  16 -     
	  ( )
  32 -     
  64 -  
  96 -      
 128 -     Windows NT
 256 -        NTFS
 512 -     
1024 -  


			5. Disclaimer

    " ".   
        .   
   Windows NT      NTFS.
        ,
     (offline)  
  .
    Windows NT Server 4.0 SP5 
Windows NT Workstation 4.0 () SP5.


			6. 

   (Mark Russinovich)    (Bryce
Cogswell) (http://www.sysinternals.com/ntinternals.htm)  
  .
   (http://www.orc.ru/~zalex/)  .


			7.  

        Windows NT ( ,
,   ),     
      Windows NT. 
        
Windows.


			8. 

	ntcopy d:\ e:\ -r

   D:   E:,     
   ( ,     
).


	ntcopy d:\Library\ArtLib e:\ArtLib

  d:\Library\ArtLib   e:\ArtLib,  
.      ArtLib    
 ,     ArtLib   .  
     (   
  ),        
 .    ,    .  :

	ntcopy d:\Library\ArtLib e:\ArtLib -r


	ntcopy d:\WINNT e:\WINNT -s -r

  ,      Windows
  E:   ,     D:. 
     ,    .
    ,     
        FixACL 
 Resource Kit Support Tools.   ,  
       .   
   XCopy,     .


	ntcopy c:\Work\MyData \\Server\MyHome\MyData

       .  ,  
 -r   ,  ,    -
       ,    .


			9.   

 ., 
 ,   ., 
mailto:piggy@lank.hypermart.net
http://lank.da.ru/