	FDIR IS A FAST FORTRAN PROGRAM DESIGNED TO MAKE A LIST OF ALL OF
THE DIRECTORIES AND SUBDIRECTORIES ON THE SYSTEM.  TO FIND THE DIRECTORIES,
FDIR FIRST MAKES SURE THAT THE FILE HAS A '.DIR' EXTENSION, AND THEN LOOKS
UP THE FILE HEADER TO MAKE SURE THAT THE FILE IS A REAL, TRUE TO LIFE
DIRECTORY.  WHEN FINISHED WITH THE DIRECTORIES, FDIR WILL SORT THEM 
BY NAME.

	AUTHOR:	ERIC YOUNGDALE
		CARLETON COLLEGE
		NORTHFIELD, MN 55057
		18-JAN-1980
		FOR VAX/VMS V1.6

	FILES:
		FILE	DESCRIPTION
		FDIR.FOR	SOURCE OF PROGRAM
		GETDCL.MAR	STANDARD PROGRAM TO GET COMMAND LINE

	COMMAND SYNTAX:
		IF FDIR IS INSTALLED ON SYSEXE, AND THERE IS A SYMBOL
DEFINED 'FDIR:==$FDIR', THEN THE FOLLOWING COMMAND CAN BE USED TO USE
FDIR.

FDIR  DRA0 DIRNAME OUTPUTFILE COMMAND_FILE_NAME

WHERE:
	DRA0 IS OUR DISK, JUST PUT THE NAME OF THE DISK YOU WANT A DIRECTORY
TREE IN THIS POSITION HERE.  THIS CANNOT BE A LOGICAL NAME, IT MUST BE THE
PHYSICAL DEVICE NAME.


	DIRNAME: IS THE DIRECTORY TO START THE TREE FROM.  FOR EXAMPLE IF
YOU GAVE IT '000000', THEN YOU WILL GET A DIRECTORY TREE FOR THE WHOLE
SYSTEM.  IF YOU GIVE IT 'SYSEXE', THEN IT WILL GIVE YOU SYSEXE AND ALL OF
IT'S SUBDIRECTORIES.  NOTE THAT BRACKETS AROUND THE DIRNAME ARE OPTIONAL.

	OUTPUTFILE: IS WHERE THE LIST OF DIRECTORIES WILL BE WRITTEN.
	COMMAND_FILE_NAME IS THE NAME OF A COMMAND FILE WHICH IS GENERATED
WHICH WHEN EXECUTED WILL CREATE ALL OF THE DIRECTORIES ON THE SYSTEM WITH
THE CORRECT OWNER UIC'S.  THIS CAN BE USEFUL IN THE CASE OF A TOTAL
REBUILD OF THE SYSTEM FROM A TOTAL BACKUP SET.  THIS FILE COULD BE COPIED
TO THE BACKUP TAPE BEFORE BACKUP IS STARTED.  IF YOU DO NOT SPECIFY A NAME
HERE, NO FILE WILL BE GENERATED.

NOTE:  IF YOU DO NOT HAVE THE FDIR:==$FDIR, THEN THE COMMAND LINE WILL NOT
BE PASSED, AND FURTHERMORE YOU MUST USE RUN TO GET IT GOING.  FDIR WILL
ASK FOR ALL OF THE INPUT PARAMETERS.

EXAMPLE: TO LIST ALL OF THE DIRECTORIES ON OUR SYSTEM DISK DRA0, WE
WOULD TYPE:
FDIR DRA0 000000 DIRS.SXX CREDIR.COM

   THE LIST OF DIRECTORIES WILL BE IN DIRS.SXX, AND THE CREATE/DIRECTORY
COMMAND FILE WILL BE IN CREDIR.COM
