NetworkPacketCapture

NetworkPacketCapture[]

creates a temporary interactive interface for capturing information on network packets transmitted or received through all network interfaces on your computer.

NetworkPacketCapture[service]

captures only packets associated with the specified network service.

NetworkPacketCapture[port]

captures only packets associated with the specified port.

NetworkPacketCapture[spec]

captures only packets matching the specification spec.

Details

  • In NetworkPacketCapture[service], possible forms for service include:
  • "name"an IANA named service (e.g. "HTTP")
    entityan entity of type "NetworkService"
  • Entities can be entered using free-form linguistics with .
  • In NetworkPacketCapture[ports], network ports can specified as follows:
  • nsingle port number n
    nmin;;nmaxa range of ports from nmin to nmax
    {n1,n2,}a list of ports
  • In NetworkPacketCapture[spec], spec can be given in the form key->value, or as an association containing multiple keys and values. Possible keys include:
  • "IPAddress"source or destination IP address
    "SourceIPAddress"source IP address
    "DestinationIPAddress"destination IP address
    "IPAddressType"source or destination IP address type (e.g. "IPv4" or "IPv6")
    "SourceIPAddressType"source IP address type
    "DestinationIPAddressType"destination IP address type
    "Port"source or destination port
    "SourcePort"source port
    "DestinationPort"destination port
    "Interface"network interface (e.g. "en0")
    "PCAPFilter"raw PCAP filter specification as a string
  • IP addresses can be given as strings or IPAddress objects.
  • Possible values for the "Interface" key can be any element in $NetworkInterfaces, a list of these or All.
  • Any setting given for "PCAPFilter" overrides all other settings.
  • On Windows computers, SystemInstall["WinPcap"] may be needed before NetworkPacketCapture is used.
  • NetworkPacketRecording typically requires elevated permissions on Linux and Mac.

Examples

open allclose all

Basic Examples  (2)

Start an interactive interface to capture network packets:

In[1]:=
Click for copyable input

When complete, a dataset with packets is returned:

In[2]:=
Click for copyable input
Out[2]=

Record network activity from a specific service and show the first packet:

In[1]:=
Click for copyable input
Out[1]=

Record network activity from a specific port and show the first packet:

In[2]:=
Click for copyable input
Out[2]=

Record network activity from all interfaces and show the first packet:

In[3]:=
Click for copyable input
Out[3]=

Record network activity using a direct PCAP filter string and show the first packet:

In[4]:=
Click for copyable input
Out[4]=

Scope  (1)

See Also

NetworkPacketRecording  $NetworkInterfaces  $DefaultNetworkInterface  HostLookup  PingTime  URLResponseTime  SocketListen  SystemInstall  AudioCapture

Introduced in 2018
(11.3)