github.com/lukasa/gopcap

Parsing .pcap files for humans.


License
MIT
Install
go get github.com/lukasa/gopcap

Documentation

gopcap

gopcap is a pure Go implementation of the pcap file format. Pcap is the standard open-source packet capture format, and is defined by the libpcap C library.

Example

The gopcap API is incredibly simple:

pcapfile, _ := os.Open("file.cap")
parsed, err := gopcap.Parse(pcapfile)

For further examples, see the API documentation.

Features

  • Fully synchronous API that is easy to make asynchronous.
  • Efficient with memory use.
  • No external dependencies.

Contributing

gopcap welcomes contributions, both bug fixes and new features (though the opportunity for new features is obviously fairly limited!). Any feature request should strongly consider the implications for the API. API clarity is valued above new features, so any feature that complicates the API must add significant value to the library to be accepted.

If you'd like to contribute, do the following:

  1. Check that your idea hasn't been proposed already, by checking both open and closed issues on GitHub.
  2. Fork the repository from GitHub and make your changes.
  3. Where possible, write a test that reproduces the bug and check that it passes after your changes have been made.
  4. Send a Pull Request. Don't forget to add yourself to the AUTHORS file.

 License

This PCAP parsing library is available under the MIT license. You are free to use this library, copy it, modify it, publish it, sell it, whatever. For more information see the enclosed LICENSE file.