home *** CD-ROM | disk | FTP | other *** search
- - 1 -
- Sat 7-December-1991
-
- About TSUTLC in General (All rights reserved)
- =======================
-
- This is the third package in my utilities series of currently five
- packages. The others are TSUTIL, TSUTLB, TSUTLD, and TSUTLE.
-
- This package may be used and distributed freely for NON-COMMERCIAL,
- NON-INSTITUTIONAL, PRIVATE purposes, provided it is not changed in
- any way. (Repacking with another method, is ok though.) For ANY
- other usage, such as use in a business enterprise or at a
- university, contact the author for registration. Uploading to
- bulletin boards is encouraged. Please do not distribute any part of
- this package separately.
-
- The programs are under development. Comments and contacts are
- solicited. If you have any questions, please do not hesitate to use
- electronic mail for communication.
- InterNet address: ts@chyde.uwasa.fi (preferred)
- Bitnet address: SALMI@FINFUN.BITNET
- Funet address: GADO::SALMI
-
- The author shall not be liable to the user for any direct, indirect
- or consequential loss arising from the use of, or inability to use,
- any program or file howsoever caused. No warranty is given that the
- programs will work under all circumstances.
-
- Timo Salmi
- Professor of Accounting and Business Finance
- School of Business Studies, University of Vaasa
- P.O. BOX 297, SF-65101 Vaasa, Finland
-
-
- Timo Salmi UTiLities set C, release 1.7 (TSUTLC17) includes the
- * * ** * * * *
- following utility-type programs:
-
- TSUTLC17 Third set of Utilities, T.Salmi
- Filename Comment
- -------- --------------------------------
- DIRF.EXE Directory in full, recursive
- DIRINFO.EXE Directory information of a disk
- DOUBLES.EXE Find double file names on a disk
- DTEDIF.EXE Difference between two dates
- HIDDEN.EXE Find all hidden files on disk
- READONLY.EXE Find all readonly files on disk
- SPLIT.EXE Split a file into pieces
- TSPROG.INF List of PD programs from T.Salmi
- TSUTLC.INF Document
- TSUTLC.NWS News announcements about tsutlc
- VAASA.INF Info: Finland, Vaasa, U of Vaasa
- WHATDATE.EXE Date +- number of days from now
- ZEROFILE.EXE Find all empty files on disk
- ---- ------ ------ -----
- 0013
-
-
- - 2 -
-
- DIRF (Ver. 1.6) Recursive directory utility
- ===============
-
- Usage: DIRF [directory mask] [/a(llocated bytes)] [/c(urrent datetime)]
- [/s(ubdirectories)] [/w(ide)]
- or: DIRF /h(elp)
-
- This is a directory program which can optionally be used recursively, that is
- can be applied automatically on all subdirectories (the /s option).
-
- Hidden files are included in the directory listing and are indicated
- by h. ReadOnly files are coded by r. DIRF also gives the volume
- creation date, which MsDos DIR (but not MsDos CHKDSK) omits.
-
- There is a slight difference to the MsDos syntax. A subdirectory in
- the MsDos DIR command is indicated e.g. by \SUBDIR whereas in DIRF
- the proper syntax is \SUBDIR\ that is the closing backslash must be
- present. Another difference is that while DIR .EXT list *.EXT files,
- you must apply DIRF *.EXT for the same effect.
-
- Release notes:
- Version 1.1: The switch for scanning also the subdirectories has
- been altered from /v to /s. Errors in the switch are now detected.
-
- Version 1.2: The /w(ide) option has been added. The help switch has
- been changed from ? to /h. If the volume has no label, this is now
- explicitly stated. DIRF accepts a /p(age) option but exhorts using
- the MsDos more filter.
-
- Version 1.3: File size gives the exact size of a file, not
- necessarily the space allocated to it, because disk space is
- allocated in clusters of bytes. The /a option gives the factual
- space allocations.
-
- Version 1.4: Added the /c option which gives the date&time at the
- time of running DIRF.EXE.
-
- Version 1:5: Switch /d made a synonym for /c.
-
- Version 1.6: Corrected a bug in the recursive option /s which
- caused problems when recursion started from a subdirectory given as
- a parameter to DIRF.EXE.
-
-
- DIRINFO (Ver. 1.2) Directory information of a disk
- ==================
-
- Usage: DIRINFO Device [/a(llocated bytes)]
- or: DIRINFO ?
-
- This program lists the names of all the directories on a disk, gives
- the total of bytes in the files, and the number of files in each
- directory on the disk. The total of bytes is the sum of the sizes of
- the files, not the total space allocation to the directory (which is
- greater since space in FAT is allocated in clusters of 512 or more).
-
- MS-DOS directory command counts directories within a directory as
- files. DIRINFO does not count them as files. MS-DOS does not count
- hidden files. DIRINFO does count them, because the author feels that
- this is more logical.
-
- Release Notes:
- Version 1.1: A summary giving the names of the empty directories
- has been appended. A directory is now considered empty if it has no
- true subdirectories (that is directories other than .. and .) and no
- files. In version 1.0 directory was considered empty if it had no
- files. This was misleading if there were subdirectories in an
- otherwise empty directory.
-
- Version 1.2: Added the /a switch which allows for the cluster size
- and thus shows the true space allocated to the files.
- Corrected a bug which allowed DIFINFO to access nonexistent
- devices.
-
-
- DOUBLES (Ver. 1.5) Find double file names on a disk
- ==================
-
- Usage: DOUBLES [device:] [second device:] [/e(xact)] [/n(o attributes)]
- or: DOUBLES ?
-
- This program searches through a disk for multiple occurrences of
- file names. Each time a multiple name is encountered, it is printed
- on the screen.
-
- The following is no longer true (see the release 1.1 information
- below): "The directory names where the multiple files are located
- are NOT given by this program. You have to locate them with some
- other program like DIRF.EXE in this package. (There are also other
- fine PD or SW programs for doing this, such as SFIND, PKZFIND, SWEEP
- DIR, and, of course, the MsDos external SEARCH utility, and so on.)
- The reason for this solution is that this way DOUBLES could be made
- much faster, and can handle a greater array of files. (Think of the
- number of files and comparisons that may be involved.)"
-
- DOUBLES can handle up to 5040 files. If there are more on the disk,
- the program will finally abort cleanly.
-
- Please note that DOUBLES program uses dynamic memory allocation. Use
- Break and CTRL-C keys at your peril. Part of free memory will be
- lost, and you may have to reboot. (Nah! Not really, TP takes care of
- the memory reallocation.)
-
- Now why this new program when there already are PD programs doing
- this same thing? The reason is simple. The PD program I tried out
- crashed when tested on my office 386 computer's harddisk. And
- DOUBLES now has capabilities not present in the other disk-serch
- programs I have tried out.
-
- Release Notes:
- Version 1.1: The multiple file names will be printed on the screen
- with the path, date and time information. This means that you no
- longer need any other programs to get the path, and date&time. The
- cases of more than two files with the same name are not treated
- consistently. That is, if a file name appears, say three times, only
- 3 (not 6) file names will be listed. You can redirect the output to
- a file. E.g. use ECHO y| DOUBLES C: > D.LOG.
-
- Version 1.2: Corrected a memory allocation error, which could have
- caused problems in rare cases on machines with very little memory
- space.
-
- Version 1.3: Added the /e(xact) switch. In order to consider no
- other than identical files as doubles, apply the /e switch. Files
- with same name, size and date&time stamp are deemed identical. The
- actual contents of the files are not compared the keep the program
- fast.
-
- Version 1.4: Added the capability of searching for the doubles on
- two disks. My thanks are due to Petri Hartoma of the Tampere
- University of Technology for suggesting this improvement. Added
- displaying file attributes. For hidden files the letter h, and for
- readonly files the letter r, will be added at the end of the
- relevant files. You can suppress this by using option /n.
-
- Version 1.5: Corrected a bug which allowed DOUBLES to access
- nonexistent devices. Made a couple of minor stylistic changes.
-
-
- DTEDIF (Ver. 1.0) Difference between two dates
- =================
-
- This program has been added to this package since tsutlc15.
-
- Usage: DTEDIF FirstDate(dd-mm-yyyy) [SecondDate(dd-mm-yyyy)]
- or: DTEDIF ?
-
- This program calculates the difference in days between two dates. If
- only a single date is given, the difference is calculated from the
- current date. Notice that you have to give the (modern) year with
- four digits, because, for example 2-7-89 will indicate year 89, not
- 1989.
-
- There is a similar program TIMDIF for difference between two times
- in the tsutil package.
-
-
- HIDDEN (Ver. 1.1) Find all hidden files on disk
- =================
-
- Usage: HIDDEN [device:]
- or: HIDDEN ?
-
- This program lists the names of all your hidden files. It performs
- the search on all the directories on the selected disk.
-
- Release Notes:
- Version 1.1: Corrected a bug which allowed HIDDEN to access
- nonexistent devices. Made a minor stylistic changes.
-
-
- READONLY (Ver. 1.1) Find all readonly files on disk
- ===================
-
- Usage: READONLY [device:]
- or: READONLY ?
-
- This program lists the names of all your readonly files whether
- hidden on not. It performs the search on all the directories on the
- selected disk. If the readonly file is also hidden, this is
- indicated by h after the file name.
-
- Release Notes:
- Version 1.1: Corrected a bug which allowed READONLY to access
- nonexistent devices. Made a minor stylistic changes.
-
-
- SPLIT (Ver. 1.1) Split a file into pieces
- ================
-
- Usage: SPLIT Filename RowsOrCharsPerPiece [DestinationPath] [/b(inary)]
- or: SPLIT ?
-
- As its name suggests, this program splits a text file or a binary
- file into pieces. The pieces will be named after the original file
- by using 001, 002, and so on, as the extension. Any existing file
- will be overwritten. So, do not split the split files.
-
- If you omit the /b switch, the original file will be treated as
- text. The second parameter will thus indicate how many rows you wish
- to have in each new file. If you set the /b switch, the second
- parameter will denote the desired number of characters rather than
- rows.
-
- SPLIT is a Turbo Pascal 5.0 program, and it applies a special
- reading and writing technique (blockread/write) to make it fast.
-
- In my TSFCOM package there is another program FILECUT.EXE for
- splitting files. Filecut is a more specialized, and slower program
- with a particular emphasis on written texts.
-
- Release Notes:
- Version 1.1: Added the option to define a destination path for the
- split files should the user want it to differ from the location of
- the file to be split.
-
-
- WHATDATE, (Ver. 1.0) Date +- number of days from now
- ===================
-
- Usage: WHATDATE ±NumberOfDays
- or: WHATDATE ?
-
- This program gives you the date that was, or will be, the given
- number of days from today. The date will include the weekday. The
- date today is easily checked by applying WHATDATE +0
-
-
- ZEROFILE (Ver. 1.0) Find all empty files on disk
- ===================
-
- Usage: ZEROFILE [device:]
- or: ZEROFILE ?
-
- This program lists the names of all your empty files. It performs
- the search on all the directories on the selected disk. If the empty
- file is hidden, this is indicated by h after the file name. If it is
- readonly r is used.
-
-