Skip to content

Latest commit

 

History

History
445 lines (351 loc) · 19.6 KB

CHANGES.md

File metadata and controls

445 lines (351 loc) · 19.6 KB
Raw

Future

New Features

  • PR#216: Add support for GTP Extension PDU Session Container.

Bug Fixes

Other Changes

Release 1.8.2 (17-Aug-2019)

New Features

Bug Fixes

  • Issues#228: Fix a bug where ArrayIndexOutOfBoundsException can be thrown during instantiating a PcapNetworkInterface that represents a NIF with Infiniband addresses.

Other Changes

Release 1.8.1 (30-May-2019)

New Features

Bug Fixes

  • Issues#225: Fix to avoid 'java.lang.NullPointerException: Attempt to invoke virtual method 'java.security.CodeSource java.security.ProtectionDomain.getCodeSource()' on a null object reference' with Android Java.

Other Changes

Release 1.8.0 (20-May-2019)

New Features

  • PR#208: Change the core module to use ServiceLoader to load a packet factory module.

  • pcap4j-core, pcap4j-packetfactory-static, and pcap4j-packetfactory-propertiesbased are now Java 9 modules with module-info.java. The module names are as follows:

    • pcap4j-core: org.pcap4j.core
    • pcap4j-packetfactory-static: org.pcap4j.packetfactory.statik
    • pcap4j-packetfactory-propertiesbased: org.pcap4j.packetfactory.propertiesbased

  • Pcap4J is now built with JDK 11.

Bug Fixes

Other Changes

Release 1.7.7 (21-Apr-2019)

New Features

  • Issues#210: findAllDevs(), getDevByAddress(), and getDevByName() of Pcaps are now thread-safe.

Bug Fixes

  • Issues#214: Fix a bug where ClassCastException is thrown when parsing a packet that contains IPv4-Mapped IPv6 Addresses.

Other Changes

Release 1.7.6 (24-Mar-2019)

New Features

Bug Fixes

  • Issues#209: SIGSEGV in finalizer for BpfProgram.

Other Changes

Release 1.7.5 (2-Jan-2019)

New Features

  • PR#196: add protocol implementations for 4 icmpv6 types (RFC6275).
  • PR#144: Generalize TcpPacket and UdpPacket to same abstract TransportPacket class.

Bug Fixes

  • Issues#200: Fix a bug that causes NullPointerException in DnsDomainName#toString(byte[]).

Other Changes

Release 1.7.4 (12-Nov-2018)

New Features

Bug Fixes

Other Changes

  • Issues#191: Change to use Native.POINTER_SIZE instead of Pointer.SIZE that is deprecated in JNA 5.

Release 1.7.3 (28-Dec-2017)

New Features

  • PR#127: Add support for setting immediate mode.
  • Add isUp() and isRunning() to PcapNetworkInterface.

Bug Fixes

Other Changes

Release 1.7.2 (30-Sep-2017)

New Features

  • PR#119: Add DNS CAA support (RFC6844).
  • Add Packets class, a utility class for operating on packets.

Bug Fixes

  • Issues#123: IllegalArgumentException occurs during dissecting a DNS packet including a resource record the RDLENGTH of which is zero.

Other Changes

Release 1.7.1 (4-June-2017)

New Features

  • Support DNS (RFC1035 and RFC3596)
  • PR#84: Support bpf applying. (Add BpfProgram#applyFilter().)
  • PR#89: Add PcapHandle#sendPacket(byte[] bytes, int len).
  • PR#102: PcapHandle and PcapDumper implement Closeable.

Bug Fixes

  • Issues#76: NullPointerException when dissecting an ICMP error packet.
  • Issues#80: Intermittent SIGSEGV in finalizer for BpfProgram.
  • Issues#88: pcap4-core and pcap4j-packetfactory-static both ship org.pcap4j.packet.factory.StaticUnknownPacketFactory
  • Issues#94: UdpPacket.hasValidChecksum is broken for checksum 0xFFFF.

Other Changes

  • PR#78 Issues#75: Change PropertiesLoader to log with INFO instead of WARN when it returns the default value.

Release 1.7.0 (23-Oct-2016)

