README 4.4 KB

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