Merge remote-tracking branch 'origin_1/master' into master

# Conflicts: # go.sum
go-delve · Sep 8, 2020 · d75633f · d75633f
2 parents 27257ff + 7555d1c
commit d75633f
Show file tree

Hide file tree

Showing 305 changed files with 22,835 additions and 85,020 deletions.
diff --git a/.travis.yml b/.travis.yml
@@ -12,9 +12,9 @@ arch:
   - arm64
 
 go:
+  - 1.15.x
   - 1.14.x
   - 1.13.x
-  - 1.12.x
   - tip
 
 matrix:
@@ -26,17 +26,17 @@ matrix:
     - os: windows
       arch: arm64
     - os: windows
-      go: 1.13.x
+      go: 1.14.x
     - os: windows
-      go: 1.12.x
-    - os: osx
       go: 1.13.x
     - os: osx
-      go: 1.12.x
-    - arch: arm64
+      go: 1.14.x
+    - os: osx
       go: 1.13.x
     - arch: arm64
-      go: 1.12.x
+      go: 1.14.x
+    - arch: arm64
+      go: 1.13.x
     - os: windows
       go: tip
     - arch: arm64
@@ -53,7 +53,7 @@ jobs:
   include:
     -  os: linux
        services: docker
-       env: go_32_version=1.14
+       env: go_32_version=1.14 # Linux/i386 tests held back to Go1.14 until issue #2134 is fixed
 
 script: >-
     if [ $TRAVIS_OS_NAME = "linux" ] && [ $go_32_version ]; then

diff --git a/Documentation/api/ClientHowto.md b/Documentation/api/ClientHowto.md
@@ -37,7 +37,7 @@ The `--log-to-file` and `--log-to-fd` options can be used to redirect the "API s
 
 ## Controlling the backend
 
