From 98278584ee2c322655849e6d673ac1739e720b53 Mon Sep 17 00:00:00 2001
From: Steven Gabarro <bewchabbacc@gmail.com>
Date: Wed, 7 Nov 2018 05:54:13 -0500
Subject: [PATCH] net: add comments explaining error check

PR-URL: https://github.com/nodejs/node/pull/24222
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
---
 lib/net.js | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/lib/net.js b/lib/net.js
index 743e9c8bfbc91e..2bdf1b81adc7bb 100644
--- a/lib/net.js
+++ b/lib/net.js
@@ -264,9 +264,16 @@ function Socket(options) {
     const { fd } = options;
     let err;
 
+    // createHandle will throw ERR_INVALID_FD_TYPE if `fd` is not
+    // a valid `PIPE` or `TCP` descriptor
     this._handle = createHandle(fd, false);
 
     err = this._handle.open(fd);
+
+    // While difficult to fabricate, in some architectures
+    // `open` may return an error code for valid file descriptors
+    // which cannot be opened. This is difficult to test as most
+    // un-openable fds will throw on `createHandle`
     if (err)
       throw errnoException(err, 'open');