commits

commits@lists.open-mesh.org

1 participants
12425 discussions

[doc] batman-adv-doc, master: Add formal public identifier with uri to DOCTYPE (2d51b200)
by postmaster＠open-mesh.org 14 Dec '17

14 Dec '17

Repository : ssh://git@open-mesh.org/doc On branches: batman-adv-doc,master >--------------------------------------------------------------- commit 2d51b2007e37e72b5d32d363939311cf3ccfcd67 Author: Sven Eckelmann <sven.eckelmann(a)gmx.de> Date: Fri Jan 23 01:37:45 2009 +0100 Add formal public identifier with uri to DOCTYPE XML needs a valid FPI with an uri after a PUBLIC keyword to be valid. xsltproc will check if it is valid xml and stop further processing otherwise >--------------------------------------------------------------- 2d51b2007e37e72b5d32d363939311cf3ccfcd67 batman.docbook | 4 +++- batman_iv_only.docbook | 4 +++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/batman.docbook b/batman.docbook index d3382aad..509b27ab 100644 --- a/batman.docbook +++ b/batman.docbook @@ -1,5 +1,7 @@ <?xml version="1.0" encoding="UTF-8" ?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" [ +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" + "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" +[ <!ENTITY bookinfo SYSTEM "bookinfo.docbook"> <!ENTITY introduction SYSTEM "introduction.docbook"> <!ENTITY batman_iv SYSTEM "batman_iv.docbook"> diff --git a/batman_iv_only.docbook b/batman_iv_only.docbook index 595da8c3..9a95b6bb 100644 --- a/batman_iv_only.docbook +++ b/batman_iv_only.docbook @@ -1,5 +1,7 @@ <?xml version="1.0" encoding="UTF-8" ?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" [ +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" + "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" +[ <!ENTITY bookinfo SYSTEM "bookinfo.docbook"> <!ENTITY introduction SYSTEM "introduction.docbook"> <!ENTITY batman_iv SYSTEM "batman_iv.docbook">

1 0

[doc] batman-adv-doc, master: Make generation of pdf more generic (e8a10297)
by postmaster＠open-mesh.org 14 Dec '17

14 Dec '17

Repository : ssh://git@open-mesh.org/doc On branches: batman-adv-doc,master >--------------------------------------------------------------- commit e8a10297bbed72d5055ee51c428c9f2f3300dfc5 Author: Sven Eckelmann <sven.eckelmann(a)gmx.de> Date: Fri Jan 23 11:47:45 2009 +0100 Make generation of pdf more generic >--------------------------------------------------------------- e8a10297bbed72d5055ee51c428c9f2f3300dfc5 Makefile | 31 ++++++++++++++++++++----------- 1 file changed, 20 insertions(+), 11 deletions(-) diff --git a/Makefile b/Makefile index e15d8082..f838a75e 100644 --- a/Makefile +++ b/Makefile @@ -1,17 +1,26 @@ default: all all: batman_doc -.PHONY: clean images -batman_doc: Makefile *.docbook images - xmlto html batman.docbook - xmlto fo batman.docbook - fop batman.fo -ps batman.ps - ps2pdf batman.ps +.PHONY: clean images batman_doc batman_iv_only_doc +.SUFFIXES: .docbook .fo .ps .pdf .html +batman_doc: batman.pdf batman.html +batman_iv_only_doc: batman_iv_only.pdf batman_iv_only.html -batman_iv_only_doc: Makefile *.docbook images - xmlto html batman_iv_only.docbook - xmlto fo batman_iv_only.docbook - fop batman_iv_only.fo -ps batman_iv_only.ps - ps2pdf batman_iv_only.ps +batman_iv_only.html: Makefile *.docbook images +batman_iv_only.pdf: Makefile *.docbook images +batman.html: Makefile *.docbook images +batman.pdf: Makefile *.docbook images + +.docbook.fo: + xmlto fo $< + +.docbook.html: + xmlto xhtml-nochunks $< + +.fo.ps: + fop $< -ps $@ + +.ps.pdf: + ps2pdf $< images: make -C images/

1 0

[doc] batman-adv-doc, master: Use latex quotation marks (bee5acad)
by postmaster＠open-mesh.org 14 Dec '17

14 Dec '17

