api: audit for Go 1.22

[mknyszek]

This is a tracking issue for doing an audit of API additions for Go 1.22 as of https://go.dev/cl/544555.

New API changes for Go 1.22

archive/tar

• pkg archive/tar, method (*Writer) AddFS(fs.FS) error archive/tar: add (*Writer).AddFS #58000
• pkg archive/tar, type FileInfoNames interface, Gname(int) (string, error) archive/tar: add FileInfoNames interface #50102
• pkg archive/tar, type FileInfoNames interface { Gname, IsDir, ModTime, Mode, Name, Size, Sys, Uname } archive/tar: add FileInfoNames interface #50102
• pkg archive/tar, type FileInfoNames interface, IsDir() bool archive/tar: add FileInfoNames interface #50102
• pkg archive/tar, type FileInfoNames interface, Mode() fs.FileMode archive/tar: add FileInfoNames interface #50102
• pkg archive/tar, type FileInfoNames interface, ModTime() time.Time archive/tar: add FileInfoNames interface #50102
• pkg archive/tar, type FileInfoNames interface, Name() string archive/tar: add FileInfoNames interface #50102
• pkg archive/tar, type FileInfoNames interface, Size() int64 archive/tar: add FileInfoNames interface #50102
• pkg archive/tar, type FileInfoNames interface, Sys() interface{} archive/tar: add FileInfoNames interface #50102
• pkg archive/tar, type FileInfoNames interface, Uname(int) (string, error) archive/tar: add FileInfoNames interface #50102
• pkg archive/zip, method (*Writer) AddFS(fs.FS) error archive/zip: add (*Writer).AddFS #54898

cmp

• pkg cmp, func Or$0 comparable $0 cmp: add Or #60204

crypto/x509

• pkg crypto/x509, func OIDFromInts([]uint64) (OID, error) crypto/x509: introduce new robust OID type & use it for certificate policies #60665
• pkg crypto/x509, method (*CertPool) AddCertWithConstraint(*Certificate, func([]*Certificate) error) crypto/x509: support code-constrained roots #57178
• pkg crypto/x509, method (OID) EqualASN1OID(asn1.ObjectIdentifier) bool crypto/x509: introduce new robust OID type & use it for certificate policies #60665
• pkg crypto/x509, method (OID) Equal(OID) bool crypto/x509: introduce new robust OID type & use it for certificate policies #60665
• pkg crypto/x509, method (OID) String() string crypto/x509: introduce new robust OID type & use it for certificate policies #60665
• pkg crypto/x509, type Certificate struct, Policies []OID crypto/x509: introduce new robust OID type & use it for certificate policies #60665
• pkg crypto/x509, type OID struct crypto/x509: introduce new robust OID type & use it for certificate policies #60665

database/sql

• pkg database/sql, method (*Null[$0]) Scan(interface{}) error database/sql: add generic Null[T] #60370
• pkg database/sql, method (Null[$0]) Value() (driver.Value, error) database/sql: add generic Null[T] #60370
• pkg database/sql, type Null[$0 interface{}] struct database/sql: add generic Null[T] #60370
• pkg database/sql, type Null[$0 interface{}] struct, V $0 database/sql: add generic Null[T] #60370
• pkg database/sql, type Null[$0 interface{}] struct, Valid bool database/sql: add generic Null[T] #60370

debug/elf

• pkg debug/elf, const R_LARCH_64_PCREL = 109 cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_64_PCREL R_LARCH cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_ADD6 = 105 cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_ADD6 R_LARCH cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_ADD_ULEB128 = 107 cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_ADD_ULEB128 R_LARCH cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_ALIGN = 102 cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_ALIGN R_LARCH cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_CFA = 104 cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_CFA R_LARCH cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_DELETE = 101 cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_DELETE R_LARCH cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_PCREL20_S2 = 103 cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_PCREL20_S2 R_LARCH cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_SUB6 = 106 cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_SUB6 R_LARCH cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_SUB_ULEB128 = 108 cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_LARCH_SUB_ULEB128 R_LARCH cmd/link: need to handle new-style loong64 relocs #63725
• pkg debug/elf, const R_MIPS_PC32 = 248 debug/elf: unknown/missing relocation type R_MIPS_PC32 #61974
• pkg debug/elf, const R_MIPS_PC32 R_MIPS debug/elf: unknown/missing relocation type R_MIPS_PC32 #61974

