NAME

       go - tool for managing Go source code

SYNOPSIS

       go list [-e] [-f format] [-json] [ packages ]

DESCRIPTION

       List lists the packages named by the import paths, one per line.

       The default output shows the package import path:

             code.google.com/p/google-api-go-client/books/v1
             code.google.com/p/goauth2/oauth
             code.google.com/p/sqlite

OPTIONS

       -f     The -f flag specifies an alternate format for the list, using the syntax of package template.  The
              default output is equivalent to -f '{{.ImportPath}}'.  The struct being passed to the template is:

                    type Package struct {
                        Dir        string // directory containing package sources
                        ImportPath string // import path of package in dir
                        Name       string // package name
                        Doc        string // package documentation string
                        Target     string // install path
                        Goroot     bool   // is this package in the Go root?
                        Standard   bool   // is this package part of the standard Go library?
                        Stale      bool   // would 'go install' do anything for this package?
                        Root       string // Go root or Go path dir containing this package

                        // Source files
                        GoFiles  []string  // .go source files (excluding CgoFiles, TestGoFiles, XTestGoFiles)
                        CgoFiles []string  // .go sources files that import "C"
                        CFiles   []string  // .c source files
                        HFiles   []string  // .h source files
                        SFiles   []string  // .s source files
                        SysoFiles []string // .syso object files to add to archive

                        // Cgo directives
                        CgoCFLAGS    []string // cgo: flags for C compiler
                        CgoLDFLAGS   []string // cgo: flags for linker
                        CgoPkgConfig []string // cgo: pkg-config names

                        // Dependency information
                        Imports []string // import paths used by this package
                        Deps    []string // all (recursively) imported dependencies

                        // Error information
                        Incomplete bool            // this package or a dependency has an error
                        Error      *PackageError   // error loading package
                        DepsErrors []*PackageError // errors loading dependencies

                        TestGoFiles  []string // _test.go files in package
                        TestImports  []string // imports from TestGoFiles
                        XTestGoFiles []string // _test.go files outside package
                        XTestImports []string // imports from XTestGoFiles
                    }

       -json  The  -json flag causes the package data to be printed in JSON format instead of using the template
              format.

       -e     The -e flag changes the handling of  erroneous  packages,  those  that  cannot  be  found  or  are
              malformed.   By  default,  the  list  command prints an error to standard error for each erroneous
              package and omits the packages from consideration during the usual printing.  With  the  -e  flag,
              the  list  command  never  prints  errors  to  standard  error and instead processes the erroneous
              packages with the usual printing.  Erroneous packages will have a non-empty ImportPath and a  non-
              nil Error field; other information may or may not be missing (zeroed).

       For more about specifying packages, see go-packages(7).

AUTHOR

       This  manual  page was written by Michael Stapelberg <stapelberg@debian.org>, for the Debian project (and
       may be used by others).

                                                   2012-05-13                                         GO-LIST(1)