Repository : ssh://git@open-mesh.org/doc On branches: batman-adv-doc,master >--------------------------------------------------------------- commit bee5acad079bf5f03f5ed67c439e88239089869a Author: Sven Eckelmann <sven.eckelmann(a)gmx.de> Date: Fri Jan 23 03:15:42 2009 +0100 Use latex quotation marks >--------------------------------------------------------------- bee5acad079bf5f03f5ed67c439e88239089869a usage.tex | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/usage.tex b/usage.tex index 5e9bb647..caf05202 100644 --- a/usage.tex +++ b/usage.tex @@ -91,7 +91,7 @@ ip-address/netmask. \subsubsectionttt{-b run connection in batch mode} The debug information are updated after a period of time by default, so if you -use "-b" it will execute once and then stop. +use ``-b'' it will execute once and then stop. \begin{verbatim} $ batmand eth1 $ batmand -b -c -d 1 @@ -207,8 +207,8 @@ from where etc. \subsubsectionttt{-g gateway class} The gateway class is used to tell other nodes in the network your available -internet bandwidth. Just enter any number (optionally followed by "kbit" or -"mbit") and the daemon will guess your appropriate gateway class. Use "/" to +internet bandwidth. Just enter any number (optionally followed by ``kbit'' or +``mbit'') and the daemon will guess your appropriate gateway class. Use ``/'' to seperate the down- and upload rates. You can omit the upload rate and batmand will assume an upload of $\mathrm{download}\over{5}$. @@ -243,8 +243,8 @@ In this case, batmand will wait 2 second until sending the next OGMs. \subsubsectionttt{-p preferred gateway} Set the internet gateway by yourself. -Note that this automatically switches your B.A.T.M.A.N. daemon to "internet -search modus" with "-r 1" unless "-r" is given. If the preferred gateway is not +Note that this automatically switches your B.A.T.M.A.N. daemon to ``internet +search modus'' with ``-r 1'' unless ``-r'' is given. If the preferred gateway is not found the gateway selection will use the current routing class to choose a gateway. @@ -255,9 +255,9 @@ In this case, you set 192.168.1.1 as your preferred gateway, so all of your internet packets will be sent to the 192.168.1.1. \subsubsectionttt{-r routing class} -The routing class can be set to four values - it enables "internet search -modus". The daemon will choose an internet gateway based on certain criteria -(unless "-p" is specified): +The routing class can be set to four values - it enables ``internet search +modus''. The daemon will choose an internet gateway based on certain criteria +(unless ``-p'' is specified): \begin{description} \item[0] set no default route (default) \item[1] use fast connection

1 0

[doc] batman-adv-doc, master: Process XML DocBook with xsl stylesheets (45f0a62b)
by postmaster＠open-mesh.org 14 Dec '17

14 Dec '17

