go-clean - remove object files and cached files
go clean [-i] [-r] [-n] [-x]
[packages]
Clean removes object files from package source directories. The go
command builds most objects in a temporary directory, so go clean is mainly
concerned with object files left by other tools or by manual invocations of
go build.
If a package argument is given or the -i or -r flag is set, clean
removes the following files from each of the source directories
corresponding to the import paths:
- _obj/
- old object directory, left from Makefiles
- _test/
- old test directory, left from Makefiles
- _testmain.go
- old gotest file, left from Makefiles
- test.out
- old test log, left from Makefiles
- build.out
- old test log, left from Makefiles
- *.[568ao]
- object files, left from Makefiles
- DIR(.exe)
- from go build
- DIR.test(.exe)
- from go test -c
- MAINFILE(.exe)
- from go build MAINFILE.go
- *.so
- from SWIG
In the list, DIR represents the final path element of the
directory, and MAINFILE is the base name of any Go source file in the
directory that is not included when building the package.
- -i
- The -i flag causes clean to remove the corresponding installed archive or
binary (what ‘go install’ would create).
- -n
- The -n flag causes clean to print the remove commands it would execute,
but not run them.
- -r
- The -r flag causes clean to be applied recursively to all the dependencies
of the packages named by the import paths.
- -x
- The -x flag causes clean to print remove commands as it executes
them.
- -cache
- The -cache flag causes clean to remove the entire go build cache.
- -testcache
- The -testcache flag causes clean to expire all test results in the go
build cache.
- -modcache
- The -modcache flag causes clean to remove the entire module download
cache, including unpacked source code of versioned dependencies.
- -fuzzcache
- The -fuzzcache flag causes clean to remove files stored in the Go build
cache for fuzz testing. The fuzzing engine caches files that expand code
coverage, so removing them may make fuzzing less effective until new
inputs are found that provide the same coverage. These files are distinct
from those stored in testdata directory; clean does not remove those
files.
For more about build flags, see go-build(1).
For more about specifying packages, see go-packages(7).
This manual page was written by Michael Stapelberg
<stapelberg@debian.org> and is maintained by the Debian Go Compiler
Team <team+go-compiler@tracker.debian.org> based on the output of
‘go help clean’ for the Debian project (and may be used by
others).