Smdn.Net.AddressResolution version 1.0.0-rc1

Released package

• NuGet Smdn.Net.AddressResolution version 1.0.0-rc1

Release notes

The full release notes are available at gist.

Change log

Change log in this release:

• 2023-04-14 disable nullability warnings
• 2023-04-14 update package version
• 2023-04-14 update package tags
• 2023-04-14 improve log message
• 2023-04-14 add CanPerformNetworkScan and allow to provide no INetworkScanner
• 2023-04-14 update XML docs
• 2023-04-13 cleanup
• 2023-04-13 rename CommandNetworkScanner
• 2023-04-13 split into new namespaces Smdn.Net.AddressTables and Smdn.Net.NetworkScanning
• 2023-04-13 use the term of 'network scanner' instead of 'neighbor discoverer'
• 2023-04-13 use the term of 'address table' instead of 'neighbor table'
• 2023-04-13 add XML docs
• 2023-04-13 split impls into individual files
• 2023-04-12 add NeighborTableEntry.DefaultEqualityComparer and ExceptStateEqualityComparer
• 2023-04-12 include State for comparing equality
• 2023-04-12 fix not to include broadcast addresses
• 2023-04-12 add cancellation point
• 2023-04-12 commonize the duplicate codes for address resolution and make it extensible
• 2023-04-12 use Stopwatch instead of DateTime.Now to measure interval of neighbor discovery
• 2023-04-12 implement IEquatable<NeighborTableEntry> and its relevant members
• 2023-04-11 refactor
• 2023-04-11 add extension point for creating process from ProcessStartInfo
• 2023-04-11 apply filtering by network interface as a default filter predicate for EnumerateNeighborTableEntriesAsync
• 2023-04-11 make semaphore count for the partial scan configurable
• 2023-04-11 add MacAddressResolver.NeighborDiscoveryMinInterval
• 2023-04-11 return immediately if no addresses invalidated
• 2023-04-11 delete NullNeighborDiscoverer
• 2023-04-09 use IsEmpty instead of Any()
• 2023-04-09 add EnumerateNeighborTableEntriesAsync
• 2023-04-09 clarify parameter name
• 2023-04-09 log exception occured on SendPingAsync
• 2023-04-09 add cancellation point
• 2023-04-09 integrate properties representing the target interface
• 2023-04-09 improve network iface ID comparison on Windows
• 2023-04-09 improve filtering according to the network interface properties
• 2023-04-09 add support for filtering address resolition candidates
• 2023-04-09 improve log points
• 2023-04-09 override ToString()
• 2023-04-09 fix for net7.0
• 2023-04-09 fix not to throw exception from IsSupported properties
• 2023-04-08 use command-based INeighborDiscoverer's also on Windows if available
• 2023-04-08 prefer IPv4 addresses
• 2023-04-08 commonize exception messages
• 2023-04-07 add NeighborDiscoveryInterval property
• 2023-04-07 reorganize constructor parameters
• 2023-04-07 add PingNeighborDiscoverer
• 2023-04-07 make parameter non-nullable
• 2023-04-07 accept IServiceProvider instead of ILogger
• 2023-04-07 improve exception message
• 2023-04-07 make CancellationToken arguments optional
• 2023-04-07 make INeighborTable and INeighborDiscoverer disposable
• 2023-04-06 clean up
• 2023-04-06 fix usage of UnixFileMode
• 2023-04-06 reduce duplicate logging
• 2023-04-06 log actual type name of INeighborTable and INeighborDiscoverer passed to ctor
• 2023-04-06 add notnull constraints to type parameters
• 2023-04-06 clarify the exception to be thrown when parameter is required
• 2023-04-06 add constructor overloads
• 2023-04-06 fix XML docs

API changes

API changes in this release:

diff --git a/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-net6.0.apilist.cs b/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-net6.0.apilist.cs
index 5cc70d9..35a49a0 100644
--- a/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-net6.0.apilist.cs
+++ b/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-net6.0.apilist.cs
@@ -1,217 +1,261 @@
-// Smdn.Net.AddressResolution.dll (Smdn.Net.AddressResolution-1.0.0-preview6)
+// Smdn.Net.AddressResolution.dll (Smdn.Net.AddressResolution-1.0.0-rc1)
 //   Name: Smdn.Net.AddressResolution
 //   AssemblyVersion: 1.0.0.0
-//   InformationalVersion: 1.0.0-preview6+867630e3d8768ccca99d991e9c0c1cca62c64c76
+//   InformationalVersion: 1.0.0-rc1+54f2767c7798db11d76ae3836009b55f701af69f
 //   TargetFramework: .NETCoreApp,Version=v6.0
 //   Configuration: Release
 //   Referenced assemblies:
 //     Microsoft.Extensions.DependencyInjection.Abstractions, Version=6.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60
 //     Microsoft.Extensions.Logging.Abstractions, Version=6.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60
+//     System.Collections, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Collections.Concurrent, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.ComponentModel, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
+//     System.ComponentModel.Primitives, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Diagnostics.Process, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Linq, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Memory, Version=6.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
 //     System.Net.NetworkInformation, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
+//     System.Net.Ping, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Net.Primitives, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Runtime, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Runtime.InteropServices, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Runtime.InteropServices.RuntimeInformation, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Threading, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
-//     Vanara.Core, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     Vanara.PInvoke.IpHlpApi, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     Vanara.PInvoke.Shared, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     Vanara.PInvoke.Ws2_32, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 #nullable enable annotations
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
 using System.Net;
 using System.Net.NetworkInformation;
 using System.Runtime.CompilerServices;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.Extensions.Logging;
 using Smdn.Net;
 using Smdn.Net.AddressResolution;
