ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º Directory Scanner (tm) Ver 3.10 º º Copyright (c) 1986, 1987, 1988 º º by Nat Martino º º ALL RIGHTS RESERVED º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ Presents a full screen display of the directory structure of a given disk drive. The display looks like the following: ÛÛÛÛÛ Drive C ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ C:\DIR2 ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ Û c:\ Û backup .exe º finder .com º guts .zzz Û Û ÃÄ dir1 Û create .com º finder .exe º help .def Û Û ÃÄ dir2 Û dump .asm º finder .obj º killer .com Û Û ³ ÃÄ sub1 Û dump .exe º guts .asm º print .com Û Û ³ ÀÄ sub2 Û dump .obj º¯guts .com® º qsort .exe Û Û ÀÄ dir3 Û eater .bas º guts .exe º vdisk .sys Û Û Û eats º guts .obj º zoo .bas Û Û Û eatz .bat º º Û Û Û º º Û Û Û º º Û Û Û º º Û Û Û º º Û Û Û º º Û Û Û º º Û Û Û º º Û Û Û º º Û Û Û º º Û Û Û º º Û ÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛÛ Total: 10,456,123 ³ Help=? Name ^ ³ Files: 22 Used: 137,354 Tagged: 0 Used: 8 000,000 ³ Free Core 146K ³ ÄÄÄÄnameÄÄÄÄ ÄÄsizeÄÄ ÄÄdateÄÄÄ ÄtimeÄ atr Free: 2,456,123 ³ Drive 80% Full ³ guts .com 17,123 10 Aug 85 4:36p r ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ FILE COMPOSITION OF DIRECTORY SCANNER SYSTEM ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ 1. DS_READ.ME - This read.me file | 2. DS_GLOBL.LOG - This file SHOULD NOT EXIST THE FIRST TIME YOU | INSTALL THE PROGRAM. The program will create this file the | first time the program is executed. This file contains | various global variables which are passed between program | modules and resides in the "home" directory where all the | rest of the DS files reside. The "home" directory is | specified with a "set DS=c:\ds" command in the user's | autoexec.bat file. This file along with the "ds_drv_?.log" | files replaces the "device driver" that was present in | earlier versions of the program. | 3. DS_DRV_?.LOG - The "?" represents an appropriate drive letter. | This file (or files) SHOULD NOT EXIST THE FIRST TIME | YOU INSTALL THE PROGRAM. The program will create the file | the first time the program is executed so long as the | user has specified that a "log" file should be maintained | for a specified drive with the "Ctrl-E" option. Once a | "log" file has been created for a specified drive, | subsequent program startups and/or drive changes to that | specified drive should take little time as the program will | obtain the directory structure info from the log file | instead of scanning the entire disk for the information. 4. DS.EXE - The directory scanner program. Can be executed by typing the following: | "ds" - Start program on the default drive. If a drive | "log" file is present for the default drive then | it will be used and read for the directory info. If | a "log" file is not present, the program will scan | the entire disk for the directory structure | information. 5. DS_BKUP.EXE - The backup program which is activated from within the DS program by selecting the "b" option. This program is not a self sufficient program. It cannot be executed on | its own and work properly. It expects to obtain directory | structure information from an appropriately maintained | DS_DRV_?.LOG file. 6. DS_HELP.EXE - The expanded context-sensitive help displays. The program is activated from within the main program by pressing the F10 key. 7. DS_INIT.EXE - This program is called by the main ds program to aid in displaying/changing macro definitions, the default | editor and lister, and the directory to number linking. It | also allows the user to change the list of which drives | will have "log" files maintained on them. 8. DS_PROG.DEF - The program "defaults" file. This file contains data on the default startup colors, macro definitions, the defined editor and lister, the links of directories to | numbers, and which drives should have "log" files | maintained. 9. DS_USERS.MAN - A 19 page users manual. (66 lines/page) 10. DS_MOUSE.MSC - Source file for a Mouse Systems optical mouse device driver pop-up menu display. | 11. DS_SITE.LIC - Information on site licensing of the program. | 12. DS_SINGL.LIC - Information on single user licenses. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ INSTALLATION PROCEDURES ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ | Note: The following procedures make the assumption that you have a | hard disk as drive "c" and boot up off that drive. | | 1. Make a subdirectory "DS" under the "C:\" (root) directory. | | 2. Copy all DS files to this new "C:\DS" directory. | | 3. Version 3.10 no longer uses a device driver as did previous | versions so if in your "config.sys" file of the root directory | you have the following line, you should remove it: | | device=c:\ds\ds_drive.sys D:C | | 4. Remove any files from previous versions of the DS program to a | backup floppy so that this new version will not attempt to use | supporting files from previous versions. | | 5. In "autoexec.bat" file of root directory have the following line: | | set DS=C:\DS | | The foregoing "set DS=pathname" command is MANDATORY to enable | execution of the program. If it was not executed in the autoexec | or directly at the DOS prompt prior to executing DS, the | Directory Scanner program will not work. | | "C:\DS" should also be present in your PATH command | | Sample "autoexec.bat" entries follow: | | path c:\;c:\dos;C:\DS;... {"C:\DS" plus other user directories} | dpath {shareware dpath program (optional) } | set DS=C:\DS {sets HOME directory of ds files } | ds {starts execution of DS program } | | Notes: | a. "DPATH" shareware program is optional but useful to enable | DOS to find overlay and support files the editor may need. | b. A cursor/keyboard speedup program (like "hotkey" shareware | program) is also highly recommended in your "autoexec.bat" | file to speed up directory and file movement. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ CURRENT PROGRAM LIMITATIONS ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ MS/PC DOS 2.0+ | Maximum number of fixed/hard disk drives supported/saved: 26 | Note: The number of drives saved or "logged" is user-definable. Use | the "Ctrl-E" option to enter the drive letters of those drives | you wish to have logged. Floppy disk drives and RAM disk | drives are not recommended to "log" as it takes little time to | scan those type drives. | Maximum number of directories per drive: 150 | Maximum number of files per directory: 300 Maximum length of full pathname for any directory: 39 characters These limitations were chosen for no particular reason. The program can be recompiled extending these limitations, but with a consequent increase in the size of the program. The program currently takes up approximately 80K during execution. This does not include the backup option (which during execution takes up additional core - but releases it upon termination of the option). ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ RECENT REVISION HISTORY ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Ver 2.12 (29 May 86) - Bug Fix to backup option introduced by Ver 2.11 where backup option listed 1 file in each directory twice and left off 1 file that was really there. Ver 2.20 (20 Dec 86) - Changed Rescan Directory option (old CTRL-D) to ALT-R option to make room for next new option. - Added CTRL-D option for Directory Modifications. Allows addition, deletion, and name changing of directories. Based on limited testing to date, name changing only appears to work for PC/MS DOS 3.0+. - Added ALT-S option for Selecting & Sorting of files within a directory. Allows the user to specify a file select filter other than the default "*.*". Also allows for sorting files up/down by filename, extension, size, date, or no sort (directory order). - Installed new sort function to rectify previous stack overflow problems with original sort routine. - Added CTRL-V option to toggle the displaying of disk volumn identifiers. Ver 2.21 (3 Jan 87) - Fixed bug in backup option. New sort routine added in version 2.20 caused backup program to crash if diskette or drive directory identified as backup destination was empty. If backup option is not used, version 2.21 is identical to version 2.20. Ver 2.30 (1 Feb 87) - Deleted F10 as an exit option to make room for the next new option. - Added expanded on-line context-sensitive help. The F10 key is used to activate this option. - Modified "c" command enter option to allow for multiple command entries prior to returning to DS. Also allows for interface with DOS command stack/editing programs such as "CED", and keyboard redefinition programs such as "Newkey". - Modified find option to display only matching files in directories where matches occur. Changed option keys in a directory with a matching file to F2 (continue search), CR (stay in current directory), & ESC (return to original directory). - Added "TAB " option to enable tabbing/moving to the first directory containing a matching letter as the first character in its full pathname. * Acknowledgement - Grateful appreciation is extended to Mr. James Lemay of Ft. Worth, Texas for his careful review and thoughtful insights and suggestions for improvements to the program. Ver 3.00 (8 Jun 87) - Modified Color Change options. Alt-K must be selected to enable color changes. This prevents accidental color changes which was annoyingly common in previous versions. Along with this change the "set DS=0F14" type command in the "autoexec.bat" file must be replaced with a "set DS=c:\ds" (without quotes) type command. The characters following the equal sign should specify the full pathname of the directory where the user has placed all the DS files. The pathname of the specified "home" directory should NOT end with a "\" so if the user places all DS files in the root directory of the "d:" drive, it would be specified as follows: "set DS=d:" (without quotes) - Added Alt-E option to enable toggling in and out of EGA 43-line mode. - Added support for macro definition and execution. Alt- F1 thru Alt-F9, Shift-F1 thru Shift-F9, and Ctrl-F1 thru Ctrl-F9 may be user defined to execute other DOS commands. Alt-F10, Shift-F10 and Ctrl-F10 are used to display/change macro definitions. Should future desired enhancements require some available keys, one set of the above keys (ie: all alternate-function keys) may be freed up for such purposes. - Add capability to link a directory to a number key or alt-number key sequence. After such linkage is made, depressing the single number key or alt-number key sequence will switch the directory display to the new directory. Selecting "0" or "alt-0" will display directory links and allow additions/deletions. - Added Ctrl-E option to enable user to define desired editor and lister program. Defaults are "edit" and "list" but may be permanently changed by the user. - Added "defaults" file support to provide for permanent user changes to most of the previous options. - Remember to change the "set DS=0FBb" entry in your "autoexec.bat" file to reflect the full pathname of the home directory for all the DS files. ie: "set DS=c:\ds" if the user has placed all the DS programs in the "c:\ds" directory. | Ver 3.10 (05 Jan 88) | | - Replaced use of Device Driver (old "ds_drive.sys" file) | with disk "log" and "global" files. User now has the | option (within "Ctrl-E") to specify which drives to | maintain a "log" file on. This change may slow the | program down somewhat but has the following advantages: | | o Recovered 10K of memory by elimination of | device driver. You can now take it out of | your "config.sys" file. | o Allows user to maintain up to 26 disk "log" | files (old device driver only allowed 2). | o Eliminates initial disk scan on program | startup if a drive "log" file has been | previously created. | | Use of a RAM drive as the "HOME" directory for the DS | files can negate some of the delay encurred due to file | input/output. | | - Expanded limits of program to accomodate a maximum of | 150 directories per drive, and 300 files per directory. | | - Changed functions of F3, F4, F5, F6 directory movement | keys to the following: | | F3 = Move directory highlighter up one-half the | screen. | F4 = Move directory highlighter down one-half the | screen. | F5 = Move directory highlighter to root directory. | F6 = Move directory highlighter to last directory. | | - Changed "TAB " command to work on tabbing to the | first file whose filename begins with the letter | entered after the TAB key is depressed. The old usage | of tabbing to directories can be done better with the | "directory-number links" options ("0" and "alt-0"). | | - Fixed file I/O problem with "ds_prog.def" defaults | file. Certain color selections resulted in a "Ctrl-Z" | (end of file) character being written to the file. Not | all the file I/O routines accessed the file in a binary | mode. They do now, eliminating the problem with | encountering an end of file character. | | - Fixed problem of recording "HOME" directory of DS files. | Program did not record home directory correctly if the | user specified the root directory of a drive. For | example, if the user specified "set DS=c:" in the | autoexec.bat file for the root directory of the "c", | the program did not record the home directory correctly. | Hopefully it records it correctly now; however, I still | recommend that users create a "ds" directory under the | root directory and place all DS files in that directory. | A "set DS=c:\ds" command would then be required in | autoexec.bat file. | | - Fixed problem with "Illegal Interrupt No. 0Ah at ...." | which was experienced mostly by AT&T 6300 PC's but also | by some other models. | | - Added option 'Z' to toggle display/non-display of time. | Time is displayed in the top border. This option is | not fully implemented in its final form yet and has not | been included in the user's manual. | | - Added option to allow arrow keys to do double duty as | not only file movement keys but also as directory | movement keys. Toggling the space bar will toggle the | definition of the arrow keys from file movement to | directory movement or from directory movement to file | movement. If a left pointing arrow appears midway down | the border between the directory and file screens, the | arrow keys will then work on moving the highlighted | directory. If no arrow appears in the border between | the 2 screens, then the arrow keys work on the files. | If desired, the space bar can be prevented from acting | as a toggle key by pressing the 'Q' key. A second way | of defining arrow keys is to use the Ctrl-Left or | Ctrl-Right arrow. Ctrl-Left Arrow will define the arrow | keys to navigate amongst directories, while Ctrl-Right | Arrow will define the arrow keys to work on files. This | option is not fully implemented in its final form yet | and will change somewhat in the next version. | | - First attempt at installing code to support PS/2 MCGA | and VGA 50 line mode. ALT-E Option should toggle PS/2 | displays to/from 25/50 line display modes. There is | not much display info readily available to me on PS/2 | modes so keep the faith as it may take an iteration or | two to get this code working correctly. I could use | some help and/or feedback from PS/2 users on this one. | Unfortunately I do not have access to PS/2 equipment so | am working in the dark on perfecting display modes for | PS/2s. | | - Added Ctrl-T option to create a "Tree Dump" file in the | root directory of the current drive showing the tree | structure of the disk. The name of the file will be | "tree_c" if on "c" drive, "tree_d" if on "d", etc. | | - As this version of the program depends more heavily on | successfully reading and writing global/drive data to | files, the following procedure should be kept in mind. | Should the user experience any hangups after initially | successful use of the program, it is recommended that | the user delete the "ds_globl.log", "ds_drv_?.log" and, | as a last resort, the "ds_prog.def" files. The program | will create the foregoing files if it does not find | them and this may clear up any hangups should one or | more of those files get messed up during a write file | operation. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ AUTHOR ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Nat Martino 501 W. Vineyard Ave. #514 Oxnard, CA 93030 (805) 485-6340 ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ REGISTRATION/LICENSING ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ * A $15 shareware contribution is requested for using the program. * The author retains the sole right to sell the program. * The author grants users the right to copy and distribute the program within the following constraints: - All program files remain unaltered and are distributed en masse. - Only the original "non-cloned" version of the program with the startup/termination and drive change time delays is distributed. - No attempt is made to sell the program, or to make money from it or any modified version of it. - The program is not bundled with any other hardware/software transactions without the author's permission. - Recognized users' groups may charge a maximum $5 duplication or distribution fee. * Continued use of the program (more than 2 weeks) by any individual, corporation or institution without a single-user or site license is prohibited. * Single-user licenses are obtained by sending in the $15 shareware contribution. * Corporations and other institutions (including government and educational) which desire using the program should refer to the "DS_SITE.LIC" file for site licensing information. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ DISCLAIMER ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ The author disclaims all warranties expressed or implied as to the quality or performance of this program. The author will not be held liable for any lost profits, lost savings or any other direct, indirect, incidental or consequential damages resulting from the use of this program. Your use of this program constitutes your agreement to this disclaimer and your release of the author from any form of liability or litigation.