Skip to main content

Tar

Supported formats​

Legacy, GNU, and USTAR tar(balls)

Description​

This backend extracts files and metadata from all popular tar formats.

info

Available in Contextal Platform 1.0 and later.

Symbols​

Object​

  • LIMITS_REACHED → limits triggered while processing the archive

Children​

  • TOOBIG → this child object was not extracted as it exceeds the limits

Example Metadata​

{
   "org": "ctx",
   "object_id": "ede727beb254a32c710ca78e66e6634cbc14caf4cd767d5ab8f7a14dffda933a",
   "object_type": "Tar",
   "object_subtype": null,
   "recursion_level": 1,
   "size": 6144,
   "hashes": {
      "sha512": "0cc584c04eba2a778eb32a2021a22ed4e551b0f28e7b3afd3945ec5111532a34145d7fe0a1f910e04bd610172a6fa616ec2f85aa710e247651701580af75d7e0",
      "sha1": "e0490f61ed91090c83b8c89ed5f777fee151b897",
      "md5": "d548df5085e4dd9b7b5ef89ebcd3d580",
      "sha256": "ede727beb254a32c710ca78e66e6634cbc14caf4cd767d5ab8f7a14dffda933a"
   },
   "ctime": 1726172095.532837,
   "ok": {
      "symbols": [],
      "object_metadata": {
         "_backend_version": "1.0.0",
         "has_devs": false,
         "has_links": false,
         "is_gnu": false,
         "is_ustar": true
      },
      "children": [
         {
            "org": "ctx",
            "object_id": "77596bfedc8d5be73e0e81e81c9036816a856f3fbf37ab27eec22f618cf467f6",
            "object_type": "Text",
            "object_subtype": null,
            "recursion_level": 2,
            "size": 2528,
            "hashes": {
               "md5": "328a3721be22138b9545f4f9218ed025",
               "sha1": "c5304e8adc5fe415ae01fa0f11fb88a49a53a354",
               "sha256": "77596bfedc8d5be73e0e81e81c9036816a856f3fbf37ab27eec22f618cf467f6",
               "sha512": "18bdb7ff602e06d3c3f011cdb71078d27a492d9fd3bf7414ec9885c8c8392af3fa770a9e57856f9345acac17bff250b1bdc81f2ef07e95e3c3f90760aaf2f935"
            },
            "ctime": 1726172095.532837,
            "relation_metadata": {
               "gid": 20,
               "group": "staff",
               "mode": "755",
               "name": "runme.py",
               "time": 1708616746,
               "uid": 501,
               "user": "joe"
            },
            "ok": {
               "symbols": [
                  "ALL_ASCII"
               ],
               "object_metadata": {
                  "_backend_version": "1.0.0",
                  "encoding": "utf-8",
                  "number_of_ascii_range_chars": 2528,
                  "number_of_characters": 2528,
                  "number_of_digits": 14,
                  "number_of_newlines": 80,
                  "number_of_whitespaces": 776,
                  "number_of_words": 204,
                  "possible_passwords": [],
                  "programming_language": "Python",
               },
               "children": []
            }
         }
      ]
   }
}

Example Queries​

object_type == "Tar"
  && @count_children() == 1
  && @has_child(
       object_type == "Text"
       && @match_object_meta($programming_language == "Python")
     )
  • This matches a Tar object, which only embeds one Text object, which was identified to contain a Python code.

Configuration Options​

  • max_processed_size → maximum size of the input object that will be processed (default: 262144000)
  • max_children → maximum number of children objects to create (default: 100)
  • max_child_input_size → maximum size of a single input children object (default: 41943040)
  • max_child_output_size → maximum size of a single output children object (default: 41943040)