-using Smdn.Net.NeighborDiscovery;
+using Smdn.Net.AddressTables;
+using Smdn.Net.NetworkScanning;
 
 namespace Smdn.Net {
   public abstract class IPNetworkProfile {
     public static IPNetworkProfile Create() {}
     public static IPNetworkProfile Create(Func<IEnumerable<IPAddress>?> addressRangeGenerator, NetworkInterface? networkInterface = null) {}
     public static IPNetworkProfile Create(IPAddress baseAddress, IPAddress subnetMask, NetworkInterface? networkInterface = null) {}
     public static IPNetworkProfile Create(IPAddress baseAddress, int prefixLength, NetworkInterface? networkInterface = null) {}
     public static IPNetworkProfile Create(NetworkInterface networkInterface) {}
-    public static IPNetworkProfile Create(Predicate<NetworkInterface> predicate) {}
+    public static IPNetworkProfile Create(Predicate<NetworkInterface> predicateForNetworkInterface) {}
 
     protected IPNetworkProfile(NetworkInterface? networkInterface) {}
 
     public NetworkInterface? NetworkInterface { get; }
 
     public abstract IEnumerable<IPAddress>? GetAddressRange();
   }
 
   public static class PhysicalAddressExtensions {
     public static string ToMacAddressString(this PhysicalAddress hardwareAddress, char delimiter = ':') {}
   }
 }
 
 namespace Smdn.Net.AddressResolution {
-  public interface IAddressResolver<TAddress, TResolvedAddress> {
+  public interface IAddressResolver<TAddress, TResolvedAddress> where TAddress : notnull where TResolvedAddress : notnull {
     void Invalidate(TAddress address);
-    ValueTask<TResolvedAddress> ResolveAsync(TAddress address, CancellationToken cancellationToken);
+    ValueTask<TResolvedAddress?> ResolveAsync(TAddress address, CancellationToken cancellationToken);
   }
 
   public class MacAddressResolver : MacAddressResolverBase {
-    protected MacAddressResolver(INeighborTable neighborTable, INeighborDiscoverer neighborDiscoverer, TimeSpan neighborDiscoveryInterval, ILogger? logger) {}
-    public MacAddressResolver(INeighborTable? neighborTable = null, INeighborDiscoverer? neighborDiscoverer = null, int neighborDiscoveryIntervalMilliseconds = -1, IServiceProvider? serviceProvider = null) {}
+    protected MacAddressResolver(IAddressTable addressTable, bool shouldDisposeAddressTable, INetworkScanner? networkScanner, bool shouldDisposeNetworkScanner, NetworkInterface? networkInterface, int maxParallelCountForRefreshInvalidatedCache, ILogger? logger) {}
+    public MacAddressResolver() {}
+    public MacAddressResolver(IAddressTable? addressTable, INetworkScanner? networkScanner, bool shouldDisposeAddressTable = false, bool shouldDisposeNetworkScanner = false, NetworkInterface? networkInterface = null, int maxParallelCountForRefreshInvalidatedCache = 3, IServiceProvider? serviceProvider = null) {}
     public MacAddressResolver(IPNetworkProfile? networkProfile, IServiceProvider? serviceProvider = null) {}
-    public MacAddressResolver(IPNetworkProfile? networkProfile, TimeSpan neighborDiscoveryInterval, IServiceProvider? serviceProvider = null) {}
-    public MacAddressResolver(TimeSpan neighborDiscoveryInterval, INeighborTable? neighborTable = null, INeighborDiscoverer? neighborDiscoverer = null, IServiceProvider? serviceProvider = null) {}
 
+    public bool CanPerformNetworkScan { get; }
     public override bool HasInvalidated { get; }
+    public TimeSpan NetworkScanInterval { get; set; }
+    public TimeSpan NetworkScanMinInterval { get; set; }
 
     protected override void Dispose(bool disposing) {}
+    public IAsyncEnumerable<AddressTableEntry> EnumerateAddressTableEntriesAsync(CancellationToken cancellationToken = default) {}
+    public IAsyncEnumerable<AddressTableEntry> EnumerateAddressTableEntriesAsync(Predicate<AddressTableEntry> predicate, CancellationToken cancellationToken = default) {}
     protected override void InvalidateCore(IPAddress ipAddress) {}
     protected override void InvalidateCore(PhysicalAddress macAddress) {}
     protected override ValueTask RefreshCacheAsyncCore(CancellationToken cancellationToken = default) {}
     protected override ValueTask RefreshInvalidatedCacheAsyncCore(CancellationToken cancellationToken = default) {}
     protected override async ValueTask<PhysicalAddress?> ResolveIPAddressToMacAddressAsyncCore(IPAddress ipAddress, CancellationToken cancellationToken) {}
     protected override async ValueTask<IPAddress?> ResolveMacAddressToIPAddressAsyncCore(PhysicalAddress macAddress, CancellationToken cancellationToken) {}
+    protected virtual async ValueTask<AddressTableEntry> SelectAddressTableEntryAsync(Predicate<AddressTableEntry> predicate, CancellationToken cancellationToken) {}
   }
 
   public abstract class MacAddressResolverBase :
     IAddressResolver<IPAddress, PhysicalAddress>,
     IAddressResolver<PhysicalAddress, IPAddress>,
     IDisposable
   {
     protected static PhysicalAddress AllZeroMacAddress { get; }
     public static MacAddressResolverBase Null { get; }
 
     protected MacAddressResolverBase(ILogger? logger = null) {}
 
     public abstract bool HasInvalidated { get; }
     protected ILogger? Logger { get; }
 
     protected virtual void Dispose(bool disposing) {}
     public void Dispose() {}
     public void Invalidate(IPAddress ipAddress) {}
     public void Invalidate(PhysicalAddress macAddress) {}
     protected abstract void InvalidateCore(IPAddress ipAddress);
     protected abstract void InvalidateCore(PhysicalAddress macAddress);
     public ValueTask RefreshCacheAsync(CancellationToken cancellationToken = default) {}
     protected virtual ValueTask RefreshCacheAsyncCore(CancellationToken cancellationToken) {}
     public ValueTask RefreshInvalidatedCacheAsync(CancellationToken cancellationToken = default) {}
     protected virtual ValueTask RefreshInvalidatedCacheAsyncCore(CancellationToken cancellationToken) {}
     public ValueTask<PhysicalAddress?> ResolveIPAddressToMacAddressAsync(IPAddress ipAddress, CancellationToken cancellationToken = default) {}
     protected abstract ValueTask<PhysicalAddress?> ResolveIPAddressToMacAddressAsyncCore(IPAddress ipAddress, CancellationToken cancellationToken);
     public ValueTask<IPAddress?> ResolveMacAddressToIPAddressAsync(PhysicalAddress macAddress, CancellationToken cancellationToken = default) {}
     protected abstract ValueTask<IPAddress?> ResolveMacAddressToIPAddressAsyncCore(PhysicalAddress macAddress, CancellationToken cancellationToken);
     void IAddressResolver<IPAddress, PhysicalAddress>.Invalidate(IPAddress address) {}
     ValueTask<PhysicalAddress?> IAddressResolver<IPAddress, PhysicalAddress>.ResolveAsync(IPAddress address, CancellationToken cancellationToken) {}
     void IAddressResolver<PhysicalAddress, IPAddress>.Invalidate(PhysicalAddress address) {}
     ValueTask<IPAddress?> IAddressResolver<PhysicalAddress, IPAddress>.ResolveAsync(PhysicalAddress address, CancellationToken cancellationToken) {}
     protected void ThrowIfDisposed() {}
   }
 }
 
-namespace Smdn.Net.NeighborDiscovery {
-  public interface INeighborDiscoverer {
-    ValueTask DiscoverAsync(CancellationToken cancellationToken);
-    ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken);
+namespace Smdn.Net.AddressTables {
+  public interface IAddressTable : IDisposable {
+    IAsyncEnumerable<AddressTableEntry> EnumerateEntriesAsync(CancellationToken cancellationToken);
   }
 
-  public interface INeighborTable {
-    IAsyncEnumerable<NeighborTableEntry> EnumerateEntriesAsync(CancellationToken cancellationToken);
-  }
-
-  public enum NeighborTableEntryState : int {
+  public enum AddressTableEntryState : int {
     Delay = 4,
     Incomplete = 1,
     None = 0,
     Probe = 5,
     Reachable = 2,
     Stale = 3,
   }
 
-  public sealed class ArpScanCommandNeighborDiscoverer : RunCommandNeighborDiscovererBase {
+  public sealed class IpHlpApiAddressTable : IAddressTable {
     public static bool IsSupported { get; }
 
-    public ArpScanCommandNeighborDiscoverer(IPNetworkProfile? networkProfile, IServiceProvider? serviceProvider) {}
+    public IpHlpApiAddressTable(IServiceProvider? serviceProvider = null) {}
 
-    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToDiscover, out string executable, out string arguments) {}
-    protected override bool GetCommandLineArguments(out string executable, out string arguments) {}
+    [AsyncIteratorStateMachine(typeof(IpHlpApiAddressTable.<EnumerateEntriesAsync>d__6))]
+    public IAsyncEnumerable<AddressTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
+    void IDisposable.Dispose() {}
   }
 
-  public sealed class IpHlpApiNeighborDiscoverer : INeighborDiscoverer {
-    public IpHlpApiNeighborDiscoverer(IPNetworkProfile networkProfile, ILogger? logger = null) {}
+  public sealed class ProcfsArpAddressTable : IAddressTable {
+    public static bool IsSupported { get; }
+
+    public ProcfsArpAddressTable(IServiceProvider? serviceProvider = null) {}
 
-    public ValueTask DiscoverAsync(CancellationToken cancellationToken = default) {}
-    public async ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
+    [AsyncIteratorStateMachine(typeof(ProcfsArpAddressTable.<EnumerateEntriesAsync>d__7))]
+    public IAsyncEnumerable<AddressTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
+    void IDisposable.Dispose() {}
   }
 
-  public sealed class IpHlpApiNeighborTable : INeighborTable {
-    public static bool IsSupported { get; }
+  public readonly struct AddressTableEntry :
+    IEquatable<AddressTableEntry>,
+    IEquatable<IPAddress>,
+    IEquatable<PhysicalAddress>
+  {
+    public static readonly AddressTableEntry Empty; // = "{IP=, MAC=(null), IsPermanent=False, State=None, Iface=}"
+
+    public static IEqualityComparer<AddressTableEntry> DefaultEqualityComparer { get; }
+    public static IEqualityComparer<AddressTableEntry> ExceptStateEqualityComparer { get; }
 
-    public IpHlpApiNeighborTable(IServiceProvider? serviceProvider = null) {}
+    public AddressTableEntry(IPAddress ipAddress, PhysicalAddress? physicalAddress, bool isPermanent, AddressTableEntryState state, string? interfaceId) {}
 
-    [AsyncIteratorStateMachine(typeof(IpHlpApiNeighborTable.<EnumerateEntriesAsync>d__5))]
-    public IAsyncEnumerable<NeighborTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
+    public IPAddress? IPAddress { get; }
+    public string? InterfaceId { get; }
+    [MemberNotNullWhen(false, "IPAddress")]
+    public bool IsEmpty { [MemberNotNullWhen(false, "IPAddress")] get; }
+    public bool IsPermanent { get; }
+    public PhysicalAddress? PhysicalAddress { get; }
+    public AddressTableEntryState State { get; }
+
+    public bool Equals(AddressTableEntry other) {}
+    public bool Equals(IPAddress? other) {}
+    public bool Equals(PhysicalAddress? other) {}
+    public override bool Equals(object? obj) {}
+    public override int GetHashCode() {}
+    public override string ToString() {}
+  }
+}
+
+namespace Smdn.Net.NetworkScanning {
+  public interface INetworkScanner : IDisposable {
+    ValueTask ScanAsync(CancellationToken cancellationToken);
+    ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken);
   }
 
-  public sealed class NmapCommandNeighborDiscoverer : RunCommandNeighborDiscovererBase {
+  public sealed class ArpScanCommandNetworkScanner : CommandNetworkScanner {
     public static bool IsSupported { get; }
 
-    public NmapCommandNeighborDiscoverer(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider) {}
+    public ArpScanCommandNetworkScanner(IPNetworkProfile? networkProfile, IServiceProvider? serviceProvider) {}
 
-    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToDiscover, out string executable, out string arguments) {}
+    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToScan, out string executable, out string arguments) {}
     protected override bool GetCommandLineArguments(out string executable, out string arguments) {}
   }
 
-  public sealed class NullNeighborDiscoverer : INeighborDiscoverer {
-    public static readonly NullNeighborDiscoverer Instance; // = "Smdn.Net.NeighborDiscovery.NullNeighborDiscoverer"
+  public abstract class CommandNetworkScanner : INetworkScanner {
+    public interface IProcessFactory {
+      Process CreateProcess(ProcessStartInfo processStartInfo);
+    }
 
-    public ValueTask DiscoverAsync(CancellationToken cancellationToken) {}
-    public ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken) {}
-  }
+    protected readonly struct Command {
+      public Command(string name, string? executablePath) {}
 
-  public sealed class ProcfsArpNeighborTable : INeighborTable {
-    public static bool IsSupported { get; }
+      public bool IsAvailable { get; }
+      public string Name { get; }
 
-    public ProcfsArpNeighborTable(IServiceProvider? serviceProvider = null) {}
+      public string GetExecutablePathOrThrow() {}
+    }
 
-    [AsyncIteratorStateMachine(typeof(ProcfsArpNeighborTable.<EnumerateEntriesAsync>d__6))]
-    public IAsyncEnumerable<NeighborTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
-  }
+    protected static IReadOnlyCollection<string> DefaultCommandPaths { get; }
 
-  public abstract class RunCommandNeighborDiscovererBase : INeighborDiscoverer {
-    protected static string FindPathToCommand(string command, IEnumerable<string> paths) {}
+    protected static CommandNetworkScanner.Command FindCommand(string command, IEnumerable<string> paths) {}
 
-    protected RunCommandNeighborDiscovererBase(ILogger? logger) {}
+    protected CommandNetworkScanner(ILogger? logger, IServiceProvider? serviceProvider) {}
 
-    public virtual ValueTask DiscoverAsync(CancellationToken cancellationToken) {}
-    public virtual ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken) {}
-    protected abstract bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToDiscover, out string executable, out string arguments);
-    protected abstract bool GetCommandLineArguments(out string executable, out string arguments);
+    protected virtual void Dispose(bool disposing) {}
+    public void Dispose() {}
+    protected abstract bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToScan, out string executable, out string? arguments);
+    protected abstract bool GetCommandLineArguments(out string executable, out string? arguments);
+    public virtual ValueTask ScanAsync(CancellationToken cancellationToken = default) {}
+    public virtual ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
   }
 
-  public readonly struct NeighborTableEntry :
-    IEquatable<IPAddress>,
-    IEquatable<PhysicalAddress>
-  {
-    public NeighborTableEntry(IPAddress ipAddress, PhysicalAddress? physicalAddress, bool isPermanent, NeighborTableEntryState state, int? interfaceIndex = null, string? interfaceName = null) {}
+  public sealed class IpHlpApiNetworkScanner : INetworkScanner {
+    public IpHlpApiNetworkScanner(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider = null) {}
 
-    public IPAddress IPAddress { get; }
-    public int? InterfaceIndex { get; }
-    public string? InterfaceName { get; }
-    public bool IsPermanent { get; }
-    public PhysicalAddress? PhysicalAddress { get; }
-    public NeighborTableEntryState State { get; }
+    public ValueTask ScanAsync(CancellationToken cancellationToken = default) {}
+    public async ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
+    void IDisposable.Dispose() {}
+  }
 
-    public bool Equals(IPAddress? other) {}
-    public bool Equals(PhysicalAddress? other) {}
+  public sealed class NmapCommandNetworkScanner : CommandNetworkScanner {
+    public static bool IsSupported { get; }
+
+    public NmapCommandNetworkScanner(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider) {}
+
+    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToScan, out string executable, out string arguments) {}
+    protected override bool GetCommandLineArguments(out string executable, out string arguments) {}
+  }
+
+  public sealed class PingNetworkScanner : INetworkScanner {
+    public PingNetworkScanner(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider = null) {}
+
+    public void Dispose() {}
+    public ValueTask ScanAsync(CancellationToken cancellationToken = default) {}
+    public ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
   }
 }
 // API list generated by Smdn.Reflection.ReverseGenerating.ListApi.MSBuild.Tasks v1.2.1.0.
 // Smdn.Reflection.ReverseGenerating.ListApi.Core v1.2.0.0 (https://github.com/smdn/Smdn.Reflection.ReverseGenerating)