New Features

  • Support IEEE 802.11 Probe Request.
  • IpV4Packet and IpV6Packet implement IpPacket interface.

Bug Fixes

Other Changes

  • Change a class name: org.pcap4j.packet.IpPacket -> org.pcap4j.packet.IpSelector

Release 1.6.6 (7-Sep-2016)

New Features

  • Support GTPv1 (only GTP-U and GTP-C header)
  • Support SCTP (only common header)

Bug Fixes

Other Changes

Release 1.6.5 (12-Aug-2016)

New Features

  • Support LLC and SNAP.
  • Support Radiotap.

Bug Fixes

  • Issues#64: JVM crash in the finalizer of BpfProgram.

Other Changes

Release 1.6.4 (13-May-2016)

New Features

  • Issues#61: Packet direction capture support

Bug Fixes

Other Changes

Release 1.6.3 (1-May-2016)

New Features

  • PR#53: Add PcapHandle.sendPacket(byte[]).

Bug Fixes

Other Changes

Release 1.6.2 (14-Dec-2015)

New Features

  • Issues#48: Add PcapHandle.getOriginalLength().
  • Issues#49: Mac address detection on Windows.

Bug Fixes

Other Changes

Release 1.6.1 (23-Sep-2015)

New Features

Bug Fixes

  • Issues#46: Fix a problem with openvpn's tun devices on FreeBSD.

Other Changes

Release 1.6.0 (1-Aug-2015)

New Features

  • New APIs:
    • Pcaps.openOffline(String filePath, TimestampPrecision precision)
    • Pcaps.openDead(DataLinkType dlt, int snaplen, TimestampPrecision precision)
    • PcapHandle.getTimestampPrecision()
    • PcapHandle.Builder.timestampPrecision(TimestampPrecision timestampPrecision)

Bug Fixes

  • Issues#42: Fix a problem where an IpV6Packet object with a high (>127) traffic class is incorrectly converted to a byte array.

Other Changes

  • API changes:
    • PcapHandle.getTimestampInts() & PcapHandle.getTimestampMicros() -> PcapHandle.getTimestamp()
    • PcapDumper.dump(Packet, long timestampSec, int timestampMicros) -> PcapDumper.dump(Packet packet, Timestamp timestamp)
    • PcapDumper.dumpRaw(byte[] packet, long timestampSec, int timestampMicros) -> PcapDumper.dumpRaw(byte[] packet, Timestamp timestamp)

Release 1.5.0 (1-Jun-2015)

New Features

  • Add BSD (Mac OS X) loopback encapsulation support.

Bug Fixes

  • Issues#34: Fix LinuxSllPacket so it can be built when the address length is 0.
  • Issues#37: Fix to properly handle pcap_address the addr field of which is null.
  • Issues#33: Re-fix it.
  • Issues#36: Fix to prevent callbacks throwing exceptions.

Other Changes

  • LinuxSllHeader API changes:

    • getHardwareType -> getAddressType
    • getHardwareLength -> getAddressLength
    • getHardwareLengthAsInt -> getAddressLengthAsInt

  • ArpHeader API changes:

    • getHardwareLength -> getHardwareAddrLength
    • getHardwareLengthAsInt -> getHardwareAddrLengthAsInt
    • getProtocolLength -> getProtocolAddrLength
    • getProtocolLengthAsInt -> getProtocolAddrLengthAsInt

  • Change serialization formats:

    • org.pcap4j.packet.LinuxSllPacket
    • org.pcap4j.packet.LinuxSllPacket.LinuxSllHeader
    • org.pcap4j.packet.ArpPacket
    • org.pcap4j.packet.ArpPacket.ArpHeader

Release 1.4.0 (29-Mar-2015)

