Annotation of embedaddon/quagga/pimd/README, revision 1.1.1.1

1.1       misho       1: #
                      2: # $QuaggaId: $Format:%an, %ai, %h$ $
                      3: #
                      4: 
                      5: INTRODUCTION
                      6: 
                      7:         qpimd aims to implement a PIM (Protocol Independent Multicast)
                      8:        daemon for the Quagga Routing Suite.
                      9: 
                     10:        Initially qpimd targets only PIM SSM (Source-Specific
                     11:        Multicast) mode as defined in section 4.8.2 (PIM-SSM-Only
                     12:        Routers) of RFC 4601.
                     13: 
                     14:        In order to deliver end-to-end multicast routing control
                     15:        plane, qpimd includes the router-side of IGMPv3 (RFC 3376).
                     16: 
                     17: LICENSE
                     18: 
                     19:         qpimd - pimd for quagga
                     20:         Copyright (C) 2008 Everton da Silva Marques
                     21: 
                     22:         qpimd is free software; you can redistribute it and/or modify
                     23:         it under the terms of the GNU General Public License as
                     24:         published by the Free Software Foundation; either version 2,
                     25:         or (at your option) any later version.
                     26: 
                     27:         qpimd is distributed in the hope that it will be useful, but
                     28:         WITHOUT ANY WARRANTY; without even the implied warranty of
                     29:         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     30:         GNU General Public License for more details.
                     31: 
                     32:         You should have received a copy of the GNU General Public
                     33:         License along with qpimd; see the file COPYING.  If not, write
                     34:         to the Free Software Foundation, Inc., 59 Temple Place - Suite
                     35:         330, Boston, MA 02111-1307, USA.
                     36: 
                     37: HOME SITE
                     38: 
                     39:         qpimd lives at:
                     40: 
                     41:         https://github.com/udhos/qpimd
                     42: 
                     43: PLATFORMS
                     44: 
                     45:        qpimd has been tested with Debian Lenny under Linux 2.6.
                     46: 
                     47: REQUIREMENTS
                     48: 
                     49:        qpimd requires Quagga (0.99.11 or higher from http://www.quagga.net)
                     50: 
                     51:        The GNU Build System (Autotools) is required to build from
                     52:        source code repository.
                     53: 
                     54:        gawk is also needed to build with Autotools. Any other awk
                     55:        usually won't work.
                     56: 
                     57: BUILDING FROM QUAGGA GIT REPOSITORY
                     58: 
                     59:        1) Get the latest quagga source tree
                     60: 
                     61:        # git clone git://code.quagga.net/quagga.git quagga
                     62: 
                     63:        2) Apply qpimd patch into quagga source tree
                     64: 
                     65:        # patch -p1 -d quagga < pimd-0.153-quagga-git20090623.patch
                     66: 
                     67:        3) Compile and install quagga
                     68: 
                     69:        # cd quagga
                     70:        # ./bootstrap.sh
                     71:        # ./configure --prefix=/usr/local/quagga --enable-pimd
                     72:        # make
                     73:        # make install
                     74: 
                     75: BUILDING FROM QUAGGA TARBALL
                     76: 
                     77:        1) Get the latest quagga tarball
                     78: 
                     79:        # wget http://www.quagga.net/download/quagga-0.99.13.tar.gz
                     80: 
                     81:        2) Unpack the quagga tarball
                     82: 
                     83:        # tar xzf quagga-0.99.13.tar.gz
                     84: 
                     85:        3) Apply qpimd patch into quagga source tree
                     86: 
                     87:        # patch -p1 -d quagga-0.99.13 < pimd-0.153-quagga-0.99.13.patch
                     88: 
                     89:        4) Compile and install quagga
                     90: 
                     91:        # cd quagga-0.99.13
                     92:        # ./configure --prefix=/usr/local/quagga --enable-pimd
                     93:        # make
                     94:        # make install
                     95: 
                     96: USAGE
                     97: 
                     98:        1) Configure and start the zebra daemon
                     99: 
                    100:        # cp /usr/local/quagga/etc/zebra.conf.sample /usr/local/quagga/etc/zebra.conf
                    101:        # vi /usr/local/quagga/etc/zebra.conf
                    102:        # /usr/local/quagga/sbin/zebra
                    103: 
                    104:        2) Configure and start the pimd daemon
                    105: 
                    106:        # cp /usr/local/quagga/etc/pimd.conf.sample /usr/local/quagga/etc/pimd.conf
                    107:        # vi /usr/local/quagga/etc/pimd.conf
                    108:        # /usr/local/quagga/sbin/pimd
                    109: 
                    110:        3) Access pimd vty interface at port TCP 2611
                    111: 
                    112:        # telnet localhost 2611
                    113: 
                    114: CONFIGURATION COMMANDS
                    115: 
                    116:        See available commands in the file pimd/COMMANDS.
                    117: 
                    118: KNOWN CAVEATS
                    119: 
                    120:        See list of known caveats in the file pimd/CAVEATS.
                    121: 
                    122: SUPPORT
                    123: 
                    124:        Please post comments, questions, patches, bug reports at the
                    125:        support site:
                    126: 
                    127:         https://github.com/udhos/qpimd
                    128: 
                    129: RELATED WORK
                    130: 
                    131:        igmprt: An IGMPv3-router implementation
                    132:        - http://www.loria.fr/~lahmadi/igmpv3-router.html
                    133: 
                    134:        USC pimd: PIMv2-SM daemon
                    135:        - http://netweb.usc.edu/pim/pimd (URL broken in 2008-12-23)
                    136:        - http://packages.debian.org/source/sid/pimd (from Debian)
                    137: 
                    138:        troglobit pimd: This is the original USC pimd from
                    139:        http://netweb.usc.edu/pim/. In January 16, 2010 it was revived
                    140:        with the intention to collect patches floating around in
                    141:        Debian, Gentoo, Lintrack and other distribution repositories
                    142:        and to provide a central point of collaboration.
                    143:        - http://github.com/troglobit/pimd
                    144: 
                    145:        zpimd: zpimd is not dependent of zebra or any other routing daemon
                    146:        - ftp://robur.slu.se/pub/Routing/Zebra
                    147:        - http://sunsite2.icm.edu.pl/pub/unix/routing/zpimd
                    148: 
                    149:        mrd6: an IPv6 Multicast Router for Linux systems
                    150:        - http://fivebits.net/proj/mrd6/
                    151: 
                    152:        MBGP: Implementation of RFC 2858 for Quagga
                    153:        - git://git.coplanar.net/~balajig/quagga
                    154:        - http://www.gossamer-threads.com/lists/quagga/dev/18000
                    155: 
                    156: REFERENCES
                    157: 
                    158:        IANA Protocol Independent Multicast (PIM) Parameters
                    159:        http://www.iana.org/assignments/pim-parameters/pim-parameters.txt
                    160: 
                    161:        Address Family Numbers
                    162:        http://www.iana.org/assignments/address-family-numbers
                    163: 
                    164:                               -- END --

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>