Repository : ssh://git@open-mesh.org/doc On branches: batman-adv-doc,master >--------------------------------------------------------------- commit 45f0a62b0a8c99ddfabf77c3b0792770aeab5971 Author: Sven Eckelmann <sven.eckelmann(a)gmx.de> Date: Fri Jan 23 02:03:31 2009 +0100 Process XML DocBook with xsl stylesheets docbook2(html|pdf) are designed for SGML DocBook and use parser which are only capable of processing sgml files. Many new versions of these tools also stop with an error when they start to process these files. xmlto helps us to execute a XSLT processor with correct paths set to the xsl stylesheets for docbook. It needs extra tools like fop to generate more complex output files like pdf or ps, but fop doesn't support eps or pdf as when generating pdf files. It is possible to use ps output and conversation to pdf as workaround. >--------------------------------------------------------------- 45f0a62b0a8c99ddfabf77c3b0792770aeab5971 Makefile | 15 ++++++++++----- batman_iv.docbook | 38 +++++++++++++++++++------------------- images/Makefile | 19 ++++++++----------- 3 files changed, 37 insertions(+), 35 deletions(-) diff --git a/Makefile b/Makefile index b8cac436..e15d8082 100644 --- a/Makefile +++ b/Makefile @@ -2,14 +2,19 @@ default: all all: batman_doc .PHONY: clean images batman_doc: Makefile *.docbook images - docbook2html batman.docbook - docbook2pdf batman.docbook + xmlto html batman.docbook + xmlto fo batman.docbook + fop batman.fo -ps batman.ps + ps2pdf batman.ps + batman_iv_only_doc: Makefile *.docbook images - docbook2html batman_iv_only.docbook - docbook2pdf batman_iv_only.docbook + xmlto html batman_iv_only.docbook + xmlto fo batman_iv_only.docbook + fop batman_iv_only.fo -ps batman_iv_only.ps + ps2pdf batman_iv_only.ps images: make -C images/ clean: - rm -f *.html *.pdf *.log *.refs + rm -f *.html *.pdf *.fo *.ps make -C images clean diff --git a/batman_iv.docbook b/batman_iv.docbook index b76981a2..d965df4b 100644 --- a/batman_iv.docbook +++ b/batman_iv.docbook @@ -89,7 +89,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, <para> Example: OGMs from Node A propagate to B. The link is asymetric, therefore B receives all packets from A in contrast to A which receives almost nothing from B. As all the packets from A get to B the packet count at B's side goes up. B will assume that it has a perfect link towards A which is not the case. <inlinemediaobject> - <imageobject> <imagedata fileref="images/asymetry.pdf" format="EPS" scale="50"/> </imageobject> + <imageobject> <imagedata fileref="images/asymetry.eps" format="EPS" scale="50"/> </imageobject> <imageobject> <imagedata fileref="images/asymetry.png" format="PNG" /> </imageobject> <textobject> <phrase>asymetry illustration</phrase> </textobject> </inlinemediaobject> @@ -165,7 +165,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/rq.pdf" format="EPS" scale="50" /> </imageobject> + <imageobject> <imagedata fileref="images/rq.eps" format="EPS" scale="50" /> </imageobject> <imageobject> <imagedata fileref="images/rq.png" format="PNG" /> </imageobject> <textobject> <phrase>Receive Quality (RQ)</phrase> </textobject> </inlinemediaobject> @@ -177,7 +177,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/eq_alt1.pdf" format="EPS" scale="50" /> </imageobject> + <imageobject> <imagedata fileref="images/eq_alt1.eps" format="EPS" scale="50" /> </imageobject> <imageobject> <imagedata fileref="images/eq_alt1.png" format="PNG" /> </imageobject> <textobject> <phrase>Echo Link Quality (EQ)</phrase> </textobject> </inlinemediaobject> @@ -189,14 +189,14 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/tq.pdf" format="EPS" scale="50" /> </imageobject> + <imageobject> <imagedata fileref="images/tq.eps" format="EPS" scale="50" /> </imageobject> <imageobject> <imagedata fileref="images/tq.png" format="PNG" /> </imageobject> <textobject> <phrase>Transmit Link Quality (TQ)</phrase> </textobject> </inlinemediaobject> </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/compute_tq.pdf" format="EPS"/> </imageobject> + <imageobject> <imagedata fileref="images/compute_tq.eps" format="EPS"/> </imageobject> <imageobject> <imagedata fileref="images/compute_tq.png" format="PNG" /> </imageobject> <textobject> <phrase>compute the Transmit Link Quality</phrase> </textobject> </inlinemediaobject> @@ -219,7 +219,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/tq_prop_calc.pdf" format="EPS" /> </imageobject> + <imageobject> <imagedata fileref="images/tq_prop_calc.eps" format="EPS" /> </imageobject> <imageobject> <imagedata fileref="images/tq_prop_calc.png" format="PNG" /> </imageobject> <textobject> <phrase>TQ calcuation</phrase> </textobject> </inlinemediaobject> @@ -229,7 +229,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/tq_prop.pdf" format="EPS" scale="40" /> </imageobject> + <imageobject> <imagedata fileref="images/tq_prop.eps" format="EPS" scale="40" /> </imageobject> <imageobject> <imagedata fileref="images/tq_prop.png" format="PNG" /> </imageobject> <textobject> <phrase>TQ propagation</phrase> </textobject> </inlinemediaobject> @@ -241,7 +241,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, Example: Node A and B are neighbors. Node A has a good connection towards node B but not vice versa. The node C has a good connection towards node A and a bad connection back, and C has a good receiving link quality and bad sending quality towards B. </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/tq_prop_best1.pdf" format="EPS" scale="40" /> </imageobject> + <imageobject> <imagedata fileref="images/tq_prop_best1.eps" format="EPS" scale="40" /> </imageobject> <imageobject> <imagedata fileref="images/tq_prop_best1.png" format="PNG" /> </imageobject> <textobject> <phrase>TQ propagation - example topology</phrase> </textobject> </inlinemediaobject> @@ -251,7 +251,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/tq_prop_best2.pdf" format="EPS" scale="40" /> </imageobject> + <imageobject> <imagedata fileref="images/tq_prop_best2.eps" format="EPS" scale="40" /> </imageobject> <imageobject> <imagedata fileref="images/tq_prop_best2.png" format="PNG" /> </imageobject> <textobject> <phrase>TQ propagation - different paths for the OGM</phrase> </textobject> </inlinemediaobject> @@ -262,7 +262,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/tq_prop_best3.pdf" format="EPS" scale="40" /> </imageobject> + <imageobject> <imagedata fileref="images/tq_prop_best3.eps" format="EPS" scale="40" /> </imageobject> <imageobject> <imagedata fileref="images/tq_prop_best3.png" format="PNG" /> </imageobject> <textobject> <phrase>TQ propagation - only the best path is propagated</phrase> </textobject> </inlinemediaobject> @@ -294,7 +294,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/asym_link1.pdf" format="EPS" scale="50" /> </imageobject> + <imageobject> <imagedata fileref="images/asym_link1.eps" format="EPS" scale="50" /> </imageobject> <imageobject> <imagedata fileref="images/asym_link1.png" format="PNG" scale="50" /> </imageobject> <textobject> <phrase>Asymetry situation without asymetry penalty</phrase> </textobject> </inlinemediaobject> @@ -304,7 +304,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/asym_penalty.pdf" format="EPS" /> </imageobject> + <imageobject> <imagedata fileref="images/asym_penalty.eps" format="EPS" /> </imageobject> <imageobject> <imagedata fileref="images/asym_penalty.png" format="PNG" /> </imageobject> <textobject> <phrase>graph for asymetry penalty</phrase> </textobject> </inlinemediaobject> @@ -314,7 +314,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/asym_link2.pdf" format="EPS" scale="50" /> </imageobject> + <imageobject> <imagedata fileref="images/asym_link2.eps" format="EPS" scale="50" /> </imageobject> <imageobject> <imagedata fileref="images/asym_link2.png" format="PNG" /> </imageobject> <textobject> <phrase>Asymetry situation with applied asymetry penalty</phrase> </textobject> </inlinemediaobject> @@ -331,7 +331,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/hop_penalty3.pdf" format="EPS" scale="50" /> </imageobject> + <imageobject> <imagedata fileref="images/hop_penalty3.eps" format="EPS" scale="50" /> </imageobject> <imageobject> <imagedata fileref="images/hop_penalty3.png" format="PNG" /> </imageobject> <textobject> <phrase>example topology</phrase> </textobject> </inlinemediaobject> @@ -341,7 +341,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/hop_penalty4.pdf" format="EPS" scale="50" /> </imageobject> + <imageobject> <imagedata fileref="images/hop_penalty4.eps" format="EPS" scale="50" /> </imageobject> <imageobject> <imagedata fileref="images/hop_penalty4.png" format="PNG" /> </imageobject> <textobject> <phrase>packet hops</phrase> </textobject> </inlinemediaobject> @@ -354,7 +354,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/hop_penalty5.pdf" format="EPS" scale="50" /> </imageobject> + <imageobject> <imagedata fileref="images/hop_penalty5.eps" format="EPS" scale="50" /> </imageobject> <imageobject> <imagedata fileref="images/hop_penalty5.png" format="PNG" /> </imageobject> <textobject> <phrase>route candidates</phrase> </textobject> </inlinemediaobject> @@ -367,7 +367,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/hop_penalty6.pdf" format="EPS" scale="50" /> </imageobject> + <imageobject> <imagedata fileref="images/hop_penalty6.eps" format="EPS" scale="50" /> </imageobject> <imageobject> <imagedata fileref="images/hop_penalty6.png" format="PNG" /> </imageobject> <textobject> <phrase>applied hop penalty</phrase> </textobject> </inlinemediaobject> @@ -382,7 +382,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/echo_cancel1.pdf" format="EPS" scale="50" /> </imageobject> + <imageobject> <imagedata fileref="images/echo_cancel1.eps" format="EPS" scale="50" /> </imageobject> <imageobject> <imagedata fileref="images/echo_cancel1.png" format="PNG" /> </imageobject> <textobject> <phrase>communication without echo cancellation penalty</phrase> </textobject> </inlinemediaobject> @@ -400,7 +400,7 @@ TODO Explain multiple interfaces, which interface sends which OGM by which TTL, </para> <para> <inlinemediaobject> - <imageobject> <imagedata fileref="images/echo_cancel2.pdf" format="EPS" scale="50" /> </imageobject> + <imageobject> <imagedata fileref="images/echo_cancel2.eps" format="EPS" scale="50" /> </imageobject> <imageobject> <imagedata fileref="images/echo_cancel2.png" format="PNG" /> </imageobject> <textobject> <phrase>communication without echo cancellation penalty</phrase> </textobject> </inlinemediaobject> diff --git a/images/Makefile b/images/Makefile index 03f5ded9..405b892f 100644 --- a/images/Makefile +++ b/images/Makefile @@ -9,15 +9,15 @@ TEX_IMAGES=compute_tq.tex tq_prop_calc.tex PNG_IMAGES= $(DIA_IMAGES:.dia=.png) PNG_IMAGES+=$(GP_IMAGES:.gp=.png) PNG_IMAGES+=$(TEX_IMAGES:.tex=.png) -PDF_IMAGES= $(DIA_IMAGES:.dia=.pdf) -PDF_IMAGES+=$(GP_IMAGES:.gp=.pdf) -PDF_IMAGES+=$(TEX_IMAGES:.tex=.pdf) +EPS_IMAGES= $(DIA_IMAGES:.dia=.eps) +EPS_IMAGES+=$(GP_IMAGES:.gp=.eps) +EPS_IMAGES+=$(TEX_IMAGES:.tex=.eps) .PHONY: clean -.SUFFIXES: .dia .png .eps .pdf .gp +.SUFFIXES: .dia .png .eps .gp default: all -all: $(PDF_IMAGES) $(PNG_IMAGES) +all: $(EPS_IMAGES) $(PNG_IMAGES) .gp.png: gnuplot $< @@ -28,16 +28,13 @@ all: $(PDF_IMAGES) $(PNG_IMAGES) /usr/bin/dia -e $@ $< .dia.eps: /usr/bin/dia -e $@ $< -.eps.pdf: - /usr/bin/epstopdf --outfile=$@ $< -.tex.pdf: +.tex.eps: rm -f file_tmp.* cp $< file_tmp.tex latex file_tmp.tex dvips file_tmp.dvi ps2eps -l file_tmp.ps - epstopdf file_tmp.eps - mv file_tmp.pdf $@ + mv file_tmp.eps $@ rm -f file_tmp.* .tex.png: @@ -48,4 +45,4 @@ all: $(PDF_IMAGES) $(PNG_IMAGES) convert file_tmp.ps $@ rm -f file_tmp.* clean: - rm -f *.png *.eps *.pdf + rm -f *.png *.eps

