1 files changed, 9 insertions, 0 deletions

diff --git a/lib/stdlib/test/shell_docs_SUITE_data/kernel_file_open_2_func.txt b/lib/stdlib/test/shell_docs_SUITE_data/kernel_file_open_2_func.txt
index 24ca2b24d6..b89e725d7b 100644
--- a/lib/stdlib/test/shell_docs_SUITE_data/kernel_file_open_2_func.txt
+++ b/lib/stdlib/test/shell_docs_SUITE_data/kernel_file_open_2_func.txt
@@ -217,6 +217,15 @@
   returned from this call can be used as an argument to the I/O
   functions (see io(3)).
 
+  Warning:
+    While this function can be used to open any file, we recommend
+    against using it for NFS-mounted files, FIFOs, devices, or
+    similar since they can cause IO threads to hang forever.
+
+    If your application needs to interact with these kinds of
+    files we recommend breaking out those parts to a port program
+    instead.
+
   Note:
     In previous versions of file, modes were specified as one of
     the atoms read, write, or read_write instead of a list.