Kill Rogues! – find and disconnect machines from your Cisco switches based LAN

Intro, screenshots | Prerequisites | Usage | Bug reports | Licensing | Download

1. Intro, screenshots

2. Prerequisites

2.1 Architecture

Your LAN must be composed of Cisco switches. Other switches will be invisible and you might disconnect such switches instead of machines. That’s because it uses Cisco commands by telnet and CDP.

The switches must have telnet enabled. Telnet and enable passwords must be  the same on all the switches.

2.2 Software

- OS

Being written in wxPython, KillRogues is platform independent. Linux and

Windows are supported. Mac OS X is supposed to work but was not tested as

I don’t have access to any OS X installation.

- Software

Running the Windows .exe files doesn’t require anything (which is why the

*.exe files are quite big for such a small app; they contain the whole

python interpreter and libraries).

Running the python files requires Python (duh) and wxPython (≥ 2.8).

3. Usage

3.1 Versions

There are 3 executables: the main command line (killrogues-cli), the graphical interface (killrogues) and the unshut port CLI (unshut-cli). Running these is done by launching either:

- the *.sh files if you’re running from the source under Linux

- the *.exe files if you’re running from the compiled Windows files

3. Options

- Main command-line interface:

Usage:

killrogues-cli [options] search type

Search types:

ping                    Perform a ping search: ping the target first. Faster, but requires

                        the target to answer to ping

exhaustive              Perform an exhaustive search: look for the target's MAC

                        address on every switch. Slower, but higher success rate.

Options:

-h, --help              Show this message

-i, --ip=ip             IP of the target machine (for ping search)

-m, --mac=mac-address   MAC addres of the target machine (for exhaustive search)

-p, --pass=pass         Password on the switches

                        It is assumed that the password is the

                        same on all switches

-s, --switch=ip         IP of the first switch to search

-d, --debug             Debug mode (default: off)

- Unshut port CLI:

 Usage: 

unshut-cli [options]

Options:

-h, --help Show this message

-p, --pass=pass         Password on the switch

-s, --switch=ip         IP of the switch

-P, --port=port         Port to unshut (ex: Fa0/1, Gi0/1...)

-d, --debug             Debug mode (default: off)

- Graphical interface:

No options; all done from the GUI.

4. Bug reports

Thanks to send bug reports to clem __ at __ lorteau . fr or comment this page.

5. Licensing

Killrogues is licensed under the terms of the GNU General Public License. It’s free to use and you can modify it and redistribute it under certain conditions. Details of this license are provided in the LICENSE file.

6. Download

- Platform independant:

killrogues-1.1.tar.gz (58 KB)

- Ubuntu package:

killrogues_1.1-0ubuntu1_all.deb (11,3 KB)

or PPA

- Windows:

killrogues-1.1-win.zip (15,5 MB)

Mac OS X users should be able to run the platform independant version (feel free to comment if not; or even better, feel free to provide a patch).