From 9b3d2464cd6dafdd3021f4513f24d19d56d42d3d Mon Sep 17 00:00:00 2001 From: Pavel Tvrdik Date: Tue, 16 Aug 2016 10:15:58 +0200 Subject: [PATCH] Rewrote README file * Made structure with headlines, * reordered, * kicked out 'What is missing' part, * Updated content by home page site and user docs --- README | 153 ++++++++++++++++++++++++++++++++------------------------- 1 file changed, 85 insertions(+), 68 deletions(-) diff --git a/README b/README index 7564a1c3..d419755f 100644 --- a/README +++ b/README @@ -1,87 +1,104 @@ - BIRD Internet Routing Daemon + BIRD Internet Routing Daemon - Mailing list bird-users@network.cz - http://bird.network.cz/mailman/listinfo/bird-users + Home page http://bird.network.cz/ + Mailing list bird-users@network.cz - Home page http://bird.network.cz/ - - (c) 1998--2008 Martin Mares + (c) 1998--2008 Martin Mares (c) 1998--2000 Pavel Machek (c) 1998--2008 Ondrej Filip - (c) 2009--2013 CZ.NIC z.s.p.o. + (c) 2009--2016 CZ.NIC z.s.p.o. ================================================================================ -The BIRD project is an attempt to create a routing daemon running on UNIX-like -systems (but not necessarily limited to them) with full support of all modern -routing protocols, easy to use configuration interface and powerful route -filtering language. +The BIRD project aims to develop a dynamic IP routing daemon with full support +of all modern routing protocols, easy to use configuration interface and +powerful route filtering language, primarily targeted on (but not limited to) +Linux and other UNIX-like systems and distributed under the GNU General +Public License. + +What do we support +================== + + o Both IPv4 and IPv6 (use --enable-ipv6 when configuring) + o Multiple routing tables + o Border Gateway Protocol (BGPv4) + o Routing Information Protocol (RIPv2) + o Open Shortest Path First protocol (OSPFv2, OSPFv3) + o Bidirectional Forwarding Detection (BFD) + o IPv6 router advertisements + o Static routes + o Inter-table protocol + o Command-line interface allowing on-line control and inspection of + status of the daemon + o Soft reconfiguration, no need to use complex online commands to + change the configuration, just edit the configuration file and notify + BIRD to re-read it and it will smoothly switch itself to the new + configuration, not disturbing routing protocols unless they are + affected by the configuration changes + o Powerful language for route filtering, see doc/bird.conf.example + o Linux, FreeBSD, NetBSD and OpenBSD ports + +How to install BIRD +=================== + + o From standard distribution package of your OS (recommended) + o From source code of the latest stable release version + ftp://bird.network.cz/pub/bird/ + o From source code of the actual development version + https://gitlab.labs.nic.cz/labs/bird + +How to compile BIRD from source code +------------------------------------ + + $ ./configure + $ make + $ sudo make install + $ sudo vi /usr/local/etc/bird.conf + $ bird + +Documentation +============= + +Online documentation is available at http://bird.network.cz/?get_doc or as HTML +files in the doc directory, you can install it by `make install-docs' and +rebuild it by `make docs', but you'll need SGMLtools and LaTeX to be installed +on your machine. You can also download a neatly formatted PostScript version as +a separate archive (bird-doc-*.tar.gz) from ftp://bird.network.cz/pub/bird/ + +User support +============ If you want to help us debugging, enhancing and porting BIRD or just lurk -around to see what's going to develop from this strange creature, feel free to -subscribe to the BIRD users mailing list (bird-users@bird.network.cz), send -subscribes to majordomo at the same machine). Bug reports, suggestions, feature -requests (: and code :) are welcome. We don't use gitlab issues reporting, sorry. +around to see what's going to develop, feel free to subscribe to the BIRD users +mailing list bird-users@bird.network.cz, just send `subscribe bird-users' to +majordomo@network.cz. Bug reports, suggestions, feature requests and code are +welcome! We don't use gitlab issues for reporting, sorry. -You can download the latest version from ftp://bird.network.cz/pub/bird/ -and look at the BIRD home page at http://bird.network.cz/. +Licence +======= + +This program is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program; if not, write to the Free Software +Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + +History +======= BIRD development started as a student project at the Faculty of Math and Physics, Charles University, Prague, Czech Republic under supervision of RNDr. Libor Forst . BIRD has been developed and supported by CZ.NIC z.s.p.o. http://www.nic.cz/ since 2009. - This program is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or - (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this program; if not, write to the Free Software - Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA - - -How to install BIRD: - - ./configure - make - make install - vi /usr/local/etc/bird.conf - -Online documentation is available as HTML files in the doc directory, -you can install it by `make install-docs' and rebuild it by `make docs', -but for the latter you need SGMLtools and LaTeX to be installed on your -machine. You can also download a neatly formatted PostScript version -as a separate archive (bird-doc-*.tar.gz). - -What do we support: - - o Both IPv4 and IPv6 (use --enable-ipv6 when configuring) - o Multiple routing tables - o BGP - o RIP - o OSPF - o Static routes - o Inter-table protocol - o IPv6 router advertisements - o Bidirectional Forwarding Detection (BFD) - o Command-line interface (using the `birdc' client; to get - some help, just press `?') - o Soft reconfiguration -- no online commands for changing the - configuration in very limited ways, just edit the configuration - file and issue a `configure' command or send SIGHUP and BIRD - will start using the new configuration, possibly restarting - protocols affected by the configuration changes. - o Powerful language for route filtering (see doc/bird.conf.example). - -What is missing: - - o See the TODO list Good Luck and enjoy the BIRD :) The BIRD Team