Read Me

ReparsePoint v0.1
Dror Gluska 2010

1. WARNINGS AND DISCLAIMERS

WARNING: IMPROPER USE OF THIS SOFTWARE COULD AND CAN CAUSE SERIOUS DATA LOSS! IF YOU DO NOT UNDERSTAND IT COMPLETELY, DO NOT USE IT, YOU HAVE BEEN WARNED!

DO NOT ATTEMPT TO EXECUTE ON A PRODUCTION ENVIRONMENT BEFORE CHECKING ON A TEST ENVIRONMENT!

EXECUTION ON WINDOWS OS DIRECTORIES IS UNTESTED! YOU'VE BEEN WARNED!


Software/code is distributed here is distributed on an "AS IS" BASIS WITHOUT WARRANTIES OF ANY KIND. THE AUTHORS OF THE SOFTWARE DISCLAIM ANY LIABILITY. ANYONE WHO USES, COPIES, MODIFIES, OR (RE)DISTRIBUTES ANY PART OF THE SOFTWARE IS, BY SUCH ACTION(S), ACCEPTING AND AGREEING TO BE BOUND BY ALL TERMS AND CONDITIONS OF THIS LICENSE. IF YOU DO NOT ACCEPT THEM, DO NOT USE, COPY, MODIFY, NOR (RE)DISTRIBUTE THE SOFTWARE, NOR ANY PART(S) THEREOF.


Must be executed under elevated permissions if UAC is active.




2. Contains the following components:
Arguments - http://www.codeproject.com/KB/recipes/command_line.aspx - MIT License
JunctionPoint - http://www.codeproject.com/KB/files/JunctionPointsNet.aspx - No License
ReparsePoints - http://www.codeproject.com/KB/vista/ReparsePointID.aspx - CPOL License

3. External Links

Windows Explorer Link Shell Extension - http://schinagl.priv.at/nt/hardlinkshellext/hardlinkshellext.html


4. Usage:
Directory Structure:
\Test Junctions
	Source 1
		Source 1 file.txt
		Source 1 file 1.txt
	Source 2
		Source 2 file.txt
		Source 2 file 1.txt
	Destinations
		Source 1 (junction - \Text Junctions\Source1)
			Source 1 file.txt
			Source 1 file 1.txt
		Source 2 (junction - \Text Junctions\Source1)
			Source 2 file.txt
			Source 2 file 1.txt
		Source 3
			Source 3 file.txt

5. Examples:
5.1 List of junctions:
(scan on source "test junctions" include subdirectories and list to console)
>reparsepoint.exe -scan -source "\Test Junctions" -s -l

Reparse Points backup/restore v0.0.1.0
============================================
WARNING: IMPROPER USE OF THIS SOFTWARE COULD AND CAN CAUSE SERIOUS
DATA LOSS! IF YOU DO NOT UNDERSTAND IT COMPLETELY, DO NOT USE IT, YOU
HAVE BEEN WARNED!
Junctions found:
Junction: g:\Test Junctions\Destinations\Source 1 Target: G:\Test Junctions\Source 1
Junction: g:\Test Junctions\Destinations\Source 2 Target: G:\Test Junctions\Source 2

5.2 Save junctions to XML file:
(scan on source "test junctions" include subdirectories and list to console, output to junc1.xml
>reparsepoint.exe -scan -source "\Test Junctions" -s -l -o "junc1.xml" 
Reparse Points backup/restore v0.0.1.0
============================================
WARNING: IMPROPER USE OF THIS SOFTWARE COULD AND CAN CAUSE SERIOUS
DATA LOSS! IF YOU DO NOT UNDERSTAND IT COMPLETELY, DO NOT USE IT, YOU
HAVE BEEN WARNED!
Junctions found:
Junction: g:\Test Junctions\Destinations\Source 1 Target: G:\Test Junctions\Source 1
Junction: g:\Test Junctions\Destinations\Source 2 Target: G:\Test Junctions\Source 2

Junc1.xml contents:
  <?xml version="1.0" encoding="utf-8" ?> 
 <!-- reparsepoint file
  --> 
 <root>
  	<RP SRC="g:\Test Junctions\Destinations\Source 1" DST="G:\Test Junctions\Source 1" /> 
  	<RP SRC="g:\Test Junctions\Destinations\Source 2" DST="G:\Test Junctions\Source 2" /> 
  </root>

5.3 Load junctions from XML file and list:
(input junction from junc1.xml and list to console)
>reparsepoint.exe -input "junc1.xml" -l 
Reparse Points backup/restore v0.0.1.0
============================================
WARNING: IMPROPER USE OF THIS SOFTWARE COULD AND CAN CAUSE SERIOUS
DATA LOSS! IF YOU DO NOT UNDERSTAND IT COMPLETELY, DO NOT USE IT, YOU
HAVE BEEN WARNED!
Junctions found:
Junction: g:\Test Junctions\Destinations\Source 1 Target: G:\Test Junctions\Source 1
Junction: g:\Test Junctions\Destinations\Source 2 Target: G:\Test Junctions\Source 2

5.4 Restoring junctions from XML and rebuilding if you didn't backup the junction's destinations, in our example, source 1 and 2 do not exist inside destinations:
(input junctions from junc1.xml and rebuild the junctions - overwrite might be used if you want the junctions to be recreated, otherwise, existing junctions will retain their previously set source)
>reparsepoint.exe -input "junc1.xml" -rebuild

5.5 Restoring junctions from XML and rebuilding on restored ZIP file (deleting the junctions destinations before creating the junctions):
(input junc1.xml and rebuild junctions, also delete (!!!) existing junctions directory (and their files!!!!!!) and overwrite with new source)

>reparsepoint.exe -input "junc1.xml" -rebuild -overwrite -overwriteDelete