diff --git a/lib/std/os.zig b/lib/std/os.zig
index d239f198f473041f108baa4d49123ea168982ec8..a1fe051997f788dcc23abc644f1fa57bf881095b 100644
--- a/lib/std/os.zig
+++ b/lib/std/os.zig
@@ -663,7 +663,8 @@ pub fn dup2(old_fd: fd_t, new_fd: fd_t) !void {
             0 => return,
             EBUSY, EINTR => continue,
             EMFILE => return error.ProcessFdQuotaExceeded,
-            EINVAL => unreachable,
+            EINVAL => unreachable, // invalid parameters passed to dup2
+            EBADF => unreachable, // always a race condition
             else => |err| return unexpectedErrno(err),
         }
     }