xtools$ callgraph
callgraph: display the call graph of a Go program.

Usage:

  callgraph [-algo=static|cha|rta|vta] [-test] [-format=...] package...

Flags:

-algo      Specifies the call-graph construction algorithm, one of:

            static      static calls only (unsound)
            cha         Class Hierarchy Analysis
            rta         Rapid Type Analysis
            vta         Variable Type Analysis

           The algorithms are ordered by increasing precision in their
           treatment of dynamic calls (and thus also computational cost).
           RTA requires a whole program (main or test), and
           include only functions reachable from main.

-test      Include the package's tests in the analysis.

-format    Specifies the format in which each call graph edge is displayed.
           One of:

            digraph     output suitable for input to
                        golang.org/x/tools/cmd/digraph.
            graphviz    output in AT&T GraphViz (.dot) format.

           All other values are interpreted using text/template syntax.
           The default value is:

            {{.Caller}}\t--{{.Dynamic}}-{{.Line}}:{{.Column}}-->\t{{.Callee}}

           The structure passed to the template is (effectively):

                   type Edge struct {
                           Caller      *ssa.Function // calling function
                           Callee      *ssa.Function // called function

                           // Call site:
                           Filename    string // containing file
                           Offset      int    // offset within file of '('
                           Line        int    // line number
                           Column      int    // column number of call
                           Dynamic     string // "static" or "dynamic"
                           Description string // e.g. "static method call"
                   }

           Caller and Callee are *ssa.Function values, which print as
           "(*sync/atomic.Mutex).Lock", but other attributes may be
           derived from them, e.g. Caller.Pkg.Pkg.Path yields the
           import path of the enclosing package.  Consult the go/ssa
           API documentation for details.

Examples:

  Show the call graph of the trivial web server application:

    callgraph -format digraph $GOROOT/src/net/http/triv.go

  Same, but show only the packages of each function:

    callgraph -format '{{.Caller.Pkg.Pkg.Path}} -> {{.Callee.Pkg.Pkg.Path}}' \
      $GOROOT/src/net/http/triv.go | sort | uniq

  Show functions that make dynamic calls into the 'fmt' test package,
  using the Rapid Type Analysis algorithm:

    callgraph -format='{{.Caller}} -{{.Dynamic}}-> {{.Callee}}' -test -algo=rta fmt |
      sed -ne 's/-dynamic-/--/p' |
      sed -ne 's/-->.*fmt_test.*$//p' | sort | uniq

  Show all functions directly called by the callgraph tool's main function:

    callgraph -format=digraph golang.org/x/tools/cmd/callgraph |
      digraph succs golang.org/x/tools/cmd/callgraph.main

xtools$ callgraph  -format='{{.Filename}}:{{.Line}}:{{.Column}}: {{.Caller}} -{{.Dynamic}}-> {{.Callee}}'  ./cmd/callgraph/ | head 
src/text/template/parse/node.go:375:25: (*text/template/parse.IdentifierNode).writeTo -static-> (*text/template/parse.IdentifierNode).String
src/strings/builder.go:41:31: (*strings.Builder).copyCheck -static-> strings.noescape
src/strings/builder.go:115:13: (*strings.Builder).WriteString -static-> (*strings.Builder).copyCheck
...

// TODO(adonovan):
//
// Features:
// - restrict graph to a single package
// - output
//   - functions reachable from root (use digraph tool?)
//   - unreachable functions (use digraph tool?)
//   - dynamic (runtime) types
//   - indexed output (numbered nodes)
//   - JSON output
//   - additional template fields:
//     callee file/line/col

callgraph -algo=cha -format='{{.Caller}}--{{.CallerLine}}:{{.CallerColumn}}--{{.Filename}}--{{.Dynamic}}--{{.Line}}:{{.Column}}-->{{.Callee}}--{{.CalleeLine}}:{{.CalleeColumn}}--{{.CalleeFilename}}'
runtime.gcParkAssist--610:6--/usr/local/go/src/runtime/mgcmark.go--static--631:36-->(*runtime.guintptr).set--266:21--/usr/local/go/src/runtime/runtime2.go
runtime.gcParkAssist--610:6--/usr/local/go/src/runtime/mgcmark.go--static--633:9-->runtime.unlock--110:6--/usr/local/go/src/runtime/lock_futex.go

$ callgraph -format='{{(.Caller.Prog.Fset.Position .Caller.Pos).Filename}}:{{(.Caller.Prog.Fset.Position .Caller.Pos).Line}}' ./cmd/digraph

{{(posn .Caller).Filename}}

-format="{{(posn .Caller).Filename}}--{{(posn .Caller).Line}}"

funcMap := template.FuncMap{
		"posn": func(f *ssa.Function) token.Position { return prog.Fset.Position(f.Pos()) },
	}
tmpl, err := template.New("-format").Funcs(funcMap).Parse(format)

-format="{{(.Posn .Caller).Filename}}--{{(.Posn .Caller).Line}}"

func (e *Edge) Posn(f *ssa.Function) token.Position { return e.fset.Position(f.Pos()) }