diff --git a/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-net7.0.apilist.cs b/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-net7.0.apilist.cs
index 5fcb493..dc3d95f 100644
--- a/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-net7.0.apilist.cs
+++ b/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-net7.0.apilist.cs
@@ -1,216 +1,260 @@
-// Smdn.Net.AddressResolution.dll (Smdn.Net.AddressResolution-1.0.0-preview6)
+// Smdn.Net.AddressResolution.dll (Smdn.Net.AddressResolution-1.0.0-rc1)
 //   Name: Smdn.Net.AddressResolution
 //   AssemblyVersion: 1.0.0.0
-//   InformationalVersion: 1.0.0-preview6+867630e3d8768ccca99d991e9c0c1cca62c64c76
+//   InformationalVersion: 1.0.0-rc1+54f2767c7798db11d76ae3836009b55f701af69f
 //   TargetFramework: .NETCoreApp,Version=v7.0
 //   Configuration: Release
 //   Referenced assemblies:
 //     Microsoft.Extensions.DependencyInjection.Abstractions, Version=6.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60
 //     Microsoft.Extensions.Logging.Abstractions, Version=6.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60
+//     System.Collections, Version=7.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Collections.Concurrent, Version=7.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.ComponentModel, Version=7.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
+//     System.ComponentModel.Primitives, Version=7.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Diagnostics.Process, Version=7.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Linq, Version=7.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Memory, Version=7.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
 //     System.Net.NetworkInformation, Version=7.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
+//     System.Net.Ping, Version=7.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Net.Primitives, Version=7.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Runtime, Version=7.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Runtime.InteropServices, Version=7.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
 //     System.Threading, Version=7.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a
-//     Vanara.Core, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     Vanara.PInvoke.IpHlpApi, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     Vanara.PInvoke.Shared, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     Vanara.PInvoke.Ws2_32, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 #nullable enable annotations
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
 using System.Net;
 using System.Net.NetworkInformation;
 using System.Runtime.CompilerServices;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.Extensions.Logging;
 using Smdn.Net;
 using Smdn.Net.AddressResolution;
