diff --git a/README.md b/README.md
index 2ab17aa9..55eac1d1 100644
--- a/README.md
+++ b/README.md
@@ -221,3 +221,12 @@ configure with:
 
 The LibBSD Waf support splits the options and converts them to uppercase and
 adds them -D options on the compiler command line.
+
+SMP Requirements
+----------------
+
+In order to support
+[EPOCH(9)](https://www.freebsd.org/cgi/man.cgi?query=epoch&apropos=0&sektion=9)
+a scheduler with thread pinning support is required.  This is the case if you
+use the default scheduler configuration.  EPOCH(9) is a central synchronization
+mechanism of the network stack.