+--------------------------+ | DISK TOPOGRAPHER | | USER'S MANUAL | | Version 2.0 | +--------------------------+ 27 March 1997 Copyright 1996,1997 Niguel Software ================================================================== TO BE NOTED Thanks for your interest in Disk Topographer! Disk Topographer is a Shareware program which may be freely distributed subject to the restrictions given in the Disclaimer and Licensing sections below. If the software meets your needs and will continue to be used, then the user is requested to please send $20.00 to: Niguel Software 11 Taylor Place Laguna Niguel, CA 92677 By registering, you will be kept up to date as to releases of future versions of Disk Topographer and will be able to access free support via e-mail. Disclaimer This software should perform substantially as documented herein. While having made every effort to minimize defects and/or errors in the software, we do not warrant that the software will meet your requirements. The user assumes all risk of damage arising from the inability to use, or consequential to the use of, this software. You are granted the right to use and to make an unlimited number of copies of the Shareware version of this program but may not reverse engineer or change any portion of this program. The software cannot be sold and cannot be bundled with any commercial package or distributed by itself or accompanying books or magazines without express written permission from the author. Licensing, Registration, and Distribution This is not free software. You are licensed to evaluate Disk Topographer for a period of four weeks. If you continue to use the software, then you are required to pay the registration fee of $20 to Niguel Software. Each concurrent user of Disk Topographer must be registered. Multiple user discounts are available. Questions or comments may be directed via e-mail to dougc@acm.org. Copyright (c) 1996,1997 Niguel Software All Rights Reserved ================================================================== 1. INTRODUCTION Disk Topographer provides the user with a means for graphically visualizing the distribution of files throughout your disks. Disk Topographer provides a number of filters which allow the user to define what type of files are mapped. This manual gives the user a quick overview of Disk Topographer and how it is used. There are two versions of Disk Topographer: one for Windows 3.1 and one for Windows 95. The two versions are identical in functionality. The Windows 3.1 version is not recommended for use on Windows 95. Installation: Disk Topographer was developed using Delphi and does not require the installation of any support libraries (DLL's) or an interpreter. Three files are installed: - Executable file (DiskTopographer.exe or Dsktop32.exe for Windows 95 or disktopo.exe for Windows 3.1) - Disk Topographer icon (disktopo.ico) - This text file (disktopo.txt) If you are installing from a Niguel Software disk, then installation is accomplished by either double clicking the dt32.exe (for Windows 95) or dt16.exe (for Windows 3.1) file on the installation disk. In Windows 95, you may also select "Run" from your menu bar Start button and enter "a:\dt32" or "b:\dt32". For Windows 3.1, select "Run" from the "File" pull-down of the Program Manager window and enter "a:\dt16" or "b:\dt16". The installation will not add Disk Topographer to the Task Bar list of programs (Windows 95) or establish a program group icon (Windows 3.1). To add Disk Topographer to the Task Bar under Windows 95: - Select Start/Settings/Task Bar using the Task Bar Start button. - Click on the "Start Menu Programs" tab. - Click "Add" then "Browse" to find the DiskTopographer.exe or Dsktop32.exe file and double-click the file name. - Click "Next" then select a folder (such as Accessories) under the 'Programs' folder or define a new utilities folder. - Click "Next" and give a name to the shortcut ("Disk Topographer") and click "Finish". To add Disk Topographer to a program group in Windows 3.1: - Open an appropriate program group such as Accessories then, under the Program Manager File item, select "New". - Click "Program Item" then "OK". - Enter "Disk Topographer" as the Description then click "Browse". - Find the disktopo.exe file and double-click the file name which will define the command line. - Click "OK" - a Disk Topographer icon should now appear in the selected Program Group. Removal: Just delete the directory in which you installed Disk Topographer (no other files need to be deleted). To remove Disk Topographer from the Task Bar under Windows 95: - Select Start/Setting/Task Bar using the Task Bar Start button. - Click on the "Start Menu Programs" tab. - Click "Remove" then click the Disk Topographer folder and the "Remove" button. To remove Disk Topographer from a program group in Windows 3.1: - Open the Program Group and click on the Disk Topographer icon. - Click "Delete" under the Program Manager File item. - Click "Yes" to delete the icon. ================================================================== 2. SETTING THE CRITERIA a. Select a Disk Click the pull-down arrow at the right end of this field to get a list of drives on the system. Find the disk you want and click on it. You may need to scroll up or down in the list to find the disk. b. Select the Directory The directory list contains an entry for the selected disk plus the directories on that disk. The directory list is structured as follows (assuming the selected disk is c:): *c: c: directory 1a directory 1a directory 1b-->double click-->*directory 1b directory 1c directory 2a directory 2b directory 1c The currently selected directory (indicated by an * above) will have its icon grayed. As shown above, double clicking or selecting a directory will cause the next level of directories below the selected directory to be displayed. When you first start Disk Topographer or select a disk, the selected directory list entry may be a sub-directory on the selected disk. If you want to view all the selected disk, then be sure that the selected disk is high-lighted or grayed in this view. Disk Topographer will map whichever disk/directory is selected. c. Select Display Mode Disk Topographer can display file counts ("Ct" - total number of files in each directory) or file sizes ("Sz" - total size for all files in each directory). Click on the option you want. d. File Type The three characters to the right of the period in the file name ("DOS name" in Windows 95) indicate what type of data is in the file. This is the file name extension. If you want to limit Disk Topographer to files of a given type, then click the pull-down arrow and select the type. If the type is not in the list, then drag over the currently selected type to highlight it and enter the three character extension of interest. The default value ("*.*") will select all files. e. File Size Criteria If displaying file counts, then you can tell Disk Topographer to limit the counts to those files whose sizes are greater than ("Gt") or less than ("Lt") a given value. Click on the option which you desire then click on the pull-down arrow to select the limiting size. If the size you want is not in the list, then drag over the currently selected size to highlight it and enter the size you want. Note that the defaults are "greater than" and "zero" for the size -- this will count all files. f. Click Calculate Size Button This begins the mapping process. Disk Topographer will search the disk, checking all files within the selected disk/directory against the selected criteria. The text field in the center of the window will display the name of the directory which Disk Topographer is currently checking. ================================================================== 3. THE DISPLAY a. The Bar Graph The results are plotted as a bar graph in the bottom half of the window. The first bar represents the size or file count for the files in the selected disk/directory but not in the directories within that disk/directory. The remaining bars represent the sizes or counts for each directory one level below the selected disk/directory. Using the selected directory shown in 2.b above: directory 1b files-------------------->bar 1 directory 2a------------->bar 2 directory 3a directory 4a directory 3b directory 2b------------->bar 3 directory 3c directory 4b directory 4c Three bars will appear in the chart corresponding to files, directory 2a, and directory 2b. Bar 2 will show the size or file count for all the files and subdirectories in directory 2a (i.e., files in the following directories: 2a, 3a, 4a, and 3b). The file list to the right above the graph lists the files mapped into bar 1. If the bar graph ever disappears, then just click in the bar graph area and it will reappear. b. File Size/Count Totals If displaying by file size, then the total file size for all the files represented by the bar graph, the size of the disk, and the free space on the disk are shown. If displaying by file count, then the total number of files represented by the bar graph and the total number of files on the disk are shown. The total number of files on the disk is only shown if the full disk has been displayed in the latest or a prior request. c. Storage Efficiency This is displayed only when the full disk is mapped and the file size option is selected. This represents the ratio of the actual file size total to the amount of disk space allocated for those files. Windows allocates disk space in clusters. The clusters range in size up to 32Kbytes - the larger the disk partition the larger the cluster. For a 2GB disk partition, a 100 byte file will use 32KB - leading to poor storage efficiency for large partitions with a lot of small files. Upcoming versions of Windows may decrease the sizes of the clusters. d. File Size Graph This horizontal bar represents the total disk size with a red bar representing the disk space requirements for the files represented by the bar graph (if displaying by file size) and the black bar representing the amount of free space. ================================================================== 4. SAVING THE RESULTS The "Save New" command under the File menu option (at the top of the screen) allows you to save the results to a file on the disk. A File Save dialog box will appear. Select the directory in which you wish to save the file, then enter the name of the file. Disk Topographer will append a ".dtp" extension to the file and save the file. The file is formatted for display with a spreadsheet program (such as Excel). To access the file, open it as a text file with a comma as the field separator ("Open", "Text" button, click comma, "OK", change "List Files of Type" to all files, select file, then "OK" under Excel 4.0). Don't over-write the ".dtp" with the new spreadsheet formatted data -- save the data in a new spreadsheet file (e.g., xyz.xls). If you over-write the .dtp file, then Disk Topographer will not be able to append to it. The "Print" command will print the same data as is saved by the Save New command. The "Save Append" command allows you to append the current results to the results in an existing "dtp" file. The appended file shows each result as a separate column when opened by spreadsheet software. The results are displayed as shown below: Disk Report Disk: c Directory: \ Disk Size 255,877,120 255,877,120 Free Space 24,829,952 24,835,856 Total File Size 204,098,027 204,098,737 No. of Files 5,195 5,196 Data File Size File Count File Extension: *.* *.* 2 Date 3/26/97 3/26/97 No. of Directories 32 Files 87,604 12 ast-save 51,018 30 astdu 16,750,995 29 cardsoft 336,258 32 ccscore 156,434 10 delphi 20,433,957 663 disktopo 700,447 10 . . . . The Data and File Extension lines indicate what type of data is being displayed and what type of filtering. By placing only file counts or file sizes in a file, you can use the spreadsheet options to produce three-dimensional graphs of the changes in your disk usage with time. ================================================================== 5. EXAMINING THE RESULTS Click on any of the bars and the directory name and size/count for that bar will display in the text area above the chart. (If you click between two bars, the display will not change.) Double click on any of the files in the file list and a window will display showing the name, path, size, and date for the file. The option to delete the file is available by clicking the Delete File button. ================================================================== 6. NO MOUSE - NOW WHAT? If you don't have a mouse or your mouse has died, then Disk Topographer provides keyboard alternatives which allow you to complete the tasks at hand. The following will move you through the various windows and menus: Control Key plus Letter To select an item from the menu just press the key marked "Ctrl" along with the underlined letter in the menu item. Tab The tab key will move the cursor from one field or button in a window to the next. Once in the field or button you need, then type in the required text, move through a list with the arrow keys, or press the Enter (or carriage return) key for a button. Arrow Keys If in a field which has a list (such as the list of file sizes or the list of file types), you can move from item to item in the list by pressing the up or down arrow keys.