Chapter 4. Go Race Detector


Go Toolset includes the Go race detector. The race detector is a feature of the Go standard library. The race detector must be enabled at compile time and is used at runtime.

4.1. Installing the Race Detector

Note

Red Hat Enterprise Linux 8 go-toolset module contains Go race detector. Skip this step.

In Go Toolset, the race detector is provided by the go-toolset-1.11-golang-race package. To install the race detector:

# yum install go-toolset-1.11-golang-race
Copy to Clipboard Toggle word wrap

This command installs a variant of the Go standard library with the runtime race detection.

See Also

4.2. Using the Race Detector

To use the runtime race detector in a Go project, add the -race option to the go tool commands used when manipulating the project.

For a minimal approach to using the race detector, build the project with the -race option:

  • For Red Hat Enterprise Linux 7:

    $ scl enable go-toolset-1.11 'go build -race -o output_file go_main_package'
    Copy to Clipboard Toggle word wrap
  • For Red Hat Enterprise Linux 8:

    $ go build -race -o output_file go_main_package
    Copy to Clipboard Toggle word wrap

Run the resulting executable binary file, and the race detector prints warnings to the standard output when a race is detected.

Important

The race detector has a significant runtime resource overhead.

4.3. Additional Resources

A detailed description of the Go race detector and its features is beyond the scope of this book. For more information, see the resources listed below.

Online Documentation

See Also

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat