SubEtha

Author(s)

• Mark Newton

Tags

pwrs powershell ipc shared-memory cross-process cmdlet bindings

Cmdlets

New-SubEthaAtomic Open-SubEthaAtomic New-SubEthaRegion Open-SubEthaRegion New-SubEthaCell Open-SubEthaCell New-SubEthaVec Open-SubEthaVec New-SubEthaSharedArc Open-SubEthaSharedArc New-SubEthaLazyValue Open-SubEthaLazyValue New-SubEthaBitVec Open-SubEthaBitVec New-SubEthaSpscRing Open-SubEthaSpscRing New-SubEthaBroadcastRing Open-SubEthaBroadcastRing New-SubEthaCapacityRing Open-SubEthaCapacityRing New-SubEthaLocaleRing Open-SubEthaLocaleRing New-SubEthaRing Open-SubEthaRing New-SubEthaReorderWindow New-SubEthaStack Open-SubEthaStack New-SubEthaDeque Open-SubEthaDeque New-SubEthaPubSub Open-SubEthaPubSub New-SubEthaLamportPair New-SubEthaFrameRegion Open-SubEthaFrameRegion New-SubEthaArena Open-SubEthaArena New-SubEthaLinkedList Open-SubEthaLinkedList New-SubEthaSlab Open-SubEthaSlab New-SubEthaBTreeMap Open-SubEthaBTreeMap New-SubEthaHashMap Open-SubEthaHashMap New-SubEthaMpscPool New-SubEthaMpmcGrid New-SubEthaNotifierSet New-SubEthaLeaderElection Open-SubEthaLeaderElection New-SubEthaHolderTable Open-SubEthaHolderTable New-SubEthaHeartbeat Open-SubEthaHeartbeat New-SubEthaEpochBarrier Open-SubEthaEpochBarrier New-SubEthaCondvar Open-SubEthaCondvar Wait-SubEthaCondition New-SubEthaFenceClock Open-SubEthaFenceClock New-SubEthaEpochs Open-SubEthaEpochs New-SubEthaRWLock Open-SubEthaRWLock New-SubEthaSemaphore Open-SubEthaSemaphore New-SubEthaOwnerLease Open-SubEthaOwnerLease New-SubEthaBloomFilter Open-SubEthaBloomFilter Measure-SubEthaBloomSize New-SubEthaBlockedBloomFilter Open-SubEthaBlockedBloomFilter New-SubEthaHyperLogLog Open-SubEthaHyperLogLog New-SubEthaCountMinSketch Open-SubEthaCountMinSketch Measure-SubEthaSketchSize New-SubEthaHistogram Open-SubEthaHistogram New-SubEthaRateLimiter Open-SubEthaRateLimiter New-SubEthaLruCache Open-SubEthaLruCache New-SubEthaReservoir Open-SubEthaReservoir New-SubEthaHandleTable Open-SubEthaHandleTable New-SubEthaTimePointTile Open-SubEthaTimePointTile New-SubEthaVersionChain Open-SubEthaVersionChain New-SubEthaVersionedSlab Open-SubEthaVersionedSlab New-SubEthaVersionedMap Open-SubEthaVersionedMap New-SubEthaLanedMap Open-SubEthaLanedMap New-SubEthaTopologyMap Open-SubEthaTopologyMap New-SubEthaGraph Open-SubEthaGraph New-SubEthaUniversal Open-SubEthaUniversal New-SubEthaTower Open-SubEthaTower New-SubEthaChannel Open-SubEthaChannel New-SubEthaAdaptiveQueue New-SubEthaWorkQueue Open-SubEthaWorkQueue New-SubEthaKvMap New-SubEthaQosPolicy New-SubEthaTinyBloom New-SubEthaFineBloom New-SubEthaClock New-SubEthaCausalClock New-SubEthaSensSender New-SubEthaSensReceiver New-SubEthaLossKind New-SubEthaLossBursts New-SubEthaTiming New-SubEthaRoundTripShape New-SubEthaPeriodicity New-SubEthaCapacity New-SubEthaForecast New-SubEthaPathChanges New-SubEthaTcpBridgeClient New-SubEthaTcpBridgeServer New-SubEthaSelfSignedCert New-SubEthaQuicBridgeClient New-SubEthaQuicBridgeServer Get-SubEthaTransport Send-SubEthaItem Receive-SubEthaItem New-SubEthaAdaptive Get-SubEthaSidecar Set-SubEthaSidecar Invoke-SubEthaSidecarScan

PSEditions

Desktop Core

Dependencies

This module has no dependencies.

Release Notes

The module reaches the process's sidecar: twenty-six structures and a new Adaptive object register with it through Observe(), a registration reads the InstanceStats the sidecar drains, and a ScriptBlock policy decides on the sidecar's own thread which tag an object runs at. Get-SubEthaSidecar, Set-SubEthaSidecar and Invoke-SubEthaSidecarScan manage it, and the Ring, CapacityRing and LocaleRing cmdlets take -Managed and -ScanIntervalUs to run a ring's own sidecar. The module imports in PowerShell 7.4 and later, where 0.5.1 needed 7.6, and in Windows PowerShell 5.1 as before. It is built with PoWerRuSt and cargo-pwrs 0.3.2, which compile its PowerShell 7 half against .NET 8 whichever machine builds it. It adds the shm: drive: $shm:name = value publishes a value every process of the user reads as $shm:name, live, outliving the session. 0.5.1 said the module works on FreeBSD x64, but that half referenced .NET 10 and did not import in FreeBSD's PowerShell 7.5.5; this one does. In Windows PowerShell 5.1, where the first PWRS module a session imports serves every later one, import it before a module built by an older cargo-pwrs: after one built by 0.2.x through 0.3.1 it fails with pwrs_module_init status 4, and after one built by 0.1.8 or earlier with a type initializer error, as https://variably-constant.github.io/SubEtha/docs/how-to/powershell/troubleshoot/ describes. On Windows a lock, semaphore or condition wait sleeps in the kernel once its monitor budget runs out, where it held a processor for as long as it waited: an idle waiter is charged 0.000 to 0.003 of a core rather than 0.953 to 1.008, measured on Windows 11 / Ryzen 9 7900X. The waker behind those waits starts each wake scan and ends each park with a fence, which closes a lost wake shown on blocking rings, where a consumer slept beside an item until its timeout. A QUIC bridge client no longer writes a line of UDP counts to stderr each time it finishes, and no longer fails with a lost connection after the server has received every item: over 200 round trips on Linux x86-64, 4 failed that way in PowerShell 7.4.20 and 3 in 7.6.5 before, and none in either after. A LocaleRing from Open-SubEthaLocaleRing takes producer and consumer ids beside the handles already registered on the ring, where its RegisterProducer() or RegisterConsumer() panicked in the native library once another handle had registered. The module's 227 Pester tests pass on Windows (PowerShell 7.6.6 and Windows PowerShell 5.1), Linux x64, macOS arm64 and FreeBSD x64.