*--------------------------- * BLRUT55.DOC *--------------------------- * *--------------------------------- * this is a brief description * of these utilities, * ( version 55 ), * placed in the public domain * as of 11/07/96 *--------------------------------- * *--------------------------------- * *---------------------------------------------------- * they were all written by Bud Rasmussen, * * in intel assembly language, * * using: * * Semware's Professional Editor as a text editor, * and * Microsoft's MASM / LINK for assembling/linking. * * my current computer configuration is : * * an NCN 50 mhz 486 with 16 mb of memory, * a MAGITRONIC SVGA monitor, * a BOCA 1 mb SVGA card, * one 1.2 mb 5.25 drive ( a ), * one 1.4 mb 3.50 drive ( b ), * a 250 mb Seagate HD partitioned ( c - k ), * an 8 mb Ramdrive ( l ), * a SONY CD-ROM drive ( m ), * a FORVAL 14400 modem, * PANASONIC KX-P1180 and Canon BJ-200 printers, * and operating happily with PC DOS 7.0 *---------------------------------------------------- * *--------------------------------------- * these utilities have been tested * on this configuration ONLY, * BUT i must admit, * NOT always thoroughly enough. *--------------------------------------- * *------------------------------------------------------------ * all of these utilities are interactive; * which is to say that all the information * they need will be requested at run time. * thus, all you need do to execute them * is to key in the program name at the DOS prompt; * e.g. * >xxx... ( where xxx... = program name ) * * also, see extended note about utility menu/shell 'EBU'. *------------------------------------------------------------ * *---------------------------------------------------------------------- * EXTENDED NOTES: * * 1. see extended note about utility menu/shell 'EBU' at end of doc. * 2. see extended note about color configuration file at end of doc. *---------------------------------------------------------------------- * *========================================================================= Pgm Brief Name Description .... ............................................................... BD Backup Directory this program will copy all files in a directory, ( that have the attributes of normal, archive, sys ), from drives ( a - k ) to drives ( a - k ). you have the option of copying all files, or selecting only those you wish to copy. if the output drive is 'a' or 'b', you have the option of erasing all the files on the diskette, before the copy. if the output diskette fills up, you have the option of putting a formatted disk in the drive and continuing or quitting. the present directory entry ( file ) limit is 512. optionally, you may request that the output directory be created, if it doesn't already exist. BHD Backup Hard Disk this program will backup a hard disk from drives ( c - k ) to previously formatted diskettes on drive 'a'. if the output diskettes have files on them, the files will be erased before the copy. as an option, a log file of all files copied, will be created in the root directory of the input drive, and named 'bhd.log'. the present directory entry ( file ) limit is 512. at the end of the backup, backup statistics will be printed. BLF Backup Large File this program will backup a large file from drives ( c - k ) to previously DD formatted diskettes on drives 'a' or 'b'. ( large file, in this case, means larger than 360 kb ) it will write as much of the file as will fit on each diskette, and then ask for another, until it reaches eof on the input file. use 'RLF' to restore the file. CACF Copy And Convert File this program will copy a text file from drives ( a - k ) to drives ( a - k ), changing all non text characters ( char < ascii 32 or char > ascii 127 ) to space ( ascii 32 ), except for : bel ( ascii 7 ), bk spc ( ascii 8 ), tab ( ascii 9 ), line feed ( ascii 10 ), form feed ( ascii 12 ), carriage return ( ascii 13 ), which are copied as is. since the output file name must be entered, this program may function as a copier/renamer. CF Copy File this program will copy a file from drives ( a - k ) to drives ( a - k ). since the output file name must be entered, this program may function as a copier/renamer. DBPB Display BIOS Parameter Block this program displays the information found in the BIOS parameter block, ( used by DOS to control disk type devices ), which is found in the boot sector on disks. dbpb recognizes drives ( a - k ). DCM Directory Copy / Move this program will copy or move all the directory entries ( with the attributes of normal, archive, sys ), from a specific directory on drive ( a - k ), to a specific directory on drive ( a - k ). the present directory entry ( file ) limit is 512. optionally, you may request that the output directory be created, if it doesn't already exist. during a move, only, you may request that the source directory be deleted after the move of all of its entries. DDBT Display Disk Base Table this program displays the information found in the disk base table, ( used by DOS to control disk type devices ), which is found in RAM. DKV Display Key Value this program displays the ascii character and the scan code, in both hex and ascii, of any key pressed. DPT Display Partition Table this program displays the standard fixed disk partition table which is found in the master fixed disk boot record on a fixed disk which was partitioned by FDISK. this program assumes that 'c' is the primary bootable DOS partition. DSE Disk Sector Edit this program gives you the ability to read, display, modify, and write back almost any sector on drives 'a' or 'b'. EADF Erase All Diskette Files this program will erase all files in the root directory of 'a' or 'b'. however, it will not erase sub directories or any files in them. FCM File Copy / Move this program will copy or move a file from drives ( a - k ) to drives ( a - k ). optionally, the input file name may be entered from the command line, ( e.g. fcm d:\xxx\xxx.xxx ), or from the input file request at run time. since the output file name must be entered, this program may function as a copier/mover/renamer. FFD Format Floppy Diskette this program formats the four most common floppies : 5.25 DD (360kb) or 5.25 HD (1.2mb), and 3.5 DD (720kb) or 3.5 HD (1.4mb), on either drive 'a' or 'b'. If errors are encountered during the format, you are given the option of a retry of the format operation. you also have the option of either a standard format, or a quick format ( initializing the FATS and directories ). the quick format is only valid on already formatted diskettes as a means of quickly clearing them of all references to previous data. during the format, the diskette is labelled 'Formatted'. FRE File Record Edit this program allows you to modify a file on drives ( a - k ). it does this by displaying the file 192 bytes at a time, on the screen in ascii and hex format. you then have the option of: 1. displaying the next screen 2. displaying the previous screen 3. modifying the screen 4. quitting if the screen is modified, the modified portion of the file is written back to the file. LPAF List/Print Any File this program will list or print any file on drives ( a - k ). its output format is an ascii line followed by the same line in hex, followed by a line of spaces. LPD List/Print Directory this program will list or print any directory on drives ( a - k ). all directory entries, even if they are hidden, are output. you have the option of having the output sorted by name. the present directory entry ( file ) limit is 512. drive and directory space information is also displayed at the end of the list/print. LPS List/Print Sector this program will list or print almost any sector on drives 'a' or 'b'. LPTF List/Print Text File this program will list or print a std text file on drives ( a - k ). this program reads in the entire file, for speed, but since it only has a 63k buffer, that is the largest text file it can handle. during the read-in process, all non text characters are changed to spaces. LTF List Text File ( forward/backward ) this program will list a std text file on drives ( a - k ). it will list forward or backward ( by line, page, or file ). this program uses the same buffer system as lptf, and therefore has the same 63k file limit. during the read-in process, all non text characters are changed to spaces, and all tab characters are expanded. optionally, the file name to be listed may be entered from the command line ( e.g. ltf d:\xxx\xxx.xxx ), or from the file name request at run time. PSF Print Spooled File this program will print a spooled file on drives ( a - k ). QDL Quick Directory List this program will list any directory on drives ( a - k ). all entries, even if they are hidden, are listed. the output is sorted by name. the list is scrollable forwards / backwards by line / page. the present directory entry ( file ) limit is 512. drive and directory space information is also displayed at the end of the list, when requested. RLF Restore Large File this program will restore a large file from DD drives 'a' or 'b' previously created by 'BLF', to drives ( c - k ). it will read as much of the file as is on each diskette, write it to the output file, and then ask for another diskette, until the user terminates with Esc, at which time it will close the output file. RSD Rename Sub Directory this program will allow the user to change the name of any sub directory on drives ( a - k ). RSD assumes that the sub directory to be renamed is in the root of whatever drive you choose. if it isn't, preface it with the proper path. for instance, rename sub dir 'aaa\bbb' to 'aaa\ccc'. SD Space Display this program displays: total bytes allocated, total bytes used, total bytes free, bytes per sector, sectors per cluster, available clusters, total clusters, on drives ( a - k ). SLTF Split Large Text Files i ran into some text files that were too large for my text editor to handle, so i wrote this program. it will allow you to break up the large text file into more manageable segments. you have the option of breaking the file into segments based either on size or # of lines. it will allow access to any file on drives ( a - k ). TFC Two File Compare this program will compare two files in 64 byte increments. if there is an inequality encountered, then the two 64 byte segments with the inequality are displayed, showing file displacement. it will allow access to any file on drives ( a - k ). VLCC Volume Label Change, Create this program is for changing or creating the volume label on diskettes in drives 'a' or 'b'. *========================================================================= *----------------------------------* * EXTENDED NOTE: * * utility MENU/SHELL 'EBU' * *----------------------------------* *------------------------------------------------- a utility menu program/shell named EBU ( Execute BLR Utilities ), has been added. basically, if EBU and the 2 files it uses, ( BLRUT.MNU + BLRUT.TBL ), are in the same directory as the utilities, and this directory is the current directory, then all the utilities may be executed from EBU. when you execute EBU, it will display a menu of all the utilities. when you pick the 2 digit number of the utility you wish, that utility will execute. when you are finished with that utility, control will be returned to EBU. you can then either pick other utilities or quit. *------------------------------------------------- *----------------------------------------* * EXTENDED NOTE: * * color configuration file / doc * *----------------------------------------* BLRUTCFG.FIL = color configuration file BLRUTCFG.DOC = color configuration documentation basically, if BLRUTCFG.FIL is in the same directory as the utilities, and this directory is the current directory, then all the utilities will get their color configuration from it. if not, then the utilities will use their preset color configuration. for further information, or if you wish to make changes in BLRUTCFG.FIL, read BLRUTCFG.DOC. *------------------* * WHERE I AM * *------------------* *----------------------------------------------------------- * * if you have any questions, suggestions, gripes, * or you wish the source for these utilities; * * here are my addresses: * * Bud Rasmussen * 3795 Saxon Drive S. * Salem, OR 97302-6041 * usa * * 503-585-1515 ( VOICE only - this is NOT a BBS nor FAX number ) * * I can also be reached through the * Salem Public Library BBS where I * am the Assembly Language SIG Sysop * * The SPL BBS has four lines : * * 503-588-6130 300-2400 * 503-588-6081 300-2400 * 503-588-6086 300-14400 * 503-588-6092 300-14400 * * All are 8-N-1 * * Internet address = bud.rasmussen@bbs.chemek.cc.or.us * *-----------------------------------------------------------