mnc.tproj/mnc.1

   1 .\"
   2 .\" mnc.1 -- mnc manual
   3 .\"
   4 .\" Colm MacCárthaigh, <colm@apache.org>
   5 .\"
   6 .\" Copyright (c) 2007 Coolm MacCarthaigh.
   7 .\" Copyright (c) 2004-2006 HEAnet Ltd.
   8 .\"
   9 .\" This software is an open source.
  10 .\"
  11 .\" Redistribution and use in source and binary forms, with or without
  12 .\" modification, are permitted provided that the following conditions
  13 .\" are met:
  14 .\"
  15 .\" Redistributions of source code must retain the above copyright notice,
  16 .\" this list of conditions and the following disclaimer.
  17 .\"
  18 .\" Redistributions in binary form must reproduce the above copyright notice,
  19 .\" this list of conditions and the following disclaimer in the documentation
  20 .\" and/or other materials provided with the distribution.
  21 .\"
  22 .\" Neither the name of the HEAnet Ltd. nor the names of its contributors may
  23 .\" be used to endorse or promote products derived from this software without
  24 .\" specific prior written permission.
  25 .\"
  26 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  27 .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  28 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  29 .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
  30 .\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  31 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  32 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  33 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  34 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  35 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  36 .\" POSSIBILITY OF SUCH DAMAGE.
  37 .\"
  38 .TH mnc 1 "17 September 2004" "mnc"
  39 .SH NAME
  40 mnc \- Multicast NetCat
  41 .SH SYNOPSIS
  42 .BR mnc
  43 [ -l ] [ -i interface ] [ -p port ] group-id [ source-address ]
  44 .SH DESCRIPTION
  45 .B mnc
  46 is designed for simple multicast debugging and testing. It supports
  47 IPv4 and IPv6 any-source multicast and source-specific multicast.
  48 In standard mode it will multicast the standard-input verbatim.
  49 In listening mode it recieves the content and displays it on the
  50 standard output.
  51 .PP
  52 When given the optional source-address, mnc will attempt to use
  53 source-specific multicast. You may also specify this address
  54 in standard mode and mnc will use this source-address for
  55 outgoing packets.
  56 .PP
  57 .SH OPTIONS
  58 .IP \-l
  59 Listen for multicast packets. Default is to send.
  60 .IP \-i\ "interface"
  61 When listening for multicast packets, use the specified interface.
  62 .IP \-p\ "port"
  63 Specify a UDP port to use for sending or receiving packets. Default is to use port 1234.
  64 .SH "SEE ALSO"
  65 .BR nc (1)
  66 .PP
  67 .SH EXAMPLES
  68 To send IPv4 packets to an ASM group-id:
  69 .PP
  70 .RS
  71 mnc 233.1.2.3
  72 .RE
  73 .PP
  74 To receive IPv4 ASM packets from the same group-id, using eth0 as
  75 the listening interface:
  76 .PP
  77 .RS
  78 mnc -l -i eth0 233.1.2.3
  79 .RE
  80 .PP
  81 To receive IPv4 packets from an SSM group-id, using eth1 as the
  82 listening interface and 193.1.219.90 as the permitted source:
  83 .PP
  84 .RS
  85 mnc -l -i eth1 232.0.0.1 193.1.219.90
  86 .RE
  87 .PP
  88 To receive IPv6 packets from an SSM group-id, using eth1 as the
  89 listening interface and 2001:770:18:2::90 as the permitted source:
  90 .PP
  91 .RS
  92 mnc -l -i eth1 ff31::12 2001:770:18:2::90
  93 .RE
  94 .PP
  95 .SH CREDITS
  96 mnc is by Colm MacCárthaigh <colm@apache.org> and is available from:
  97 .PP
  98 http://people.apache.org/~colm/mnc/
  99 .PP
 100 Additional multicast development and support provided by John Lyons
 101 <john.lyons@heanet.ie> and Eoin Kenny <eoin.kenny@heanet.ie>