diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/godebug.md | 13 | ||||
-rw-r--r-- | doc/next/6-stdlib/99-minor/os/61893.md | 7 | ||||
-rw-r--r-- | doc/next/6-stdlib/99-minor/path/filepath/63703.md | 5 |
3 files changed, 25 insertions, 0 deletions
diff --git a/doc/godebug.md b/doc/godebug.md index 184bae4932..83b4bda89a 100644 --- a/doc/godebug.md +++ b/doc/godebug.md @@ -126,6 +126,19 @@ for example, see the [runtime documentation](/pkg/runtime#hdr-Environment_Variables) and the [go command documentation](/cmd/go#hdr-Build_and_test_caching). +### Go 1.23 + +Go 1.23 changed the mode bits reported by [`os.Lstat`](/pkg/os#Lstat) and [`os.Stat`](/pkg/os#Stat) +for reparse points, which can be controlled with the `winsymlink` setting. +As of Go 1.23 (`winsymlink=1`), mount points no longer have [`os.ModeSymlink`](/pkg/os#ModeSymlink) +set, and reparse points that are not symlinks, Unix sockets, or dedup files now +always have [`os.ModeIrregular`](/pkg/os#ModeIrregular) set. As a result of these changes, +[`filepath.EvalSymlinks`](/pkg/path/filepath#EvalSymlinks) no longer evaluates +mount points, which was a source of many inconsistencies and bugs. +At previous versions (`winsymlink=0`), mount points are treated as symlinks, +and other reparse points with non-default [`os.ModeType`](/pkg/os#ModeType) bits +(such as [`os.ModeDir`](/pkg/os#ModeDir)) do not have the `ModeIrregular` bit set. + ### Go 1.22 Go 1.22 adds a configurable limit to control the maximum acceptable RSA key size diff --git a/doc/next/6-stdlib/99-minor/os/61893.md b/doc/next/6-stdlib/99-minor/os/61893.md new file mode 100644 index 0000000000..b2dd537039 --- /dev/null +++ b/doc/next/6-stdlib/99-minor/os/61893.md @@ -0,0 +1,7 @@ +On Windows, the mode bits reported by [`os.Lstat`](/pkg/os#Lstat) and [`os.Stat`](/pkg/os#Stat) +for reparse points changed. Mount points no longer have [`os.ModeSymlink`](/pkg/os#ModeSymlink) set, +and reparse points that are not symlinks, Unix sockets, or dedup files now +always have [`os.ModeIrregular`](/pkg/os#ModeIrregular) set. +This behavior is controlled by the `winsymlink` setting. +For Go 1.23, it defaults to `winsymlink=1`. +Previous versions default to `winsymlink=0`. diff --git a/doc/next/6-stdlib/99-minor/path/filepath/63703.md b/doc/next/6-stdlib/99-minor/path/filepath/63703.md new file mode 100644 index 0000000000..f5dc76c46a --- /dev/null +++ b/doc/next/6-stdlib/99-minor/path/filepath/63703.md @@ -0,0 +1,5 @@ +On Windows, [`filepath.EvalSymlinks`](/pkg/path/filepath#EvalSymlinks) no longer evaluates +mount points, which was a source of many inconsistencies and bugs. +This behavior is controlled by the `winsymlink` setting. +For Go 1.23, it defaults to `winsymlink=1`. +Previous versions default to `winsymlink=0`. |