xref: /aosp_15_r20/external/libpcap/CONTRIBUTING.md (revision 8b26181f966a6af5cf6981a6f474313de533bb28)
1*8b26181fSAndroid Build Coastguard WorkerGuidelines for contributing
2*8b26181fSAndroid Build Coastguard Worker===========================
3*8b26181fSAndroid Build Coastguard Worker
4*8b26181fSAndroid Build Coastguard WorkerTo report a security issue (segfault, buffer overflow, infinite loop, arbitrary
5*8b26181fSAndroid Build Coastguard Workercode execution etc) please send an e-mail to [email protected], do not use
6*8b26181fSAndroid Build Coastguard Workerthe bug tracker!
7*8b26181fSAndroid Build Coastguard Worker
8*8b26181fSAndroid Build Coastguard WorkerTo report a non-security problem (failure to compile, failure to capture packets
9*8b26181fSAndroid Build Coastguard Workerproperly, missing support for a network interface type or DLT) please check
10*8b26181fSAndroid Build Coastguard Workerfirst that it reproduces with the latest stable release of libpcap. If it does,
11*8b26181fSAndroid Build Coastguard Workerplease check that the problem reproduces with the current git master branch of
12*8b26181fSAndroid Build Coastguard Workerlibpcap. If it does (and it is not a security-related problem, otherwise see
13*8b26181fSAndroid Build Coastguard Workerabove), please navigate to https://github.com/the-tcpdump-group/libpcap/issues
14*8b26181fSAndroid Build Coastguard Workerand check if the problem has already been reported. If it has not, please open
15*8b26181fSAndroid Build Coastguard Workera new issue and provide the following details:
16*8b26181fSAndroid Build Coastguard Worker
17*8b26181fSAndroid Build Coastguard Worker* libpcap version (e.g. from `tcpdump --version`)
18*8b26181fSAndroid Build Coastguard Worker* operating system name and version and any other details that may be relevant
19*8b26181fSAndroid Build Coastguard Worker  (`uname -a`, compiler name and version, CPU type etc.)
20*8b26181fSAndroid Build Coastguard Worker* `configure` or `cmake` flags if any were used
21*8b26181fSAndroid Build Coastguard Worker* statement of the problem
22*8b26181fSAndroid Build Coastguard Worker* steps to reproduce
23*8b26181fSAndroid Build Coastguard Worker
24*8b26181fSAndroid Build Coastguard WorkerPlease note that if you know exactly how to solve the problem and the solution
25*8b26181fSAndroid Build Coastguard Workerwould not be too intrusive, it would be best to contribute some development time
26*8b26181fSAndroid Build Coastguard Workerand open a pull request instead.
27*8b26181fSAndroid Build Coastguard Worker
28*8b26181fSAndroid Build Coastguard WorkerStill not sure how to do? Feel free to [subscribe](https://www.tcpdump.org/#mailing-lists)
29*8b26181fSAndroid Build Coastguard Workerto the mailing list [email protected] and ask!
30