1DRIFTNET(1) General Commands Manual DRIFTNET(1)
2
3
4
6 driftnet - capture images from network traffic and display them in an X
7 window; optionally, capture audio streams and play them.
8
9
11 driftnet [options] [filter code]
12
13
15 Driftnet watches network traffic, and picks out and displays JPEG and
16 GIF images for display. It is an horrific invasion of privacy and
17 shouldn't be used by anyone anywhere. It has been described as `a
18 graphical tcpdump(8)', `EtherPeg for Unix', and called all sorts of
19 nasty names by people on Freshmeat. It is also possible to use driftnet
20 to capture MPEG audio data from the network and play it through a
21 player such as mpg123(1).
22
23 Images may be saved by clicking on them.
24
25
27 -h Print a summary of usage.
28
29 -v Print additional details of packets captured to the terminal.
30
31 -b Beep when a new image is displayed.
32
33 -i interface
34 Listen to packets on interface. By default, driftnet will try to
35 pick up traffic on all interfaces, but this does not work with
36 all versions of pcap(3); on such systems, an interface must be
37 specified. On some systems, driftnet can only use promiscuous
38 mode if an interface is specified.
39
40 -p Do not put the interface into promiscuous mode.
41
42 -a Operate in `adjunct mode', where driftnet gathers images for use
43 by another program, such as Jamie Zawinski's webcollage. In this
44 mode, no window is displayed; images are captured and saved in a
45 temporary directory, and their names written on standard output.
46
47 -m number
48 In adjunct mode, silently drop images if there are more than
49 number in the temporary directory. It is assumed that another
50 process will delete images which it has processed.
51
52 -x prefix
53 The filename prefix to use when saving images, by default
54 `driftnet-'.
55
56 -d directory
57 Use directory to store temporary files. Driftnet will clear this
58 directory of its own temporary files on exit, but will not
59 delete the directory or any other files.
60
61 -s Attempt to capture streamed audio data from the network, and
62 either play it or, in adjunct mode, save it in files. At present
63 this only works with MPEG data.
64
65 -S Capture streamed audio data only, ignoring images.
66
67 -M command
68 Use the named command to play MPEG audio data. The command,
69 which is executed using the shell, should accept MPEG frames on
70 standard input. The default is `mpg123 -'.
71
72 filter code
73 Additional filter code to restrict the packets captured, in the
74 libpcap syntax. User filter code is evaluated as `tcp and (fil‐
75 ter code)'.
76
77
79 tcpdump(8), pcap(3), webcollage(1), mpg123(1),
80 http://www.etherpeg.org/,
81 http://freshmeat.net/projects/driftnet/,
82 http://www.ex-parrot.com/~chris/driftnet/.
83
84
86 Chris Lightfoot <chris@ex-parrot.com>
87
88
90 Driftnet, version 0.1.6.
91 $Id: driftnet.1.in,v 1.7 2004/04/26 14:42:36 chris Exp $
92
93
95 This program is free software; you can redistribute it and/or modify it
96 under the terms of the GNU General Public License as published by the
97 Free Software Foundation; either version 2 of the License, or (at your
98 option) any later version.
99
100 This program is distributed in the hope that it will be useful, but
101 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
102 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
103 Public License for more details.
104
105 You should have received a copy of the GNU General Public License along
106 with this program; if not, write to the Free Software Foundation, Inc.,
107 675 Mass Ave, Cambridge, MA 02139, USA.
108
109
110
111
112 DRIFTNET(1)