encoding/base32

• pkg encoding/base32, method (*Encoding) AppendDecode([]uint8, []uint8) ([]uint8, error) encoding: provide append-like variants #53693
• pkg encoding/base32, method (*Encoding) AppendEncode([]uint8, []uint8) []uint8 encoding: provide append-like variants #53693

encoding/base64

• pkg encoding/base64, method (*Encoding) AppendDecode([]uint8, []uint8) ([]uint8, error) encoding: provide append-like variants #53693
• pkg encoding/base64, method (*Encoding) AppendEncode([]uint8, []uint8) []uint8 encoding: provide append-like variants #53693

encoding/hex

• pkg encoding/hex, func AppendDecode([]uint8, []uint8) ([]uint8, error) encoding: provide append-like variants #53693
• pkg encoding/hex, func AppendEncode([]uint8, []uint8) []uint8 encoding: provide append-like variants #53693

go/ast

• pkg go/ast, func Unparen(Expr) Expr go/ast: add func Unparen(Expr) Expr #60061

go/types

• pkg go/types, func NewAlias(*TypeName, Type) *Alias go/types: API changes to support explicit Alias nodes #63223
• pkg go/types, func Unalias(Type) Type go/types: API changes to support explicit Alias nodes #63223
• pkg go/types, method (*Alias) Obj() *TypeName go/types: API changes to support explicit Alias nodes #63223
• pkg go/types, method (*Alias) String() string go/types: API changes to support explicit Alias nodes #63223
• pkg go/types, method (*Alias) Underlying() Type go/types: API changes to support explicit Alias nodes #63223
• pkg go/types, method (Checker) PkgNameOf(*ast.ImportSpec) *PkgName go/types: add Info.PkgName method #62037
• pkg go/types, method (*Info) PkgNameOf(*ast.ImportSpec) *PkgName go/types: add Info.PkgName method #62037
• pkg go/types, type Alias struct go/types: API changes to support explicit Alias nodes #63223
• pkg go/types, type Info struct, FileVersions map[*ast.File]string go/types: Export Info.FileVersions for access to file-specific version information #62605

go/version

• pkg go/version, func Compare(string, string) int go/version: package for handling Go version strings #62039
• pkg go/version, func IsValid(string) bool go/version: package for handling Go version strings #62039
• pkg go/version, func Lang(string) string go/version: package for handling Go version strings #62039

html/template

• pkg html/template, const ErrJSTemplate //deprecated html/template: allow actions in JS template literals #61619

io

• pkg io, method (*SectionReader) Outer() (ReaderAt, int64, int64) io: add SectionReader.Outer method #61870

log/slog

• pkg log/slog, func SetLogLoggerLevel(Level) Level log/slog: enable setting level on default log.Logger #62418

math/big

• pkg math/big, method (*Rat) FloatPrec() (int, bool) math/big: Rat: add FloatPrec() (int, bool) #50489

math/rand/v2

• pkg math/rand/v2, func ExpFloat64() float64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func Float32() float32 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func Float64() float64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func Int32() int32 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func Int32N(int32) int32 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func Int64() int64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func Int64N(int64) int64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func Int() int math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func IntN(int) int math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func N$0 intType $0 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func NewPCG(uint64, uint64) *PCG math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func New(Source) *Rand math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func NewZipf(*Rand, float64, float64, uint64) *Zipf math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func NormFloat64() float64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func Perm(int) []int math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func Shuffle(int, func(int, int)) math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func Uint32N(uint32) uint32 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func Uint32() uint32 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func Uint64N(uint64) uint64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func Uint64() uint64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, func UintN(uint) uint math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*PCG) MarshalBinary() ([]uint8, error) math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*PCG) Seed(uint64, uint64) math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*PCG) Uint64() uint64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*PCG) UnmarshalBinary([]uint8) error math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) ExpFloat64() float64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) Float32() float32 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) Float64() float64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) Int32() int32 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) Int32N(int32) int32 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) Int64() int64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) Int64N(int64) int64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) Int() int math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) IntN(int) int math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) NormFloat64() float64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) Perm(int) []int math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) Shuffle(int, func(int, int)) math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) Uint32N(uint32) uint32 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) Uint32() uint32 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) Uint64N(uint64) uint64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) Uint64() uint64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Rand) UintN(uint) uint math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, method (*Zipf) Uint64() uint64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, type PCG struct math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, type Rand struct math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, type Source interface { Uint64 } math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, type Source interface, Uint64() uint64 math/rand/v2: revised API for math/rand #61716
• pkg math/rand/v2, type Zipf struct math/rand/v2: revised API for math/rand #61716

