table.go

     1  // Copyright 2023 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  // Package godebugs provides a table of known GODEBUG settings,
     6  // for use by a variety of other packages, including internal/godebug,
     7  // runtime, runtime/metrics, and cmd/go/internal/load.
     8  package godebugs
     9  
    10  // An Info describes a single known GODEBUG setting.
    11  type Info struct {
    12  	Name      string // name of the setting ("panicnil")
    13  	Package   string // package that uses the setting ("runtime")
    14  	Changed   int    // minor version when default changed, if any; 21 means Go 1.21
    15  	Old       string // value that restores behavior prior to Changed
    16  	Opaque    bool   // setting does not export information to runtime/metrics using [internal/godebug.Setting.IncNonDefault]
    17  	Immutable bool   // setting cannot be changed after program start
    18  }
    19  
    20  // All is the table of known settings, sorted by Name.
    21  //
    22  // Note: After adding entries to this table, run 'go generate runtime/metrics'
    23  // to update the runtime/metrics doc comment.
    24  // (Otherwise the runtime/metrics test will fail.)
    25  //
    26  // Note: After adding entries to this table, update the list in doc/godebug.md as well.
    27  // (Otherwise the test in this package will fail.)
    28  var All = []Info{
    29  	{Name: "allowmultiplevcs", Package: "cmd/go"},
    30  	{Name: "asynctimerchan", Package: "time", Changed: 23, Old: "1"},
    31  	{Name: "containermaxprocs", Package: "runtime", Changed: 25, Old: "0"},
    32  	{Name: "cryptocustomrand", Package: "crypto", Changed: 26, Old: "1"},
    33  	{Name: "dataindependenttiming", Package: "crypto/subtle", Opaque: true},
    34  	{Name: "decoratemappings", Package: "runtime", Opaque: true, Changed: 25, Old: "0"},
    35  	{Name: "embedfollowsymlinks", Package: "cmd/go"},
    36  	{Name: "execerrdot", Package: "os/exec"},
    37  	{Name: "fips140", Package: "crypto/fips140", Opaque: true, Immutable: true},
    38  	{Name: "gocachehash", Package: "cmd/go"},
    39  	{Name: "gocachetest", Package: "cmd/go"},
    40  	{Name: "gocacheverify", Package: "cmd/go"},
    41  	{Name: "gotestjsonbuildtext", Package: "cmd/go", Changed: 24, Old: "1"},
    42  	{Name: "gotypesalias", Package: "go/types", Changed: 23, Old: "0"},
    43  	{Name: "htmlmetacontenturlescape", Package: "html/template"},
    44  	{Name: "http2client", Package: "net/http"},
    45  	{Name: "http2debug", Package: "net/http", Opaque: true},
    46  	{Name: "http2server", Package: "net/http"},
    47  	{Name: "httpcookiemaxnum", Package: "net/http", Changed: 24, Old: "0"},
    48  	{Name: "httplaxcontentlength", Package: "net/http", Changed: 22, Old: "1"},
    49  	{Name: "httpmuxgo121", Package: "net/http", Changed: 22, Old: "1"},
    50  	{Name: "httpservecontentkeepheaders", Package: "net/http", Changed: 23, Old: "1"},
    51  	{Name: "installgoroot", Package: "go/build"},
    52  	{Name: "jstmpllitinterp", Package: "html/template", Opaque: true}, // bug #66217: remove Opaque
    53  	//{Name: "multipartfiles", Package: "mime/multipart"},
    54  	{Name: "multipartmaxheaders", Package: "mime/multipart"},
    55  	{Name: "multipartmaxparts", Package: "mime/multipart"},
    56  	{Name: "multipathtcp", Package: "net", Changed: 24, Old: "0"},
    57  	{Name: "netdns", Package: "net", Opaque: true},
    58  	{Name: "netedns0", Package: "net", Changed: 19, Old: "0"},
    59  	{Name: "panicnil", Package: "runtime", Changed: 21, Old: "1"},
    60  	{Name: "randautoseed", Package: "math/rand"},
    61  	{Name: "randseednop", Package: "math/rand", Changed: 24, Old: "0"},
    62  	{Name: "rsa1024min", Package: "crypto/rsa", Changed: 24, Old: "0"},
    63  	{Name: "tarinsecurepath", Package: "archive/tar"},
    64  	{Name: "tls10server", Package: "crypto/tls", Changed: 22, Old: "1"},
    65  	{Name: "tls3des", Package: "crypto/tls", Changed: 23, Old: "1"},
    66  	{Name: "tlsmaxrsasize", Package: "crypto/tls"},
    67  	{Name: "tlsmlkem", Package: "crypto/tls", Changed: 24, Old: "0", Opaque: true},
    68  	{Name: "tlsrsakex", Package: "crypto/tls", Changed: 22, Old: "1"},
    69  	{Name: "tlssecpmlkem", Package: "crypto/tls", Changed: 26, Old: "0", Opaque: true},
    70  	{Name: "tlssha1", Package: "crypto/tls", Changed: 25, Old: "1"},
    71  	{Name: "tlsunsafeekm", Package: "crypto/tls", Changed: 22, Old: "1"},
    72  	{Name: "updatemaxprocs", Package: "runtime", Changed: 25, Old: "0"},
    73  	{Name: "urlmaxqueryparams", Package: "net/url", Changed: 24, Old: "0"},
    74  	{Name: "urlstrictcolons", Package: "net/url", Changed: 26, Old: "0"},
    75  	{Name: "winreadlinkvolume", Package: "os", Changed: 23, Old: "0"},
    76  	{Name: "winsymlink", Package: "os", Changed: 23, Old: "0"},
    77  	{Name: "x509keypairleaf", Package: "crypto/tls", Changed: 23, Old: "0"},
    78  	{Name: "x509negativeserial", Package: "crypto/x509", Changed: 23, Old: "1"},
    79  	{Name: "x509rsacrt", Package: "crypto/x509", Changed: 24, Old: "0"},
    80  	{Name: "x509sha256skid", Package: "crypto/x509", Changed: 25, Old: "0"},
    81  	{Name: "x509usefallbackroots", Package: "crypto/x509"},
    82  	{Name: "x509usepolicies", Package: "crypto/x509", Changed: 24, Old: "0"},
    83  	{Name: "zipinsecurepath", Package: "archive/zip"},
    84  }
    85  
    86  type RemovedInfo struct {
    87  	Name    string // name of the removed GODEBUG setting.
    88  	Removed int    // minor version of Go, when the removal happened
    89  }
    90  
    91  // Removed contains all GODEBUGs that we have removed.
    92  var Removed = []RemovedInfo{
    93  	{Name: "x509sha1", Removed: 24},
    94  }
    95  
    96  // Lookup returns the Info with the given name.
    97  func Lookup(name string) *Info {
    98  	// binary search, avoiding import of sort.
    99  	lo := 0
   100  	hi := len(All)
   101  	for lo < hi {
   102  		m := int(uint(lo+hi) >> 1)
   103  		mid := All[m].Name
   104  		if name == mid {
   105  			return &All[m]
   106  		}
   107  		if name < mid {
   108  			hi = m
   109  		} else {
   110  			lo = m + 1
   111  		}
   112  	}
   113  	return nil
   114  }
   115
View as plain text