summaryrefslogtreecommitdiff
path: root/man/busctl.xml
diff options
context:
space:
mode:
authorStephen Hemminger <sthemmin@microsoft.com>2021-12-24 22:07:40 -0800
committerGitHub <noreply@github.com>2021-12-25 15:07:40 +0900
commit7c4bd9ac98db6f8804fca6a362a583057f6058f7 (patch)
tree9b7174a8c603500cfed7d87f6584b3b07a40eed3 /man/busctl.xml
parent402b81ffd8548249e846b045b10d6e8c852d2904 (diff)
downloadsystemd-7c4bd9ac98db6f8804fca6a362a583057f6058f7.tar.gz
bus-dump: change capture output to use pcapng (#21738)
This patch changes busctl capture to generate pcapng format instead of the legacy pcap format files. It includes basic meta-data in the file and still uses microsecond time resolution. In future, more things can be added such as high resolution timestams, statistics, etc. PCAP Next Generation capture file format is what tshark uses and is in process of being standardized in IETF. It is also readable with libpcap. $ capinfos /tmp/new.pcapng File name: /tmp/new.pcapng File type: Wireshark/... - pcapng File encapsulation: D-Bus File timestamp precision: microseconds (6) Packet size limit: file hdr: (not set) Packet size limit: inferred: 4096 bytes Number of packets: 22 File size: 21kB Data size: 20kB Capture duration: 0.005694 seconds First packet time: 2021-12-11 11:57:42.788374 Last packet time: 2021-12-11 11:57:42.794068 Data byte rate: 3,671kBps Data bit rate: 29Mbps Average packet size: 950.27 bytes Average packet rate: 3,863 packets/s SHA256: b85ed8b094af60c64aa6d9db4a91404e841736d36b9e662d707db9e4096148f1 RIPEMD160: 81f9bac7ec0ec5cd1d55ede136a5c90413894e3a SHA1: 8400822ef724b934d6000f5b7604b9e6e91be011 Strict time order: True Capture oper-sys: Linux 5.14.0-0.bpo.2-amd64 Capture application: systemd 250 (250-rc2-33-gdc79ae2+) Number of interfaces in file: 1 Interface #0 info: Encapsulation = D-Bus (146 - dbus) Capture length = 4096 Time precision = microseconds (6) Time ticks per second = 1000000 Number of stat entries = 0 Number of packets = 22
Diffstat (limited to 'man/busctl.xml')
-rw-r--r--man/busctl.xml8
1 files changed, 4 insertions, 4 deletions
diff --git a/man/busctl.xml b/man/busctl.xml
index cc5a6508ef..bcd3f4805e 100644
--- a/man/busctl.xml
+++ b/man/busctl.xml
@@ -78,10 +78,10 @@
<term><command>capture</command> <arg choice="opt" rep="repeat"><replaceable>SERVICE</replaceable></arg></term>
<listitem><para>Similar to <command>monitor</command> but
- writes the output in pcap format (for details, see the <ulink
- url="https://wiki.wireshark.org/Development/LibpcapFileFormat">Libpcap
- File Format</ulink> description). Make sure to redirect
- standard output to a file. Tools like
+ writes the output in pcapng format (for details, see
+ <ulink url="https://github.com/pcapng/pcapng/">
+ PCAP Next Generation (pcapng) Capture File Format</ulink>).
+ Make sure to redirect standard output to a file or pipe. Tools like
<citerefentry project='die-net'><refentrytitle>wireshark</refentrytitle><manvolnum>1</manvolnum></citerefentry>
may be used to dissect and view the resulting
files.</para></listitem>