Imported Upstream version 878.70.2
[platform/upstream/mdnsresponder.git] / mDNSMacOSX / mDNSNetMonitor / mDNSNetMonitor.8
1 .\"Modified from man(1) of FreeBSD, the NetBSD mdoc.template, and mdoc.samples.
2 .\"See Also:
3 .\"man mdoc.samples for a complete listing of options
4 .\"man mdoc for the short list of editing options
5 .\"/usr/share/misc/mdoc.template
6 .Dd 8/31/16               \" DATE
7 .Dt mDNSNetMonitor 8      \" Program name and manual section number
8 .Os Darwin
9 .Sh NAME                 \" Section Header - required - don't modify 
10 .Nm mDNSNetMonitor
11 .\" The following lines are read in generating the apropos(man -k) database. Use only key
12 .\" words here as the database is built based on the words here and in the .ND line. 
13 .\" Use .Nm macro to designate other names for the documented program.
14 .Nd dumps mDNS traffic on a network
15 .Sh SYNOPSIS             \" Section Header - required - don't modify
16 .Nm
17 .Op Fl i Ar interface
18 .Op  Ar host
19 .Sh DESCRIPTION          \" Section Header - required - don't modify
20 .Nm
21 prints out a description of the contents of mDNS packets on a network interface. It is similiar to tcpdump in that it continuously captures packets until it is interrupted by a SIGINT signal (generated, for example, by typing your interrupt character, typically  control-C)  or a SIGTERM signal (typically generated with the kill(1) command). 
22
23 When mDNSNetMonitor finishes capturing packets, it will report counts of packets captured per mDNS packet type, service type and source device.
24  
25 Note that mDNSNetMonitor will not capture unicast mDNS packets.
26 .Sh OPTION 
27
28 -i interface    Displays packets on specified interface.
29 .Sh Example 
30
31 To print all packets arriving at or departing from 
32 .Pa sundown Ns :
33     % mDNSNetMonitor sundown
34 .Sh SEE ALSO 
35 .\" List links in ascending order by section, alphabetically within a section.
36 .\" Please do not reference files that do not exist without filing a bug report
37 .Xr mDNSResponder 8 ,
38 .Xr dns-sd 8
39 .\" .Sh BUGS              \" Document known, unremedied bugs 
40 .\" .Sh HISTORY           \" Document history if command behaves in a unique manner