     [file version.texi not included]

This file documents the GNU macchanger command for printing a greeting message.

Copyright (C) 2003,2013 Alvaro Lopez Ortega.

     Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

     Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

     Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Foundation.

Stress
******

This manual documents MacChanger version VERSION, a utility for viewing/manipulating the MAC address of network interfaces.

Overview of macchanger
**********************

The GNU macchanger utility helps to view and manipulate the MAC address of network interfaces.

Features
********

  * Set specific MAC address of a network interface

  * Set the MAC randomly

  * Set a MAC of another vendor

  * Set another MAC of the same vendor

  * Set a MAC of the same kind (eg: wireless card)

  * Reset MAC address to its original, permanent hardware value

  * Display a vendor MAC list (more than 17000 items) to choose from

Invoking macchanger
*******************

The program accepts the following options.

-h
--help
     Print a usage message briefly summarizing these command-line options and the bug-reporting address, then exit.

-V
--version
     Print the version number of macchanger to the standard output stream. This version number should be included in all bug reports.

-s
--show
     Print the current MAC address and exit. This is the default action when no other option is specified.

-e
--ending
     Change the MAC address setting the same hardware vendor as the current.

-a
--another
     Change the MAC address setting a random vendor MAC of the same kind. For example, if it's a wireless card, macchanger will set another wireless MAC address.

-A
     Change the MAC address setting a random vendor MAC of any kind.

-r
--random
     Set fully random MAC address: Any kind and any vendor.

-p
--permanent
     Reset MAC address to its original, permanent hardware value.

-l
--list[=KEYWORD]
     Print known vendors. If a key is spefified, macchanger will print only vendor that matches the string.

-b
--bia
     When setting fully random MAC pretend to be a burned-in-address. If not used, the MAC will have the locally-administered bit set.

-m
--mac=XX:XX:XX:XX:XX:XX
     Set a specific MAC address. Each XX must be an hexadecial value (00 to FF).

Example invocations
*******************

The simple case is that you just want change the hardware address of the first ethernet network interface for a fully random one:

# macchanger -r eth0

Long options are supported. The following change the MAC address for another one of the same kind (for example, wireless):

# macchanger -a wifi0

To execute this examples, the interface must be down, otherwise macchanger will be exit with an error message.