diff --git a/docs/EXPERIMENTAL.md b/docs/EXPERIMENTAL.md index c5083e9f65..f2cd6416b7 100644 --- a/docs/EXPERIMENTAL.md +++ b/docs/EXPERIMENTAL.md @@ -126,3 +126,20 @@ Graduation requirements: - no test cases are disabled for the feature - feedback from users saying the API works for their use cases + +## Apple fast UDP + +There are undocumented system calls available in Apple operating systems that +when used allow for faster sending and receiving of UDP messages. + +The undocumented and thus unsupported-by-Apple nature of these functions +brings a risk that they are removed in a future OS update, or perhaps worse: +marginally modified to instead cause subtle and hard-to-spot bugs. + +Graduation requirements: + +- testimonials from users that these work reliably + +- measurements that show they make a measurable performance impact + +- an easy way to (re-)build curl to not use these functions