1 0

[doc] batman-adv-doc, master: Add missing dashes (2a84979e)
by postmaster＠open-mesh.org 14 Dec '17

14 Dec '17

Repository : ssh://git@open-mesh.org/doc On branches: batman-adv-doc,master >--------------------------------------------------------------- commit 2a84979e10d2931a1e33f3fcde2b7d1d426b785e Author: Sven Eckelmann <sven.eckelmann(a)gmx.de> Date: Thu Jan 22 16:57:39 2009 +0100 Add missing dashes >--------------------------------------------------------------- 2a84979e10d2931a1e33f3fcde2b7d1d426b785e installing.tex | 2 +- title.tex | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/installing.tex b/installing.tex index 3234cf92..fac28154 100644 --- a/installing.tex +++ b/installing.tex @@ -1,5 +1,5 @@ \section{Installing from source} -\subsection{Prerequirements} +\subsection{Pre-requirements} \begin{itemize} \item Compile environment and libraries. diff --git a/title.tex b/title.tex index b5f4c9f5..840a97ae 100644 --- a/title.tex +++ b/title.tex @@ -1,7 +1,7 @@ \maketitle \begin{abstract} -B.A.T.M.A.N stands for ``better approach to mobile ad hoc networking'', this is +B.A.T.M.A.N stands for ``better approach to mobile ad-hoc networking'', this is a new routing protocol for multi-hop ad-hoc mesh networks. Go to \url{http://www.open-mesh.net} to see more information.

