Skip to the content.

Home

jc.parsers.ss

jc - JSON Convert ss command output parser

Usage (cli):

$ ss | jc --ss

or

$ jc ss

Usage (module):

import jc
result = jc.parse('ss', ss_command_output)

Schema:

Information from https://www.cyberciti.biz/files/ss.html used to define field names

[
  {
    "netid":                      string,
    "state":                      string,
    "recv_q":                     integer,
    "send_q":                     integer,
    "local_address":              string,
    "local_port":                 string,
    "local_port_num":             integer,
    "peer_address":               string,
    "peer_port":                  string,
    "peer_port_num":              integer,
    "interface":                  string,
    "link_layer"                  string,
    "channel":                    string,
    "path":                       string,
    "pid":                        integer,
    "opts": {
      "process_id": {
        "<process_id>": {
          "user":                 string,
          "file_descriptor":      string
        }
      }
      "inode_number":             string,
      "cookie":                   string,
      "cgroup":                   string,
      "v6only":                   string,
      "timer_name":               string,
      "expire_time":              string,
      "retrans":                  string
    }
  }
]

Examples:

  $ sudo ss -a | jc --ss -p
  [
    {
      "netid": "nl",
      "state": "UNCONN",
      "recv_q": 0,
      "send_q": 0,
      "peer_address": "*",
      "channel": "rtnl:kernel"
    },
    {
      "netid": "nl",
      "state": "UNCONN",
      "recv_q": 0,
      "send_q": 0,
      "peer_address": "*",
      "pid": 893,
      "channel": "rtnl:systemd-resolve"
    },
    ...
    {
      "netid": "p_raw",
      "state": "UNCONN",
      "recv_q": 0,
      "send_q": 0,
      "peer_address": "*",
      "link_layer": "LLDP",
      "interface": "ens33"
    },
    {
      "netid": "u_dgr",
      "state": "UNCONN",
      "recv_q": 0,
      "send_q": 0,
      "local_port": "93066",
      "peer_address": "*",
      "peer_port": "0",
      "path": "/run/user/1000/systemd/notify"
    },
    {
      "netid": "u_seq",
      "state": "LISTEN",
      "recv_q": 0,
      "send_q": 128,
      "local_port": "20699",
      "peer_address": "*",
      "peer_port": "0",
      "path": "/run/udev/control"
    },
    ...
    {
      "netid": "icmp6",
      "state": "UNCONN",
      "recv_q": 0,
      "send_q": 0,
      "local_address": "*",
      "local_port": "ipv6-icmp",
      "peer_address": "*",
      "peer_port": "*",
      "interface": "ens33"
    },
    {
      "netid": "udp",
      "state": "UNCONN",
      "recv_q": 0,
      "send_q": 0,
      "local_address": "127.0.0.53",
      "local_port": "domain",
      "peer_address": "0.0.0.0",
      "peer_port": "*",
      "interface": "lo"
    },
    {
      "netid": "tcp",
      "state": "LISTEN",
      "recv_q": 0,
      "send_q": 128,
      "local_address": "127.0.0.53",
      "local_port": "domain",
      "peer_address": "0.0.0.0",
      "peer_port": "*",
      "interface": "lo"
    },
    {
      "netid": "tcp",
      "state": "LISTEN",
      "recv_q": 0,
      "send_q": 128,
      "local_address": "0.0.0.0",
      "local_port": "ssh",
      "peer_address": "0.0.0.0",
      "peer_port": "*"
    },
    {
      "netid": "tcp",
      "state": "LISTEN",
      "recv_q": 0,
      "send_q": 128,
      "local_address": "[::]",
      "local_port": "ssh",
      "peer_address": "[::]",
      "peer_port": "*"
    },
    {
      "netid": "v_str",
      "state": "ESTAB",
      "recv_q": 0,
      "send_q": 0,
      "local_address": "999900439",
      "local_port": "1023",
      "peer_address": "0",
      "peer_port": "976",
      "local_port_num": 1023,
      "peer_port_num": 976
    }
  ]

  $ sudo ss -a | jc --ss -p -r
  [
    {
      "netid": "nl",
      "state": "UNCONN",
      "recv_q": "0",
      "send_q": "0",
      "peer_address": "*",
      "channel": "rtnl:kernel"
    },
    {
      "netid": "nl",
      "state": "UNCONN",
      "recv_q": "0",
      "send_q": "0",
      "peer_address": "*",
      "pid": "893",
      "channel": "rtnl:systemd-resolve"
    },
    ...
    {
      "netid": "p_raw",
      "state": "UNCONN",
      "recv_q": "0",
      "send_q": "0",
      "peer_address": "*",
      "link_layer": "LLDP",
      "interface": "ens33"
    },
    {
      "netid": "u_dgr",
      "state": "UNCONN",
      "recv_q": "0",
      "send_q": "0",
      "local_port": "93066",
      "peer_address": "*",
      "peer_port": "0",
      "path": "/run/user/1000/systemd/notify"
    },
    {
      "netid": "u_seq",
      "state": "LISTEN",
      "recv_q": "0",
      "send_q": "128",
      "local_port": "20699",
      "peer_address": "*",
      "peer_port": "0",
      "path": "/run/udev/control"
    },
    ...
    {
      "netid": "icmp6",
      "state": "UNCONN",
      "recv_q": "0",
      "send_q": "0",
      "local_address": "*",
      "local_port": "ipv6-icmp",
      "peer_address": "*",
      "peer_port": "*",
      "interface": "ens33"
    },
    {
      "netid": "udp",
      "state": "UNCONN",
      "recv_q": "0",
      "send_q": "0",
      "local_address": "127.0.0.53",
      "local_port": "domain",
      "peer_address": "0.0.0.0",
      "peer_port": "*",
      "interface": "lo"
    },
    {
      "netid": "tcp",
      "state": "LISTEN",
      "recv_q": "0",
      "send_q": "128",
      "local_address": "127.0.0.53",
      "local_port": "domain",
      "peer_address": "0.0.0.0",
      "peer_port": "*",
      "interface": "lo"
    },
    {
      "netid": "tcp",
      "state": "LISTEN",
      "recv_q": "0",
      "send_q": "128",
      "local_address": "0.0.0.0",
      "local_port": "ssh",
      "peer_address": "0.0.0.0",
      "peer_port": "*"
    },
    {
      "netid": "tcp",
      "state": "LISTEN",
      "recv_q": "0",
      "send_q": "128",
      "local_address": "[::]",
      "local_port": "ssh",
      "peer_address": "[::]",
      "peer_port": "*"
    },
    {
      "netid": "v_str",
      "state": "ESTAB",
      "recv_q": "0",
      "send_q": "0",
      "local_address": "999900439",
      "local_port": "1023",
      "peer_address": "0",
      "peer_port": "976"
    }
  ]

parse

def parse(data, raw=False, quiet=False)

Main text parsing function

Parameters:

data:        (string)  text data to parse
raw:         (boolean) unprocessed output if True
quiet:       (boolean) suppress warning messages if True

Returns:

List of Dictionaries. Raw or processed structured data.

Parser Information

Compatibility: linux

Source: jc/parsers/ss.py

Version 1.8 by Kelly Brazil (kellyjonbrazil@gmail.com)