tshark | Using the Example Extcap from the Documentation

by pocc 6 years ago

macOS • xterm-256color • bash 3676 views

Description

This asciicast goes over how to use the extcap_example.py in the wireshark repo: https://github.com/wireshark/wireshark/blob/master/doc/extcap_example.py

The aim is to assist readers unfamiliar with extcaps on how they are expected to work and what expected behavior might look like for reader-created extcaps.

Transcript

# === Using the example extcap provided by wireshark ===
# This script is from the repo (github.com/wireshark/wireshark) in /docs
# Per docs, this utility will create random IPv4 packets

cd /tmp
mkfifo myfifo # extcaps require a FIFO

# Download script from repo
curl -O https://raw.githubusercontent.com/wireshark/wireshark/master/doc/extcap_example.py

# Let's check out the options
python extcap_example.py --help | less

# Let's list the interfaces as one is required
python extcap_example.py --extcap-interfaces

# Let's use the example1 interface and start capture with --capture
# A delay isn't required, but changing it to 1(s) saves time
python extcap_example.py --extcap-interface=example1 --fifo=myfifo --delay=1 --capture &
tshark -i myfifo

# wireshark -k -i myfifo can also used to see this traffic

More by pocc

Editing hex with vim 0:51

by pocc 6 years ago featured

tshark | Decrypt TLSv1.2 3:38

by pocc 6 years ago

tshark | Check traffic on default interface 0:09

by pocc 6 years ago

Editing hex in emacs 0:54

by pocc 6 years ago

See all

https://asciinema.org/a/237441

Copied!

Append ?t=30 to start the playback at 30s, ?t=3:20 to start the playback at 3m 20s.

See sharing docs for more link customization options.

Embed as image link

Use snippets below to display a preview image linking to this recording.
Ideal for places where scripts are not allowed, such as project README files.

HTML:

<a href="https://asciinema.org/a/237441" target="_blank"><img src="https://asciinema.org/a/237441.svg" /></a>

Copied!

Markdown:

[![asciicast](https://asciinema.org/a/237441.svg)](https://asciinema.org/a/237441)

Copied!

Embed the player

If you're embedding on your own page or on a site which permits script tags, you can use the full player widget:

<script src="https://asciinema.org/a/237441.js" id="asciicast-237441" async="true"></script>

Copied!

Paste the above script tag where you want the player to be displayed on your page.

See embedding docs for more player customization options.

You can download this recording in asciicast v2 format, as a .cast file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 237441.cast

Copied!

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="/assets/asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="/assets/asciinema-player.min.js"></script>
  <script>
    AsciinemaPlayer.create(
      '/assets/237441.cast',
      document.getElementById('player'),
      { cols: 100, rows: 28 }
    );
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't provide GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed, generate a GIF with the following command:

agg https://asciinema.org/a/237441 demo.gif

Copied!

Or, if you already downloaded the recording file:

agg demo.cast demo.gif

Copied!

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.