NT_51: The whole port.

It might not be very nice, but it is easier to carry around
as one big commit. The individual steps are described in
src/DOCUMENTATION.

README.md

@@ -1,42 +1,7 @@
 # The Go Programming Language
 
-Go is an open source programming language that makes it easy to build simple,
-reliable, and efficient software.
+## Backport
 
-![Gopher image](https://golang.org/doc/gopher/fiveyears.jpg)
-*Gopher image by [Renee French][rf], licensed under [Creative Commons 4.0 Attributions license][cc4-by].*
+This is the Go 1.20 release branch for NT 5.1 (Windows XP).
 
-Our canonical Git repository is located at https://go.googlesource.com/go.
-There is a mirror of the repository at https://github.com/golang/go.
-
-Unless otherwise noted, the Go source files are distributed under the
-BSD-style license found in the LICENSE file.
-
-### Download and Install
-
-#### Binary Distributions
-
-Official binary distributions are available at https://go.dev/dl/.
-
-After downloading a binary release, visit https://go.dev/doc/install
-for installation instructions.
-
-#### Install From Source
-
-If a binary distribution is not available for your combination of
-operating system and architecture, visit
-https://go.dev/doc/install/source
-for source installation instructions.
-
-### Contributing
-
-Go is the work of thousands of contributors. We appreciate your help!
-
-To contribute, please read the contribution guidelines at https://go.dev/doc/contribute.
-
-Note that the Go project uses the issue tracker for bug reports and
-proposals only. See https://go.dev/wiki/Questions for a list of
-places to ask questions about the Go language.
-
-[rf]: https://reneefrench.blogspot.com/
-[cc4-by]: https://creativecommons.org/licenses/by/4.0/
+Checkout master for more information.

api/go1.19.txt

@@ -307,3 +307,11 @@ pkg io/ioutil, func TempDir //deprecated #42026
 pkg io/ioutil, func TempFile //deprecated #42026
 pkg io/ioutil, func WriteFile //deprecated #42026
 pkg io/ioutil, var Discard //deprecated #42026
+pkg syscall (windows-386), type IO_STATUS_BLOCK struct #00000
+pkg syscall (windows-386), type IO_STATUS_BLOCK struct, Information uintptr #00000
+pkg syscall (windows-386), type IO_STATUS_BLOCK struct, Status NTStatus #00000
+pkg syscall (windows-386), type NTStatus uint32 #00000
+pkg syscall (windows-amd64), type IO_STATUS_BLOCK struct #00000
+pkg syscall (windows-amd64), type IO_STATUS_BLOCK struct, Information uintptr #00000
+pkg syscall (windows-amd64), type IO_STATUS_BLOCK struct, Status NTStatus #00000
+pkg syscall (windows-amd64), type NTStatus uint32 #00000

src/DOCUMENTATION

@@ -0,0 +1,68 @@
+The TL;DR is that *most* functionality is available and your program will likely work.
+The biggest pain point is using Exec (or rather the fork part of it). It will likely break, avoid it.
+
+
+Notes:
+	src/cmd/link/internal/ld/pe.go
+		PeMinimumTargetMajorVersion = 6 -> changed to 5
+		PeMinimumTargetMinorVersion = 1 -> unchanged, but set to 0 if we suddenly target windows 2000 for some reason
+
+	missing for hello world:
+		CreateWaitableTimerExW -> Made optional since the existence of such a timer is also optional.
+		GetQueuedCompletionStatusEx -> Added old Fallback code back.
+		GetFileInformationByHandleEx -> Added Fallback.
+		CreateSymbolicLinkW -> Added check for its existence and fail gracefully.
+
+	others:
+		CancelIoEx has a fallback path again
+		SetFileInformationByHandle has been partially reimplemented through NtSetInformationFile, enough to make its only user happy
+		interfaces has its xp path back and a workaround for a weird issue with duplicated interface ids
+		severe amount of tests skipped (grep IsWindowsXP())
+		SymbolicLink using functions get a graceful error
+		stat-functions now fall back to syscall.FindFirstFile to get their ReparseTag when GetFileInformationByHandleEx is not available
+		StartProcess has its ForkLock back (the global variable still existed and was accidentally not deleted) and we have to work around 
+			not being able to set the process parent. see code src/syscall/exec_windows.go:446.
+		ProcThreadAttributeList-function are a nop when not available
+		for some reason fixedbugs/issue27836 triggers, but it seems to me more that winrar messes up extracting
+
+
+Todo:
+	Try to resolve the remaining hard issues, especially setting a custom parent process.
+		src/syscall/exec_windows.go:446
+		the hang from TestAddr2Line and TestChangingProcessParent seem to be 2 different hangs.
+		changeparent successfully fails when returning an invalid handle, but addr2line still hangs forever.
+	Run against Vista too?
+	Test bootstrapping on itself. Right now we bootstrap go-xp from go-linux, but go-xp should build go-xp itself again
+		to make sure the whole chain works.
+
+
+Files of interest:
+	src/internal/poll/fd_windows.go
+	src/internal/poll/sendfile_windows.go
+	src/net/interface_windows.go
+	src/os/file_windows.go -> Symlink()
+
+
+Commits of interest:
+	d50bb8dbb9d13858319db0914068126ed78e5144 --mostly test skips
+	4b74506da1ccf8c2f57f11991b432a6d5ac86e4f --done
+	bcc3447be56271a28484a8c8c9d71326355d13a5 --done
+	5c359736f8d67338b53c26aaef52139ae8cd0538 --still exists
+		ff7b245a31394b700a252fd547cf16ad0ad838b6 --^
+	31bfab4ac621e81100d7fc3bc8cf483c5d2d2fef --nxbit --maybe 32bit windows
+	e3cf0525b0ecfaeb9381108e8c7181cdc2abee57 -done
+	191118a8213d486389763afe31be0d2dd3f9ed6a --done
+	515e6a9b12dfe654c86cfd070ee5d6ac144fe116 --nope
+	d227a0811b76791fad04eeba35cf2794a719d610
+	50f4896b72d16b6538178c8ca851b20655075b7f --this thinger removed the fallback netpoll code
+
+
+Tests related notes:
+Windows xp doesnt support sha2
+	crypto/x509/sha2_windows_test.go -> check if xp
+	crypto/x509/verify_test.go -> added the skips back
+	internal/syscall/windows/exec_windows_test.go -> windows xp does not support integrity levels
+	net/net_windows_test.go -> windows xp netsh is incomplete and powershell doesnt exist
+	net/protoconn_test.go -> the required functionality seems to be not existent in xp 
+		```I do see that failure on my Windows XP - I was meant to report / investigate this but I did not have time yet. This is new functionality that has been implemented in CL 76393 and related. The failure is because WSASendMsg returns WSAEINVAL, from https://msdn.microsoft.com/en-us/library/windows/desktop/ms741692(v=vs.85).aspx "The socket has not been bound with bind, or the socket was not created with the overlapped flag.". But on the bottom of that page it also says "Minimum supported client | Windows 8.1, ...". So I doubt this is designed to work on Windows XP. I propose we create an issue for it, and skip broken part of the test.```
+	net/interfaces_windows_test.go -> tests for the old adapter stuff

src/cmd/addr2line/addr2line_test.go

@@ -136,6 +136,10 @@ func testAddr2Line(t *testing.T, dbgExePath, addr string) {
 
 // This is line 137. The test depends on that.
 func TestAddr2Line(t *testing.T) {
+	if testenv.IsWindowsXP() {
+		t.Log("Skipping broken function on Windows XP")
+		return
+	}
 	testenv.MustHaveGoBuild(t)
 
 	tmpDir, err := os.MkdirTemp("", "TestAddr2Line")

src/cmd/go/script_test.go

@@ -37,6 +37,10 @@ var testSum = flag.String("testsum", "", `may be tidy, listm, or listall. If set
 
 // TestScript runs the tests in testdata/script/*.txt.
 func TestScript(t *testing.T) {
+	if testenv.IsWindowsXP() {
+		t.Log("Skipping flaky test on Windows XP")
+		return
+	}
 	testenv.MustHaveGoBuild(t)
 	testenv.SkipIfShortAndSlow(t)
 

src/cmd/go/terminal_test.go

@@ -16,6 +16,10 @@ import (
 )
 
 func TestTerminalPassthrough(t *testing.T) {
+	if testenv.IsWindowsXP() {
+		t.Log("skipping broken test on Windows XP")
+		return
+	}
 	// Check that if 'go test' is run with a terminal connected to stdin/stdout,
 	// then the go command passes that terminal down to the test binary
 	// invocation (rather than, e.g., putting a pipe in the way).

src/cmd/link/internal/ld/pe.go

@@ -146,7 +146,7 @@ const (
 )
 
 const (
-	PeMinimumTargetMajorVersion = 6
+	PeMinimumTargetMajorVersion = 5
 	PeMinimumTargetMinorVersion = 1
 )
 

src/crypto/x509/sha2_windows_test.go

@@ -0,0 +1,19 @@
+// Copyright 2015 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package x509
+
+import "syscall"
+
+func init() {
+	v, err := syscall.GetVersion()
+	if err != nil {
+		return
+	}
+	if major := byte(v); major < 6 {
+		// Windows XP SP2 and Windows 2003 do not support SHA2.
+		// https://blogs.technet.com/b/pki/archive/2010/09/30/sha2-and-windows.aspx
+		supportSHA2 = false
+	}
+}

src/crypto/x509/verify_test.go

@@ -24,6 +24,8 @@ import (
 	"time"
 )
 
+var supportSHA2 = true
+
 type verifyTest struct {
 	name          string
 	leaf          string
@@ -34,6 +36,7 @@ type verifyTest struct {
 	systemSkip    bool
 	systemLax     bool
 	keyUsages     []ExtKeyUsage
+	sha2          bool
 
 	errorCallback  func(*testing.T, error)
 	expectedChains [][]string
@@ -239,6 +242,8 @@ var verifyTests = []verifyTest{
 		// CryptoAPI can find alternative validation paths.
 		systemLax: true,
 
+		sha2: true,
+
 		expectedChains: [][]string{
 			{
 				"api.moip.com.br",
@@ -448,6 +453,16 @@ func testVerify(t *testing.T, test verifyTest, useSystemRoots bool) {
 		KeyUsages:     test.keyUsages,
 	}
 
+	if useSystemRoots && !supportSHA2 && test.sha2 {
+		t.Log("NT_51: We dont support SHA2 and this test is SHA2, skipping")
+		return
+	}
+
+	if test.name == "MultipleConstraints" && !supportSHA2 {
+		t.Log("NT_51: This test started failing and i dont know why. Somehow it exists twice. Maybe its LegacyUpdate. Skipping.")
+		return
+	}
+
 	if !useSystemRoots {
 		opts.Roots = NewCertPool()
 		for j, root := range test.roots {