1
0
mirror of https://github.com/golang/go synced 2024-09-29 13:34:30 -06:00

os: document File's concurrent operation resource limits

Document that *os.File is subject to resource limits
for concurrent operations. We aren't documenting
a specific number of concurrent operations because that
number is OS/system dependent. This limit comes from:
    internal/poll/fd_mutex.go
where we use 20 bits to count locks.

Fixes #32544

Change-Id: I7d305d4aaba5b2dbc6f1ab8c447117fde5e31a66
Reviewed-on: https://go-review.googlesource.com/c/go/+/181841
Reviewed-by: Rob Pike <r@golang.org>
This commit is contained in:
Emmanuel T Odeke 2019-06-12 08:19:31 -07:00 committed by Emmanuel Odeke
parent 68e28998d7
commit 919594830f

View File

@ -34,6 +34,10 @@
// } // }
// fmt.Printf("read %d bytes: %q\n", count, data[:count]) // fmt.Printf("read %d bytes: %q\n", count, data[:count])
// //
// Note: The maximum number of concurrent operations on a File may be limited by
// the OS or the system. The number should be high, but exceeding it may degrade
// performance or cause other issues.
//
package os package os
import ( import (