-using Smdn.Net.NeighborDiscovery;
+using Smdn.Net.AddressTables;
+using Smdn.Net.NetworkScanning;
 
 namespace Smdn.Net {
   public abstract class IPNetworkProfile {
     public static IPNetworkProfile Create() {}
     public static IPNetworkProfile Create(Func<IEnumerable<IPAddress>?> addressRangeGenerator, NetworkInterface? networkInterface = null) {}
     public static IPNetworkProfile Create(IPAddress baseAddress, IPAddress subnetMask, NetworkInterface? networkInterface = null) {}
     public static IPNetworkProfile Create(IPAddress baseAddress, int prefixLength, NetworkInterface? networkInterface = null) {}
     public static IPNetworkProfile Create(NetworkInterface networkInterface) {}
-    public static IPNetworkProfile Create(Predicate<NetworkInterface> predicate) {}
+    public static IPNetworkProfile Create(Predicate<NetworkInterface> predicateForNetworkInterface) {}
 
     protected IPNetworkProfile(NetworkInterface? networkInterface) {}
 
     public NetworkInterface? NetworkInterface { get; }
 
     public abstract IEnumerable<IPAddress>? GetAddressRange();
   }
 
   public static class PhysicalAddressExtensions {
     public static string ToMacAddressString(this PhysicalAddress hardwareAddress, char delimiter = ':') {}
   }
 }
 
 namespace Smdn.Net.AddressResolution {
-  public interface IAddressResolver<TAddress, TResolvedAddress> {
+  public interface IAddressResolver<TAddress, TResolvedAddress> where TAddress : notnull where TResolvedAddress : notnull {
     void Invalidate(TAddress address);
-    ValueTask<TResolvedAddress> ResolveAsync(TAddress address, CancellationToken cancellationToken);
+    ValueTask<TResolvedAddress?> ResolveAsync(TAddress address, CancellationToken cancellationToken);
   }
 
   public class MacAddressResolver : MacAddressResolverBase {
-    protected MacAddressResolver(INeighborTable neighborTable, INeighborDiscoverer neighborDiscoverer, TimeSpan neighborDiscoveryInterval, ILogger? logger) {}
-    public MacAddressResolver(INeighborTable? neighborTable = null, INeighborDiscoverer? neighborDiscoverer = null, int neighborDiscoveryIntervalMilliseconds = -1, IServiceProvider? serviceProvider = null) {}
+    protected MacAddressResolver(IAddressTable addressTable, bool shouldDisposeAddressTable, INetworkScanner? networkScanner, bool shouldDisposeNetworkScanner, NetworkInterface? networkInterface, int maxParallelCountForRefreshInvalidatedCache, ILogger? logger) {}
+    public MacAddressResolver() {}
+    public MacAddressResolver(IAddressTable? addressTable, INetworkScanner? networkScanner, bool shouldDisposeAddressTable = false, bool shouldDisposeNetworkScanner = false, NetworkInterface? networkInterface = null, int maxParallelCountForRefreshInvalidatedCache = 3, IServiceProvider? serviceProvider = null) {}
     public MacAddressResolver(IPNetworkProfile? networkProfile, IServiceProvider? serviceProvider = null) {}
-    public MacAddressResolver(IPNetworkProfile? networkProfile, TimeSpan neighborDiscoveryInterval, IServiceProvider? serviceProvider = null) {}
-    public MacAddressResolver(TimeSpan neighborDiscoveryInterval, INeighborTable? neighborTable = null, INeighborDiscoverer? neighborDiscoverer = null, IServiceProvider? serviceProvider = null) {}
 
+    public bool CanPerformNetworkScan { get; }
     public override bool HasInvalidated { get; }
+    public TimeSpan NetworkScanInterval { get; set; }
+    public TimeSpan NetworkScanMinInterval { get; set; }
 
     protected override void Dispose(bool disposing) {}
+    public IAsyncEnumerable<AddressTableEntry> EnumerateAddressTableEntriesAsync(CancellationToken cancellationToken = default) {}
+    public IAsyncEnumerable<AddressTableEntry> EnumerateAddressTableEntriesAsync(Predicate<AddressTableEntry> predicate, CancellationToken cancellationToken = default) {}
     protected override void InvalidateCore(IPAddress ipAddress) {}
     protected override void InvalidateCore(PhysicalAddress macAddress) {}
     protected override ValueTask RefreshCacheAsyncCore(CancellationToken cancellationToken = default) {}
     protected override ValueTask RefreshInvalidatedCacheAsyncCore(CancellationToken cancellationToken = default) {}
     protected override async ValueTask<PhysicalAddress?> ResolveIPAddressToMacAddressAsyncCore(IPAddress ipAddress, CancellationToken cancellationToken) {}
     protected override async ValueTask<IPAddress?> ResolveMacAddressToIPAddressAsyncCore(PhysicalAddress macAddress, CancellationToken cancellationToken) {}
+    protected virtual async ValueTask<AddressTableEntry> SelectAddressTableEntryAsync(Predicate<AddressTableEntry> predicate, CancellationToken cancellationToken) {}
   }
 
   public abstract class MacAddressResolverBase :
     IAddressResolver<IPAddress, PhysicalAddress>,
     IAddressResolver<PhysicalAddress, IPAddress>,
     IDisposable
   {
     protected static PhysicalAddress AllZeroMacAddress { get; }
     public static MacAddressResolverBase Null { get; }
 
     protected MacAddressResolverBase(ILogger? logger = null) {}
 
     public abstract bool HasInvalidated { get; }
     protected ILogger? Logger { get; }
 
     protected virtual void Dispose(bool disposing) {}
     public void Dispose() {}
     public void Invalidate(IPAddress ipAddress) {}
     public void Invalidate(PhysicalAddress macAddress) {}
     protected abstract void InvalidateCore(IPAddress ipAddress);
     protected abstract void InvalidateCore(PhysicalAddress macAddress);
     public ValueTask RefreshCacheAsync(CancellationToken cancellationToken = default) {}
     protected virtual ValueTask RefreshCacheAsyncCore(CancellationToken cancellationToken) {}
     public ValueTask RefreshInvalidatedCacheAsync(CancellationToken cancellationToken = default) {}
     protected virtual ValueTask RefreshInvalidatedCacheAsyncCore(CancellationToken cancellationToken) {}
     public ValueTask<PhysicalAddress?> ResolveIPAddressToMacAddressAsync(IPAddress ipAddress, CancellationToken cancellationToken = default) {}
     protected abstract ValueTask<PhysicalAddress?> ResolveIPAddressToMacAddressAsyncCore(IPAddress ipAddress, CancellationToken cancellationToken);
     public ValueTask<IPAddress?> ResolveMacAddressToIPAddressAsync(PhysicalAddress macAddress, CancellationToken cancellationToken = default) {}
     protected abstract ValueTask<IPAddress?> ResolveMacAddressToIPAddressAsyncCore(PhysicalAddress macAddress, CancellationToken cancellationToken);
     void IAddressResolver<IPAddress, PhysicalAddress>.Invalidate(IPAddress address) {}
     ValueTask<PhysicalAddress?> IAddressResolver<IPAddress, PhysicalAddress>.ResolveAsync(IPAddress address, CancellationToken cancellationToken) {}
     void IAddressResolver<PhysicalAddress, IPAddress>.Invalidate(PhysicalAddress address) {}
     ValueTask<IPAddress?> IAddressResolver<PhysicalAddress, IPAddress>.ResolveAsync(PhysicalAddress address, CancellationToken cancellationToken) {}
     protected void ThrowIfDisposed() {}
   }
 }
 
-namespace Smdn.Net.NeighborDiscovery {
-  public interface INeighborDiscoverer {
-    ValueTask DiscoverAsync(CancellationToken cancellationToken);
-    ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken);
+namespace Smdn.Net.AddressTables {
+  public interface IAddressTable : IDisposable {
+    IAsyncEnumerable<AddressTableEntry> EnumerateEntriesAsync(CancellationToken cancellationToken);
   }
 
-  public interface INeighborTable {
-    IAsyncEnumerable<NeighborTableEntry> EnumerateEntriesAsync(CancellationToken cancellationToken);
-  }
-
-  public enum NeighborTableEntryState : int {
+  public enum AddressTableEntryState : int {
     Delay = 4,
     Incomplete = 1,
     None = 0,
     Probe = 5,
     Reachable = 2,
     Stale = 3,
   }
 
-  public sealed class ArpScanCommandNeighborDiscoverer : RunCommandNeighborDiscovererBase {
+  public sealed class IpHlpApiAddressTable : IAddressTable {
     public static bool IsSupported { get; }
 
-    public ArpScanCommandNeighborDiscoverer(IPNetworkProfile? networkProfile, IServiceProvider? serviceProvider) {}
+    public IpHlpApiAddressTable(IServiceProvider? serviceProvider = null) {}
 
-    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToDiscover, out string executable, out string arguments) {}
-    protected override bool GetCommandLineArguments(out string executable, out string arguments) {}
+    [AsyncIteratorStateMachine(typeof(IpHlpApiAddressTable.<EnumerateEntriesAsync>d__6))]
+    public IAsyncEnumerable<AddressTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
+    void IDisposable.Dispose() {}
   }
 
-  public sealed class IpHlpApiNeighborDiscoverer : INeighborDiscoverer {
-    public IpHlpApiNeighborDiscoverer(IPNetworkProfile networkProfile, ILogger? logger = null) {}
+  public sealed class ProcfsArpAddressTable : IAddressTable {
+    public static bool IsSupported { get; }
+
+    public ProcfsArpAddressTable(IServiceProvider? serviceProvider = null) {}
 
-    public ValueTask DiscoverAsync(CancellationToken cancellationToken = default) {}
-    public async ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
+    [AsyncIteratorStateMachine(typeof(ProcfsArpAddressTable.<EnumerateEntriesAsync>d__7))]
+    public IAsyncEnumerable<AddressTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
+    void IDisposable.Dispose() {}
   }
 
-  public sealed class IpHlpApiNeighborTable : INeighborTable {
-    public static bool IsSupported { get; }
+  public readonly struct AddressTableEntry :
+    IEquatable<AddressTableEntry>,
+    IEquatable<IPAddress>,
+    IEquatable<PhysicalAddress>
+  {
+    public static readonly AddressTableEntry Empty; // = "{IP=, MAC=(null), IsPermanent=False, State=None, Iface=}"
+
+    public static IEqualityComparer<AddressTableEntry> DefaultEqualityComparer { get; }
+    public static IEqualityComparer<AddressTableEntry> ExceptStateEqualityComparer { get; }
 
-    public IpHlpApiNeighborTable(IServiceProvider? serviceProvider = null) {}
+    public AddressTableEntry(IPAddress ipAddress, PhysicalAddress? physicalAddress, bool isPermanent, AddressTableEntryState state, string? interfaceId) {}
 
-    [AsyncIteratorStateMachine(typeof(IpHlpApiNeighborTable.<EnumerateEntriesAsync>d__5))]
-    public IAsyncEnumerable<NeighborTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
+    public IPAddress? IPAddress { get; }
+    public string? InterfaceId { get; }
+    [MemberNotNullWhen(false, "IPAddress")]
+    public bool IsEmpty { [MemberNotNullWhen(false, "IPAddress")] get; }
+    public bool IsPermanent { get; }
+    public PhysicalAddress? PhysicalAddress { get; }
+    public AddressTableEntryState State { get; }
+
+    public bool Equals(AddressTableEntry other) {}
+    public bool Equals(IPAddress? other) {}
+    public bool Equals(PhysicalAddress? other) {}
+    public override bool Equals(object? obj) {}
+    public override int GetHashCode() {}
+    public override string ToString() {}
+  }
+}
+
+namespace Smdn.Net.NetworkScanning {
+  public interface INetworkScanner : IDisposable {
+    ValueTask ScanAsync(CancellationToken cancellationToken);
+    ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken);
   }
 
-  public sealed class NmapCommandNeighborDiscoverer : RunCommandNeighborDiscovererBase {
+  public sealed class ArpScanCommandNetworkScanner : CommandNetworkScanner {
     public static bool IsSupported { get; }
 
-    public NmapCommandNeighborDiscoverer(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider) {}
+    public ArpScanCommandNetworkScanner(IPNetworkProfile? networkProfile, IServiceProvider? serviceProvider) {}
 
-    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToDiscover, out string executable, out string arguments) {}
+    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToScan, out string executable, out string arguments) {}
     protected override bool GetCommandLineArguments(out string executable, out string arguments) {}
   }
 
-  public sealed class NullNeighborDiscoverer : INeighborDiscoverer {
-    public static readonly NullNeighborDiscoverer Instance; // = "Smdn.Net.NeighborDiscovery.NullNeighborDiscoverer"
+  public abstract class CommandNetworkScanner : INetworkScanner {
+    public interface IProcessFactory {
+      Process CreateProcess(ProcessStartInfo processStartInfo);
+    }
 
-    public ValueTask DiscoverAsync(CancellationToken cancellationToken) {}
-    public ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken) {}
-  }
+    protected readonly struct Command {
+      public Command(string name, string? executablePath) {}
 
-  public sealed class ProcfsArpNeighborTable : INeighborTable {
-    public static bool IsSupported { get; }
+      public bool IsAvailable { get; }
+      public string Name { get; }
 
-    public ProcfsArpNeighborTable(IServiceProvider? serviceProvider = null) {}
+      public string GetExecutablePathOrThrow() {}
+    }
 
-    [AsyncIteratorStateMachine(typeof(ProcfsArpNeighborTable.<EnumerateEntriesAsync>d__6))]
-    public IAsyncEnumerable<NeighborTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
-  }
+    protected static IReadOnlyCollection<string> DefaultCommandPaths { get; }
 
-  public abstract class RunCommandNeighborDiscovererBase : INeighborDiscoverer {
-    protected static string FindPathToCommand(string command, IEnumerable<string> paths) {}
+    protected static CommandNetworkScanner.Command FindCommand(string command, IEnumerable<string> paths) {}
 
-    protected RunCommandNeighborDiscovererBase(ILogger? logger) {}
+    protected CommandNetworkScanner(ILogger? logger, IServiceProvider? serviceProvider) {}
 
-    public virtual ValueTask DiscoverAsync(CancellationToken cancellationToken) {}
-    public virtual ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken) {}
-    protected abstract bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToDiscover, out string executable, out string arguments);
-    protected abstract bool GetCommandLineArguments(out string executable, out string arguments);
+    protected virtual void Dispose(bool disposing) {}
+    public void Dispose() {}
+    protected abstract bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToScan, out string executable, out string? arguments);
+    protected abstract bool GetCommandLineArguments(out string executable, out string? arguments);
+    public virtual ValueTask ScanAsync(CancellationToken cancellationToken = default) {}
+    public virtual ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
   }
 
-  public readonly struct NeighborTableEntry :
-    IEquatable<IPAddress>,
-    IEquatable<PhysicalAddress>
-  {
-    public NeighborTableEntry(IPAddress ipAddress, PhysicalAddress? physicalAddress, bool isPermanent, NeighborTableEntryState state, int? interfaceIndex = null, string? interfaceName = null) {}
+  public sealed class IpHlpApiNetworkScanner : INetworkScanner {
+    public IpHlpApiNetworkScanner(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider = null) {}
 
-    public IPAddress IPAddress { get; }
-    public int? InterfaceIndex { get; }
-    public string? InterfaceName { get; }
-    public bool IsPermanent { get; }
-    public PhysicalAddress? PhysicalAddress { get; }
-    public NeighborTableEntryState State { get; }
+    public ValueTask ScanAsync(CancellationToken cancellationToken = default) {}
+    public async ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
+    void IDisposable.Dispose() {}
+  }
 
-    public bool Equals(IPAddress? other) {}
-    public bool Equals(PhysicalAddress? other) {}
+  public sealed class NmapCommandNetworkScanner : CommandNetworkScanner {
+    public static bool IsSupported { get; }
+
+    public NmapCommandNetworkScanner(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider) {}
+
+    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToScan, out string executable, out string arguments) {}
+    protected override bool GetCommandLineArguments(out string executable, out string arguments) {}
+  }
+
+  public sealed class PingNetworkScanner : INetworkScanner {
+    public PingNetworkScanner(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider = null) {}
+
+    public void Dispose() {}
+    public ValueTask ScanAsync(CancellationToken cancellationToken = default) {}
+    public ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
   }
 }
 // API list generated by Smdn.Reflection.ReverseGenerating.ListApi.MSBuild.Tasks v1.2.1.0.
 // Smdn.Reflection.ReverseGenerating.ListApi.Core v1.2.0.0 (https://github.com/smdn/Smdn.Reflection.ReverseGenerating)