New Features

  • Add PPP (RFC1661, RFC1662) support.
  • Issues#28: Support Linux cooked-mode capture (SLL).
  • Pluggability for FragmentedPacket and IpV6ExtUnknownPacket.
  • Add raw packet capture APIs:
    • byte[] org.pcap4j.core.PcapHandle.getNextRawPacket()
    • byte[] org.pcap4j.core.PcapHandle.getNextRawPacketEx()
    • void org.pcap4j.core.PcapHandle.loop(int, RawPacketListener)
    • void org.pcap4j.core.PcapHandle.loop(int, RawPacketListener, Executor)
    • int org.pcap4j.core.PcapHandle.dispatch(int, RawPacketListener)
    • int org.pcap4j.core.PcapHandle.dispatch(int, RawPacketListener, Executor)
    • void org.pcap4j.core.PcapDumper.dumpRaw(byte[])
    • void org.pcap4j.core.PcapDumper.dumpRaw(byte[], long, int)

Bug Fixes

  • Fix a typo (flagment -> fragment) in org.pcap4j.packet.IpV4Packet.
    • IpV4Header#getFlagmentOffset() -> IpV4Header#getFragmentOffset()
    • Builder#flagmentOffset -> Builder#fragmentOffset
    • Change the serialization format of IpV4Packet and IpV4Header.
  • Issues#31: Fix ByteArrays.calcChecksum() so it can accept odd length data.
  • Issues#33: Mutex PcapHandle.setFilter() and PcapHandle.compileFilter() to prevent JVM crash.

Other Changes

  • Property changes:

    • org.pcap4j.packet.Packet.classFor.unknownNumber -> org.pcap4j.packet.Packet.classFor.org.pcap4j.packet.namednumber.NotApplicable.0
    • org.pcap4j.packet.IpV6ExtOptionsPacket$IpV6Option.classFor.org.pcap4j.packet.namednumber.IpV6OptionType.0 -> org.pcap4j.packet.IpV6ExtOptionsPacket$IpV6Option.classFor.org.pcap4j.packet.namednumber.IpV6OptionType.0x00
    • org.pcap4j.packet.IpV6ExtOptionsPacket$IpV6Option.classFor.org.pcap4j.packet.namednumber.IpV6OptionType.1 -> org.pcap4j.packet.IpV6ExtOptionsPacket$IpV6Option.classFor.org.pcap4j.packet.namednumber.IpV6OptionType.0x01

  • Class name changes:

    • org.pcap4j.packet.namednumber.IpV6RoutingHeaderType -> org.pcap4j.packet.namednumber.IpV6RoutingType
    • org.pcap4j.packet.namednumber.IpV6OptionType.IpV6OptionTypeIdentifier -> org.pcap4j.packet.namednumber.IpV6OptionType.IpV6OptionTypeAction

  • Method name changes:

    • org.pcap4j.packet.namednumber.IpV6OptionType.optionDataIsChangable -> org.pcap4j.packet.namednumber.IpV6OptionType.optionDataMayChange
    • org.pcap4j.packet.namednumber.IpV6OptionType.getIdentifier -> org.pcap4j.packet.namednumber.IpV6OptionType.getAction

  • Change serialization formats:

    • org.pcap4j.packet.UnknownPacket
    • org.pcap4j.packet.FragmentedPacket
    • org.pcap4j.packet.IpV6ExtRoutingPacket
    • org.pcap4j.packet.IpV6ExtRoutingPacket.IpV6ExtRoutingHeader
    • org.pcap4j.packet.namednumber.IpV6OptionType

Release 1.3.0 (4-Oct-2014)

New Features

  • PR#23: Add support for a data link type DLT_RAW.

Bug Fixes

  • Issues#27: TCP timestamp options are not captured correctly.

Other Changes

  • Constructors and static factory methods of all packet classes and packet factory classes now have additional arguments offset and length to specify data range in rawData.

Release 1.2.3 (4-Aug-2014)

New Features

  • Optimize mutually exclusive executions of methods in PcapHandle and PcapDumper.
  • Improve performance of PcapHandle#getStats().

Bug Fixes

  • Fix a bug in PcapHandle#listDatalinks().

Other Changes

  • PcapHandle#breakLoop() now throws NotOpenException.

Release 1.2.2 (31-Jul-2014)

New Features

  • Improved performance of PcapHandle#loop(), PcapHandle#getNextPacket(), and PcapHandle#getNextPacketEx().

Bug Fixes

Other Changes

Release 1.2.1 (4-Jul-2014)

New Features

