MacOS下O_NONBLOCK标志异常：/dev/ptmx默认非阻塞问题问询

问题背景 #

在MacOS 14.2.1系统、Go 1.22版本环境下，打开/dev/ptmx文件时未指定O_NONBLOCK标志，但该文件默认以非阻塞模式打开。尝试读取文件时会触发EAGAIN错误，即使调用了os.File的Fd()方法（该方法源码逻辑会将文件设置为阻塞模式），仍然会收到EAGAIN错误。

触发EAGAIN错误的代码 #

ptmx, err := os.OpenFile("/dev/ptmx", syscall.O_RDWR, 0)
if err != nil {
    panic(err)
}
err = Unlockpt(ptmx) // 此函数会调用ptmx.Fd()方法
if err != nil {
    fmt.Println("unlock err", err)
    return
}
name, err := Ptsname(ptmx) // 此函数会调用ptmx.Fd()方法
if err != nil {
    fmt.Println("err", err)
    return
}

go func() {
    _, err = io.Copy(os.Stdout, ptmx)
    if err != nil {
        // 此处收到EAGAIN错误
        fmt.Println("copy err", err)
    }
    close(done)
}()

修复方案及原理分析 #

方案1：打开时显式指定O_NONBLOCK标志 #

ptmx, err := os.OpenFile("/dev/ptmx", syscall.O_RDWR|syscall.O_NONBLOCK, 0)
// 此代码正常工作，读取时无EAGAIN错误
go func() {
    _, err = io.Copy(os.Stdout, ptmx)
    if err != nil {
        // 无EAGAIN错误，运行正常
        fmt.Println("copy err", err)
    }
    close(done)
}()

原理解析：
MacOS的/dev/ptmx设备有特殊行为：当未显式指定O_NONBLOCK打开时，内核会强制将其设为非阻塞模式；而如果显式传入O_NONBLOCK标志，后续Go的Fd()方法在将文件转为阻塞模式时，内核会尊重这个修改。这是因为/dev/ptmx在MacOS上的默认行为和标准POSIX定义有差异，显式指定标志后，内核会允许用户态修改其阻塞属性。

方案2：手动调用syscall.SetNonblock设置为阻塞模式 #

调用syscall.SetNonblock(int(ptmx.Fd()), false)后，读取操作不再触发EAGAIN错误。
原理解析：
Go的Fd()方法内部设置阻塞模式的逻辑，可能因为/dev/ptmx的特殊属性没有生效（比如内核层面的强制非阻塞标记未被清除）。而直接调用syscall.SetNonblock是直接对文件描述符的阻塞属性进行底层修改，绕过了Go标准库的封装逻辑，能确保内核真正将文件描述符设置为阻塞模式，因此读取操作会等待数据而非返回EAGAIN。

内容的提问来源于stack exchange，提问作者Shubhang b