net/http

• pkg net/http, func FileServerFS(fs.FS) Handler net/http: add ServeFileFS, FileServerFS, NewFileTransportFS #51971
• pkg net/http, func NewFileTransportFS(fs.FS) RoundTripper net/http: add ServeFileFS, FileServerFS, NewFileTransportFS #51971
• pkg net/http, func ServeFileFS(ResponseWriter, *Request, fs.FS, string) net/http: add ServeFileFS, FileServerFS, NewFileTransportFS #51971
• pkg net/http, method (*Request) PathValue(string) string net/http: enhanced ServeMux routing #61410
• pkg net/http, method (*Request) SetPathValue(string, string) net/http: enhanced ServeMux routing #61410

net

• pkg net, method (*TCPConn) WriteTo(io.Writer) (int64, error) net: arrange zero-copy of os.File and TCPConn to UnixConn #58808

net/netip

• pkg net/netip, method (AddrPort) Compare(AddrPort) int net/netip: add Prefix.Compare and AddrPort.Compare #61642
• pkg net/netip, method (Prefix) Compare(Prefix) int net/netip: add Prefix.Compare and AddrPort.Compare #61642

os

• pkg os, method (*File) WriteTo(io.Writer) (int64, error) net: arrange zero-copy of os.File and TCPConn to UnixConn #58808

reflect

• pkg reflect, func PtrTo //deprecated reflect: deprecate PtrTo #59599
• pkg reflect, func TypeFor$0 interface{} Type reflect: add TypeFor #60088

slices

• pkg slices, func Concat$0 interface{ ~[]$1 }, $1 interface{} $0 slices: add Concat #56353

syscall

• pkg syscall (linux-386-cgo), type SysProcAttr struct, PidFD *int syscall: add PidFD, CgroupFD, and UseCgroupFD options for Linux clone to SysProcAttr #51246
• pkg syscall (linux-386), type SysProcAttr struct, PidFD *int syscall: add PidFD, CgroupFD, and UseCgroupFD options for Linux clone to SysProcAttr #51246
• pkg syscall (linux-amd64-cgo), type SysProcAttr struct, PidFD *int syscall: add PidFD, CgroupFD, and UseCgroupFD options for Linux clone to SysProcAttr #51246
• pkg syscall (linux-amd64), type SysProcAttr struct, PidFD *int syscall: add PidFD, CgroupFD, and UseCgroupFD options for Linux clone to SysProcAttr #51246
• pkg syscall (linux-arm-cgo), type SysProcAttr struct, PidFD *int syscall: add PidFD, CgroupFD, and UseCgroupFD options for Linux clone to SysProcAttr #51246
• pkg syscall (linux-arm), type SysProcAttr struct, PidFD *int syscall: add PidFD, CgroupFD, and UseCgroupFD options for Linux clone to SysProcAttr #51246

testing/slogtest

• pkg testing/slogtest, func Run(*testing.T, func(*testing.T) slog.Handler, func(*testing.T) map[string]interface{}) testing/slogtest: support sub-tests #61758

[mateusz834]

Related #64012

[rsc]

Went through them all. LGTM. This is much easier now that we have issues linked in the api files.

The program that posts the audit issue needs to be updated to escape [ in api lines when creating the markdown. See cmp.Compare above for why.