diff options
| -rw-r--r-- | doc/bird.sgml | 84 | ||||
| -rwxr-xr-x | doc/kernel-doc | 2 | ||||
| -rw-r--r-- | doc/prog-foot.sgml | 2 | ||||
| -rw-r--r-- | doc/prog-head.sgml | 2 | ||||
| -rw-r--r-- | doc/prog-intro.sgml | 10 | ||||
| -rw-r--r-- | doc/prog-proto.sgml | 8 | ||||
| -rwxr-xr-x | tools/progdoc | 2 |
7 files changed, 55 insertions, 55 deletions
diff --git a/doc/bird.sgml b/doc/bird.sgml index 0de6971..1dc2bee 100644 --- a/doc/bird.sgml +++ b/doc/bird.sgml @@ -13,7 +13,7 @@ configuration primitives, <cf> is fragment of configuration within normal text, --> -<article> +<book> <title>BIRD User's Guide <author> @@ -31,9 +31,9 @@ This document contains user documentation for the BIRD Internet Routing Daemon p <!-- Begin the document --> -<sect>Introduction +<chapt>Introduction -<sect1>What is BIRD +<sect>What is BIRD <p><label id="intro"> The name `BIRD' is actually an acronym standing for `BIRD Internet Routing Daemon'. @@ -94,11 +94,11 @@ Public License. tested under Linux 2.0 to 2.3, but porting to other systems (even non-UNIX ones) should be relatively easy due to its highly modular architecture. -<sect1>About this documentation +<sect>About this documentation <p>This documentation can have 4 forms: sgml (this is master copy), html, ASCII text and dvi/postscript (generated from sgml using sgmltools). You should always edit master copy. -<sect1>About routing tables +<sect>About routing tables <p>Bird has one or more routing tables, which may or may not be synchronized with kernel and which may or may not be synchronized with @@ -127,7 +127,7 @@ get list of route attributes in "Route attributes" section in filters. Filters can alter routes passed between routing tables and protocols. -<sect1>Installing BIRD +<sect>Installing BIRD <p>On recent UNIX (with GNU-compatible tools -- BIRD relies on GCC extensions) system, installing BIRD should be as easy as: @@ -160,9 +160,9 @@ options. Most important (and not easily guessed) option is use given filename for socket for communications with bird client, default is <file/bird.ctl/. </descrip> -<sect>Configuration +<chapt>Configuration -<sect1>Introduction +<sect>Introduction <p>BIRD is configured using text configuration file. At startup, BIRD reads <file/bird.conf/ (unless <tt/-c/ command line option is given). Configuration may be changed on user request: if you modify @@ -200,7 +200,7 @@ protocol rip { </code> -<sect1>Global options +<sect>Global options <p><descrip> <tag>log "<m/filename/"|syslog|stderr all|{ <m/list of classes/ }</tag> @@ -244,7 +244,7 @@ protocol rip { is used by us for testing. </descrip> -<sect1>Protocol options +<sect>Protocol options <p>Several options are per-protocol, but all protocols support them. They are described here. @@ -286,7 +286,7 @@ protocol rip { </descrip> -<sect1>Client +<sect>Client <p>You can use command-line client <file>birdc</file> to talk with running BIRD. Communications is done using <file/bird.ctl/ unix domain @@ -301,9 +301,9 @@ own application could do that, too -- format of communication between BIRD and BIRDC is stable (see programmer's documentation). -<sect>Filters +<chapt>Filters -<sect1>Introduction +<sect>Introduction <p>BIRD contains rather simple programming language. (No, it can not yet read mail :-). There are two objects in this language: filters and functions. Filters are called by BIRD core when route is @@ -390,7 +390,7 @@ bird> show route filter { if 127.0.0.5 ~ net then accept; } bird> </code> -<sect1>Data types +<sect>Data types <p>Each variable and each value has certain type. Unlike C, booleans, integers and enums are incompatible with each other (that is to prevent you from shooting in the foot). @@ -462,7 +462,7 @@ incompatible with each other (that is to prevent you from shooting in the foot). </descrip> -<sect1>Operations +<sect>Operations <p>Filter language supports common integer operations <cf>(+,-,*,/)</cf>, parentheses <cf/(a*(b+c))/, comparison <cf/(a=b, a!=b, a<b, a>=b)/. Special operators include <cf/˜/ for "in" operation. In operation can be @@ -471,7 +471,7 @@ prefix and prefix or on bgppath and bgpmask or on pair and clist. Its result is true if element is in given set or if ip address is inside given prefix. Operator <cf/=/ is used to assign value to variable. Logical operations include unary not (<cf/!/), and (<cf/&&/) and or (<cf/||/>). -<sect1>Control structures +<sect>Control structures <p>Filters support two control structures: if/then/else and case. Syntax of if/then/else is <cf>if <M>expression</M> then <M>command</M>; else <M>command</M>;</cf> and you can use <cf>{ @@ -498,7 +498,7 @@ case arg1 { if 1234 = i then printn "."; else { print "not 1234"; print "You need {} around multiple commands"; } </code> -<sect1>Route attributes +<sect>Route attributes <p>Filter is implicitly passed route, and it can access its attributes, just like it accesses variables. Access to undefined @@ -533,7 +533,7 @@ defined using <cf>defined( <m>attribute</m> )</cf> syntax. <p>Plus, there are protocol-specific attributes, which are described in protocol sections. -<sect1>Utility functions +<sect>Utility functions <p>There are few functions you might find convenient to use: @@ -552,9 +552,9 @@ defined using <cf>defined( <m>attribute</m> )</cf> syntax. terminates bird. Useful while debugging filter interpreter. </descrip> -<sect>Protocols +<chapt>Protocols -<sect1>BGP +<sect>BGP <p>The Border Gateway Protocol is the routing protocol used for backbone level routing in the today's Internet. Contrary to other protocols, its convergence @@ -590,7 +590,7 @@ latest draft <htmlurl url="ftp://ftp.rfc-editor.org/internet-drafts/draft-ietf-i and applied to IPv6 according to RFC 2545<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc2545.txt">. -<sect2>Route selection rules +<sect1>Route selection rules <p>BGP doesn't have any simple metric, so the rules for selection of an optimal route among multiple BGP routes with the same preference are a bit more complex @@ -608,7 +608,7 @@ among them and so on. advertising router. </itemize> -<sect2>Configuration +<sect1>Configuration <p>Each instance of the BGP corresponds to one neighboring router. This allows to set routing policy and all other parameters differently @@ -670,7 +670,7 @@ for each neighbor using the following protocol parameters: is missing. Default: 0. </descrip> -<sect2>Attributes +<sect1>Attributes <p>BGP defines several route attributes. Some of them (those marked with `I' in the table below) are available on internal BGP connections only, some of them (marked @@ -715,7 +715,7 @@ with `O') are optional. attributes it defines and what their semantics will be. </descrip> -<sect2>Example +<sect1>Example <p><code> protocol bgp { @@ -736,7 +736,7 @@ protocol bgp { } </code> -<sect1>Device +<sect>Device <p>The Device protocol is not a real routing protocol as it doesn't generate any routes and only serves as a module for getting information about network @@ -765,7 +765,7 @@ protocol device { } </code> -<sect1>Direct +<sect>Direct <p>The Direct protocol is a simple generator of device routes for all the directly connected networks according to the list of interfaces provided @@ -797,7 +797,7 @@ protocol direct { } </code> -<sect1>Kernel +<sect>Kernel <p>The Kernel protocol is not a real routing protocol. Instead of communicating with other routers in the network, it performs synchronization of BIRD's routing @@ -814,7 +814,7 @@ allow policy routing), you can run as many instances as you want, but each of them must be connected to a different BIRD routing table and to a different kernel table. -<sect2>Configuration +<sect1>Configuration <p><descrip> <tag>persist <m/switch/</tag> Tell BIRD to leave all its routes in the @@ -859,11 +859,11 @@ protocol kernel { # Secondary routing table <p>The Kernel protocol doesn't define any route attributes. -<sect1>OSPF +<sect>OSPF -<sect1>Pipe +<sect>Pipe -<sect2>Introduction +<sect1>Introduction <p>The Pipe protocol serves as a link between two routing tables, allowing routes to be passed from a table declared as primary (i.e., the one the pipe is connected using the @@ -883,18 +883,18 @@ connect them to the kernel ones, use filters to control which routes appear in w and also you can employ the Pipe protocol to export a selected subset of one table in another one. -<sect2>Configuration +<sect1>Configuration <p><descrip> <tag>peer table <m/table/</tag> Define secondary routing table to connect to. The primary one is selected by the <cf/table/ keyword. </descrip> -<sect2>Attributes +<sect1>Attributes <p>The Pipe protocol doesn't define any route attributes. -<sect2>Example +<sect1>Example <p>Let's consider a router which serves as a boundary router of two different autonomous systems, each of them connected to a subset of interfaces of the router, having its own @@ -962,9 +962,9 @@ protocol pipe { # The Pipe } </code> -<sect1>Rip +<sect>Rip -<sect2>Introduction +<sect1>Introduction <p>Rip protocol (sometimes called Rest In Pieces) is a simple protocol, where each router broadcasts distances to all networks it can reach. When router hears distance to other network, it increments @@ -984,7 +984,7 @@ makes it pretty much obsolete in IPv4 world. (It is still usable on very small networks, through.) It is widely used in IPv6 world, because they are no good implementations of OSPFv3. -<sect2>Configuration +<sect1>Configuration <p>In addition to options generic to other protocols, rip supports following options: @@ -1034,7 +1034,7 @@ other than equally misconfigured BIRD. I warned you. </tag>specifies how old route has to be to be discarded. Default is 10*period. </descrip> -<sect2>Attributes +<sect1>Attributes <p>RIP defines two route attributes: @@ -1048,7 +1048,7 @@ other than equally misconfigured BIRD. I warned you. in case of external routes). </descrip> -<sect2>Example +<sect1>Example <p><code> protocol rip MyRIP_test { @@ -1064,7 +1064,7 @@ protocol rip MyRIP_test { } </code> -<sect1>Static +<sect>Static <p>The Static protocol doesn't communicate with other routers in the network, but instead it allows you to define routes manually. This is often used for @@ -1111,7 +1111,7 @@ protocol static { } </code> -<sect>Problems +<chapt>Problems <p>BIRD is relatively young system, and probably contains some bugs. You can report bugs at <HTMLURL URL="fixme">, but before you do, @@ -1128,7 +1128,7 @@ relevant reading; you can get them from <HTMLURL URL="fixme">. <p><it/Good luck!/ -</article> +</book> <!-- LocalWords: GPL IPv GateD BGPv RIPv OSPFv Linux sgml html dvi sgmltools Pavel diff --git a/doc/kernel-doc b/doc/kernel-doc index b495758..b09cf56 100755 --- a/doc/kernel-doc +++ b/doc/kernel-doc @@ -572,7 +572,7 @@ sub output_intro_bird { # print out each section $lineprefix=" "; foreach $section (@{$args{'sectionlist'}}) { - print "<sect1>$section\n<p>\n"; + print "<sect>$section\n<p>\n"; output_highlight($args{'sections'}{$section}); } diff --git a/doc/prog-foot.sgml b/doc/prog-foot.sgml index c847722..9e69f93 100644 --- a/doc/prog-foot.sgml +++ b/doc/prog-foot.sgml @@ -1,2 +1,2 @@ -</article> +</book> diff --git a/doc/prog-head.sgml b/doc/prog-head.sgml index 5114d14..8e0e792 100644 --- a/doc/prog-head.sgml +++ b/doc/prog-head.sgml @@ -6,7 +6,7 @@ Copyright (c) 2000 Martin Mares <mj@ucw.cz> --> -<article> +<book> <title>BIRD Programmer's Documentation <author> diff --git a/doc/prog-intro.sgml b/doc/prog-intro.sgml index e4affaf..ac45ab2 100644 --- a/doc/prog-intro.sgml +++ b/doc/prog-intro.sgml @@ -1,6 +1,6 @@ -<sect>BIRD Design +<chapt>BIRD Design -<sect1>Introduction +<sect>Introduction <p>This document describes the internal workings of the BIRD, its architecture, design decisions and rationale behind them. It also contains documentation on @@ -17,7 +17,7 @@ is a sister of talent", we've tried to write a much shorter document highlightin the most important stuff and leaving the boring technical details better explained by the program source itself together with comments contained therein. -<sect1>Design goals +<sect>Design goals <p>When planning the architecture of BIRD, we've taken a close look at the other existing routing daemons and also at some of the operating systems used on dedicated routers, gathered all important @@ -81,7 +81,7 @@ our own scheduling of events. </itemize> -<sect1>Architecture +<sect>Architecture <p>The requirements set above have lead to a simple modular architecture containing the following types of modules: @@ -118,7 +118,7 @@ interface to the CLI. </descrip> -<sect1>Implementation +<sect>Implementation <p>BIRD has been written in GNU C. We've considered using of C++, but we've preferred the simplicity and straightforward nature of C which gives us fine diff --git a/doc/prog-proto.sgml b/doc/prog-proto.sgml index ab90b7a..45ef88d 100644 --- a/doc/prog-proto.sgml +++ b/doc/prog-proto.sgml @@ -4,9 +4,9 @@ (c) 2000 Martin Mares <mj@ucw.cz> --> -<sect1>Routing protocols +<sect>Routing protocols -<sect2>Introduction +<sect1>Introduction <p>The routing protocols are the BIRD's heart and a fine amount of code is dedicated to their management and for providing support functions to them. @@ -41,7 +41,7 @@ running protocols, <param/initial_proto_list/ for protocols being initialized or configuration of protocols, please refer to the configuration chapter and also to the description of the <func/proto_commit/ function. -<sect2>Protocol states +<sect1>Protocol states <p>As startup and shutdown of each protocol are complex processes which can be affected by lots of external events (user's actions, reconfigurations, behaviour of neighboring routers etc.), @@ -86,6 +86,6 @@ new state. There exist the following core states: routing tables. </descrip> -<sect2>Functions of the protocol module +<sect1>Functions of the protocol module <p>The protocol module provides the following functions: diff --git a/tools/progdoc b/tools/progdoc index 2294712..a5028bd 100755 --- a/tools/progdoc +++ b/tools/progdoc @@ -33,7 +33,7 @@ sub process { if ($cmd eq "C") { process("$dir/$arg"); } elsif ($cmd eq "H") { push @stack, "H"; - print OUT "<sect>$arg\n"; + print OUT "<chapt>$arg\n"; } elsif ($cmd eq "S") { print " $arg\n"; open(DOC, "cd $srcdir/$dir ; $srcdir/doc/kernel-doc -bird $arg |") || die "Unable to start kernel-doc"; |