home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / qutils32.zip / QUTILS32.DOC < prev    next >
Text File  |  1994-07-11  |  19KB  |  432 lines
  1. Quick Utils 3.2
  2. (C) Copyright 1994 by Henning Vahlenkamp
  3.  
  4.  
  5. I) Disclaimer:
  6. --------------
  7. While every effort has been made to make this package bug-free, the author
  8. assumes no responsibility for any incidental or consequential damages
  9. resulting from the use or misuse of this package in whole or in part. There
  10. are also no implied or expressed warranties regarding this package in whole or
  11. in part.
  12.  
  13.  
  14. II) Status:
  15. -----------
  16. This package is shareware. If you find it useful in whole or in part, please
  17. send the registration fee ($10 US by check or money order) to the following
  18. address:
  19.  
  20.          Henning Vahlenkamp
  21.          216 Spring Hill Road
  22.          Matawan, NJ 07747
  23.  
  24. If you send a 3.5" disk and a SASE along with the registration, you'll receive
  25. the next update free. Registered users of previous versions of Quick Utils
  26. needn't send the registration fee.
  27.  
  28.  
  29. III) What is it?:
  30. -----------------
  31. Quick Utils is a group of 14 small, tightly written and optimized utilities
  32. that perform various useful functions (see below). They work with any PC
  33. using at least DOS 3.3. I couldn't find any programs that quickly and easily
  34. perform these tasks to my liking, so I decided to write my own.
  35.  
  36.  
  37. IV) History:
  38. ------------
  39. 2.0 - first public release
  40.       includes BIOSDATE, CONTEXT, CRYPT, EVAL, TEXTAN
  41. 3.0 - added CAT, DTSET, FINDER, INFO, MOVE, RENDIR, SPIN, SPLIT
  42.       incorporated BIOSDATE into INFO
  43.       fixed bug in square root function of EVAL
  44.       enhanced previous programs
  45. 3.1 - added CALENDAR, PASSLOCK
  46.       replaced EVAL with CALC, a greatly enhanced version
  47.       renamed RENDIR to QREN
  48.       fixed bug in disk id display of INFO
  49.       enhanced previous programs
  50. 3.2 - added extended/standard ASCII option to CALENDAR
  51.       rewrote SPIN for much greater accuracy
  52.       various minor enhancements
  53.  
  54.  
  55. V) Documentation:
  56. -----------------
  57. With the exception of INFO, typing any of the commands without parameters, as
  58. well as with incorrect parameters, will display a copyright message/usage
  59. guide for that command. The parameters shown in the guide contain symbols
  60. whose meanings are as follows:
  61.  
  62.   <parameter>             a required parameter
  63.   [parameter]             an optional parameter
  64.   parameter1|parameter2   use only one of the two parameters
  65.   parameter1+parameter2   use one or both of the parameters
  66.  
  67. In this section, each command's message/usage guide is shown followed by a
  68. more detailed discussion of that command.
  69.  
  70. A)********************************************************************
  71. »Calc 3.2« ∞ the command line calculator
  72. (C) 1994 by Henning Vahlenkamp
  73.  
  74. Usage: CALC <expression|?>
  75.  constants: e pi
  76.  operators: + - * / \ ^ & | ~ < > <= >= <> ()
  77.  functions: sin(x) cos(x) tan(x) csc(x) sec(x) cot(x)
  78.           : arcsin(x) arccos(x) arctan(x) arccsc(x) arcsec(x) arccot(x)
  79.           : sinh(x) cosh(x) tanh(x) csch(x) sech(x) coth(x)
  80.           : arcsinh(x) arccosh(x) arctanh(x) arcscsh(x) arcsech(x) arccoth(x)
  81.           : ln(x) log(base,exponent) sign(x) sqrt(x)
  82.  note     : \ {mod}, ^ {power}, & {and}, | {or}, ~ {not}, x {argument}
  83.           : sign(x) returns -1 (x<0), 0 (x=0), 1 (x>0)
  84.           : ? {use interactive mode}
  85.  
  86. CALC performs quick calculations when you don't have a calculator handy.
  87. Simply give it an arbitrary mathematical expression consisting of any
  88. combination of the above constants, operators, and functions. It also
  89. supports parentheses nesting subexpressions. Standard arithmetic conventions
  90. apply, meaning operators separated by operands, multiplication takes
  91. precedence over addition, etc.
  92. For example,
  93.             (3+(4-5)*6/7+sqrt(4)+3.8^2)
  94. yields an answer of 18.58285714300
  95. If you type a ? instead of an expression, CALC starts in interactive mode,
  96. so you can do multiple calculations without rerunning the program each time.
  97. Pressing Enter by itself at the expression prompt quits CALC. By the way,
  98. CALC is accurate to 11 decimal places regardless of whether you have a math
  99. coprocessor.
  100.  
  101. B)********************************************************************
  102. »Calendar 3.2« ∞ the calendar generator
  103. (c) Copyright 1994 by Henning Vahlenkamp
  104.  
  105. Usage: CALENDAR <year> <style> [[path]filename]
  106.  year : 1800<=year<=9999
  107.  style: /e {use extended ASCII for borders}
  108.         /s {use standard ASCII for borders}
  109.  note : without a filename, output goes to the screen
  110.  
  111. CALENDAR generates attractive, full year calendars that fit onto standard
  112. 8.5"x11" sheets of paper. Simply give it a year and a border style, and it
  113. will send the resulting calendar to the screen or to a text file if a filename
  114. is specified.  You can then copy the file to your printer. It uses
  115. CALENDAR.DT1 (extended ASCII borders) and CALENDAR.DT2 (standard ASCII
  116. borders) as templates. You can customize these templates to your liking, but
  117. make sure that the positions for each month and space for the title remain the
  118. same, as the program expects them where they are.
  119.  
  120. C)********************************************************************
  121. »Cat 3.2« ∞ the file displayer
  122. (c) Copyright 1994 by Henning Vahlenkamp
  123.  
  124. Usage: CAT <switch> [path]<filename> [search_string]
  125.  switches: /p {printable chars     ■ASCII#10,13,32->255}
  126.          : /d {standard printables ■ASCII#10,13,32->127}
  127.          : /h {hexadecimal}
  128.          : /s {search, search_string can be anything}
  129.  
  130. CAT works like TYPE, but allows filtering of the file to be displayed. For
  131. example, you can filter out unprintable (control) characters and the
  132. nonstandard IBM graphics characters. CAT is especially useful for displaying
  133. all the text in binary files. Plus, CAT can display files in hexadecimal
  134. format. Each line of the hex dump begins with the offset of the first of the
  135. 16 bytes on the line, followed by the bytes (two hex digits each), followed by
  136. an ASCII representation of the bytes; unprintable characters are replaced by
  137. periods. There's also a searching mode whereby you specify a string of
  138. characters, and CAT returns all the locations (offsets) in the file containing
  139. that string.
  140.  
  141. D)********************************************************************
  142. »ConText 3.2« ∞ the textfile converter
  143. (c) Copyright 1994 by Henning Vahlenkamp
  144.  
  145. Usage: CONTEXT <switch> [path]<sourcefile> [path]<targetfile>
  146.  switches: /up {UNIX|Amiga->PC}       | /pm {PC->Mac}
  147.          : /um {UNIX|Amiga->Mac}      | /mu {Mac->UNIX|Amiga}
  148.          : /pu {PC->UNIX|Amiga}       | /mp {Mac->PC}
  149.          : /ul {uppercase->lowercase} | /lu {lowercase->uppercase}
  150.          : /s  {strip ASCII #s>127}   | /c  {strip all control chars}
  151.          : /e  {strip all line endings}
  152.  note    : source & target must be different files or paths
  153.  
  154. CONTEXT is a conversion program which converts text files among UNIX/
  155. Amiga, PC, and Macintosh platforms in any direction. This is necessary
  156. since each platform uses different end-of-line markers.
  157.  
  158. platform       marker(s)
  159. ----------     ---------
  160. UNIX/Amiga     lf
  161. PC             cr,lf
  162. Macintosh      cr
  163.  
  164. (lf=line feed, ASCII#10; cr=carriage return, ASCII#13)
  165.  
  166. In addition, CONTEXT can convert all the letters in a file between upper and
  167. lower case, remove nonstandard ASCII characters (128..255), remove all control
  168. characters (except for line endings), and remove all the line endings. Giving
  169. it anything other than an ASCII text file will produce meaningless results.
  170.  
  171. E)********************************************************************
  172. »Crypt 3.2« ∞ the file en/decrypter
  173. (c) Copyright 1994 by Henning Vahlenkamp
  174.  
  175. Usage: CRYPT <switch> <password> [path]<sourcefile> [path]<targetfile>
  176.  switches: /e {encrypt} | /d {decrypt}
  177.  password: any # of characters, no spaces
  178.  note    : source & target must be different files or paths
  179.  
  180. CRYPT protects files from prying eyes by scrambling their contents
  181. according to a password you supply. It also decrypts encrypted files if
  182. you supply the same password you used to encrypt. Don't forget your
  183. password, since files can't be restored otherwise. In addition to
  184. documents, CRYPT is useful for executables, as encrypted files can't be run
  185. successfully. CRYPT attaches a tiny message to the beginning of encrypted
  186. files so you can easily recognize them. Just type a file you're uncertain
  187. about and look for "Crypt3.0!" This version uses the same en/decryption
  188. algorithm as 3.0, which was improved from 2.0. Files encrypted with 2.0 can't
  189. be decrypted with later versions and vice versa.
  190.  
  191. F)********************************************************************
  192. »DTSet 3.2« ∞ the file date/time modifier
  193. (c) Copyright 1994 by Henning Vahlenkamp
  194.  
  195. Usage: DTSET [path]<filename> <[date]+[time]>
  196.  date: MM-DD-YY {MM 1..12, DD 1..31, YY 80..99
  197.  time: HH:NN    {HH 0..23, NN 0..59}
  198.  
  199. Inspired by the AmigaDOS SetDate command, DTSET permits you to change the
  200. date and/or time of one or more files. Using it is very simple; just follow
  201. the above template (MM=month,DD=day,YY=year,HH=hour,NN=minute). Remember to
  202. specify the time with the 24-hour clock (e.g. 3:00PM is 15:00). Error
  203. checking is limited, so if you enter numbers outside the acceptable ranges,
  204. the resulting dates and/or times will be unpredictable.
  205.  
  206. G)********************************************************************
  207. »Finder 3.2« ∞ the file finder
  208. (c) Copyright 1994 by Henning Vahlenkamp
  209.  
  210. Usage: FINDER [switch] [path]<filename>
  211.  switch: /n {no searching lower directories}
  212.  note  : searching starts downward from path (or current dir)
  213.  
  214. FINDER is a file finding utility. Give it a file specification, and it will
  215. search the specified (or current) directory plus all lower subdirectories for
  216. all matches. You can also choose to search the one directory only.
  217. Matches are displayed in a format similar to that of DIR, except FINDER also
  218. shows all attributes (even hidden files) and each file's path.
  219.  
  220. attributes:                            rhsvda
  221.  r=read only   ─┐                      ──┬───
  222.  h=hidden       │                        │
  223.  s=system file  │     letter in one of these positions means bit is set
  224.  v=volume label │     dash   "   "  "    "       "       "    "  "  clear
  225.  d=directory    │
  226.  a=archive     ─┘
  227.  
  228. H)********************************************************************
  229. »Info 3.2« ∞ the information displayer
  230. (c) Copyright 1994 Henning Vahlenkamp
  231.  
  232. Usage: INFO [drive]
  233.  drive: A: .. Z:
  234.  
  235. INFO without any parameters reports some general information about your
  236. system. For example:
  237.  
  238. DOS version        : 5.0
  239. ROM BIOS date      : 12/01/88
  240. ctrl-break flag    : FALSE (off)
  241. verify flag        : FALSE (off)
  242. free memory        : 288960 bytes
  243.  largest block     : 288960 bytes
  244. date               : Monday  July 11, 1994
  245. time               : 3:20:0.0pm
  246. environment strings:
  247. --------------------
  248. COMSPEC=C:\DOS\COMMAND.COM
  249. PATH=C:\;C:\DOS;C:\NORTON;C:\PROWRITE;C:\TURBO
  250. PROMPT=TIME = $T$H$H$H$H$H$H$_DATE = $D$_$P$G$
  251.  
  252. Giving INFO a drive letter makes it print a lot of disk-related information.
  253. For example, INFO C: would print:
  254.  
  255. Information for drive->c: unit->2 type->fixed disk
  256. ---------------------------------------------------
  257. total bytes         : 42844160         bytes per sector     : 512
  258. bytes used          : 22683648 (53%)   bytes per cluster    : 2048
  259. bytes free          : 20160512 (47%)   sectors per cluster  : 4
  260. sectors             : 83680            sectors per FAT      : 82
  261. clusters            : 20920            sectors per track    : 40
  262. cylinders(tracks)   : 523              reserved sectors     : 1
  263. FATs                : 2                hidden sectors       : 40
  264. max root dir entries: 512              media descriptor byte: 248
  265. disk sides          : 4                disk id              : MSDOS5.0
  266.  
  267. sector: 0 boot record
  268.         1-164 FAT
  269.         165-196 root dir
  270.         197-83639 data
  271.  
  272. You can view the message/usage guide by giving INFO a question mark as a
  273. parameter. Explanations of all the things reported by INFO are beyond the
  274. scope of this documentation.
  275.  
  276. I)********************************************************************
  277. »Move 3.2« ∞ the file mover
  278. (c) Copyright 1994 by Henning Vahlenkamp
  279.  
  280. Usage: uses COPY command syntax
  281.  
  282. MOVE simply copies files from a source to a destination and deletes the
  283. source. It's the equivalent of using a DEL after a COPY - only more
  284. convenient. MOVE works just like COPY.
  285.  
  286. J)********************************************************************
  287. »PassLock 3.2« ∞ a system access protection utility
  288. (c) Copyright 1994 by Henning Vahlenkamp
  289.  
  290. Usage: PASSLOCK <switch> <sourcefile> [targetfile]
  291.  switches: /c {create encoded config file}
  292.               {targetfile required}
  293.            /p {do security check}
  294.  note    : source & target must be different files or paths
  295.  
  296. PassLock is a handy utility to prevent unauthorized users from gaining access
  297. to your computer. It uses a configuration file consisting of login names and
  298. passwords for up to 50 users. In order to gain access, one would need to know
  299. a valid login/password combination.
  300.  
  301. The first step in installing PassLock is to create a configuration file. You
  302. start with a simple ASCII text file such as this (LOGFILE.TXT):
  303.  
  304. vahlenkamp,testpass1
  305. security,check
  306.  
  307. Each line of the file should contain a login name, followed by a single comma,
  308. followed by a password, followed by a line ending (CR,LF). For simplicity,
  309. try to limit each line to 80 characters. Don't put commas anywhere else,
  310. since PassLock uses them as separators. The last character of the file should
  311. be an EOF. Most word processors and text editors should be able to create
  312. correct files for you.
  313.  
  314. Now run PassLock with the "/c" switch, a sourcefile name (the file you just
  315. created), and a targetfile name (the resulting configuration file).  PassLock
  316. will write an encoded version of the sourcefile. The configuration file is
  317. encoded for an extra measure of security. Just be sure to keep a copy of the
  318. unencoded sourcefile in a safe place in case you forget your login name or
  319. password.
  320.  
  321. The included sample configuration file, PASSLOCK.CFG, was derived from
  322. LOGFILE.TXT.
  323.  
  324. Once a configuration file is created, you need to add PassLock to your
  325. AUTOEXEC.BAT file so that it runs every time you start up your computer. Add
  326. the following line before anything else in AUTOEXEC.BAT:
  327.  
  328. passlock /p <sourcefile>
  329.  
  330. where <sourcefile> is now the name of your configuration file. You can also
  331. type this from the command line to protect your computer if it is left on and
  332. unattended temporarily.
  333.  
  334. Upon running PassLock, you'll be prompted for your login name, followed by
  335. your password. Press Enter after each. Using unassociated login names and
  336. passwords won't work. Moreover, you have only three chances to enter each.
  337. After the third incorrect input, the program will freeze, completely locking
  338. out the keyboard, forcing you to turn the computer off and reboot. The same
  339. thing happens by trying to bypass the program with CTRL-BREAK. This will
  340. frustrate those attempting to guess your login name or password.
  341.  
  342. PassLock should provide adequate protection against casual users, but the more
  343. determined may still get in by booting off a floppy instead of the hard disk.
  344. Unfortunately, there is really no way to prevent this via software alone. For
  345. total security, you would need some kind of hardware device, or perhaps you
  346. could remove the floppy drives from your computer.
  347.  
  348. K)********************************************************************
  349. »QRen 3.2« ∞ the file/directory renamer
  350. (c) Copyright 1994 Henning Vahlenkamp
  351.  
  352. Usage: QREN [path]<oldname> <newname>
  353.  
  354. QREN performs another simple function - renaming directories. It works
  355. just like REN, accepting files as well.
  356.  
  357. L)********************************************************************
  358. »Spin 3.2« ∞ the disk spinner
  359. (c) Copyright 1994 by Henning Vahlenkamp
  360.  
  361. Usage: SPIN <drive> <time>
  362.  drive: A: .. Z:
  363.  time : /3 {30 sec.} | /6 {60 sec.}
  364.  note : without time parameter, disk spins until a keypress
  365.  
  366. SPIN makes it easy to clean the read/write heads of a floppy drive by spinning
  367. a (user-supplied) cleaning disk in the drive. While spinning, it also moves
  368. the heads randomly so that no part of the cleaning disk is overused. You can
  369. choose either a short spin (30 sec.) or a long one (60 sec.). SPIN
  370. automatically detects invalid drives and fixed disks, aborting in both cases.
  371. Omitting the time parameter spins the disk and displays the elapsed time until
  372. you press a key.
  373.  
  374. M)********************************************************************
  375. »Split 3.2« ∞ the file splitter
  376. (c) Copyright 1994 by Henning Vahlenkamp
  377.  
  378. Usage: SPLIT <# parts> [path]<sourcefile> [[path]targetfile]
  379.  # parts: 2..255
  380.  note   : source extension cannot be in 1..255
  381.         :  resulting file extension is part #
  382.         : rejoin files w. COPY /B ...
  383.  
  384. I wrote SPLIT in order to transfer files too large to fit on a single floppy
  385. disk from one computer to another. You may find it equally useful. This
  386. utility cuts up any file into a user-specified number of parts. The resulting
  387. files' extensions are the numbers of the parts. There's no need for an
  388. UNSPLIT command since parts can be rejoined with COPY. Just remember to
  389. rejoin them in the correct order (xxxxxxxx.1 followed by xxxxxxxx.2 etc.).
  390.  
  391. N)********************************************************************
  392. »TextAn 3.2« ∞ the textfile analyzer
  393. (c) Copyright 1994 by Henning Vahlenkamp
  394.  
  395. Usage: TEXTAN [path]<filename>
  396.  
  397. TEXTAN analyzes text files, calculating a lot of statistics about them.
  398. Here's a sample analysis of this file:
  399.  
  400. Analyzing (QUTILS32.DOC)...done
  401. ------------------------------------------------------------
  402. file size          :19146      paragraphs             :431
  403.  nonprintable chars:863        lines                  :431
  404.  printable chars   :18283      pages (66 lines each)  :7
  405.   alphanumerics    :12643      avg word length        :4.57
  406.     letters        :12191      avg words/sentence     :15.19
  407.     digits         :452        avg words/paragraph    :6.42
  408.   symbols          :5640       avg words/page         :395.00
  409. words              :2765       avg sentences/paragraph:0.42
  410. sentences          :182        avg sentences/page     :26.00
  411.  exclamatory(!)    :2          avg paragraphs/page    :61.57
  412.  interrogative(?)  :5
  413.  declarative(.)    :175
  414.  
  415. Giving it anything other than an ASCII text file will produce meaningless
  416. results.
  417.  
  418.  
  419. VI) Notes:
  420. ----------
  421. CAT, CONTEXT, CRYPT, SPLIT, and TEXTAN can process files of any size,
  422. since they all have reusable input/output buffers.
  423. DTSET, FINDER, and MOVE are the only commands supporting DOS wild cards.
  424. The functions of MOVE and QREN are now part of DOS as of version 6.0. I
  425. decided to keep them in Quick Utils since they were developed prior to the
  426. release of DOS 6.
  427.  
  428. Questions, comments, bug reports, and suggestions for improvements are
  429. welcome by mail or e-mail (vahlenka@trenton.edu).
  430.  
  431. That's all for now. I hope you find Quick Utils as useful as I do.
  432.