Go Tool Shared Flags: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
 
(24 intermediate revisions by the same user not shown)
Line 1: Line 1:
=Internal=
=Internal=
* [[Go_Tool#Shared_Flags|<tt>go</tt> Tool]]


* [[Go Commands - build#Shared_Tool_Flags|build]]
=Overview=


=Overview=
These flags are shared by the <code>[[Go_Tool#build|build]]</code>, <code>[[Go_Tool#clean|clean]]</code>, <code>[[Go_Tool#get|get]]</code>, <code>[[Go_Tool#install|install]]</code>, <code>[[Go_Tool#list|list]]</code>, <code>[[Go_Tool#run|run]]</code>, and <code>[[Go_Tool#test|test]]</code> commands.


These flags are shared by the [[Go Commands - build#Shared_Tool_Flags|build]], [[Go Commands - clean#Shared_Tool_Flags|clean]], [[Go Commands - get#Shared_Tool_Flags|get]], [[Go Commands - install#Shared_Tool_Flags|install]], list, [[Go Commands - run#Shared_Tool_Flags|run]], and test commands
=<tt>-v</tt>=
 
Print the names of packages as they are compiled.
=<tt>-x</tt>=
Print the commands while running them.


=<tt>-a</tt>=
=<tt>-a</tt>=
Line 14: Line 19:


Print the commands but do not run them.
Print the commands but do not run them.
=<tt>-work</tt>=
Print the name of the temporary work directory and do not delete it when exiting.


=<tt>-p</tt>=
=<tt>-p</tt>=
Line 30: Line 38:


Enable interoperation with memory sanitizer. Supported only on linux/amd64, and only with Clang/LLVM as the host C compiler.
Enable interoperation with memory sanitizer. Supported only on linux/amd64, and only with Clang/LLVM as the host C compiler.
=<tt>-v</tt>=
Print the names of packages as they are compiled.
=<tt>-work</tt>=
Print the name of the temporary work directory and do not delete it when exiting.
=<tt>-x</tt>=
Print the commands.
=To Process=
<pre>
-asmflags 'flag list'
arguments to pass on each go tool asm invocation.
-buildmode mode
build mode to use. See 'go help buildmode' for more.
-compiler name
name of compiler to use, as in runtime.Compiler (gccgo or gc).
-gccgoflags 'arg list'
arguments to pass on each gccgo compiler/linker invocation.
-gcflags 'arg list'
arguments to pass on each go tool compile invocation.
-installsuffix suffix
a suffix to use in the name of the package installation directory,
in order to keep output separate from default builds.
If using the -race flag, the install suffix is automatically set to race
or, if set explicitly, has _race appended to it.  Likewise for the -msan
flag.  Using a -buildmode option that requires non-default compile flags
has a similar effect.
-ldflags 'flag list'
arguments to pass on each go tool link invocation.
-linkshared
link against shared libraries previously created with
-buildmode=shared.
-pkgdir dir
install and load all packages from dir instead of the usual locations.
For example, when building with a non-standard configuration,
use -pkgdir to keep generated packages in a separate location.
-tags 'tag list'
a list of build tags to consider satisfied during the build.
For more information about build tags, see the description of
build constraints in the documentation for the go/build package.
-toolexec 'cmd args'
a program to use to invoke toolchain programs like vet and asm.
For example, instead of running asm, the go command will run
'cmd args /path/to/asm <arguments for asm>'.
The list flags accept a space-separated list of strings. To embed spaces
in an element in the list, surround it with either single or double quotes.
</pre>

Latest revision as of 00:29, 3 October 2023

Internal

Overview

These flags are shared by the build, clean, get, install, list, run, and test commands.

-v

Print the names of packages as they are compiled.

-x

Print the commands while running them.

-a

Force rebuilding of packages that are already up-to-date.

-n

Print the commands but do not run them.

-work

Print the name of the temporary work directory and do not delete it when exiting.

-p

-p n

represents the number of programs, such as build commands or test binaries, that can be run in parallel. The default is the number of CPUs available, except on darwin/arm which defaults to 1.

-race

Enable data race detection. Supported only on linux/amd64, freebsd/amd64, darwin/amd64 and windows/amd64.

-msan

Enable interoperation with memory sanitizer. Supported only on linux/amd64, and only with Clang/LLVM as the host C compiler.