{"id":13792640,"url":"https://github.com/tarantool/tarantool-dissector","last_synced_at":"2025-05-12T14:31:56.360Z","repository":{"id":44458623,"uuid":"438723187","full_name":"tarantool/tarantool-dissector","owner":"tarantool","description":"Wireshark's dissector for the Tarantool's protocol","archived":false,"fork":true,"pushed_at":"2024-07-01T10:37:43.000Z","size":154,"stargazers_count":6,"open_issues_count":4,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-22T18:05:13.570Z","etag":null,"topics":["dissector","tarantool","wireshark","wireshark-dissector"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"mikhainin/tarantool-dissector","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tarantool.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-15T17:54:08.000Z","updated_at":"2023-07-25T10:33:47.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tarantool/tarantool-dissector","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarantool%2Ftarantool-dissector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarantool%2Ftarantool-dissector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarantool%2Ftarantool-dissector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarantool%2Ftarantool-dissector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tarantool","download_url":"https://codeload.github.com/tarantool/tarantool-dissector/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253754967,"owners_count":21958934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dissector","tarantool","wireshark","wireshark-dissector"],"created_at":"2024-08-03T22:01:14.606Z","updated_at":"2025-05-12T14:31:56.037Z","avatar_url":"https://github.com/tarantool.png","language":null,"funding_links":[],"categories":["Packages"],"sub_categories":["Administration"],"readme":"## Tarantool protocol dissector\n\n[Tarantool](https://www.tarantool.io/en/) is an in-memory computing platform.\nIt uses binary protocol named IProto for communicating. See protocol\ndescription in [documentation][box-protocol].\n\nIn Wireshark the user can control how protocols are dissected. Each protocol\nhas its own dissector and user may add his own dissectors written in Lua. This\ndissector implemented for Tarantool binary protocol.\n\n![Wireshark][screenshot]\n\n### How to use\n\n- Setup Wireshark. See chapter [Building and Installing\n  Wireshark][building-and-installing-wireshark] in documentation.\n- Put a Lua file with dissector and `MessagePack.lua` to a directory with\n  plugins for Wireshark, directory depends on operating system, please refer to\n  chapter [Plugin folders][plugin-folders].\n  Note that Wireshark requires root privileges, make sure you are using plugin\n  directory for a user that is used for running Wireshark. It possible to run\n  Wireshark in terminal and pass Lua extension explicitly: `wireshark -X\n  lua_script:tarantool.dissector.lua` or `tshark -X\n  lua_script:tarantool.dissector.lua -V`.\n- If for some reason you still use Tarantool \u003c= 1.5, use `tarantool15.dissector.lua`\n- Run Wireshark. By default Tarantool protocol dissector decodes TCP packets\n  with port 3301. However one can change a port for dissector in Wireshark\n  settings, see chapter [Control Protocol dissection][control-protocol-dissection].\n\n### How to test\n\nThere is a script `test.lua` that uses Tarantool instance remotely via network\nand covers most part of IProto commands. For testing one can run Wireshark on\nlocal interface `lo0` with filtering by port 3301 and run script with command\n`tarantool test.lua`.\n\n[box-protocol]: https://www.tarantool.io/en/doc/latest/dev_guide/internals/box_protocol/\n[screenshot]: screenshot.png\n[building-and-installing-wireshark]: https://www.wireshark.org/docs/wsug_html_chunked/ChapterBuildInstall.html\n[plugin-folders]: https://www.wireshark.org/docs/wsug_html_chunked/ChPluginFolders.html\n[control-protocol-dissection]: https://www.wireshark.org/docs/wsug_html_chunked/ChCustProtocolDissectionSection.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftarantool%2Ftarantool-dissector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftarantool%2Ftarantool-dissector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftarantool%2Ftarantool-dissector/lists"}