From eb6b43dfa49e34677354b313f9d5c05ff4148c13 Mon Sep 17 00:00:00 2001 From: Håkon Nessjøen Date: Sun, 22 Jul 2012 15:40:20 -0700 Subject: Create gh-pages branch via GitHub --- index.html | 129 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 129 insertions(+) create mode 100644 index.html (limited to 'index.html') diff --git a/index.html b/index.html new file mode 100644 index 0000000..24c7d37 --- /dev/null +++ b/index.html @@ -0,0 +1,129 @@ + + + + + + Mac-telnet by haakonnessjoen + + + + + + + +
+
+

Mac-telnet

+

Open source MAC Telnet client and server for connecting to Microtik RouterOS routers and Linux machines via MAC address.

+ +

View the Project on GitHub haakonnessjoen/MAC-Telnet

+ + + +
+
+

MAC-Telnet for Linux

+ +

Console tools for connecting to, and serving, devices using MikroTik RouterOS MAC-Telnet protocol.

+ +

Installation

+ +

Then download source tarball, extract, compile and install:

+ +
wget http://github.com/haakonnessjoen/MAC-Telnet/tarball/master
+tar zxvf haakonness*.tar.gz
+cd haakonness*/
+make all install
+
+ +

Now you're ready.

+ +

TIP: You can use the well known "expect" tool to automate/script dialogues via mactelnet!

+ +

Usage

+ +
# mactelnet -h
+Usage: mactelnet <MAC|identity> [-h] [-n] [-t <timeout>] [-u <user>] [-p <password>] [-U <user>] | -l
+
+Parameters:
+  MAC            MAC-Address of the RouterOS/mactelnetd device. Use mndp to
+                 discover it.
+  identity       The identity/name of your destination device. Uses
+                 MNDP protocol to find it.
+  -l             List/Search for routers nearby. (using MNDP)
+  -n             Do not use broadcast packets. Less insecure but requires
+                 root privileges.
+  -t <timeout>   Amount of seconds to wait for a response on each interface.
+  -u <user>      Specify username on command line.
+  -p <password>  Specify password on command line.
+  -U <user>      Drop privileges to this user. Used in conjunction with -n
+                 for security.
+  -q             Quiet mode.
+  -h             This help.
+
+ +

Example:

+ +
$ mactelnet 0:c:42:43:58:a5 -u admin
+Password: 
+Connecting to 0:c:42:43:58:a5...done
+
+
+  MMM      MMM       KKK                          TTTTTTTTTTT      KKK
+  MMMM    MMMM       KKK                          TTTTTTTTTTT      KKK
+  MMM MMMM MMM  III  KKK  KKK  RRRRRR     OOOOOO      TTT     III  KKK  KKK
+  MMM  MM  MMM  III  KKKKK     RRR  RRR  OOO  OOO     TTT     III  KKKKK
+  MMM      MMM  III  KKK KKK   RRRRRR    OOO  OOO     TTT     III  KKK KKK
+  MMM      MMM  III  KKK  KKK  RRR  RRR   OOOOOO      TTT     III  KKK  KKK
+
+  MikroTik RouterOS 4.0 (c) 1999-2009       http://www.mikrotik.com/
+
+
+ [admin@HMG] >
+
+ +

MAC-Ping usage

+ +
# macping -h
+Usage: macping <MAC> [-h] [-c <count>] [-s <packet size>]
+
+Parameters:
+  MAC       MAC-Address of the RouterOS/mactelnetd device.
+  -s        Specify size of ping packet.
+  -c        Number of packets to send. (0 = for ever)
+  -h        This help.
+
+ +

Example:

+ +
# macping 0:c:42:43:58:a5
+0:c:42:43:58:a5 56 byte, ping time 1.17 ms
+0:c:42:43:58:a5 56 byte, ping time 1.07 ms
+0:c:42:43:58:a5 56 byte, ping time 1.20 ms
+0:c:42:43:58:a5 56 byte, ping time 0.65 ms
+0:c:42:43:58:a5 56 byte, ping time 1.19 ms
+
+5 packets transmitted, 5 packets received, 0% packet loss
+round-trip min/avg/max = 0.65/1.06/1.20 ms
+
+ +

Or for use in bash-scripting:

+ +
# macping 0:c:42:43:58:a5 -c 2 >/dev/null 2>&1 || ( echo "No answer for 2 pings" | mail -s "router down" my.email@address.com )
+
+
+ +
+ + + + \ No newline at end of file -- cgit v1.2.3