File 1258-kernel-Recommend-against-opening-NFS-mount... of Package erlang

Overview Repositories Revisions Requests Users Attributes Meta

File 1258-kernel-Recommend-against-opening-NFS-mounted-files.patch of Package erlang (Revision aa120d3233f613ad478314c3181372c5)

Currently displaying revision aa120d3233f613ad478314c3181372c5 , Show latest

From 9840537ab271ab25a1f1bb4643f787555b8d9bff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?John=20H=C3=B6gberg?= <john@erlang.org>
Date: Mon, 23 Aug 2021 17:34:17 +0200
Subject: [PATCH] kernel: Recommend against opening NFS-mounted files

---
 lib/kernel/doc/src/file.xml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/lib/kernel/doc/src/file.xml b/lib/kernel/doc/src/file.xml
index 42798530bd..aa1201d381 100644
--- a/lib/kernel/doc/src/file.xml
+++ b/lib/kernel/doc/src/file.xml
@@ -988,6 +988,13 @@ f.txt: {person, "kalle", 25}.
 An <c><anno>IoDevice</anno></c> returned from this call can be used
 as an argument to the I/O functions (see
 <seealso marker="stdlib:io"><c>io(3)</c></seealso>).
+ <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.
+ </warning>
 <note>
 In previous versions of <c>file</c>, modes were specified
 as one of the atoms <c>read</c>, <c>write</c>, or
-- 
2.31.1

Places

File 1258-kernel-Recommend-against-opening-NFS-mounted-files.patch of Package erlang (Revision aa120d3233f613ad478314c3181372c5)

Places