diff --git a/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-netstandard2.0.apilist.cs b/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-netstandard2.0.apilist.cs
index 5528b32..529a3a6 100644
--- a/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-netstandard2.0.apilist.cs
+++ b/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-netstandard2.0.apilist.cs
@@ -1,210 +1,250 @@
-// Smdn.Net.AddressResolution.dll (Smdn.Net.AddressResolution-1.0.0-preview6)
+// Smdn.Net.AddressResolution.dll (Smdn.Net.AddressResolution-1.0.0-rc1)
 //   Name: Smdn.Net.AddressResolution
 //   AssemblyVersion: 1.0.0.0
-//   InformationalVersion: 1.0.0-preview6+867630e3d8768ccca99d991e9c0c1cca62c64c76
+//   InformationalVersion: 1.0.0-rc1+54f2767c7798db11d76ae3836009b55f701af69f
 //   TargetFramework: .NETStandard,Version=v2.0
 //   Configuration: Release
 //   Referenced assemblies:
 //     Microsoft.Bcl.AsyncInterfaces, Version=6.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
+//     Microsoft.Bcl.HashCode, Version=1.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
 //     Microsoft.Extensions.DependencyInjection.Abstractions, Version=6.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60
 //     Microsoft.Extensions.Logging.Abstractions, Version=6.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60
 //     System.Memory, Version=4.0.1.2, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
 //     System.Threading.Tasks.Extensions, Version=4.2.0.1, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
-//     Vanara.Core, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     Vanara.PInvoke.IpHlpApi, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     Vanara.PInvoke.Shared, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     Vanara.PInvoke.Ws2_32, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     netstandard, Version=2.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
 #nullable enable annotations
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Net;
 using System.Net.NetworkInformation;
 using System.Runtime.CompilerServices;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.Extensions.Logging;
 using Smdn.Net;
 using Smdn.Net.AddressResolution;
