| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
|
|
| |
Move one "use regular font" macro such that every "note that" block
switches between bold and regular font explicitly. This way HTML output
has the same style as console man.
|
|
|
|
| |
[skip ci]
|
|
|
|
| |
[skip cp]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Note that, on Linux and Windows, pcap_breakloop() attempts to force a
wakeup on the thread reading the packets.
Note all the hilarity that ensues from that; this is one of the areas
where capture-mechanism differences are not quite so easily papered
over.
(These capture mechanisms were all pretty much designed for a program
that reads captures until it's told to stop, and then may or may not
process packets that arrived after that point. Making it available
through libpcap has opened up packet capturing to a zillion developers,
many of whom are doing different types of capture programs with
different requirements, and stumbling over all these problems. Perhaps
it's time for a rethink.
We won't even mention the use of the capture mechanisms for purposes
*other* than packet capture, such as implementing various protocols atop
the link-layer; libpcap's API is not the best fit for that - a
corss-platform "link-layer sockets" library, possibly using a
*different* OS mechanism than libpcap on some platforms, might be handy
there.)
|
|
|
|
|
|
|
|
| |
This reverts commit 4441992020d06cd219c085f587fc9471b4f883b0.
For the two paragraphs in question, the entire paragraph in which those
function names appear is boldfaced, so we shouldn't tweak function name
references in those paragraphs.
|
| |
|
|
|
|
|
|
|
|
| |
Use the BSD house style, in which, in
foobar() returns 17 on success and 137 on failure.
"foobar" is boldfaced but "()" isn't.
|
|
|
|
|
|
|
| |
All manpage references such as pcap_create(3PCAP) will now be formatted
with the identifier (e.g. "pcap_create") in **bold** and the section
name (e.g. "(3PCAP)") in roman (default) face. This is how most manpages
seem to be formatted and makes things more consistent.
|
|
|
|
| |
[skip ci]
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
When a man page text for the first time refers to a libpcap function that
is not a topic of the man page, make sure it points to the 3PCAP section.
This way the reference becomes a hyperlink in the HTML version and the
web-site cohesion improves.
Make sure the SEE ALSO section does not list references already present
in the main text. This way the references that appear only in SEE ALSO
are much easier to notice, and cohesion remains the same.
[skip ci]
|
|
|
|
|
|
|
|
| |
In the man pages that since the previous timestamp had meaningful (i.e.
not typos or whitespace fixups) changes set the timestamp to the date
of such last meaningful change.
[skip ci]
|
| |
|
| |
|
| |
|
| |
|
|
|
|
|
|
| |
This change removes CVS keywords that express that the file belongs to
libpcap repository. All such keywords represented the revision and
timestamp by the end of 2008 or even older.
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Different renderers (different *roffs, different -man macro packages,
different man-to-HTML translators, etc.) may handle fonts and paragraph
boundaries differently, or may handle font resetting in .BR and .B
differently, so:
reset the font at or before the end of a paragraph;
don't assume that font changes persist across paragraph breaks;
don't use .B or .BR inside boldfaced text.
|
|
|
|
|
|
| |
concepts to the pcap(3PCAP) man page, refer people to the pcap(3PCAP)
man page from the man pages for libpcap functions, and clean up some
errors.
|
|
|
|
|
|
|
| |
to 1.0, might as well go with the place where Red Hat stuck the header
at one point and where the header "officially" resides.
(We should put a "backwards compatibility" note into pcap.3pcap.)
|
|
functions plus an overall man page for libpcap, and put them all into
section 3PCAP. That means you can actually do "man pcap_open_live" and
get something meaningful, rather than having to do "man pcap" and then
scroll through all the other stuff in the man page.
|