Skip to content

Commit

Permalink
Add installation instructions plus license
Browse files Browse the repository at this point in the history
  • Loading branch information
andydavies committed Jan 7, 2013
1 parent 38f8b2b commit 966bc76
Show file tree
Hide file tree
Showing 2 changed files with 40 additions and 1 deletion.
18 changes: 17 additions & 1 deletion README.md
Expand Up @@ -6,9 +6,25 @@ Wireshark dissector for Safari Remote Debugging Protocol

Currently uses print so will only show packets in tshark

##Usage/Installation

###tshark

```tshark -X lua_script:bplist.lua -i lo0 -f "tcp port 27753" -O bplist -V```

###Wireshark

On OSX

Copy bplist.lua to ~/.wireshark

Add ```dofile(USER_DIR.."bplist.lua")``` to the end of ```/Applications/Wireshark.app/Contents/Resources/share/wireshark/init.lua```

##TODO

- Implement Sets, UTF16
- Format dates correctly
- Move port number into prefs?
- Tests
- Can tree be defaulted open?
~~- Display in Wireshark rather then relying on print!~~
- ~~ Display in Wireshark rather then relying on print!~~
23 changes: 23 additions & 0 deletions license.md
@@ -0,0 +1,23 @@
bplist.lua is released under GPL v3

Wireshark dissector for Apple bplist protocol used by Safari Remote Debugging

Copyright (C) 2013 Andy Davies (hello@andydavies.me)

Heavily influenced by
http://delog.wordpress.com/2010/09/27/create-a-wireshark-dissector-in-lua/
http://opensource.apple.com/source/CF/CF-550/CFBinaryPList.c
https://github.com/nearinfinity/node-bplist-parser
http://code.google.com/p/plist/

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

See http://www.gnu.org/licenses/ for more.

0 comments on commit 966bc76

Please sign in to comment.