Provided by: driftnet_0.1.6-9ubuntu1_amd64 bug

NAME

       driftnet  -  capture  images  from  network  traffic  and  display  them  in  an X window;
       optionally, capture audio streams and play them.

SYNOPSIS

       driftnet [options] [filter code]

DESCRIPTION

       Driftnet watches network traffic, and picks out and  displays  JPEG  and  GIF  images  for
       display.  It  is an horrific invasion of privacy and shouldn't be used by anyone anywhere.
       It has been described as `a graphical tcpdump(8)', `EtherPeg for  Unix',  and  called  all
       sorts  of  nasty  names  by  people  on  Freshmeat. It is also possible to use driftnet to
       capture MPEG audio data from the network and play it through a player such as mpg123(1).

       Images may be saved by clicking on them.

OPTIONS

       -h     Print a summary of usage.

       -v     Print additional details of packets captured to the terminal.

       -i interface
              Listen to packets on interface. By default, driftnet will try to pick up traffic on
              all  interfaces,  but  this  does  not  work  with all versions of pcap(3); on such
              systems, an interface must be specified. On some systems,  driftnet  can  only  use
              promiscuous mode if an interface is specified.

       -p     Do not put the interface into promiscuous mode.

       -a     Operate  in  `adjunct  mode',  where  driftnet  gathers  images  for use by another
              program, such as Jamie Zawinski's webcollage. In this mode, no window is displayed;
              images  are captured and saved in a temporary directory, and their names written on
              standard output.

       -m number
              In adjunct mode, silently drop  images  if  there  are  more  than  number  in  the
              temporary directory. It is assumed that another process will delete images which it
              has processed.

       -x prefix
              The filename prefix to use when saving images, by default `driftnet-'.

       -d directory
              Use directory to store temporary files. Driftnet will clear this directory  of  its
              own temporary files on exit, but will not delete the directory or any other files.

       -s     Attempt  to capture streamed audio data from the network, and either play it or, in
              adjunct mode, save it in files. At present this only works with MPEG data.

       -S     Capture streamed audio data only, ignoring images.

       -M command
              Use the named command to play MPEG audio data. The command, which is executed using
              the shell, should accept MPEG frames on standard input.  The default is `mpg123 -'.

       filter code
              Additional  filter  code  to  restrict the packets captured, in the libpcap syntax.
              User filter code is evaluated as `tcp and (filter code)'.

SEE ALSO

       tcpdump(8), pcap(3), webcollage(1), mpg123(1),
       http://www.etherpeg.org/,
       http://freshmeat.net/projects/driftnet/,
       http://www.ex-parrot.com/~chris/driftnet/.

AUTHOR

       Chris Lightfoot <chris@ex-parrot.com>

VERSION

       Driftnet, version 0.1.6.
       $Id: driftnet.1.in,v 1.5 2002/06/04 15:39:54 chris Exp $

COPYING

       This program is free software; you can redistribute it and/or modify it under the terms of
       the  GNU  General  Public  License  as  published  by the Free Software Foundation; either
       version 2 of the License, or (at your option) any later version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY  WARRANTY;
       without  even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
       See the GNU General Public License for more details.

       You should have received a copy of the GNU General Public License along with this program;
       if  not,  write  to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
       USA.

                                                                                      DRIFTNET(1)