network-3.2.7.0: CHANGELOG.md

## Version 3.2.7.0

* Using nested `bracket` for `gracefulClose`.
  [#591](https://github.com/haskell/network/issues/590)
* Fix memory leak in getaddrinfo and make it async exception safe.
  [#591](https://github.com/haskell/network/pull/591)
* Make call to c_free async exception safe.
  [#592](https://github.com/haskell/network/pull/592)

## Version 3.2.6.0

* fixing the Show instance of IPv4-mapped IPv6 address on little endian machines

## Version 3.2.5.0

* `gracefulClose` based on STM racing and `timeout`.
  [#587](https://github.com/haskell/network/issues/587)

## Version 3.2.4.0

* New API: setSockOptValue.
  [#588](https://github.com/haskell/network/issues/588)

## Version 3.2.3.0

* Making getAddrInfo polymorphic
  [#587](https://github.com/haskell/network/issues/587)

## Version 3.2.2.0

* New API: waitReadSocketSTM, waitAndCancelReadSocketSTM,
  waitWriteSocketSTM, waitAndCancelWriteSocketSTM
  [#586](https://github.com/haskell/network/issues/586)
* Checking the length of ASCII string allowing trailing 0.
  [#585](https://github.com/haskell/network/issues/585)

## Version 3.2.1.0

* Trying to release with the latest autoreconf.
  Packing "network" in the local directory instead of CI.
* Remove includes from .cabal-file
  [#583](https://github.com/haskell/network/issues/583)
* making gracefulClose more graceful
  [#580](https://github.com/haskell/network/issues/580)
* Update config.guess, config.sub to their latest versions
  [#579](https://github.com/haskell/network/issues/579)

## Version 3.2.0.0

* Breaking change: Using Strict and StrictData.
* Breaking change: Allow a control message to contain multiple file descriptors
  [#567](https://github.com/haskell/network/issues/567)
* Breaking change: CmsgIdFd -> CmsgIdFds
  [#575](https://github.com/haskell/network/issues/575)
* SocketTypes: use UnsupportedSocketType instead of -1.
  [#560](https://github.com/haskell/network/issues/560)
* Expose NullSockAddr, add send-with-fds functions.
  [#562](https://github.com/haskell/network/issues/562)
* Allow bytestring-0.12 and replace deprecated memcpy by copyBytes.
  [#564](https://github.com/haskell/network/issues/564)
* Close file descriptor in accept when exception happens
  [#569](https://github.com/haskell/network/issues/569)
* Bump CI to GHC 9.8 and latest versions of actions
  [#573](https://github.com/haskell/network/issues/573)

## Version 3.1.5.0

* [#541](https://github.com/haskell/network/issues/541)
  * Export `Network.Socket.Internal.NullSockAddr`
  * Add `Network.Socket.ByteString.sendManyWithFds`
  * Add `Network.Socket.ByteString.Lazy.sendWithFds`

## Version 3.1.4.0

* Install and use afunix_compat.h header.
  [#556](https://github.com/haskell/network/pull/556)
* Supporting SO_SNDTIMEO and SO_RCVTIMEO.
  [#555](https://github.com/haskell/network/pull/555)
* Emulating socketPair on Windows.
  [#554](https://github.com/haskell/network/pull/554)

## Version 3.1.3.0

* Supporting AF_UNIX on Windows
  [#553](https://github.com/haskell/network/issues/553)

## Version 3.1.2.9

* Resolving the runtime linker problem on Windows.
  [#552](https://github.com/haskell/network/issues/552)

## Version 3.1.2.8

* Ignoring error from shutdown in gracefulClose
* Fix bitsize of some msghdr and cmsghdr fields on Linux
  [#535](https://github.com/haskell/network/issues/535)
* Add SO_ACCEPTCONN SocketOption
  [#524](https://github.com/haskell/network/issues/524)

## Version 3.1.2.7

* No change from 3.1.2.6 but to take a right procedure to upload "network"
  to Hackage for Windows.

## Version 3.1.2.6

* Making IPv4PktInfo on Win the same as that on Posix
  [#522](https://github.com/haskell/network/issues/522)
* Add support for nix/ghcjs
  [#517](https://github.com/haskell/network/issues/517)

## Version 3.1.2.5

* Regenerate `configure` script with autoconf-2.69 to temporarily fix broken cabal-3.4.0.0 on Windows. Note that the old one was generated with autoconf-2.71.
  [#513](https://github.com/haskell/network/issues/513)

## Version 3.1.2.3

* Supporting M1 Mac
  [#510](https://github.com/haskell/network/pull/510)
* Workaround for autoconf on Windows
  [#508](https://github.com/haskell/network/pull/508)
* Fixing building failure on SmartOS
  [#507](https://github.com/haskell/network/pull/507)
* HsNet.h: remove unused fn hsnet_inet_ntoa definition
  [#504](https://github.com/haskell/network/pull/504)
* Use a working define for OpenBSD detection
  [#503](https://github.com/haskell/network/pull/503)

## Version 3.1.2.2

* Allow bytestring 0.11
  [#490](https://github.com/haskell/network/pull/490)
* Export StructLinger
  [#491](https://github.com/haskell/network/pull/491)
* Fix a couple of broken tests on OpenBSD
  [#498](https://github.com/haskell/network/pull/498)

## Version 3.1.2.1

* Increasing base lower bound to 4.9.
  [#473](https://github.com/haskell/network/pull/473)
* Suppressing errors from removeFile in UNIX bind.
  [#478](https://github.com/haskell/network/pull/478)
* Restoring UNIX stub functions on Windows.
  [#489](https://github.com/haskell/network/pull/489)

## Version 3.1.2.0

* Added `-f devel` for test cases that are known to fail.
  [#471](https://github.com/haskell/network/pull/471)
* Improved precedence-compliant Read/Show instances. Verified via QuickCheck.
  [#465](https://github.com/haskell/network/pull/465)
  [#466](https://github.com/haskell/network/pull/466)
* Removed the racing graceful close implementation to avoid issues with `CLOSE_WAIT`.
  [#460](https://github.com/haskell/network/pull/438)
* Gracefully handle binding of UNIX domain sockets.
  [#460](https://github.com/haskell/network/pull/460)
* Replace Socket type and family with extensible `CInt` pattern and synonyms.
  [#459](https://github.com/haskell/network/pull/459)
* Fixed race conditions in tests.
  [#458](https://github.com/haskell/network/pull/458)
* Removed many legacy uses of `undefined`.
  [#456](https://github.com/haskell/network/pull/456)
* Defined extensible `CustomSockOpt` via `ViewPatterns`.
  [#455](https://github.com/haskell/network/pull/455)
* Defined `openSocket` in terms of `AddrInfo`.
  [5b0987197fe2ed7beddd7b2096522d624e71151e](https://github.com/haskell/network/commit/5b0987197fe2ed7beddd7b2096522d624e71151e)
* Improved FreeBSD portability for Control Messages and tests
  [#452](https://github.com/haskell/network/pull/452)
* Support `sendMsg` and `recvMsg`
  [#433](https://github.com/haskell/network/pull/433)
  [#445](https://github.com/haskell/network/pull/445)
  [#451](https://github.com/haskell/network/pull/451)
    * Added `sendMsg` and `recvMsg` APIs
    * Redefined `SocketOption` as pattern synonym
* Implement total Show functions for SockAddr
  [#441](https://github.com/haskell/network/pull/441)
* Improve portability changing `u_int32_t` to `uint32_t`.
  [#442](https://github.com/haskell/network/pull/442)
* Removed obsolete CPP statements.
  [d1f4ee60ce6a4a85abb79532f64d4a4e71e2b1ce](https://github.com/haskell/network/commit/d1f4ee60ce6a4a85abb79532f64d4a4e71e2b1ce)
* Loads of improved test coverage.
  [cbd67cc50a37770432eb978ac8b8eb6da3664817](https://github.com/haskell/network/commit/cbd67cc50a37770432eb978ac8b8eb6da3664817)
  [fcc2d86d53a6bec793f6a979a9e8fdf7fe3f4c22](https://github.com/haskell/network/commit/fcc2d86d53a6bec793f6a979a9e8fdf7fe3f4c22)
  [6db96969b3e8974abbfd50a7f073baa57376fd5e](https://github.com/haskell/network/commit/6db96969b3e8974abbfd50a7f073baa57376fd5e)

## Version 3.1.1.1

* Fix for GHCJS.
  [#431](https://github.com/haskell/network/pull/431)

## Version 3.1.1.0

* A new API: `gracefulClose`.
  [#417](https://github.com/haskell/network/pull/417)
* `touchSocket`, `unsafeFdSocket`: Allow direct access to a socket's file
  descriptor while providing tools to prevent it from being garbage collected.
  This also deprecated `fdSocket` in favor of `unsafeFdSocket` and
  `withFdSocket`.
  [#423](https://github.com/haskell/network/pull/423)
* `socketToFd`: Duplicates a socket as a file desriptor and closes the source
  socket.
  [#424](https://github.com/haskell/network/pull/424)

## Version 3.1.0.1

* getAddrInfo: raise exception if no AddrInfo returned.
  [#410](https://github.com/haskell/network/pull/410)
* Avoid catching SomeException.
  [#411](https://github.com/haskell/network/pull/411)

## Version 3.1.0.0

* Making GC of socket safer.
  [#399](https://github.com/haskell/network/pull/399)
* Deprecating fdSocket. Use withFdSocket instead to ensure
  that sockets are GCed in proper time.
  [#399](https://github.com/haskell/network/pull/399)

## Version 3.0.1.1

* Fix blocking `if_nametoindex` errors on Windows
  [#391](https://github.com/haskell/network/pull/391)

## Version 3.0.1.0

* Added `getSocketType :: Socket -> IO SocketType`.
  [#372](https://github.com/haskell/network/pull/372)
* Correcting manual and brushing up test cases
  [#375](https://github.com/haskell/network/pull/375)
* Fixed longstanded bug in `getContents` on mac
  [#375](https://github.com/haskell/network/pull/375)
* Fixing regression: set correct sockaddr length for abstract addresses
  for Linux.
  [#374](https://github.com/haskell/network/pull/374)

## Version 3.0.0.1

* Fixed a bug in `connect` where exceptions were not thrown
  [#368](https://github.com/haskell/network/pull/368)

## Version 3.0.0.0

* Breaking change: the Network and Network.BSD are removed.
  Network.BSD is provided a new package: network-bsd.
* Breaking change: the signatures are changed:
```
old fdSocket :: Socket -> CInt
new fdSocket :: Socket -> IO CInt

old mkSocket :: CInt -> Family -> SocketType -> ProtocolNumber -> SocketStatus -> IO Socket
new mkSocket :: CInt -> IO Socket
```
* Breaking change: the deprecated APIs are removed: send, sendTo, recv, recvFrom, recvLen, htonl, ntohl, inet_addr, int_ntoa, bindSocket, sClose, SocketStatus, isConnected, isBound, isListening, isReadable, isWritable, sIsConnected, sIsBound, sIsListening, sIsReadable, sIsWritable, aNY_PORT, iNADDR_ANY, iN6ADDR_ANY, sOMAXCONN, sOL_SOCKET, sCM_RIGHTS, packSocketType, getPeerCred.
* Breaking change: SockAddrCan is removed from SockAddr.
* Socket addresses are extendable with Network.Socket.Address.
* "socket" is now asynchronous-exception-safe.
  [#336](https://github.com/haskell/network/pull/336)
* "recvFrom" returns (0, addr) instead of throwing an error on EOF.
  [#360](https://github.com/haskell/network/pull/360)
* All APIs are available on any platforms.
* Build system is simplified.
* Bug fixes.

## Version 2.8.0.1

* Eensuring that accept returns a correct sockaddr for unix domain.
  [#400](https://github.com/haskell/network/pull/400)
* Avoid out of bounds writes in pokeSockAddr.
  [#400](https://github.com/haskell/network/pull/400)

## Version 2.8.0.0

* Breaking change: PortNumber originally contained Word16 in network
  byte order and used "deriving Ord". This results in strange behavior
  on the Ord instance. Now PortNumber holds Word16 in host byte order.
  [#347](https://github.com/haskell/network/pull/347)
* Breaking change: stopping the export of the PortNum constructor in
  PortNumber.
* Use bytestring == 0.10.* only.
* Use base >= 4.7 && < 5.

## Version 2.7.0.2

* Removing withMVar to avoid the deadlock between "accept" and "close"
   [#330](https://github.com/haskell/network/pull/330)
* "close" does not throw exceptions. A new API: "close'" throws
   exceptions when necessary.
   [#337](https://github.com/haskell/network/pull/337)
* Fixing the hang of lazy sendAll.
   [#340](https://github.com/haskell/network/pull/340)
* Installing NetDef.h (#334)
   [#334](https://github.com/haskell/network/pull/334)

## Version 2.7.0.1

 * A new API: socketPortSafe.
   [#319](https://github.com/haskell/network/pull/319)
 * Fixing a drain bug of sendAll.
   [#320](https://github.com/haskell/network/pull/320)
 * Porting the new CALLCONV convention from master.
   [#313](https://github.com/haskell/network/pull/313)
 * Withdrawing the deprecations of packFamily and unpackFamily.
   [#324](https://github.com/haskell/network/pull/324)

## Version 2.7.0.0

 * Obsoleting the Network module.
 * Obsoleting the Network.BSD module.
 * Obsoleting APIs: MkSocket, htonl, ntohl,
              getPeerCred, getPeerEid,
              send, sendTo, recv, recvFrom, recvLen,
              inet_addr, inet_ntoa,
              isConnected, isBound, isListening, isReadable, isWritable,
              aNY_PORT, iNADDR_ANY, iN6ADDR_ANY, sOMAXCONN,
              sOL_SOCKET, sCM_RIGHTS,
              packFamily, unpackFamily, packSocketType
 * Breaking change: do not closeFd within sendFd.
   [#271](https://github.com/haskell/network/pull/271)
 * Exporting ifNameToIndex and ifIndexToName from Network.Socket.
 * New APIs: setCloseOnExecIfNeeded, getCloseOnExec and getNonBlock
 * New APIs: isUnixDomainSocketAvailable and getPeerCredential
 * socketPair, sendFd and recvFd are exported even on Windows.

## Version 2.6.3.5

 * Reverting "Do not closeFd within sendFd"
   [#271](https://github.com/haskell/network/pull/271)

## Version 2.6.3.4

 * Don't touch IPv6Only when running on OpenBSD
   [#227](https://github.com/haskell/network/pull/227)
 * Do not closeFd within sendFd
   [#271](https://github.com/haskell/network/pull/271)
 * Updating examples and docs.

## Version 2.6.3.3

 * Adds a function to show the defaultHints without reading their undefined fields
   [#291](https://github.com/haskell/network/pull/292)
 * Improve exception error messages for getAddrInfo and getNameInfo
   [#289](https://github.com/haskell/network/pull/289)

## Version 2.6.3.2

 * Zero memory of `sockaddr_un` if abstract socket
   [#220](https://github.com/haskell/network/pull/220)

 * Improving error messages
   [#232](https://github.com/haskell/network/pull/232)

 * Allow non-blocking file descriptors via `setNonBlockIfNeeded`
   [#242](https://github.com/haskell/network/pull/242)

 * Update config.{guess,sub} to latest version
   [#244](https://github.com/haskell/network/pull/244)

 * Rename `my_inet_ntoa` to avoid symbol conflicts
   [#228](https://github.com/haskell/network/pull/228)

 * Test infrastructure improvements
   [#219](https://github.com/haskell/network/pull/219)
   [#217](https://github.com/haskell/network/pull/217)
   [#218](https://github.com/haskell/network/pull/218)

 * House keeping and cleanup
   [#238](https://github.com/haskell/network/pull/238)
   [#237](https://github.com/haskell/network/pull/237)

## Version 2.6.3.1

 * Reverse breaking exception change in `Network.Socket.ByteString.recv`
   [#215](https://github.com/haskell/network/issues/215)

## Version 2.6.3.0

 * New maintainers: Evan Borden (@eborden) and Kazu Yamamoto (@kazu-yamamoto).
   The maintainer for a long period, Johan Tibell (@tibbe) stepped down.
   Thank you, Johan, for your hard work for a long time.

 * New APIs: ntohl, htonl,hostAddressToTuple{,6} and tupleToHostAddress{,6}.
   [#210](https://github.com/haskell/network/pull/210)

 * Added a Read instance for PortNumber. [#145](https://github.com/haskell/network/pull/145)

 * We only set the IPV6_V6ONLY flag to 0 for stream and datagram socket types,
   as opposed to all of them. This makes it possible to use ICMPv6.
   [#180](https://github.com/haskell/network/pull/180)
   [#181](https://github.com/haskell/network/pull/181)

 * Work around GHC bug #12020. Socket errors no longer cause segfaults or
   hangs on Windows. [#192](https://github.com/haskell/network/pull/192)

 * Various documentation improvements and the deprecated pragmas.
   [#186](https://github.com/haskell/network/pull/186)
   [#201](https://github.com/haskell/network/issues/201)
   [#205](https://github.com/haskell/network/pull/205)
   [#206](https://github.com/haskell/network/pull/206)
   [#211](https://github.com/haskell/network/issues/211)

 * Various internal improvements.
   [#193](https://github.com/haskell/network/pull/193)
   [#200](https://github.com/haskell/network/pull/200)

## Version 2.6.2.1

 * Regenerate configure and `HsNetworkConfig.h.in`.

 * Better detection of CAN sockets.

## Version 2.6.2.0

 * Add support for `TCP_USER_TIMEOUT`.

 * Don't conditionally export the `SockAddr` constructors.

 * Add `isSupportSockAddr` to allow checking for supported address types
   at runtime.