mergeVFS v1.1 by sorrum
------------------------

Here's a quick howto on using the program.

Initial setup
-------------
Run mergeVFS.exe, the textboxes are pretty straightforward but i'll re-explain.
Considering there are no labels, I'll just explain them in the order of their
appearance in the GUI, or you can just mouseover and view the tooltips for
field description.   First thing you will want to do is RENAME YOUR VFS to
something like yourname.vfs.bak.  THIS IS A MUST.



1) Physical harddrive location of where all the links will be created.
	This is the folder where the program makes all the subfolders of your
	merged filesystems.  So if you have mp3s on two drives, we'll say in
	I:\mp3s and D:\mp3s, and you want them both in a folder called "shitfuck"
	on your FTP, you could make this folder anything.
	Suchlike: C:\FTPROOT\linked_mp3path

2) Filename that your server uses.  Very simple and understandable.  This is the
	name of your VFS before you renamed it to *.bak or whatever you named it to

3) The backup that you renamed goes here.  The program reads this file and outputs
	all of it's contents to the server file setup in step 2, then appends the
	dirstructure of the merger.

4) Virtual path of where all the merged links are aimed at.  Fairly straightforward
	again.  If you have I:\mp3s and D:\mp3s and you want them in /mp3s on your ftp,
	then this would simply be /mp3.  MAKE SURE YOU DON'T ADD AN END SLASH, IT WILL
	bash things up.

5) The next three boxes are straightforward as well.  Owner User is which user gets to
	own the new merged folders, group is the group that gets access to it, and chmod
	are the rights.  You know how to do this stuff

6) The paths.  This is where the magic happens, so i'll explain this as best I can.


Method 1:

	Let's say you want to share I:\mp3s and D:\mp3s again.  But in each folder is a
	bunch of genre's like I:\mp3s\alternative, I:\mp3s\folkrock, D:\mp3\metal.  If
	your structure is setup this way you can use the genre function:
	
	I:\mp3s\alternative\|alternative
	I:\mp3s\folkrock\|folk-rock
	
	(note: the endslash is VITAL on these entries.  It's the way raiden works, so it's
	the way this program works. Maybe someday an auto insertion of slashes will
	be implemented for those who can't follow instructions)

	Entering items this way will result in the output folder having subfolders in them.
	
	ie: If your physical location is C:\ftproot\mp3s then you would get the following structure:

	C:\ftproot\mp3s\alternative
	C:\ftproot\mp3s\folk-rock

Method 2:

	If your shares have no substructure to them, you can use method 2.  If you have the folders
	I:\iso and D:\iso that you want to be in /isosex on your FTP, you would simply add the
	lines:

	I:\iso\
	D:\iso\

	Of course you would have setup (in step 4) the virtual path to /isosex


Program Usage:
--------------
mergeVFS.exe ?settings_file_to_use.dat
             ^
	this delimiter lets the program know you want to 
	update.  Without the questionmark the program will
	assume you want to edit the file stated.

Using the program without parameters will bring up the GUI.
From the GUI clicking "Build VFS" will create the structure, if you don't
want to run a parameter.

It is recommended to run this program daily but setting up the onNewDay 
event in RaidenFTPd	


Program can be used in succession:
----------------------------------
If you have groups of folders that you want merged, you can do it just by changing
dat files:

Type this in a batch file to execute two or more merges
mergeVFS.exe ?settings1.dat
mergeVFS.exe ?settings2.dat

NOTICE: If you are using more than one merge, be weary that the INPUT file for the second
merger will be the output for the first one.  Why?  Because if you don't do this the lines
just written in the VFS using settings1.dat will be deleted and overwritten with that of
settings2.dat

simple solution is to do this:
VFS input for settings1.dat = VFS.vfs.bak
VFS output for settings1.dat = VFS.vfs
VFS input for settings2.dat = VFS.vfs
VFS output for settings2.dat = VFS.vfs


		Questions or comments?  E-mail me:  nyarr@myrealbox.com
			Website: http://bazoi.virtualave.net