NAME

       go-clean - remove object files and cached files

SYNOPSIS

       go clean [-i] [-r] [-n] [-x] [packages]

DESCRIPTION

       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.

OPTIONS

       -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).

AUTHOR

       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).

                                                   2022-03-15                                        GO-CLEAN(1)