1 0

[doc] batman-adv-doc, master: Add captions to figures (bb74bc5f)
by postmaster＠open-mesh.org 14 Dec '17

14 Dec '17

Repository : ssh://git@open-mesh.org/doc On branches: batman-adv-doc,master >--------------------------------------------------------------- commit bb74bc5f9f09916bf561af9b3d4d1407b6cd7a7d Author: Sven Eckelmann <sven.eckelmann(a)gmx.de> Date: Thu Jan 22 13:24:27 2009 +0100 Add captions to figures >--------------------------------------------------------------- bb74bc5f9f09916bf561af9b3d4d1407b6cd7a7d batmand_howto.tex | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/batmand_howto.tex b/batmand_howto.tex index a6efa2aa..74f46d4c 100644 --- a/batmand_howto.tex +++ b/batmand_howto.tex @@ -170,12 +170,13 @@ while the daemon is running. The parameter has to be in the form of ip-address/netmask. For example, if you are the node A, and you can connect to \emph{other -network}, then you can execute a to announce the gateway. +network}, then you can execute -a to announce the gateway. \begin{figure}[H] \begin{center} \input{img/announce_networks} \end{center} + \caption{Announce A as gateway to B} \end{figure} If the other nodes in the B.A.T.M.A.N. network want to connect to node B after @@ -205,6 +206,7 @@ then the results are different. \begin{center} \input{img/multiple_announces} \end{center} + \caption{Two announced networks} \end{figure} Node A can announce more than one network. To announce two networks execute the @@ -243,6 +245,7 @@ at runtime. \begin{center} \input{img/multiple_clients} \end{center} + \caption{Multiple clients connected to B.A.T.M.A.N. interface} \end{figure} \begin{verbatim}

