File:  [ELWIX - Embedded LightWeight unIX -] / embedaddon / quagga / pimd / README
Revision 1.1.1.1 (vendor branch): download - view: text, annotated - select for diffs - revision graph
Wed Nov 2 10:09:11 2016 UTC (7 years, 8 months ago) by misho
Branches: quagga, MAIN
CVS tags: v1_0_20160315, HEAD
quagga 1.0.20160315

    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>