-using Smdn.Net.NeighborDiscovery;
+using Smdn.Net.AddressTables;
+using Smdn.Net.NetworkScanning;
 
 namespace Smdn.Net {
   public abstract class IPNetworkProfile {
     public static IPNetworkProfile Create() {}
     public static IPNetworkProfile Create(Func<IEnumerable<IPAddress>?> addressRangeGenerator, NetworkInterface? networkInterface = null) {}
     public static IPNetworkProfile Create(IPAddress baseAddress, IPAddress subnetMask, NetworkInterface? networkInterface = null) {}
     public static IPNetworkProfile Create(IPAddress baseAddress, int prefixLength, NetworkInterface? networkInterface = null) {}
     public static IPNetworkProfile Create(NetworkInterface networkInterface) {}
-    public static IPNetworkProfile Create(Predicate<NetworkInterface> predicate) {}
+    public static IPNetworkProfile Create(Predicate<NetworkInterface> predicateForNetworkInterface) {}
 
     protected IPNetworkProfile(NetworkInterface? networkInterface) {}
 
     public NetworkInterface? NetworkInterface { get; }
 
     public abstract IEnumerable<IPAddress>? GetAddressRange();
   }
 
   public static class PhysicalAddressExtensions {
     public static string ToMacAddressString(this PhysicalAddress hardwareAddress, char delimiter = ':') {}
   }
 }
 
 namespace Smdn.Net.AddressResolution {
-  public interface IAddressResolver<TAddress, TResolvedAddress> {
+  public interface IAddressResolver<TAddress, TResolvedAddress> where TAddress : notnull where TResolvedAddress : notnull {
     void Invalidate(TAddress address);
-    ValueTask<TResolvedAddress> ResolveAsync(TAddress address, CancellationToken cancellationToken);
+    ValueTask<TResolvedAddress?> ResolveAsync(TAddress address, CancellationToken cancellationToken);
   }
 
   public class MacAddressResolver : MacAddressResolverBase {
-    protected MacAddressResolver(INeighborTable neighborTable, INeighborDiscoverer neighborDiscoverer, TimeSpan neighborDiscoveryInterval, ILogger? logger) {}
-    public MacAddressResolver(INeighborTable? neighborTable = null, INeighborDiscoverer? neighborDiscoverer = null, int neighborDiscoveryIntervalMilliseconds = -1, IServiceProvider? serviceProvider = null) {}
+    protected MacAddressResolver(IAddressTable addressTable, bool shouldDisposeAddressTable, INetworkScanner? networkScanner, bool shouldDisposeNetworkScanner, NetworkInterface? networkInterface, int maxParallelCountForRefreshInvalidatedCache, ILogger? logger) {}
+    public MacAddressResolver() {}
+    public MacAddressResolver(IAddressTable? addressTable, INetworkScanner? networkScanner, bool shouldDisposeAddressTable = false, bool shouldDisposeNetworkScanner = false, NetworkInterface? networkInterface = null, int maxParallelCountForRefreshInvalidatedCache = 3, IServiceProvider? serviceProvider = null) {}
     public MacAddressResolver(IPNetworkProfile? networkProfile, IServiceProvider? serviceProvider = null) {}
-    public MacAddressResolver(IPNetworkProfile? networkProfile, TimeSpan neighborDiscoveryInterval, IServiceProvider? serviceProvider = null) {}
-    public MacAddressResolver(TimeSpan neighborDiscoveryInterval, INeighborTable? neighborTable = null, INeighborDiscoverer? neighborDiscoverer = null, IServiceProvider? serviceProvider = null) {}
 
+    public bool CanPerformNetworkScan { get; }
     public override bool HasInvalidated { get; }
+    public TimeSpan NetworkScanInterval { get; set; }
+    public TimeSpan NetworkScanMinInterval { get; set; }
 
     protected override void Dispose(bool disposing) {}
+    public IAsyncEnumerable<AddressTableEntry> EnumerateAddressTableEntriesAsync(CancellationToken cancellationToken = default) {}
+    public IAsyncEnumerable<AddressTableEntry> EnumerateAddressTableEntriesAsync(Predicate<AddressTableEntry> predicate, CancellationToken cancellationToken = default) {}
     protected override void InvalidateCore(IPAddress ipAddress) {}
     protected override void InvalidateCore(PhysicalAddress macAddress) {}
     protected override ValueTask RefreshCacheAsyncCore(CancellationToken cancellationToken = default) {}
     protected override ValueTask RefreshInvalidatedCacheAsyncCore(CancellationToken cancellationToken = default) {}
     protected override async ValueTask<PhysicalAddress?> ResolveIPAddressToMacAddressAsyncCore(IPAddress ipAddress, CancellationToken cancellationToken) {}
     protected override async ValueTask<IPAddress?> ResolveMacAddressToIPAddressAsyncCore(PhysicalAddress macAddress, CancellationToken cancellationToken) {}
+    protected virtual async ValueTask<AddressTableEntry> SelectAddressTableEntryAsync(Predicate<AddressTableEntry> predicate, CancellationToken cancellationToken) {}
   }
 
   public abstract class MacAddressResolverBase :
     IAddressResolver<IPAddress, PhysicalAddress>,
     IAddressResolver<PhysicalAddress, IPAddress>,
     IDisposable
   {
     protected static PhysicalAddress AllZeroMacAddress { get; }
     public static MacAddressResolverBase Null { get; }
 
     protected MacAddressResolverBase(ILogger? logger = null) {}
 
     public abstract bool HasInvalidated { get; }
     protected ILogger? Logger { get; }
 
     protected virtual void Dispose(bool disposing) {}
     public void Dispose() {}
     public void Invalidate(IPAddress ipAddress) {}
     public void Invalidate(PhysicalAddress macAddress) {}
     protected abstract void InvalidateCore(IPAddress ipAddress);
     protected abstract void InvalidateCore(PhysicalAddress macAddress);
     public ValueTask RefreshCacheAsync(CancellationToken cancellationToken = default) {}
     protected virtual ValueTask RefreshCacheAsyncCore(CancellationToken cancellationToken) {}
     public ValueTask RefreshInvalidatedCacheAsync(CancellationToken cancellationToken = default) {}
     protected virtual ValueTask RefreshInvalidatedCacheAsyncCore(CancellationToken cancellationToken) {}
     public ValueTask<PhysicalAddress?> ResolveIPAddressToMacAddressAsync(IPAddress ipAddress, CancellationToken cancellationToken = default) {}
     protected abstract ValueTask<PhysicalAddress?> ResolveIPAddressToMacAddressAsyncCore(IPAddress ipAddress, CancellationToken cancellationToken);
     public ValueTask<IPAddress?> ResolveMacAddressToIPAddressAsync(PhysicalAddress macAddress, CancellationToken cancellationToken = default) {}
     protected abstract ValueTask<IPAddress?> ResolveMacAddressToIPAddressAsyncCore(PhysicalAddress macAddress, CancellationToken cancellationToken);
     void IAddressResolver<IPAddress, PhysicalAddress>.Invalidate(IPAddress address) {}
     ValueTask<PhysicalAddress?> IAddressResolver<IPAddress, PhysicalAddress>.ResolveAsync(IPAddress address, CancellationToken cancellationToken) {}
     void IAddressResolver<PhysicalAddress, IPAddress>.Invalidate(PhysicalAddress address) {}
     ValueTask<IPAddress?> IAddressResolver<PhysicalAddress, IPAddress>.ResolveAsync(PhysicalAddress address, CancellationToken cancellationToken) {}
     protected void ThrowIfDisposed() {}
   }
 }
 
-namespace Smdn.Net.NeighborDiscovery {
-  public interface INeighborDiscoverer {
-    ValueTask DiscoverAsync(CancellationToken cancellationToken);
-    ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken);
+namespace Smdn.Net.AddressTables {
+  public interface IAddressTable : IDisposable {
+    IAsyncEnumerable<AddressTableEntry> EnumerateEntriesAsync(CancellationToken cancellationToken);
   }
 
-  public interface INeighborTable {
-    IAsyncEnumerable<NeighborTableEntry> EnumerateEntriesAsync(CancellationToken cancellationToken);
-  }
-
-  public enum NeighborTableEntryState : int {
+  public enum AddressTableEntryState : int {
     Delay = 4,
     Incomplete = 1,
     None = 0,
     Probe = 5,
     Reachable = 2,
     Stale = 3,
   }
 
-  public sealed class ArpScanCommandNeighborDiscoverer : RunCommandNeighborDiscovererBase {
+  public sealed class IpHlpApiAddressTable : IAddressTable {
     public static bool IsSupported { get; }
 
-    public ArpScanCommandNeighborDiscoverer(IPNetworkProfile? networkProfile, IServiceProvider? serviceProvider) {}
+    public IpHlpApiAddressTable(IServiceProvider? serviceProvider = null) {}
 
-    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToDiscover, out string executable, out string arguments) {}
-    protected override bool GetCommandLineArguments(out string executable, out string arguments) {}
+    [AsyncIteratorStateMachine(typeof(IpHlpApiAddressTable.<EnumerateEntriesAsync>d__6))]
+    public IAsyncEnumerable<AddressTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
+    void IDisposable.Dispose() {}
   }
 
-  public sealed class IpHlpApiNeighborDiscoverer : INeighborDiscoverer {
-    public IpHlpApiNeighborDiscoverer(IPNetworkProfile networkProfile, ILogger? logger = null) {}
+  public sealed class ProcfsArpAddressTable : IAddressTable {
+    public static bool IsSupported { get; }
+
+    public ProcfsArpAddressTable(IServiceProvider? serviceProvider = null) {}
 
-    public ValueTask DiscoverAsync(CancellationToken cancellationToken = default) {}
-    public async ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
+    [AsyncIteratorStateMachine(typeof(ProcfsArpAddressTable.<EnumerateEntriesAsync>d__7))]
+    public IAsyncEnumerable<AddressTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
+    void IDisposable.Dispose() {}
   }
 
-  public sealed class IpHlpApiNeighborTable : INeighborTable {
-    public static bool IsSupported { get; }
+  public readonly struct AddressTableEntry :
+    IEquatable<AddressTableEntry>,
+    IEquatable<IPAddress>,
+    IEquatable<PhysicalAddress>
+  {
+    public static readonly AddressTableEntry Empty; // = "{IP=, MAC=(null), IsPermanent=False, State=None, Iface=}"
+
+    public static IEqualityComparer<AddressTableEntry> DefaultEqualityComparer { get; }
+    public static IEqualityComparer<AddressTableEntry> ExceptStateEqualityComparer { get; }
 
-    public IpHlpApiNeighborTable(IServiceProvider? serviceProvider = null) {}
+    public AddressTableEntry(IPAddress ipAddress, PhysicalAddress? physicalAddress, bool isPermanent, AddressTableEntryState state, string? interfaceId) {}
 
-    [AsyncIteratorStateMachine(typeof(IpHlpApiNeighborTable.<EnumerateEntriesAsync>d__5))]
-    public IAsyncEnumerable<NeighborTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
+    public IPAddress? IPAddress { get; }
+    public string? InterfaceId { get; }
+    public bool IsEmpty { get; }
+    public bool IsPermanent { get; }
+    public PhysicalAddress? PhysicalAddress { get; }
+    public AddressTableEntryState State { get; }
+
+    public bool Equals(AddressTableEntry other) {}
+    public bool Equals(IPAddress? other) {}
+    public bool Equals(PhysicalAddress? other) {}
+    public override bool Equals(object? obj) {}
+    public override int GetHashCode() {}
+    public override string ToString() {}
+  }
+}
+
+namespace Smdn.Net.NetworkScanning {
+  public interface INetworkScanner : IDisposable {
+    ValueTask ScanAsync(CancellationToken cancellationToken);
+    ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken);
   }
 
-  public sealed class NmapCommandNeighborDiscoverer : RunCommandNeighborDiscovererBase {
+  public sealed class ArpScanCommandNetworkScanner : CommandNetworkScanner {
     public static bool IsSupported { get; }
 
-    public NmapCommandNeighborDiscoverer(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider) {}
+    public ArpScanCommandNetworkScanner(IPNetworkProfile? networkProfile, IServiceProvider? serviceProvider) {}
 
-    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToDiscover, out string executable, out string arguments) {}
+    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToScan, out string executable, out string arguments) {}
     protected override bool GetCommandLineArguments(out string executable, out string arguments) {}
   }
 
-  public sealed class NullNeighborDiscoverer : INeighborDiscoverer {
-    public static readonly NullNeighborDiscoverer Instance; // = "Smdn.Net.NeighborDiscovery.NullNeighborDiscoverer"
+  public abstract class CommandNetworkScanner : INetworkScanner {
+    public interface IProcessFactory {
+      Process CreateProcess(ProcessStartInfo processStartInfo);
+    }
 
-    public ValueTask DiscoverAsync(CancellationToken cancellationToken) {}
-    public ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken) {}
-  }
+    protected readonly struct Command {
+      public Command(string name, string? executablePath) {}
 
-  public sealed class ProcfsArpNeighborTable : INeighborTable {
-    public static bool IsSupported { get; }
+      public bool IsAvailable { get; }
+      public string Name { get; }
 
-    public ProcfsArpNeighborTable(IServiceProvider? serviceProvider = null) {}
+      public string GetExecutablePathOrThrow() {}
+    }
 
-    [AsyncIteratorStateMachine(typeof(ProcfsArpNeighborTable.<EnumerateEntriesAsync>d__6))]
-    public IAsyncEnumerable<NeighborTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
-  }
+    protected static IReadOnlyCollection<string> DefaultCommandPaths { get; }
 
-  public abstract class RunCommandNeighborDiscovererBase : INeighborDiscoverer {
-    protected static string FindPathToCommand(string command, IEnumerable<string> paths) {}
+    protected static CommandNetworkScanner.Command FindCommand(string command, IEnumerable<string> paths) {}
 
-    protected RunCommandNeighborDiscovererBase(ILogger? logger) {}
+    protected CommandNetworkScanner(ILogger? logger, IServiceProvider? serviceProvider) {}
 
-    public virtual ValueTask DiscoverAsync(CancellationToken cancellationToken) {}
-    public virtual ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken) {}
-    protected abstract bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToDiscover, out string executable, out string arguments);
-    protected abstract bool GetCommandLineArguments(out string executable, out string arguments);
+    protected virtual void Dispose(bool disposing) {}
+    public void Dispose() {}
+    protected abstract bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToScan, out string executable, out string? arguments);
+    protected abstract bool GetCommandLineArguments(out string executable, out string? arguments);
+    public virtual ValueTask ScanAsync(CancellationToken cancellationToken = default) {}
+    public virtual ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
   }
 
-  public readonly struct NeighborTableEntry :
-    IEquatable<IPAddress>,
-    IEquatable<PhysicalAddress>
-  {
-    public NeighborTableEntry(IPAddress ipAddress, PhysicalAddress? physicalAddress, bool isPermanent, NeighborTableEntryState state, int? interfaceIndex = null, string? interfaceName = null) {}
+  public sealed class IpHlpApiNetworkScanner : INetworkScanner {
+    public IpHlpApiNetworkScanner(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider = null) {}
 
-    public IPAddress IPAddress { get; }
-    public int? InterfaceIndex { get; }
-    public string? InterfaceName { get; }
-    public bool IsPermanent { get; }
-    public PhysicalAddress? PhysicalAddress { get; }
-    public NeighborTableEntryState State { get; }
+    public ValueTask ScanAsync(CancellationToken cancellationToken = default) {}
+    public async ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
+    void IDisposable.Dispose() {}
+  }
 
-    public bool Equals(IPAddress? other) {}
-    public bool Equals(PhysicalAddress? other) {}
+  public sealed class NmapCommandNetworkScanner : CommandNetworkScanner {
+    public static bool IsSupported { get; }
+
+    public NmapCommandNetworkScanner(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider) {}
+
+    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToScan, out string executable, out string arguments) {}
+    protected override bool GetCommandLineArguments(out string executable, out string arguments) {}
+  }
+
+  public sealed class PingNetworkScanner : INetworkScanner {
+    public PingNetworkScanner(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider = null) {}
+
+    public void Dispose() {}
+    public ValueTask ScanAsync(CancellationToken cancellationToken = default) {}
+    public ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
   }
 }
 // API list generated by Smdn.Reflection.ReverseGenerating.ListApi.MSBuild.Tasks v1.2.1.0.
 // Smdn.Reflection.ReverseGenerating.ListApi.Core v1.2.0.0 (https://github.com/smdn/Smdn.Reflection.ReverseGenerating)