Bug Fixes

  • org.pcap4j.core.PcapStat#getNumPacketsCaptured() doesn't return a valid value even on Windows.

Other Changes

  • Change a method name from org.pcap4j.core.PcapHandle#getStat() to getStats().

Release 1.2.0 (16-May-2014)

New Features

  • Upgrade JNA to 4.10.
  • Issues#17: Add PcapHandle.Builder, which internally uses pcap_create, pcap_set_snaplen, pcap_set_promisc, pcap_set_rfmon, pcap_set_timeout, pcap_set_buffer_size, and pcap_activate.
  • Issues#15: TSO support.
  • Add getTargetClass(N number) and getTargetClass() to org.pcap4j.packet.factory.PacketFactory.
  • Support TCP Window Scale option, TCP Sack-Permitted option, TCP Sack option, and TCP Timestamps option.

Bug Fixes

  • Change required libpcap version from 0.9.3 to 1.0.0 to solve Issues#16.
  • Issues#14: Fix some getters of Inet4Address and Inet6Address which cause endless recursion --> stack overflow.
  • Issues#18: Fix a bug where freed pointer may be accessed.
  • Issues#21: Fix VLAN ID discovery by Dot1qVlanTagPacket class.

Other Changes

  • Required Java version changes from 5 to 6.
  • Change org.pcap4j.packet.IllegalRawDataException to checked exception.
  • Change serialization formats:
    • Change org.pcap4j.packet.IllegalRawDataException
  • Make compareTo methods of NamedNumber's subclasses more reasonable.

Release 1.1.0 (7-Mar-2014)

New Features

  • Issues#2: Add FreeBSD support.
  • Mac address discovery on Linux, Mac OS X, and FreeBSD.
  • Add properties; org.pcap4j.af.inet, org.pcap4j.af.inet6, org.pcap4j.af.packet and org.pcap4j.af.link to specify address family numbers.

Bug Fixes

  • Issues#11: Correct IP address discovery on Mac OS X.

Other Changes

  • Change org.pcap4j.packet.AbstractPacket.measureLength() to org.pcap4j.packet.AbstractPacket.calcLength()
  • Change org.pcap4j.packet.AbstractPacket.AbstractHeader.measureLength() to org.pcap4j.packet.AbstractPacket.AbstractHeader.calcLength()
  • Change the return value of org.pcap4j.util.PropertiesLoader#getInteger() from int to Integer.
  • Change serialization formats:
    • org.pcap4j.util.MacAddress

Release 1.0.0 (20-Jun-2013)

New Features

  • Add pcap APIs support: pcap_setnonblock, pcap_getnonblock, lookupNet, dispatch, pcap_compile_nopcap, pcap_compile, pcap_freecode, pcap_snapshot, pcap_is_swapped, pcap_major_version, pcap_minor_version, pcap_stats, pcap_dump_ftell, pcap_list_datalinks, pcap_free_datalinks, pcap_set_datalink, pcap_datalink_name_to_val, pcap_datalink_val_to_name, pcap_datalink_val_to_description, pcap_strerror, pcap_lib_version, pcap_dump_flush
  • Issues#10: Add Ubuntu support.
  • Add getReturnCode method to PcapNativeException.
  • Issues#3: Change to a multi-module project.

Bug Fixes

  • Fix org.pcap4j.packet.IpV6NeighborDiscoveryPrefixInformationOption#getRawData() to return correct prefixLength.
  • Fix invalid properties for IPv4 Internet TimestampOption.
  • Fix org.pcap4j.core.Pcaps.openDead() to return opened PcapHandle.

