
Readme.txt file for Linux Programs
----------------------------------

                                     Last updated: Oct 9, 2006

(c) Copyright by Dave Edwards, 2006. All rights reserved.

This directory contains some Linux utility programs that you may
find useful if you are running Hercules or MUSIC/SP under Linux.
These programs are the Linux equivalents of Windows .exe programs
in other directories of this site.

They were compiled with the gcc 3.2 C compiler and tested on
Red Hat Linux 8.0.  They may work on other versions of Linux and
Unix, but I have not tested on other systems - please use caution
and do your own testing before using them!  The C source assumes
that types "int" and "long int" are 32 bits.

NOTICE: These programs are provided "as-is", without any support,
        and without any warranty or claim that they work correctly.
        Use them at your own risk.  See the file license.txt in
        this directory (a BSD-style license).

These programs and source are (c) Copyright by Dave Edwards, 2005.
Please refer to the accompanying license.txt file.

To install a program, download it as a BINARY file to your Linux
machine, rename it from xxxx.bin to xxxx, set the attributes
to make the file executable (e.g. chmod a+x xxxx), and copy it
to a directory in the search path (echo $PATH).  Most programs
display short help when run as a command with no parameters.
NOTE: Be careful when editing a Unix shell script file (such as
md5pw_sh). Some Unix/Linux shells require LF (not CR LF) line ends.
Transfer them as BINARY files to preserve the LF endings.

In case you need to customize a program, or if you are just curious
about how it works, C source files for most of the programs are
also provided.

Please report any bugs or suggestions to the Yahoo H390-music
discussion group, or send me a message via the Sim390 home page
http://www.geocities.com/sim390 .

You can use the Unix/Linux commands md5sum and sha1sum to check
the MD5 or SHA1 digest (check sum) of a downloaded file.  This
verifies that the file is authentic and has not been corrupted.
The digests are given below. You can also use the file md5.txt
with the md5sum command on Linux:  md5sum --check md5.txt
(NOTE: The MD5 digests for the source files (*.c) were calculated
on files with CRLF line endings. If your download to Linux changed
CRLF to LF, your MD5 digests will be different. You can avoid this
either by turning off "CR stripping" in your FTP client, or by
using BINARY mode for the download even though the files are text.
However, the md5sum command does not like CRLF in the check file
itself, so download md5.txt in Ascii mode with CR stripping on!)


md5pw      - This program is similar to the Windows md5pw.exe
             command.  It concatenates a challenge string and a
             password, and displays the MD5 digest (as 32 hex digits)
             of the result.  For example, if the challenge string
             presented by a login screen is BA07F9B8BCE2FA5D and the
             password is mypass, the program calculates and displays
             the MD5 of the string BA07F9B8BCE2FA5Dmypass which is
             7f596071f367d973ea4fdf88538a71ef. You would then enter
             the 32-char MD5 string instead of your password, on the
             login screen.  This avoids sending your password in
             clear text over the Internet.  When you enter your
             password into the md5pw program, it does not echo on
             the screen.  For more info, type the command
             "/help challenge" in MUSIC/SP.

             File size:  17680 bytes    Date: Nov 30, 2005
             MD5 digest:  E957D07B 7B9DA6C3 C9A8EAEE B1B0F4AD
             SHA1:  8A97DA4D E9B924D9 8740079C 5741C174 BD1EE9C2


md5pw_sh   - This is the shell version of md5pw.  Operation is
             similar, except it runs as a shell script and uses
             the md5sum command (standard with most Unix and Linux
             systems) to calculate the MD5 digest.
            NOTE: This script requires the readpass program.

             File size:  575 bytes    Date: Nov 30, 2005
             MD5 digest:  15E4487E B75764BE 826CB268 39ACCE17
             SHA1:  C4D9FF64 37DA5732 A2073F5E DF59DE37 562B2C6A


readpass   - This program reads a password, without echoing it to
             the screen, and writes the password to standard output.
             It is used by md5pw_sh.

             File size:  12707 bytes    Date: Nov 30, 2005
             MD5 digest:  799F2E0B 13BBA02E 70BDC58E D4F40F75
             SHA1:  562BB139 CE8A306F F7F9337D CBFC815B 82CF01BE


wipezero   - Writes a specified number of zero bytes to a file,
             at a specified byte displacement in the file.
             It can be used to enlarge a Hercules FBA volume file
             (specify e as the displacement).  Max file size: 2 GB.
            NOTE: It's a good idea to make a copy of any important
             file before using wipezero on it.
            CAUTION: Do not try to use wipezero on a file larger
             than 2 GB; the result may be incorrect.

             File size:  16979 bytes    Date: Dec 1, 2005
             MD5 digest:  BDE1F107 39C0AFFC 92FA0EA6 797DC612
             SHA1:  FDF352F5 90F485F8 DECF10B1 D3C0E546 64236C1A

                           - - - - -
