dmapi/src/sample_hsm/README

The files in this directory comprise a simple HSM example that uses 
the DMAPI. These files are distributed in the hope that they will be
useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  These programs
have been tested on an SGI platform (as of April 1995) and found
to be suitably functional; however, there is no guarantee that they
do, in fact, provide the functationality that is advertised. This
is a long winded way of saying they probably have bugs; if you 
find 'em, fix 'em. 

Okay, now that we have the disclaimers out of the way, here are the details.

	migfind
	=======
This will find all files of a specified size, and print out the handles.
It is normally used like this:
	migfind -s 800k /migfs >& cand_file

This example will find all files greater than 800K in the /migfs filesystem,
and put the handles (converted to ascii) in the file 'cand_file'. The output
consists of three fields per line:
	handle length		filehandle		file size in bytes

	migout
	======
migout reads a list of handles as created by migfind, and migrates
the files data. The data is stored in files that are located in 
another directory. The usage is
	migout /dmapi_fs/stagedir < cand_file

This will all the files specified by handle in 'cand_file', and
put their data in files located under the directory /dmapi_fs/stagedir'.
The staging directory must be on a filesystem that supports
the dmapi; the reason for this is to allow for a simplification
in the code that stores the location of the data as a DM attribute
(file handles are easier than path names).

	migin
	=====
This daemon waits for DMAPI events and dispatches worker bees
to actually stage the data in. The usage is:
	migin -l dmapi_log /migfs
migin will fork/exec a 'wbee' to either bring the data back from
the staging directory, or to invalidate the file.


Other programs:
There are a couple of other programs in this directory. 

	mrmean
	======
Simplist cleanup/debugging tool that will print information about
the active sessions. If desired, it can also respond to outstanding
events and destroy sessions that may have been left around from
a process exiting unexpectedly.

	mls
	===
Simple ls type program to display information about a file, such
as the managed region info, allocation info, event lists, and
file handle.