Low-level networking interface.

This package provides a low-level networking interface.

High-Level Packages

Other packages provide higher level interfaces:

• connection

• hookup

• network-simple

Extended Packages

network seeks to provide a cross-platform core for networking. As such some APIs live in extended libraries. Packages in the network ecosystem are often prefixed with network-.

network-bsd

In network-3.0.0.0 the Network.BSD module was split off into its own package, network-bsd-3.0.0.0.

network-uri

In network-2.6 the Network.URI module was split off into its own package, network-uri-2.6. If you're using the Network.URI module you can automatically get it from the right package by adding this to your .cabal file:

library
  build-depends: network-uri-flag

network

To build this package directly from git, you must run autoreconf -i. And then use cabal configure; cabal build or stack build.

Support Policy

GHC

The network package support 3 major versions of GHC only. This means that the current stable version and two previous stable versions are supported. However, all GHC 8.x are supported currently.

Windows

We use MSYS to build this package on Windows. To use the network package on Cygwin, use stack.

Coding

.hs files

If you need C macros created by "configure" or CALLCONV/SAFE_ON_WIN, put

#include "HsNetDef.h"

"HsNet.h" does now work well since Mac's cpp sucks.

.hsc files

If you need #peek, #poke and others, create a .hsc file with

#include "HsNet.h"

HsNet.h includes HsNefDef.h and necessary C structures. Unfortunately, hsc2hs does not convert C macros. So, if you use CALLCONV/SAFE_ON_WIN, the following is also necessary:

##include "HsNetDef.h"

Milestones

2.6

• [x] Making SockAddrCan deprecated

2.7

See https://github.com/haskell/network/issues/296

• [x] Making Network deprecated
• [x] Making Network.BSD deprecated
• [x] Making MkSocket deprecated
• [x] Making many APIs deprecated

2.8

• [x] Stop exporting the PortNum Constructor in PortNumber

3.0

• [x] Removing Network
• [x] Removing Network.BSD
• [x] Removing SockAddrCan
• [x] Changing the internal structure of Socket.
• [x] Make address extensible.
• [x] Remove EOF errors.