1 0

[doc] batman-adv-doc, master: Unify styling of verbatim blocks (b1ebc913)
by postmaster＠open-mesh.org 14 Dec '17

14 Dec '17

Repository : ssh://git@open-mesh.org/doc On branches: batman-adv-doc,master >--------------------------------------------------------------- commit b1ebc913d7cf0f7c974f97207e658077d9f72653 Author: Sven Eckelmann <sven.eckelmann(a)gmx.de> Date: Wed Jan 21 20:54:41 2009 +0100 Unify styling of verbatim blocks >--------------------------------------------------------------- b1ebc913d7cf0f7c974f97207e658077d9f72653 batmand_howto.tex | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/batmand_howto.tex b/batmand_howto.tex index 42585341..3ff1cc9e 100644 --- a/batmand_howto.tex +++ b/batmand_howto.tex @@ -138,9 +138,9 @@ the following we will explain all parameters and how to work with them in a mesh network. \subsection{SYNOPSIS} -\begin{verb} +\begin{verbatim} batmand [options] interface [interface interface] -\end{verb} +\end{verbatim} \subsection{DESCRIPTION} @@ -175,10 +175,12 @@ The default value is 1000 ms (1 second). In a mobile network, you may want to detect network changes very quickly, so you need to send message very often, for example, use a value of 500 ms. In a static network, you can save bandwidth by using a higher value. -\begin{verbatim} batmand -o 2000 eth1\end{verbatim} +\begin{verbatim} + $ batmand -o 2000 eth1 +\end{verbatim} In this case, batmand will wait 2 second until sending the next OGMs. -\begin{verbatim} -d debug level\end{verbatim} +\subsubsectionttt{-d debug level} The debug level can be set to five values. \begin{description}

1 0

[doc] batman-adv-doc, master: Merge changes of batman's manpage (89367995)
by postmaster＠open-mesh.org 14 Dec '17

14 Dec '17

