FileStream.FlushAsync(CancellationToken) doesn't actually flush to the underlying device

[cyungmann]

Type of issue

Other (describe below)

Description

The text says (emphasis added):

Asynchronously clears all buffers for this stream, causes any buffered data to be written to the underlying device, and monitors cancellation requests.

However, I don't believe this is correct per dotnet/coreclr#24902

Page URL

https://learn.microsoft.com/en-us/dotnet/api/system.io.filestream.flushasync?view=net-9.0

Content source URL

https://github.com/dotnet/dotnet-api-docs/blob/main/xml/System.IO/FileStream.xml

Document Version Independent Id

46e94ca5-7d11-469d-3c88-6754520d4380

Platform Id

714cf877-f30f-31fd-1175-4a196a7f79fd

Article author

@dotnet-bot

[dotnet-policy-service]

Tagging subscribers to this area: @dotnet/area-system-io