Other Changes

  • Modify org.pcap4j.core.PcapHandle and org.pcap4j.core.PcapDumper to throw NotOpenException instead of IllegalStateException.
  • Change a package of class: org.pcap4j.core.PcapHandle.BpfCompileMode -> org.pcap4j.core.BpfProgram.BpfCompileMode
  • Change class names:
    • org.pcap4j.packet.UnknownIpV4InternetTimestampData -> org.pcap4j.packet.UnknownIpV4InternetTimestampOptionData
    • org.pcap4j.packet.factory.PropertiesBasedIpV4InternetTimestampDataFactory -> org.pcap4j.packet.factory.PropertiesBasedIpV4InternetTimestampOptionDataFactory
  • Change method names:
    • org.pcap4j.core.Pcaps.getNifByName(String) -> org.pcap4j.core.Pcaps.getDevByName(String)
    • org.pcap4j.core.Pcaps.getNifByAddress(InetAddress) -> org.pcap4j.core.Pcaps.getDevByAddress(InetAddress)
  • Delete obsolete classes:
    • org.pcap4j.packet.factory.IpV4TosFactories
    • org.pcap4j.packet.factory.IpV4TosFactory
    • org.pcap4j.packet.factory.IpV6FlowLabelFactories
    • org.pcap4j.packet.factory.IpV6FlowLabelFactory
    • org.pcap4j.packet.factory.IpV6TrafficClassFactories
    • org.pcap4j.packet.factory.IpV6TrafficClassFactory
    • org.pcap4j.packet.factory.ClassifiedDataFactories
    • org.pcap4j.packet.factory.ClassifiedDataFactoriy

Release 0.9.15 (29-May-2013)

New Features

  • Add ICMPv6(RFC4443, RFC4861) support.

Bug Fixes

Other Changes

  • Change class names:
    • org.pcap4j.core.PcapIpv4Address -> org.pcap4j.core.PcapIpV4Address
    • org.pcap4j.core.PcapIpv6Address -> org.pcap4j.core.PcapIpV6Address
  • Change property names:
    • org.pcap4j.packet.icmpv4.calcChecksumAtBuild -> org.pcap4j.packet.icmpV4.calcChecksumAtBuild
    • org.pcap4j.packet.ipv4.calcChecksumAtBuild -> org.pcap4j.packet.ipV4.calcChecksumAtBuild
    • org.pcap4j.packet.tcpv4.calcChecksumAtBuild -> org.pcap4j.packet.tcpV4.calcChecksumAtBuild
    • org.pcap4j.packet.udpv4.calcChecksumAtBuild -> org.pcap4j.packet.udpV4.calcChecksumAtBuild
    • org.pcap4j.packet.tcpv6.calcChecksumAtBuild -> org.pcap4j.packet.tcpV6.calcChecksumAtBuild
    • org.pcap4j.packet.udpv6.calcChecksumAtBuild -> org.pcap4j.packet.udpV6.calcChecksumAtBuild
  • Change serialization formats:
    • org.pcap4j.packet.IcmpV4CommonPacket
    • org.pcap4j.packet.IcmpV4CommonPacket.IcmpV4CommonHeader
    • org.pcap4j.packet.IcmpV4DestinationUnreachablePacket
    • org.pcap4j.packet.IcmpV4DestinationUnreachablePacket.IcmpV4DestinationUnreachableHeader
    • org.pcap4j.packet.IcmpV4ParameterProblemPacket
    • org.pcap4j.packet.IcmpV4ParameterProblemPacket.IcmpV4ParameterProblemHeader
    • org.pcap4j.packet.IcmpV4RedirectPacket
    • org.pcap4j.packet.IcmpV4RedirectPacket.IcmpV4RedirectHeader
    • org.pcap4j.packet.IcmpV4SourceQuenchPacket
    • org.pcap4j.packet.IcmpV4SourceQuenchPacket.IcmpV4SourceQuenchHeader
    • org.pcap4j.packet.IcmpV4TimeExceededPacket
    • org.pcap4j.packet.IcmpV4TimeExceededPacket.IcmpV4TimeExceededHeader
  • Move invoking packet from header to payload:
    • org.pcap4j.packet.IcmpV4DestinationUnreachablePacket
    • org.pcap4j.packet.IcmpV4ParameterProblemPacket
    • org.pcap4j.packet.IcmpV4RedirectPacket
    • org.pcap4j.packet.IcmpV4SourceQuenchPacket
    • org.pcap4j.packet.IcmpV4TimeExceededPacket

Release 0.9.14 (13-Apr-2013)

New Features

  • The first release to the Maven Central Repository.
  • Issues#4: JNA 3.5+ Support. - @kaitoy

Bug Fixes