Repository : ssh://git@open-mesh.org/doc On branches: batman-adv-doc,master >--------------------------------------------------------------- commit 89367995943349265be785105ecfc45caf2d8cd7 Author: Sven Eckelmann <sven.eckelmann(a)gmx.de> Date: Wed Jan 21 22:26:32 2009 +0100 Merge changes of batman's manpage >--------------------------------------------------------------- 89367995943349265be785105ecfc45caf2d8cd7 batmand_howto.tex | 128 ++++++++++++++++++++++++++++++++---------------------- 1 file changed, 77 insertions(+), 51 deletions(-) diff --git a/batmand_howto.tex b/batmand_howto.tex index 4f6aa4ae..796fb3cd 100644 --- a/batmand_howto.tex +++ b/batmand_howto.tex @@ -164,9 +164,13 @@ address from the given interfaces. Note also that you have to check whether your essid, channel or wifi mode is correct or not. -\subsubsectionttt{-a announce network(s)} -\emph{announce network} means a node announces the connection to another -network. For example, if you are the node A, and you can connect to \emph{other +\subsubsectionttt{-a add announced network(s)} +The daemon announces the availability of a connection to another network. This +option can be used multiple times and can be used to add networks dynamically +while the daemon is running. The parameter has to be in the form of +ip-address/netmask. + +For example, if you are the node A, and you can connect to \emph{other network}, then you can execute a to announce the gateway. \begin{center} @@ -207,9 +211,15 @@ following command: \end{verbatim} Note that node A has to have a route to connect the node or network. +\subsubsectionttt{-A delete announced network(s)} +Delete networks to the daemons list of available connections to another +network(s). This option can be used multiple times and can only be used while +the daemon is running. The parameter has to be in the form of +ip-address/netmask. + \subsubsectionttt{-b run connection in batch mode} The debug information are updated after a period of time by default, so if you -use -b it will execute once and then stop. +use "-b" it will execute once and then stop. \begin{verbatim} $ batmand eth1 $ batmand -b -c -d 1 @@ -223,6 +233,8 @@ The B.A.T.M.A.N. daemon offers a unix socket interface to which you can connect. First, you have to create a B.A.T.M.A.N. daemon on your host, then use -c to connect to its interface. Note you can create as many client sockets as you like. +Deploy it without any arguments to get the current configuration even if changed +at runtime. \begin{center} \includegraphics[scale=0.5]{multiple_clients} @@ -246,7 +258,9 @@ The debug level can be set to five values. \item[2] list gateways \item[3] observe batmand \item[4] observe batmand (very verbose) + \item[5] memory debug / cpu usage \end{description} +Note that debug level 5 can be disabled at compile time. For example, you can run in normal start: \begin{verbatim} @@ -317,51 +331,47 @@ packets you sent, and sent to where, or how many packets you got, and received from where etc. \subsubsectionttt{-g gateway class} -Gateway class can set eleven values, it means how much bandwidth you want to -share. -\begin{description} - \item[0] this is not an internet gateway (default) - \item[1] modem line - \item[2] ISDN line - \item[3] double ISDN - \item[4] 256 KBit - \item[5] UMTS / 0.5 MBit - \item[6] 1 MBit - \item[7] 2 MBit - \item[8] 3 MBit - \item[9] 5 MBit - \item[10] 6 MBit - \item[11] $>$6 Mbit -\end{description} +The gateway class is used to tell other nodes in the network your available +internet bandwidth. Just enter any number (optionally followed by "kbit" or +"mbit") and the daemon will guess your appropriate gateway class. Use "/" to +seperate the down- and upload rates. You can omit the upload rate and batmand +will assume an upload of $\mathrm{download}\over{5}$. + +\begin{itemize} +\item 5000 +\item 5000kbit +\item 5mbit +\item 5mbit/1024 +\item 5mbit/1024kbit +\item 5mbit/1mbit +\end{itemize} You only can set the value in a normal start \begin{verbatim} - $ batmand -g 7 -d 3 eth1 + $ batmand -g 5mbit/1024 -d 3 eth1 \end{verbatim} Note that if you use debug level 3, then you will know whether you succeed setting the gateway class or not. \subsubsectionttt{-o originator interval in ms} - Originator means a node transmits broadcast messages (we call them originator - message or OGM) to inform the neighboring nodes about its existence. Originator - interval is the time to wait after sending one message and before the - B.A.T.M.A.N. daemon sends the next message. - -The default value is 1000 ms (1 second). - -In a mobile network, you may want to detect network changes very quickly, so you -need to send message very often, for example, use a value of 500 ms. In a static -network, you can save bandwidth by using a higher value. +A node transmits broadcast messages (we call them originator message or OGM) to +inform the neighboring nodes about it’s existence. Originator interval is the +time to wait after sending one message and before sending the next message. +The default value is 1000 ms (1 second). In a mobile network, you may want to +detect network changes very quickly, so you need to send message very often, for +example, use a value of 500 ms. In a static network, you can save bandwidth by +using a higher value. This option is only available in daemon mode. \begin{verbatim} $ batmand -o 2000 eth1 \end{verbatim} In this case, batmand will wait 2 second until sending the next OGMs. \subsubsectionttt{-p preferred gateway} -Set the default gateway by yourself. +Set the internet gateway by yourself. -Note that you have to use -r to tell B.A.T.M.A.N. daemon you want to set the -default gateway, because -r will be used if the preferred gateway is not -available. +Note that this automatically switches your B.A.T.M.A.N. daemon to "internet +search modus" with "-r 1" unless "-r" is given. If the preferred gateway is not +found the gateway selection will use the current routing class to choose a +gateway. \begin{verbatim} $ batmand -r 3 -d 3 -p 192.168.1.1 eth1 @@ -370,14 +380,15 @@ In this case, you set 192.168.1.1 as your preferred gateway, so all of your internet packets will be sent to the 192.168.1.1. \subsubsectionttt{-r routing class} -Routing class can set to four values, it means this node in the B.A.T.M.A.N. -network wants to connect the Internet and chooses its internet gateway based on -certain criteria: +The routing class can be set to four values - it enables "internet search +modus". The daemon will choose an internet gateway based on certain criteria +(unless "-p" is specified): \begin{description} \item[0] set no default route (default) -\item[1] use fast internet connection -\item[2] use stable internet connection -\item[3] use best statistic internet connection +\item[1] use fast connection +\item[2] use stable connection +\item[3] use fast-switch connection +\item[XX] use late-switch connection \end{description} \paragraph*{Level 1} @@ -385,12 +396,20 @@ B.A.T.M.A.N tries to find the best available connection by watching the uplinks throughput and the link quality. \paragraph*{Level 2} -B.A.T.M.A.N observes the internet nodes and tries to find out which one is the -most reliable. This mode is not implemented yet but will follow in batmand 0.3. +B.A.T.M.A.N compares the link quality of the internet node and chooses the one +with the best connection. \paragraph*{Level 3} -B.A.T.M.A.N only compares the link quality of the internet node and chooses the -one with the best connection. +B.A.T.M.A.N compares the link quality of the internet node and chooses the one +with the best connection but switches to another gateway as soon as a better +connection is found. + +\paragraph*{Level XX} +B.A.T.M.A.N compares the link quality of the internet node and chooses the one +with the best link quality but switches to another gateway as soon as this +gateway has a TQ value which is XX better than the currently selected gateway. + +XX ist a number between 3 and 256 \begin{verbatim} $ batmand -r 3 -d 3 eth1 @@ -401,12 +420,19 @@ whether you succeeded setting the routing class or not. \subsubsectionttt{-s visualization server} Since no topology database is computed by the protocol an additional solution to -create topology graphs has been implemented, the Vis-Server. B.A.T.M.A.N. -daemons may send their local view about their single hop neighbors to the -Vis-server. The Vis-Server collects the information and provides data in a -format similar to OLSR's topology information output. Therefore existing -solutions to draw topology graphs developed for OLSR can be used to visualize -mesh clouds using B.A.T.M.A.N. +create topology graphs has been implemented, the vis server. B.A.T.M.A.N. +daemons may send their local view about their single-hop neighbors to the vis +server. It collects the information and provides data in a format similar to +OLSR's topology information output. Therefore existing solutions to draw +topology graphs developed for OLSR can be used to visualize mesh-clouds +using B.A.T.M.A.N. + +\subsubsectionttt{--policy-routing-script} +This option disables the policy routing feature of batmand - all routing changes +are send to the script which can make use of this information or not. Firmware +and package maintainers can use this option to tightly integrate batmand into +their own routing policies. This option is only available in daemon mode. + \section{Reference Links} \begin{itemize}

