burnm Version 0.0                                    By Jason Nunn
                                                     Darwin, NT, Australia
                                                     This software is GNU GPL


This distribution is a "Kernel side" companion for Terry Porters "Burn"
program. It allows burn to safely talk to the parallel port using kernel
facilities.

Although this has been written for burn, it can be used for anything
that's wants to access the register ports of a parallel port safely. at
the moment, it's geared towards burn.


Requirements
------------

You need a kernel that is 2.2.x or better.


Installing
----------

- create /dev/burn. Do this by typing: mknod /dev/burn c 200 0, and
then 'chmod 666 /dev/burn' if you want user access to it (which i do).

- To compile, type in 'make'.

- copy burnm.o somewhere into /lib/modules/<kernel_version>/misc, where
<kernel_version> is the version of your kernel. For example, this is my
path: /lib/modules/2.2.15/misc/

- type in 'depmod -a'

- edit the /etc/conf.modules file (or where ever it is), and add the
  following entry:

  alias char-major-200 burn
  options burn parport=0

parport=0 is for lpt1. if you want it to use another port, then set
parport=x to the same ordinal port. .. ie parport=1 is for lpt2, parport=2
is for lpt3 etc


Running (under Linux 2.1 and 2.2):
---------------------------------

- to load manually, you can now type in 'modprobe burnm', or if your
kernel automatically loads modules, it will now be able to do so with
burnm.o

you can type in 'modprobe burnm'. in this case, burnm will assign to
/dev/burnm the first parallel port it finds (normally parport0).



Contacts:

  burnm ......................... Jason Nunn <jsno@downunder.net.au>
                                  jsno.downunder.net.au


  burn &  AT892051 Programmer ... Terry Porter <tjporter@odyssey.apana.org.au>
                                  www.odyssey.apana.org.au/~tjporter



                                   oo0oo
