The README file for MACWAC - August 12 2005
___________________________________________
-------------------------------------------

  macwac     Software to change the MAC address of an ether card
  Copyright (C) 2005  Ben Teschendorff

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

   Contact the author:
      email -	software@eyedropvideo.com

*******************************************************************************

1) General Info
2) Usage
3) Compiling
4) Installing
5) Dependencies
6) Change Log


************
General Info
*************

macwac-0.1

This command line utility allows you to change MAC data in the structure of 
the kernel driver for your ether card. It does NOT change the actual hardware 
address which will be read in the next time the machine reboots.

In order to update the MAC the ether device must be down (ifconfig ethX down)
and the binary must be run by the superuser (root). 


*****
Usage
*****

To view the current MAC for a card ...
	macwac -m [device_number]
... where device_number is the number of the ether card. If no device_number is
specified the default is 0.

To change the MAC ...
	macwac -s hardware_address [-d device_number]
... where hardware_address is the new MAC with a format of xx:xx:xx:xx:xx:xx
and -d device_number is the number of the ether card. If no device_number is
specified the default is 0.

To see a quick help ...
	macwac -h


*********
Compiling
*********

The easiest thing to do is use the Makefile and run the command,

	make all

This will compile and strip the binary. Then if you have permission run 
the ...

	make install

... command to install the binary plus a man page. See below in the section 
Installing for more info.

There is also a 'make uninstall' command should you wish to remove macwac 
from the default installation location. And you can use 'make clean' to remove 
macwac from the source directory.

		-------------------------------------------------

To compile from a command line ...

	gcc -Wall -O2 macwac.c machelp.c -o macwac

... then strip with ...

	strip --strip-all macwac



**********
Installing
**********

If you ran the 'make install' routine the following file(s) were installed,
	/usr/local/bin/macwac
	/usr/share/man/man8/macwac.8.gz

If you're doing it by hand just put the binary in ...
	/usr/local/bin/macwac
... or anywhere in your PATH that you've got permission for and put the man
page in ...
	/usr/share/man/man8/macwac.8.gz
... and you're done!


************
Dependencies
************

C Library


**********
Change Log
**********

0.1 - August 12 2005
  Initial release.


*******************************************************************************
email the author:  software@eyedropvideo.com