1. 3COM_905_EtherLink.zip Driver
2. BPPATCH.TXT File Contents

BPPATCH.TXT Driver File Contents (3COM_905_EtherLink.zip)

BPPATCH
=======

The BPPATCH program is used to replace parameters from the BOOTP reply
packet into text files.  This allows one common image file to be used by
several workstations, with the parameters unique to each workstation (like
the IP address) being specified in the BOOTPTAB file on the server and
replaced in the image file when the workstation boots.

Important: BPPATCH MUST BE RUN BEFORE FREEMEM.


Using BPPATCH
-------------

In order to use BPPATCH you first need to put "tags" into your text files
(batch files, configuration files etc.) to indicate what BOOTP fields you
want to replace.  You then run BPPATCH and specify the files to be patched
on the command line.  You can specify more then one file at a time.  For
example if you wanted to patch the files "start.bat" and "pctcp.ini" your
command line would be:

    bppatch start.bat pctcp.ini

Note: If you need to patch parameters for commands in your autoexec.bat file
      you will need to place these commands in a second batch file, so you
      can run BPPATCH before the second batch file is executed.  For example
      if you put all the commands in a file called "start.bat", your
      autoexec.bat file would be:

         bppatch start.bat
         start


Tags
----

All tags begin with the character sequence "#@" which is followed by a three
character tag name.  Following the tag name are additional "#" characters
used to specify the tag length.  The total tag length is counted from the
first # character to the last # character.  It is important to make the tag
large enough to contain all the characters that may be in the field. If the
field is larger then the tag length then the field is truncated.

The following tags can be used with BPPATCH:

    Tag       Field name               Description
    -----------------------------------------------------------------------

    Adapter specific information:

    #@iop#    Adapter I/O address      The I/O address that 3Com MBA used to
                                       access the network adapter card.

    #@shm#    Adapter memory address   The network adapter RAM address used
                                       by 3Com MBA (not used on all adapters).

    #@typ#    3Com MBA type code       The 3Com MBA type code for the
                                       network adapter (see the 3Com MBA
                                       User Guide for a list of type codes).

    BOOTP RFC951 fields

    #@bfn#    Boot file name           The name of the boot image file.

    #@cha#    Client hardware address  The ethernet hardware address for the
                                       adapter card.

    #@gip#    Gateway IP address

    #@shn#    Server host name

    #@sip#    Server IP address

    #@yip#    "Your" IP address        The BOOTPTAB ip= field value.

    RFC1048 vendor fields

    #@smf#    Subnet mask field        The BOOTPTAB sm= field value.

    #@tof#    Time offset field        The BOOTPTAB to= field value.

    #@chn#    Client host name field   The full name of the host, including
                                       both the host and domain names.  This
                                       is specified in the first field of the
                                       BOOTPTAB file.

    #@cno#    Client host name only    The host name only, as specified in
                                       the first field of the BOOTPTAB file.

    #@cdo#    Client domain name only  The domain name only, as specified in
                                       the first field of the BOOTPTAB file.

    #@gw?#    Gateway IP address*      The BOOTPTAB gw= field value.

    #@ts?#    Time server IP address*  The BOOTPTAB ts= field value.

    #@ns?#    Name server IP address*  The BOOTPTAB ns= field value.

    #@ds?#    Domain name server IP*   The BOOTPTAB ds= field value.

    #@lg?#    Log server IP address*   The BOOTPTAB lg= field value.

    #@cs?#    Cookie server IP*        The BOOTPTAB cs= field value.

    #@lp?#    LRP server IP address*   The BOOTPTAB lp= field value.

    #@im?#    Impress server IP*       The BOOTPTAB im= field value.

    #@rl?#    RLP server IP address*   The BOOTPTAB rl= field value.

    #@txxx#   User defined field number xxx
              (see information below)


* For IP address fields inwhich you can specify more then one IP address
  you can select which address you want by including the number in the
  tag.  For example, to indicate the IP address of the first domain name
  server the tag would be #@ds0#, the second domain server IP address would
  be #@ds1#, etc.

RFC1048 user fields
-------------------

BPPATCH supports custom RFC1048 user fields (tag numbers 128-254).  To
specify a user field use the tag "#@t" followed by the field number, for
example to specify user field 129 the tag would be "#@t129####".


Alignment
---------

Normally BPPATCH will left align a field to a tag name.  If you want to right
align the field place a "-" character after the tag name.  Example, to right
align the boot file name field the tag would be "#@bfn-#####".

Examples
--------

If you have a "hosts" file that lists the server's IP address and the local
IP address you can change the file to be:

    # hosts internet address file
    #@yip##########   #@chn############################
    #@sip##########   #@shn############################

Then after you run BPPATCH on the hosts file the servers IP address and name,
along with the unique workstation IP address and name will be in the file,
example:

    # hosts internet address file
    132.147.170.6     Station1
    132.147.160.0     UnixHost

There is a test file called "BPTEST.TXT" included with BPPATCH that includes
all tags, you can use this file as an example and for testing BPPATCH on your
system.

Command line options
--------------------

There two command line options available; /s and /v.

    /s   The /s option is used to display all the available tags, and their
         values.  The output is formatted in such a way that it can be
         redirected to a disk file and then used to set DOS environment
         variables.  An example output:

              rem BOOTP Patch v1.0 (25-May-94)
              rem RFC951 BOOTP reply
              set yip=132.147.175.9
              set sip=132.147.160.1
              set bfn=/tftpboot/hp.img
              set typ=56
              set iop=0x300
              rem RFC1048 vendor fields
              set smf=255.255.0.0
              set tof=18000
              set t128="UnixBox"

         The output can be redirected to a file using the DOS redirection
         character ">", example, to record the settings in a file called
         "BOOTP.TXT":

              BPPATCH -s >BOOTP.TXT

    /v   The /v option selects "verbose" mode so BPPATCH will display
         messages while it processing the text files.  Normally BPPATCH
         doesn't display anything on the screen.