From patchwork Thu May 26 12:32:25 2011 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marek Lindner X-Patchwork-Id: 1127 Return-Path: Received: from nm16.bullet.mail.ukl.yahoo.com (nm16.bullet.mail.ukl.yahoo.com [217.146.183.190]) by open-mesh.org (Postfix) with SMTP id 774F61543B8 for ; Thu, 26 May 2011 14:33:40 +0200 (CEST) Authentication-Results: open-mesh.org; dkim=pass (1024-bit key) header.i=@yahoo.de; dkim-adsp=none Received: from [217.146.183.216] by nm16.bullet.mail.ukl.yahoo.com with NNFMP; 26 May 2011 12:33:39 -0000 Received: from [217.146.183.177] by tm9.bullet.mail.ukl.yahoo.com with NNFMP; 26 May 2011 12:33:39 -0000 Received: from [127.0.0.1] by omp1018.mail.ukl.yahoo.com with NNFMP; 26 May 2011 12:33:39 -0000 X-Yahoo-Newman-Id: 453450.31790.bm@omp1018.mail.ukl.yahoo.com Received: (qmail 38142 invoked from network); 26 May 2011 12:33:39 -0000 DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=s1024; d=yahoo.de; h=DKIM-Signature:X-Yahoo-Newman-Property:X-YMail-OSG:X-Yahoo-SMTP:Received:From:To:Cc:Subject:Date:Message-Id:X-Mailer; b=JQ4LcRCACSL6RltuUp6+XxlbXWWpacG2kJ3GYkvJn3hxHZ3XSayuNxg+QvUBJnyNPnJxXlVLSTWhFRFoiz0+XChZi1xhV+wmp7BSwW859amtwxBHBNiBnMg0XzigGbkdntUIpkuE6mbULTI6FCa2fTFVkotmWcN9T9aZb8Kcc+o= ; DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.de; s=s1024; t=1306413219; bh=Kos3ALLtasf+SoFJiKmUqwFMjW5pvl80ngdjTyVtbLA=; h=X-Yahoo-Newman-Property:X-YMail-OSG:X-Yahoo-SMTP:Received:From:To:Cc:Subject:Date:Message-Id:X-Mailer; b=3I5yidrb/Okag1LuAFLCm4bG3NBQgyUxSaTa+glOW4cFlh9c/PWbbwQF46diXrdnwE5s/JrHwGFN3ViQNIyH0ictNXL0Z2gWz3TERcdnSj1j7ThrqWRnfhdczUbKhfmBjXf6jRrSONoRVbaKdtNDd6hlrBewmfNxYiNeXHL0gmk= X-Yahoo-Newman-Property: ymail-3 X-YMail-OSG: S1dR3i0VM1nz5DPtEAVAPPhBEsybNPgj2w.YGgO6n_XSb_r QuSZnp5es0LfBY9YCiBR3GkPBMW27I0Q2WZTBTO0nJ9n0.ZFVu6mzfliGJ3e RI885ejizoFW00ox2H.lGjfHy3v1HN5OBTPMfQ4EG33SMXCXlnFwUvTgZ823 q89s6uglPDCjpQ9I4fj8FuGcmyXsWAU5N_1b1GEdzBbyuscF5nh9GC.v2Nv5 NEGHyKr5I2YTTPUu1Tpf0yWhXSh_7MNLnDQiFgREUB8krypYj0QTTubPY..8 yIv9e3cErDj2sdrrdZRFUHWq_XVK537GcihgBenzqJ6oB1RMo9P_7avIgALd OIspdReNvxLb0Ieclgx2a1kstp_7_JaB1iXNFttr0D2SfCi0gFTCWgbhdhN9 89Xw5HXY- X-Yahoo-SMTP: tW.h3tiswBBMXO2coYcbPigGD5Lt6zY_.Zc- Received: from localhost (lindner_marek@90.35.97.226 with plain) by smtp127.mail.ukl.yahoo.com with SMTP; 26 May 2011 12:33:38 +0000 GMT From: Marek Lindner To: b.a.t.m.a.n@lists.open-mesh.org Date: Thu, 26 May 2011 14:32:25 +0200 Message-Id: <1306413145-7921-1-git-send-email-lindner_marek@yahoo.de> X-Mailer: git-send-email 1.7.2.3 Cc: Marek Lindner Subject: [B.A.T.M.A.N.] [PATCH] batctl: update readme X-BeenThere: b.a.t.m.a.n@lists.open-mesh.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: The list for a Better Approach To Mobile Ad-hoc Networking List-Id: The list for a Better Approach To Mobile Ad-hoc Networking List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 26 May 2011 12:33:40 -0000 Signed-off-by: Marek Lindner --- README | 41 ++++++++++++++++++++--------------------- 1 files changed, 20 insertions(+), 21 deletions(-) diff --git a/README b/README index d11c6d3..442f8b6 100644 --- a/README +++ b/README @@ -18,8 +18,8 @@ settings. How does it work ? ================== -batctl uses the /dev/batman-adv device provided by the B.A.T.M.A.N. advanced -kernel module to inject custom icmp packets into the data flow. That's why +batctl uses the debugfs/batman_adv/bat0/socket device provided by the B.A.T.M.A.N. +advanced kernel module to inject custom icmp packets into the data flow. That's why ping and traceroute work almost like their IP based counterparts. Tcpdump was designed because B.A.T.M.A.N. advanced encapsulates all traffic within batman packets, so that the normal tcpdump would not recognize the packets. @@ -30,8 +30,8 @@ The bat-hosts file This file is simliar to the /etc/hosts file. You can write one MAC address and one host name per line. batctl will analyze the file to find the matching MAC -address to your provided host name. Host names are much easier to remember -than MAC addresses. ;) +address to your provided host name. Host names are much easier to remember than +MAC addresses. ;) batctl ping @@ -45,6 +45,7 @@ options: -h print this help -i interval in seconds -t timeout in seconds + -R record route Example: @@ -95,8 +96,9 @@ options: 4 - batman unicast packets 8 - batman broadcast packets 16 - batman vis packets - 32 - non batman packets - 33 - batman ogm & non batman packets + 32 - batman fragmented packets + 64 - non batman packets + 65 - batman ogm & non batman packets Example output for tcpdump: @@ -241,12 +243,12 @@ batctl interface display or modify the interface settings -Usage: batctl interface|if [none|interface] +Usage: batctl interface|if [add|del iface(s)] Example: $ batctl interface -[ active] eth0 fe:fe:00:00:01:01 +eth0: active batctl interval =============== @@ -270,7 +272,6 @@ Usage: batctl log|l Example: $ batctl log -r) [ 400] Received BATMAN packet via NB: fe:fe:00:00:02:01 IF: eth0 [fe:fe:00:00:01:01] (from OG: fe:fe:00:00:01:01 via prev OG: fe:fe:00:00:01:01 seqno 670, tq 245, TTL 49, V 8, IDF 1) [ 400] Drop packet: originator packet from myself (via neighbour) [ 400] Received BATMAN packet via NB: fe:fe:00:00:02:01 IF: eth0 [fe:fe:00:00:01:01] (from OG: fe:fe:00:00:02:01 via prev OG: fe:fe:00:00:02:01 seqno 545, tq 255, TTL 50, V 8, IDF 0) @@ -285,15 +286,14 @@ batctl loglevel display or modify the log level -Usage: batctl |ll [level] +Usage: batctl loglevel|ll [level] Example: $ batctl loglevel -[x] critical (0) -[x] warnings (1) -[x] notices (2) -[x] batman (4) -[x] routes (8) +[x] all debug output disabled (0) +[ ] messages related to routing / flooding / broadcasting (1) +[ ] messages related to route or hna added / changed / deleted (2) +[ ] all debug messages (3) batctl aggregation ================== @@ -334,18 +334,17 @@ Globally announced TT entries received via the mesh (translation table): * 86:4b:b2:d2:00:00 via fe:fe:00:00:07:01 * ca:a1:5b:e5:00:00 via fe:fe:00:00:06:01 -batctl vis_server +batctl vis_mode ================= display or modify the status of the VIS server -Usage: batctl vis_server|vs [enabled|disabled] +Usage: batctl vis_mode|vm [mode] Example: -$ batctl vis_server -[x] client mode (server disabled) -[ ] server mode (server enabled) +$ batctl vis_mode +client batctl vis_data @@ -410,7 +409,7 @@ vis-dot to png -------------- The vis dot output could then further be converted to an image of the topology -graph, e.g. with the help of the graphviz-tools. The according commands could +graph, e.g. with the help of the graphviz-tools. The according commands could then look like this: $ batctl vis_data dot > /tmp/graph.dot