1 0

[doc] batman-adv-doc, master: Ignore output files and backup files in git status (a7370557)
by postmaster＠open-mesh.org 14 Dec '17

14 Dec '17

Repository : ssh://git@open-mesh.org/doc On branches: batman-adv-doc,master >--------------------------------------------------------------- commit a737055718973833bdb629d570ef0d53d49d4c40 Author: Sven Eckelmann <sven.eckelmann(a)gmx.de> Date: Wed Jan 21 23:43:14 2009 +0100 Ignore output files and backup files in git status >--------------------------------------------------------------- a737055718973833bdb629d570ef0d53d49d4c40 .gitignore | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/.gitignore b/.gitignore new file mode 100644 index 00000000..7533bcdc --- /dev/null +++ b/.gitignore @@ -0,0 +1,6 @@ +*.pdf +*.eps +*.aux +*.log +*.out +*~

1 0

[doc] batman-adv-doc, master: Include by-nc-sa-3.0 logo as vector graphic (acf01b9e)
by postmaster＠open-mesh.org 14 Dec '17

14 Dec '17

Repository : ssh://git@open-mesh.org/doc On branches: batman-adv-doc,master >--------------------------------------------------------------- commit acf01b9e22f30e551bb29d1c3ee2b31ef7388538 Author: Sven Eckelmann <sven.eckelmann(a)gmx.de> Date: Wed Jan 21 23:54:56 2009 +0100 Include by-nc-sa-3.0 logo as vector graphic >--------------------------------------------------------------- acf01b9e22f30e551bb29d1c3ee2b31ef7388538 .gitignore | 1 + batmand_howto.tex | 2 +- img/by-nc-sa.pdf | Bin 0 -> 8055 bytes img/byncsa30.png | Bin 1761 -> 0 bytes 4 files changed, 2 insertions(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index 7533bcdc..e5ae50c1 100644 --- a/.gitignore +++ b/.gitignore @@ -4,3 +4,4 @@ *.log *.out *~ +!img/by-nc-sa.pdf diff --git a/batmand_howto.tex b/batmand_howto.tex index 2b88d969..26db2293 100644 --- a/batmand_howto.tex +++ b/batmand_howto.tex @@ -460,7 +460,7 @@ Note that you don't set the default route by yourself. \vfill \section*{Copyright} \begin{center} - \includegraphics[scale=0.8]{byncsa30} + \includegraphics[scale=0.5]{by-nc-sa} \end{center} This work is licensed under the Creative Commons Attribution-Noncommercial-Share Alike 3.0 License. To view a copy of this license, visit diff --git a/img/by-nc-sa.pdf b/img/by-nc-sa.pdf new file mode 100644 index 00000000..9259ca3e Binary files /dev/null and b/img/by-nc-sa.pdf differ diff --git a/img/byncsa30.png b/img/byncsa30.png deleted file mode 100644 index 88c9d930..00000000 Binary files a/img/byncsa30.png and /dev/null differ

1 0

Jump to page:

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

commits