diff --git a/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-netstandard2.1.apilist.cs b/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-netstandard2.1.apilist.cs
index 8c8dcd4..f4e73c3 100644
--- a/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-netstandard2.1.apilist.cs
+++ b/doc/api-list/Smdn.Net.AddressResolution/Smdn.Net.AddressResolution-netstandard2.1.apilist.cs
@@ -1,207 +1,246 @@
-// Smdn.Net.AddressResolution.dll (Smdn.Net.AddressResolution-1.0.0-preview6)
+// Smdn.Net.AddressResolution.dll (Smdn.Net.AddressResolution-1.0.0-rc1)
 //   Name: Smdn.Net.AddressResolution
 //   AssemblyVersion: 1.0.0.0
-//   InformationalVersion: 1.0.0-preview6+867630e3d8768ccca99d991e9c0c1cca62c64c76
+//   InformationalVersion: 1.0.0-rc1+54f2767c7798db11d76ae3836009b55f701af69f
 //   TargetFramework: .NETStandard,Version=v2.1
 //   Configuration: Release
 //   Referenced assemblies:
 //     Microsoft.Extensions.DependencyInjection.Abstractions, Version=6.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60
 //     Microsoft.Extensions.Logging.Abstractions, Version=6.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60
-//     Vanara.Core, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     Vanara.PInvoke.IpHlpApi, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     Vanara.PInvoke.Shared, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     Vanara.PInvoke.Ws2_32, Version=3.4.13.0, Culture=neutral, PublicKeyToken=c37e4080322237fa
 //     netstandard, Version=2.1.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
 #nullable enable annotations
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Net;
 using System.Net.NetworkInformation;
 using System.Runtime.CompilerServices;
 using System.Threading;
 using System.Threading.Tasks;
 using Microsoft.Extensions.Logging;
 using Smdn.Net;
 using Smdn.Net.AddressResolution;