-Once you have a running headless instance you can connect to it and start sending commands. Delve's protocol is built on top of the [JSON-RPC](http://json-rpc.org) specification.
+Once you have a running headless instance you can connect to it and start sending commands. Delve's protocol is built on top of the [JSON-RPC 1.0 specification](https://www.jsonrpc.org/specification_v1).
 
 The methods of a `service/rpc2.RPCServer` are exposed through this connection, to find out which requests you can send see the documentation of RPCServer on [godoc](https://godoc.org/github.com/go-delve/Delve/service/rpc2#RPCServer). 
 

diff --git a/Documentation/cli/README.md b/Documentation/cli/README.md
@@ -412,17 +412,23 @@ Restart process.
 
 For recorded targets the command takes the following forms:
 
-	restart				resets ot the start of the recording
-	restart [checkpoint]		resets the recording to the given checkpoint
-	restart -r [newargv...]		re-records the target process
+	restart					resets ot the start of the recording
+	restart [checkpoint]			resets the recording to the given checkpoint
+	restart -r [newargv...]	[redirects...]	re-records the target process
 
 For live targets the command takes the following forms:
 
-	restart [newargv...]		restarts the process
+	restart [newargv...] [redirects...]	restarts the process
 
 If newargv is omitted the process is restarted (or re-recorded) with the same argument vector.
 If -noargs is specified instead, the argument vector is cleared.
 
+A list of file redirections can be specified after the new argument list to override the redirections defined using the '--redirect' command line option. A syntax similar to Unix shells is used:
+
+	<input.txt	redirects the standard input of the target process from input.txt
+	>output.txt	redirects the standard output of the target process to output.txt
+	2>error.txt	redirects the standard error of the target process to error.txt
+
 
 Aliases: r
 

diff --git a/Documentation/cli/starlark.md b/Documentation/cli/starlark.md
@@ -51,7 +51,7 @@ threads() | Equivalent to API call [ListThreads](https://godoc.org/github.com/go
 types(Filter) | Equivalent to API call [ListTypes](https://godoc.org/github.com/go-delve/delve/service/rpc2#RPCServer.ListTypes)
 process_pid() | Equivalent to API call [ProcessPid](https://godoc.org/github.com/go-delve/delve/service/rpc2#RPCServer.ProcessPid)
 recorded() | Equivalent to API call [Recorded](https://godoc.org/github.com/go-delve/delve/service/rpc2#RPCServer.Recorded)
-restart(Position, ResetArgs, NewArgs, Rerecord, Rebuild) | Equivalent to API call [Restart](https://godoc.org/github.com/go-delve/delve/service/rpc2#RPCServer.Restart)
+restart(Position, ResetArgs, NewArgs, Rerecord, Rebuild, NewRedirects) | Equivalent to API call [Restart](https://godoc.org/github.com/go-delve/delve/service/rpc2#RPCServer.Restart)
 set_expr(Scope, Symbol, Value) | Equivalent to API call [Set](https://godoc.org/github.com/go-delve/delve/service/rpc2#RPCServer.Set)
 stacktrace(Id, Depth, Full, Defers, Opts, Cfg) | Equivalent to API call [Stacktrace](https://godoc.org/github.com/go-delve/delve/service/rpc2#RPCServer.Stacktrace)
 state(NonBlocking) | Equivalent to API call [State](https://godoc.org/github.com/go-delve/delve/service/rpc2#RPCServer.State)

diff --git a/Documentation/faq.md b/Documentation/faq.md
@@ -3,7 +3,7 @@
 #### I'm getting an error while compiling Delve / unsupported architectures and OSs
 
 The most likely cause of this is that you are running an unsupported Operating System or architecture.
-Currently Delve supports Linux, Windows and macOS on the amd64 architecture (also known as Intel 86x64).
+Currently Delve supports Linux, Windows and macOS on the amd64 (also known as Intel 86x64) architecture and Linux on the arm64 (also known as ARM AArch64) and i386 architectures.
 
 For example if you are getting the `undefined: ArchInst` error message while compiling Delve, that means that Delve doesn't currently support your processor architecture.
 

diff --git a/Documentation/usage/dlv.md b/Documentation/usage/dlv.md
@@ -19,19 +19,21 @@ Pass flags to the program you are debugging using `--`, for example:
 ### Options
 
 ```
-      --accept-multiclient   Allows a headless server to accept multiple client connections.
-      --api-version int      Selects API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md. (default 1)
-      --backend string       Backend selection (see 'dlv help backend'). (default "default")
-      --build-flags string   Build flags, to be passed to the compiler.
-      --check-go-version     Checks that the version of Go in use is compatible with Delve. (default true)
-      --headless             Run debug server only, in headless mode.
-      --init string          Init file, executed by the terminal client.
-  -l, --listen string        Debugging server listen address. (default "127.0.0.1:0")
-      --log                  Enable debugging server logging.
-      --log-dest string      Writes logs to the specified file or file descriptor (see 'dlv help log').
-      --log-output string    Comma separated list of components that should produce debug output (see 'dlv help log')
-      --only-same-user       Only connections from the same user that started this instance of Delve are allowed to connect. (default true)
-      --wd string            Working directory for running the program. (default ".")
+      --accept-multiclient               Allows a headless server to accept multiple client connections.
+      --allow-non-terminal-interactive   Allows interactive sessions of Delve that don't have a terminal as stdin, stdout and stderr
+      --api-version int                  Selects API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md. (default 1)
+      --backend string                   Backend selection (see 'dlv help backend'). (default "default")
+      --build-flags string               Build flags, to be passed to the compiler.
+      --check-go-version                 Checks that the version of Go in use is compatible with Delve. (default true)
+      --headless                         Run debug server only, in headless mode.
+      --init string                      Init file, executed by the terminal client.
+  -l, --listen string                    Debugging server listen address. (default "127.0.0.1:0")
+      --log                              Enable debugging server logging.
+      --log-dest string                  Writes logs to the specified file or file descriptor (see 'dlv help log').
+      --log-output string                Comma separated list of components that should produce debug output (see 'dlv help log')
+      --only-same-user                   Only connections from the same user that started this instance of Delve are allowed to connect. (default true)
+  -r, --redirect stringArray             Specifies redirect rules for target process (see 'dlv help redirect')
+      --wd string                        Working directory for running the program.
 ```
 
 ### SEE ALSO

diff --git a/Documentation/usage/dlv_attach.md b/Documentation/usage/dlv_attach.md
@@ -25,19 +25,21 @@ dlv attach pid [executable]
 ### Options inherited from parent commands
 
 ```
-      --accept-multiclient   Allows a headless server to accept multiple client connections.
-      --api-version int      Selects API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md. (default 1)
-      --backend string       Backend selection (see 'dlv help backend'). (default "default")
-      --build-flags string   Build flags, to be passed to the compiler.
-      --check-go-version     Checks that the version of Go in use is compatible with Delve. (default true)
-      --headless             Run debug server only, in headless mode.
-      --init string          Init file, executed by the terminal client.
-  -l, --listen string        Debugging server listen address. (default "127.0.0.1:0")
-      --log                  Enable debugging server logging.
-      --log-dest string      Writes logs to the specified file or file descriptor (see 'dlv help log').
-      --log-output string    Comma separated list of components that should produce debug output (see 'dlv help log')
-      --only-same-user       Only connections from the same user that started this instance of Delve are allowed to connect. (default true)
-      --wd string            Working directory for running the program. (default ".")
+      --accept-multiclient               Allows a headless server to accept multiple client connections.
+      --allow-non-terminal-interactive   Allows interactive sessions of Delve that don't have a terminal as stdin, stdout and stderr
+      --api-version int                  Selects API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md. (default 1)
+      --backend string                   Backend selection (see 'dlv help backend'). (default "default")
+      --build-flags string               Build flags, to be passed to the compiler.
+      --check-go-version                 Checks that the version of Go in use is compatible with Delve. (default true)
+      --headless                         Run debug server only, in headless mode.
+      --init string                      Init file, executed by the terminal client.
+  -l, --listen string                    Debugging server listen address. (default "127.0.0.1:0")
+      --log                              Enable debugging server logging.
+      --log-dest string                  Writes logs to the specified file or file descriptor (see 'dlv help log').
+      --log-output string                Comma separated list of components that should produce debug output (see 'dlv help log')
+      --only-same-user                   Only connections from the same user that started this instance of Delve are allowed to connect. (default true)
+  -r, --redirect stringArray             Specifies redirect rules for target process (see 'dlv help redirect')
+      --wd string                        Working directory for running the program.
 ```
 
 ### SEE ALSO

diff --git a/Documentation/usage/dlv_backend.md b/Documentation/usage/dlv_backend.md
@@ -18,19 +18,21 @@ are:
 ### Options inherited from parent commands
 
 ```
-      --accept-multiclient   Allows a headless server to accept multiple client connections.
-      --api-version int      Selects API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md. (default 1)
-      --backend string       Backend selection (see 'dlv help backend'). (default "default")
-      --build-flags string   Build flags, to be passed to the compiler.
-      --check-go-version     Checks that the version of Go in use is compatible with Delve. (default true)
-      --headless             Run debug server only, in headless mode.
-      --init string          Init file, executed by the terminal client.
-  -l, --listen string        Debugging server listen address. (default "127.0.0.1:0")
-      --log                  Enable debugging server logging.
-      --log-dest string      Writes logs to the specified file or file descriptor (see 'dlv help log').
-      --log-output string    Comma separated list of components that should produce debug output (see 'dlv help log')
-      --only-same-user       Only connections from the same user that started this instance of Delve are allowed to connect. (default true)
-      --wd string            Working directory for running the program. (default ".")
+      --accept-multiclient               Allows a headless server to accept multiple client connections.
+      --allow-non-terminal-interactive   Allows interactive sessions of Delve that don't have a terminal as stdin, stdout and stderr
+      --api-version int                  Selects API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md. (default 1)
+      --backend string                   Backend selection (see 'dlv help backend'). (default "default")
+      --build-flags string               Build flags, to be passed to the compiler.
+      --check-go-version                 Checks that the version of Go in use is compatible with Delve. (default true)
+      --headless                         Run debug server only, in headless mode.
+      --init string                      Init file, executed by the terminal client.
+  -l, --listen string                    Debugging server listen address. (default "127.0.0.1:0")
+      --log                              Enable debugging server logging.
+      --log-dest string                  Writes logs to the specified file or file descriptor (see 'dlv help log').
+      --log-output string                Comma separated list of components that should produce debug output (see 'dlv help log')
+      --only-same-user                   Only connections from the same user that started this instance of Delve are allowed to connect. (default true)
+  -r, --redirect stringArray             Specifies redirect rules for target process (see 'dlv help redirect')
+      --wd string                        Working directory for running the program.
 ```
 
 ### SEE ALSO

diff --git a/Documentation/usage/dlv_connect.md b/Documentation/usage/dlv_connect.md
@@ -14,19 +14,21 @@ dlv connect addr
 ### Options inherited from parent commands
 
 ```
-      --accept-multiclient   Allows a headless server to accept multiple client connections.
-      --api-version int      Selects API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md. (default 1)
-      --backend string       Backend selection (see 'dlv help backend'). (default "default")
-      --build-flags string   Build flags, to be passed to the compiler.
-      --check-go-version     Checks that the version of Go in use is compatible with Delve. (default true)
-      --headless             Run debug server only, in headless mode.
-      --init string          Init file, executed by the terminal client.
-  -l, --listen string        Debugging server listen address. (default "127.0.0.1:0")
-      --log                  Enable debugging server logging.
-      --log-dest string      Writes logs to the specified file or file descriptor (see 'dlv help log').
-      --log-output string    Comma separated list of components that should produce debug output (see 'dlv help log')
-      --only-same-user       Only connections from the same user that started this instance of Delve are allowed to connect. (default true)
-      --wd string            Working directory for running the program. (default ".")
+      --accept-multiclient               Allows a headless server to accept multiple client connections.
+      --allow-non-terminal-interactive   Allows interactive sessions of Delve that don't have a terminal as stdin, stdout and stderr
+      --api-version int                  Selects API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md. (default 1)
+      --backend string                   Backend selection (see 'dlv help backend'). (default "default")
+      --build-flags string               Build flags, to be passed to the compiler.
+      --check-go-version                 Checks that the version of Go in use is compatible with Delve. (default true)
+      --headless                         Run debug server only, in headless mode.
+      --init string                      Init file, executed by the terminal client.
+  -l, --listen string                    Debugging server listen address. (default "127.0.0.1:0")
+      --log                              Enable debugging server logging.
+      --log-dest string                  Writes logs to the specified file or file descriptor (see 'dlv help log').
+      --log-output string                Comma separated list of components that should produce debug output (see 'dlv help log')
+      --only-same-user                   Only connections from the same user that started this instance of Delve are allowed to connect. (default true)
+  -r, --redirect stringArray             Specifies redirect rules for target process (see 'dlv help redirect')
+      --wd string                        Working directory for running the program.
 ```
 
 ### SEE ALSO

diff --git a/Documentation/usage/dlv_core.md b/Documentation/usage/dlv_core.md
@@ -20,19 +20,21 @@ dlv core <executable> <core>
 ### Options inherited from parent commands
 
 ```
-      --accept-multiclient   Allows a headless server to accept multiple client connections.
-      --api-version int      Selects API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md. (default 1)
-      --backend string       Backend selection (see 'dlv help backend'). (default "default")
-      --build-flags string   Build flags, to be passed to the compiler.
-      --check-go-version     Checks that the version of Go in use is compatible with Delve. (default true)
-      --headless             Run debug server only, in headless mode.
-      --init string          Init file, executed by the terminal client.
-  -l, --listen string        Debugging server listen address. (default "127.0.0.1:0")
-      --log                  Enable debugging server logging.
-      --log-dest string      Writes logs to the specified file or file descriptor (see 'dlv help log').
-      --log-output string    Comma separated list of components that should produce debug output (see 'dlv help log')
-      --only-same-user       Only connections from the same user that started this instance of Delve are allowed to connect. (default true)
-      --wd string            Working directory for running the program. (default ".")
+      --accept-multiclient               Allows a headless server to accept multiple client connections.
+      --allow-non-terminal-interactive   Allows interactive sessions of Delve that don't have a terminal as stdin, stdout and stderr
+      --api-version int                  Selects API version when headless. New clients should use v2. Can be reset via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md. (default 1)
+      --backend string                   Backend selection (see 'dlv help backend'). (default "default")
+      --build-flags string               Build flags, to be passed to the compiler.
+      --check-go-version                 Checks that the version of Go in use is compatible with Delve. (default true)
+      --headless                         Run debug server only, in headless mode.
+      --init string                      Init file, executed by the terminal client.
+  -l, --listen string                    Debugging server listen address. (default "127.0.0.1:0")
+      --log                              Enable debugging server logging.
+      --log-dest string                  Writes logs to the specified file or file descriptor (see 'dlv help log').
+      --log-output string                Comma separated list of components that should produce debug output (see 'dlv help log')
+      --only-same-user                   Only connections from the same user that started this instance of Delve are allowed to connect. (default true)
+  -r, --redirect stringArray             Specifies redirect rules for target process (see 'dlv help redirect')
+      --wd string                        Working directory for running the program.
 ```
 
 ### SEE ALSO