The ASP.NET Core Kestrel webserver has been using libuv as a cross-platform network library. It is possible to replace libuv with another implementation thanks to the Transport abstraction.

In this repo we explore creating a Transport for Linux specifically.

Add the myget feed to your NuGet.Config file:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="rh" value="https://www.myget.org/F/redhat-dotnet/api/v3/index.json" />
  </packageSources>
</configuration>

Include a package reference in your project csproj file:

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.All" Version="2.1.0-*" />
    <PackageReference Include="RedHatX.AspNetCore.Server.Kestrel.Transport.Linux" Version="2.1.0-*" />
  </ItemGroup>

Call UseLinuxTransport when creating the WebHost in your Program.cs:

public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseLinuxTransport()
                .UseStartup<Startup>()
                .Build();

note: It's safe to call UseLinuxTransport on non-Linux platforms, it will no-op.

There are 5 projects in this repository:

• src/RedHatX.AspNetCore.Server.Kestrel.Transport.Linux: managed library implementing Transport
• src/RedHatX.AspNetCore.Server.Kestrel.Transport.Linux.Native: native library used by managed library
• samples/KestrelSample: Kestrel app for benchmarking
• test/RedHatX.AspNetCore.Server.Kestrel.Transport.Linux.Test: xunit test projects, has access to internals of managed library
• test/RedHatX.AspNetCore.Server.Kestrel.Transport.Linux.TestApp: empty application to use during development, has access to internals of managed library

The library can be packaged by running the dotnet pack on src/RedHatX.AspNetCore.Server.Kestrel.Transport.Linux.

$ dotnet pack src/RedHatX.AspNetCore.Server.Kestrel.Transport.Linux --configuration Release

To build the library and run the tests execute dotnet test on test/RedHatX.AspNetCore.Server.Kestrel.Transport.Linux.Test.

$ dotnet test test/RedHatX.AspNetCore.Server.Kestrel.Transport.Linux.Test

Similar to other implementations, this library makes use of the non-blocking socket and epoll. Like the corefx Socket implementation, the eventloop is implemented in managed (C#) code. This is different from the libuv loop which is part of the native libuv library.

This library does not provide a generic xplat network API. It uses the kernel primitives directly to implement the Transport API. This reduces the number of heap allocated objects (e.g. uv_buf_t, SocketAsyncEventArgs), which means there is less GC pressure. Implementations building on top of an xplat API will pool objects to achieve this.

The implementation starts a number of threads that each accept connections. This is based on SO_REUSEPORT socket option. This option allow multiple sockets to concurrently bind and listen to the same port. The kernel performs load-balancing between the listen sockets.

The Transport has these options:

• DeferSend: This defers sends to the Transport Thread which increases chances for multiple sends to coalesce. This options defaults to true.

• ThreadCount: Specifies the number of Transport Threads. This defaults to the number of logical processors in the system divided by 4.

• CheckAvailable: When set to true the Transport tries to read all available data. When set to false it reads 1 buffer at a time (page size, e.g. 4K). This defaults to true.

• AioSend/AioReceive: Uses Linux AIO system calls to batch send and receive calls. AioSend implies DeferSend. These options default to true.