Module Name: src
Committed By: joerg
Date: Wed Oct 21 22:56:56 UTC 2009
Modified Files:
src/dist/tcpdump: tcpdump.8
Log Message:
Use actual comments to comment blocks and don't leave empty lines in the
output.
To generate a diff of this commit:
cvs rdiff -u -r1.17 -r1.18 src/dist/tcpdump/tcpdump.8
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/dist/tcpdump/tcpdump.8
diff -u src/dist/tcpdump/tcpdump.8:1.17 src/dist/tcpdump/tcpdump.8:1.18
--- src/dist/tcpdump/tcpdump.8:1.17 Thu Sep 10 15:02:49 2009
+++ src/dist/tcpdump/tcpdump.8 Wed Oct 21 22:56:56 2009
@@ -1,7 +1,7 @@
-.\" $NetBSD: tcpdump.8,v 1.17 2009/09/10 15:02:49 wiz Exp $
+.\" $NetBSD: tcpdump.8,v 1.18 2009/10/21 22:56:56 joerg Exp $
.\" @(#) Header: /tcpdump/master/tcpdump/tcpdump.1,v 1.167.2.11 2007/06/15 20:13:49 guy Exp (LBL)
.\"
-.\" $NetBSD: tcpdump.8,v 1.17 2009/09/10 15:02:49 wiz Exp $
+.\" $NetBSD: tcpdump.8,v 1.18 2009/10/21 22:56:56 joerg Exp $
.\"
.\" Copyright (c) 1987, 1988, 1989, 1990, 1991, 1992, 1994, 1995, 1996, 1997
.\" The Regents of the University of California. All rights reserved.
@@ -175,78 +175,78 @@
.LP
Reading packets from a network interface may require that you have
special privileges:
-\" .TP
-\" .B Under SunOS 3.x or 4.x with NIT or BPF:
-\" You must have read access to
-\" .I /dev/nit
-\" or
-\" .IR /dev/bpf* .
-\" .TP
-\" .B Under Solaris with DLPI:
-\" You must have read/write access to the network pseudo device, e.g.
-\" .IR /dev/le .
-\" On at least some versions of Solaris, however, this is not sufficient to
-\" allow
-\" .I tcpdump
-\" to capture in promiscuous mode; on those versions of Solaris, you must
-\" be root, or
-\" .I tcpdump
-\" must be installed setuid to root, in order to capture in promiscuous
-\" mode. Note that, on many (perhaps all) interfaces, if you don't capture
-\" in promiscuous mode, you will not see any outgoing packets, so a capture
-\" not done in promiscuous mode may not be very useful.
-\" .TP
-\" .B Under HP-UX with DLPI:
-\" You must be root or
-\" .I tcpdump
-\" must be installed setuid to root.
-\" .TP
-\" .B Under IRIX with snoop:
-\" You must be root or
-\" .I tcpdump
-\" must be installed setuid to root.
-\" .TP
-\" .B Under Linux:
-\" You must be root or
-\" .I tcpdump
-\" must be installed setuid to root (unless your distribution has a kernel
-\" that supports capability bits such as CAP_NET_RAW and code to allow
-\" those capability bits to be given to particular accounts and to cause
-\" those bits to be set on a user's initial processes when they log in, in
-\" which case you must have CAP_NET_RAW in order to capture and
-\" CAP_NET_ADMIN to enumerate network devices with, for example, the
-\" .B \-D
-\" flag).
-\" .TP
-\" .B Under ULTRIX and Digital UNIX/Tru64 UNIX:
-\" Any user may capture network traffic with
-\" .IR tcpdump .
-\" However, no user (not even the super-user) can capture in promiscuous
-\" mode on an interface unless the super-user has enabled promiscuous-mode
-\" operation on that interface using
-\" .IR pfconfig (8),
-\" and no user (not even the super-user) can capture unicast traffic
-\" received by or sent by the machine on an interface unless the super-user
-\" has enabled copy-all-mode operation on that interface using
-\" .IR pfconfig ,
-\" so
-\" .I useful
-\" packet capture on an interface probably requires that either
-\" promiscuous-mode or copy-all-mode operation, or both modes of
-\" operation, be enabled on that interface.
-\" .TP
-\" .B Under BSD (this includes Mac OS X):
+.\" .TP
+.\" .B Under SunOS 3.x or 4.x with NIT or BPF:
+.\" You must have read access to
+.\" .I /dev/nit
+.\" or
+.\" .IR /dev/bpf* .
+.\" .TP
+.\" .B Under Solaris with DLPI:
+.\" You must have read/write access to the network pseudo device, e.g.
+.\" .IR /dev/le .
+.\" On at least some versions of Solaris, however, this is not sufficient to
+.\" allow
+.\" .I tcpdump
+.\" to capture in promiscuous mode; on those versions of Solaris, you must
+.\" be root, or
+.\" .I tcpdump
+.\" must be installed setuid to root, in order to capture in promiscuous
+.\" mode. Note that, on many (perhaps all) interfaces, if you don't capture
+.\" in promiscuous mode, you will not see any outgoing packets, so a capture
+.\" not done in promiscuous mode may not be very useful.
+.\" .TP
+.\" .B Under HP-UX with DLPI:
+.\" You must be root or
+.\" .I tcpdump
+.\" must be installed setuid to root.
+.\" .TP
+.\" .B Under IRIX with snoop:
+.\" You must be root or
+.\" .I tcpdump
+.\" must be installed setuid to root.
+.\" .TP
+.\" .B Under Linux:
+.\" You must be root or
+.\" .I tcpdump
+.\" must be installed setuid to root (unless your distribution has a kernel
+.\" that supports capability bits such as CAP_NET_RAW and code to allow
+.\" those capability bits to be given to particular accounts and to cause
+.\" those bits to be set on a user's initial processes when they log in, in
+.\" which case you must have CAP_NET_RAW in order to capture and
+.\" CAP_NET_ADMIN to enumerate network devices with, for example, the
+.\" .B \-D
+.\" flag).
+.\" .TP
+.\" .B Under ULTRIX and Digital UNIX/Tru64 UNIX:
+.\" Any user may capture network traffic with
+.\" .IR tcpdump .
+.\" However, no user (not even the super-user) can capture in promiscuous
+.\" mode on an interface unless the super-user has enabled promiscuous-mode
+.\" operation on that interface using
+.\" .IR pfconfig (8),
+.\" and no user (not even the super-user) can capture unicast traffic
+.\" received by or sent by the machine on an interface unless the super-user
+.\" has enabled copy-all-mode operation on that interface using
+.\" .IR pfconfig ,
+.\" so
+.\" .I useful
+.\" packet capture on an interface probably requires that either
+.\" promiscuous-mode or copy-all-mode operation, or both modes of
+.\" operation, be enabled on that interface.
+.\" .TP
+.\" .B Under BSD (this includes Mac OS X):
You must have read access to
-\" .I /dev/bpf*
-\" on systems that don't have a cloning BPF device, or to
+.\" .I /dev/bpf*
+.\" on systems that don't have a cloning BPF device, or to
.I /dev/bpf .
-\" on systems that do.
-\" On BSDs with a devfs (this includes Mac OS X), this might involve more
-\" than just having somebody with super-user access setting the ownership
-\" or permissions on the BPF devices - it might involve configuring devfs
-\" to set the ownership or permissions every time the system is booted,
-\" if the system even supports that; if it doesn't support that, you might
-\" have to find some other way to make that happen at boot time.
+.\" on systems that do.
+.\" On BSDs with a devfs (this includes Mac OS X), this might involve more
+.\" than just having somebody with super-user access setting the ownership
+.\" or permissions on the BPF devices - it might involve configuring devfs
+.\" to set the ownership or permissions every time the system is booted,
+.\" if the system even supports that; if it doesn't support that, you might
+.\" have to find some other way to make that happen at boot time.
.LP
Reading a saved packet file doesn't require special privileges.
.SH OPTIONS
