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)