-using Smdn.Net.NeighborDiscovery;
+using Smdn.Net.AddressTables;
+using Smdn.Net.NetworkScanning;
 
 namespace Smdn.Net {
   public abstract class IPNetworkProfile {
     public static IPNetworkProfile Create() {}
     public static IPNetworkProfile Create(Func<IEnumerable<IPAddress>?> addressRangeGenerator, NetworkInterface? networkInterface = null) {}
     public static IPNetworkProfile Create(IPAddress baseAddress, IPAddress subnetMask, NetworkInterface? networkInterface = null) {}
     public static IPNetworkProfile Create(IPAddress baseAddress, int prefixLength, NetworkInterface? networkInterface = null) {}
     public static IPNetworkProfile Create(NetworkInterface networkInterface) {}
-    public static IPNetworkProfile Create(Predicate<NetworkInterface> predicate) {}
+    public static IPNetworkProfile Create(Predicate<NetworkInterface> predicateForNetworkInterface) {}
 
     protected IPNetworkProfile(NetworkInterface? networkInterface) {}
 
     public NetworkInterface? NetworkInterface { get; }
 
     public abstract IEnumerable<IPAddress>? GetAddressRange();
   }
 
   public static class PhysicalAddressExtensions {
     public static string ToMacAddressString(this PhysicalAddress hardwareAddress, char delimiter = ':') {}
   }
 }
 
 namespace Smdn.Net.AddressResolution {
-  public interface IAddressResolver<TAddress, TResolvedAddress> {
+  public interface IAddressResolver<TAddress, TResolvedAddress> where TAddress : notnull where TResolvedAddress : notnull {
     void Invalidate(TAddress address);
-    ValueTask<TResolvedAddress> ResolveAsync(TAddress address, CancellationToken cancellationToken);
+    ValueTask<TResolvedAddress?> ResolveAsync(TAddress address, CancellationToken cancellationToken);
   }
 
   public class MacAddressResolver : MacAddressResolverBase {
-    protected MacAddressResolver(INeighborTable neighborTable, INeighborDiscoverer neighborDiscoverer, TimeSpan neighborDiscoveryInterval, ILogger? logger) {}
-    public MacAddressResolver(INeighborTable? neighborTable = null, INeighborDiscoverer? neighborDiscoverer = null, int neighborDiscoveryIntervalMilliseconds = -1, IServiceProvider? serviceProvider = null) {}
+    protected MacAddressResolver(IAddressTable addressTable, bool shouldDisposeAddressTable, INetworkScanner? networkScanner, bool shouldDisposeNetworkScanner, NetworkInterface? networkInterface, int maxParallelCountForRefreshInvalidatedCache, ILogger? logger) {}
+    public MacAddressResolver() {}
+    public MacAddressResolver(IAddressTable? addressTable, INetworkScanner? networkScanner, bool shouldDisposeAddressTable = false, bool shouldDisposeNetworkScanner = false, NetworkInterface? networkInterface = null, int maxParallelCountForRefreshInvalidatedCache = 3, IServiceProvider? serviceProvider = null) {}
     public MacAddressResolver(IPNetworkProfile? networkProfile, IServiceProvider? serviceProvider = null) {}
-    public MacAddressResolver(IPNetworkProfile? networkProfile, TimeSpan neighborDiscoveryInterval, IServiceProvider? serviceProvider = null) {}
-    public MacAddressResolver(TimeSpan neighborDiscoveryInterval, INeighborTable? neighborTable = null, INeighborDiscoverer? neighborDiscoverer = null, IServiceProvider? serviceProvider = null) {}
 
+    public bool CanPerformNetworkScan { get; }
     public override bool HasInvalidated { get; }
+    public TimeSpan NetworkScanInterval { get; set; }
+    public TimeSpan NetworkScanMinInterval { get; set; }
 
     protected override void Dispose(bool disposing) {}
+    public IAsyncEnumerable<AddressTableEntry> EnumerateAddressTableEntriesAsync(CancellationToken cancellationToken = default) {}
+    public IAsyncEnumerable<AddressTableEntry> EnumerateAddressTableEntriesAsync(Predicate<AddressTableEntry> predicate, CancellationToken cancellationToken = default) {}
     protected override void InvalidateCore(IPAddress ipAddress) {}
     protected override void InvalidateCore(PhysicalAddress macAddress) {}
     protected override ValueTask RefreshCacheAsyncCore(CancellationToken cancellationToken = default) {}
     protected override ValueTask RefreshInvalidatedCacheAsyncCore(CancellationToken cancellationToken = default) {}
     protected override async ValueTask<PhysicalAddress?> ResolveIPAddressToMacAddressAsyncCore(IPAddress ipAddress, CancellationToken cancellationToken) {}
     protected override async ValueTask<IPAddress?> ResolveMacAddressToIPAddressAsyncCore(PhysicalAddress macAddress, CancellationToken cancellationToken) {}
+    protected virtual async ValueTask<AddressTableEntry> SelectAddressTableEntryAsync(Predicate<AddressTableEntry> predicate, CancellationToken cancellationToken) {}
   }
 
   public abstract class MacAddressResolverBase :
     IAddressResolver<IPAddress, PhysicalAddress>,
     IAddressResolver<PhysicalAddress, IPAddress>,
     IDisposable
   {
     protected static PhysicalAddress AllZeroMacAddress { get; }
     public static MacAddressResolverBase Null { get; }
 
     protected MacAddressResolverBase(ILogger? logger = null) {}
 
     public abstract bool HasInvalidated { get; }
     protected ILogger? Logger { get; }
 
     protected virtual void Dispose(bool disposing) {}
     public void Dispose() {}
     public void Invalidate(IPAddress ipAddress) {}
     public void Invalidate(PhysicalAddress macAddress) {}
     protected abstract void InvalidateCore(IPAddress ipAddress);
     protected abstract void InvalidateCore(PhysicalAddress macAddress);
     public ValueTask RefreshCacheAsync(CancellationToken cancellationToken = default) {}
     protected virtual ValueTask RefreshCacheAsyncCore(CancellationToken cancellationToken) {}
     public ValueTask RefreshInvalidatedCacheAsync(CancellationToken cancellationToken = default) {}
     protected virtual ValueTask RefreshInvalidatedCacheAsyncCore(CancellationToken cancellationToken) {}
     public ValueTask<PhysicalAddress?> ResolveIPAddressToMacAddressAsync(IPAddress ipAddress, CancellationToken cancellationToken = default) {}
     protected abstract ValueTask<PhysicalAddress?> ResolveIPAddressToMacAddressAsyncCore(IPAddress ipAddress, CancellationToken cancellationToken);
     public ValueTask<IPAddress?> ResolveMacAddressToIPAddressAsync(PhysicalAddress macAddress, CancellationToken cancellationToken = default) {}
     protected abstract ValueTask<IPAddress?> ResolveMacAddressToIPAddressAsyncCore(PhysicalAddress macAddress, CancellationToken cancellationToken);
     void IAddressResolver<IPAddress, PhysicalAddress>.Invalidate(IPAddress address) {}
     ValueTask<PhysicalAddress?> IAddressResolver<IPAddress, PhysicalAddress>.ResolveAsync(IPAddress address, CancellationToken cancellationToken) {}
     void IAddressResolver<PhysicalAddress, IPAddress>.Invalidate(PhysicalAddress address) {}
     ValueTask<IPAddress?> IAddressResolver<PhysicalAddress, IPAddress>.ResolveAsync(PhysicalAddress address, CancellationToken cancellationToken) {}
     protected void ThrowIfDisposed() {}
   }
 }
 
-namespace Smdn.Net.NeighborDiscovery {
-  public interface INeighborDiscoverer {
-    ValueTask DiscoverAsync(CancellationToken cancellationToken);
-    ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken);
+namespace Smdn.Net.AddressTables {
+  public interface IAddressTable : IDisposable {
+    IAsyncEnumerable<AddressTableEntry> EnumerateEntriesAsync(CancellationToken cancellationToken);
   }
 
-  public interface INeighborTable {
-    IAsyncEnumerable<NeighborTableEntry> EnumerateEntriesAsync(CancellationToken cancellationToken);
-  }
-
-  public enum NeighborTableEntryState : int {
+  public enum AddressTableEntryState : int {
     Delay = 4,
     Incomplete = 1,
     None = 0,
     Probe = 5,
     Reachable = 2,
     Stale = 3,
   }
 
-  public sealed class ArpScanCommandNeighborDiscoverer : RunCommandNeighborDiscovererBase {
+  public sealed class IpHlpApiAddressTable : IAddressTable {
     public static bool IsSupported { get; }
 
-    public ArpScanCommandNeighborDiscoverer(IPNetworkProfile? networkProfile, IServiceProvider? serviceProvider) {}
+    public IpHlpApiAddressTable(IServiceProvider? serviceProvider = null) {}
 
-    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToDiscover, out string executable, out string arguments) {}
-    protected override bool GetCommandLineArguments(out string executable, out string arguments) {}
+    [AsyncIteratorStateMachine(typeof(IpHlpApiAddressTable.<EnumerateEntriesAsync>d__6))]
+    public IAsyncEnumerable<AddressTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
+    void IDisposable.Dispose() {}
   }
 
-  public sealed class IpHlpApiNeighborDiscoverer : INeighborDiscoverer {
-    public IpHlpApiNeighborDiscoverer(IPNetworkProfile networkProfile, ILogger? logger = null) {}
+  public sealed class ProcfsArpAddressTable : IAddressTable {
+    public static bool IsSupported { get; }
+
+    public ProcfsArpAddressTable(IServiceProvider? serviceProvider = null) {}
 
-    public ValueTask DiscoverAsync(CancellationToken cancellationToken = default) {}
-    public async ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
+    [AsyncIteratorStateMachine(typeof(ProcfsArpAddressTable.<EnumerateEntriesAsync>d__7))]
+    public IAsyncEnumerable<AddressTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
+    void IDisposable.Dispose() {}
   }
 
-  public sealed class IpHlpApiNeighborTable : INeighborTable {
-    public static bool IsSupported { get; }
+  public readonly struct AddressTableEntry :
+    IEquatable<AddressTableEntry>,
+    IEquatable<IPAddress>,
+    IEquatable<PhysicalAddress>
+  {
+    public static readonly AddressTableEntry Empty; // = "{IP=, MAC=(null), IsPermanent=False, State=None, Iface=}"
+
+    public static IEqualityComparer<AddressTableEntry> DefaultEqualityComparer { get; }
+    public static IEqualityComparer<AddressTableEntry> ExceptStateEqualityComparer { get; }
 
-    public IpHlpApiNeighborTable(IServiceProvider? serviceProvider = null) {}
+    public AddressTableEntry(IPAddress ipAddress, PhysicalAddress? physicalAddress, bool isPermanent, AddressTableEntryState state, string? interfaceId) {}
 
-    [AsyncIteratorStateMachine(typeof(IpHlpApiNeighborTable.<EnumerateEntriesAsync>d__5))]
-    public IAsyncEnumerable<NeighborTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
+    public IPAddress? IPAddress { get; }
+    public string? InterfaceId { get; }
+    public bool IsEmpty { get; }
+    public bool IsPermanent { get; }
+    public PhysicalAddress? PhysicalAddress { get; }
+    public AddressTableEntryState State { get; }
+
+    public bool Equals(AddressTableEntry other) {}
+    public bool Equals(IPAddress? other) {}
+    public bool Equals(PhysicalAddress? other) {}
+    public override bool Equals(object? obj) {}
+    public override int GetHashCode() {}
+    public override string ToString() {}
+  }
+}
+
+namespace Smdn.Net.NetworkScanning {
+  public interface INetworkScanner : IDisposable {
+    ValueTask ScanAsync(CancellationToken cancellationToken);
+    ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken);
   }
 
-  public sealed class NmapCommandNeighborDiscoverer : RunCommandNeighborDiscovererBase {
+  public sealed class ArpScanCommandNetworkScanner : CommandNetworkScanner {
     public static bool IsSupported { get; }
 
-    public NmapCommandNeighborDiscoverer(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider) {}
+    public ArpScanCommandNetworkScanner(IPNetworkProfile? networkProfile, IServiceProvider? serviceProvider) {}
 
-    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToDiscover, out string executable, out string arguments) {}
+    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToScan, out string executable, out string arguments) {}
     protected override bool GetCommandLineArguments(out string executable, out string arguments) {}
   }
 
-  public sealed class NullNeighborDiscoverer : INeighborDiscoverer {
-    public static readonly NullNeighborDiscoverer Instance; // = "Smdn.Net.NeighborDiscovery.NullNeighborDiscoverer"
+  public abstract class CommandNetworkScanner : INetworkScanner {
+    public interface IProcessFactory {
+      Process CreateProcess(ProcessStartInfo processStartInfo);
+    }
 
-    public ValueTask DiscoverAsync(CancellationToken cancellationToken) {}
-    public ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken) {}
-  }
+    protected readonly struct Command {
+      public Command(string name, string? executablePath) {}
 
-  public sealed class ProcfsArpNeighborTable : INeighborTable {
-    public static bool IsSupported { get; }
+      public bool IsAvailable { get; }
+      public string Name { get; }
 
-    public ProcfsArpNeighborTable(IServiceProvider? serviceProvider = null) {}
+      public string GetExecutablePathOrThrow() {}
+    }
 
-    [AsyncIteratorStateMachine(typeof(ProcfsArpNeighborTable.<EnumerateEntriesAsync>d__6))]
-    public IAsyncEnumerable<NeighborTableEntry> EnumerateEntriesAsync([EnumeratorCancellation] CancellationToken cancellationToken = default) {}
-  }
+    protected static IReadOnlyCollection<string> DefaultCommandPaths { get; }
 
-  public abstract class RunCommandNeighborDiscovererBase : INeighborDiscoverer {
-    protected static string FindPathToCommand(string command, IEnumerable<string> paths) {}
+    protected static CommandNetworkScanner.Command FindCommand(string command, IEnumerable<string> paths) {}
 
-    protected RunCommandNeighborDiscovererBase(ILogger? logger) {}
+    protected CommandNetworkScanner(ILogger? logger, IServiceProvider? serviceProvider) {}
 
-    public virtual ValueTask DiscoverAsync(CancellationToken cancellationToken) {}
-    public virtual ValueTask DiscoverAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken) {}
-    protected abstract bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToDiscover, out string executable, out string arguments);
-    protected abstract bool GetCommandLineArguments(out string executable, out string arguments);
+    protected virtual void Dispose(bool disposing) {}
+    public void Dispose() {}
+    protected abstract bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToScan, out string executable, out string? arguments);
+    protected abstract bool GetCommandLineArguments(out string executable, out string? arguments);
+    public virtual ValueTask ScanAsync(CancellationToken cancellationToken = default) {}
+    public virtual ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
   }
 
-  public readonly struct NeighborTableEntry :
-    IEquatable<IPAddress>,
-    IEquatable<PhysicalAddress>
-  {
-    public NeighborTableEntry(IPAddress ipAddress, PhysicalAddress? physicalAddress, bool isPermanent, NeighborTableEntryState state, int? interfaceIndex = null, string? interfaceName = null) {}
+  public sealed class IpHlpApiNetworkScanner : INetworkScanner {
+    public IpHlpApiNetworkScanner(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider = null) {}
 
-    public IPAddress IPAddress { get; }
-    public int? InterfaceIndex { get; }
-    public string? InterfaceName { get; }
-    public bool IsPermanent { get; }
-    public PhysicalAddress? PhysicalAddress { get; }
-    public NeighborTableEntryState State { get; }
+    public ValueTask ScanAsync(CancellationToken cancellationToken = default) {}
+    public async ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
+    void IDisposable.Dispose() {}
+  }
 
-    public bool Equals(IPAddress? other) {}
-    public bool Equals(PhysicalAddress? other) {}
+  public sealed class NmapCommandNetworkScanner : CommandNetworkScanner {
+    public static bool IsSupported { get; }
+
+    public NmapCommandNetworkScanner(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider) {}
+
+    protected override bool GetCommandLineArguments(IEnumerable<IPAddress> addressesToScan, out string executable, out string arguments) {}
+    protected override bool GetCommandLineArguments(out string executable, out string arguments) {}
+  }
+
+  public sealed class PingNetworkScanner : INetworkScanner {
+    public PingNetworkScanner(IPNetworkProfile networkProfile, IServiceProvider? serviceProvider = null) {}
+
+    public void Dispose() {}
+    public ValueTask ScanAsync(CancellationToken cancellationToken = default) {}
+    public ValueTask ScanAsync(IEnumerable<IPAddress> addresses, CancellationToken cancellationToken = default) {}
   }
 }
 // API list generated by Smdn.Reflection.ReverseGenerating.ListApi.MSBuild.Tasks v1.2.1.0.
 // Smdn.Reflection.ReverseGenerating.ListApi.Core v1.2.0.0 (https://github.com/smdn/Smdn.Reflection.ReverseGenerating)

Notes

Full Changelog: releases/Smdn.Net.AddressResolution-1.0.0-preview6...releases/Smdn.Net.AddressResolution-1.0.0-rc1