jc/docs/parsers/proc_crypto.md

Home

jc.parsers.proc_crypto

jc - JSON Convert /proc/crypto file parser

Usage (cli):

$ cat /proc/crypto | jc --proc

or

$ jc /proc/crypto

or

$ cat /proc/crypto | jc --proc-crypto

Usage (module):

import jc
result = jc.parse('proc', proc_crypto_file)

or

import jc
result = jc.parse('proc_crypto', proc_crypto_file)

Schema:

"Well-known" keys like priority and refcnt are converted to integers. Also, keynames ending in "size" are converted to integers.

If this is not desired, then use the --raw (CLI) or raw=True (Module) option.

[
  {
    "name":                   string,
    "driver":                 string,
    "module":                 string,
    "priority":               integer,
    "refcnt":                 integer,
    "selftest":               string,
    "internal":               string,
    "type":                   string,
    "*size":                  integer
  }
]

Examples:

$ cat /proc/crypto | jc --proc -p
[
  {
    "name": "ecdh",
    "driver": "ecdh-generic",
    "module": "ecdh_generic",
    "priority": 100,
    "refcnt": 1,
    "selftest": "passed",
    "internal": "no",
    "type": "kpp"
  },
  {
    "name": "blake2b-512",
    "driver": "blake2b-512-generic",
    "module": "blake2b_generic",
    "priority": 100,
    "refcnt": 1,
    "selftest": "passed",
    "internal": "no",
    "type": "shash",
    "blocksize": 128,
    "digestsize": 64
  },
  ...
]

$ cat /proc/crypto | jc --proc_crypto -p -r
[
  {
    "name": "ecdh",
    "driver": "ecdh-generic",
    "module": "ecdh_generic",
    "priority": "100",
    "refcnt": "1",
    "selftest": "passed",
    "internal": "no",
    "type": "kpp"
  },
  {
    "name": "blake2b-512",
    "driver": "blake2b-512-generic",
    "module": "blake2b_generic",
    "priority": "100",
    "refcnt": "1",
    "selftest": "passed",
    "internal": "no",
    "type": "shash",
    "blocksize": "128",
    "digestsize": "64"
  },
  {
    "name": "blake2b-384",
    "driver": "blake2b-384-generic",
    "module": "blake2b_generic",
    "priority": "100",
    "refcnt": "1",
    "selftest": "passed",
    "internal": "no",
    "type": "shash",
    "blocksize": "128",
    "digestsize": "48"
  },
  ...
]

parse

def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]

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/proc_crypto.py

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