1a2f01efa6
Update the Go library to the 1.10beta1 release. Requires a few changes to the compiler for modifications to the map runtime code, and to handle some nowritebarrier cases in the runtime. Reviewed-on: https://go-review.googlesource.com/86455 gotools/: * Makefile.am (go_cmd_vet_files): New variable. (go_cmd_buildid_files, go_cmd_test2json_files): New variables. (s-zdefaultcc): Change from constants to functions. (noinst_PROGRAMS): Add vet, buildid, and test2json. (cgo$(EXEEXT)): Link against $(LIBGOTOOL). (vet$(EXEEXT)): New target. (buildid$(EXEEXT)): New target. (test2json$(EXEEXT)): New target. (install-exec-local): Install all $(noinst_PROGRAMS). (uninstall-local): Uninstasll all $(noinst_PROGRAMS). (check-go-tool): Depend on $(noinst_PROGRAMS). Copy down objabi.go. (check-runtime): Depend on $(noinst_PROGRAMS). (check-cgo-test, check-carchive-test): Likewise. (check-vet): New target. (check): Depend on check-vet. Look at cmd_vet-testlog. (.PHONY): Add check-vet. * Makefile.in: Rebuild. From-SVN: r256365
59 lines
2.1 KiB
Go
59 lines
2.1 KiB
Go
// Copyright 2009 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
// Package hash provides interfaces for hash functions.
|
|
package hash
|
|
|
|
import "io"
|
|
|
|
// Hash is the common interface implemented by all hash functions.
|
|
//
|
|
// Hash implementations in the standard library (e.g. hash/crc32 and
|
|
// crypto/sha256) implement the encoding.BinaryMarshaler and
|
|
// encoding.BinaryUnmarshaler interfaces. Marshaling a hash implementation
|
|
// allows its internal state to be saved and used for additional processing
|
|
// later, without having to re-write the data previously written to the hash.
|
|
// The hash state may contain portions of the input in its original form,
|
|
// which users are expected to handle for any possible security implications.
|
|
//
|
|
// Compatibility: Any future changes to hash or crypto packages will endeavor
|
|
// to maintain compatibility with state encoded using previous versions.
|
|
// That is, any released versions of the packages should be able to
|
|
// decode data written with any previously released version,
|
|
// subject to issues such as security fixes.
|
|
// See the Go compatibility document for background: https://golang.org/doc/go1compat
|
|
type Hash interface {
|
|
// Write (via the embedded io.Writer interface) adds more data to the running hash.
|
|
// It never returns an error.
|
|
io.Writer
|
|
|
|
// Sum appends the current hash to b and returns the resulting slice.
|
|
// It does not change the underlying hash state.
|
|
Sum(b []byte) []byte
|
|
|
|
// Reset resets the Hash to its initial state.
|
|
Reset()
|
|
|
|
// Size returns the number of bytes Sum will return.
|
|
Size() int
|
|
|
|
// BlockSize returns the hash's underlying block size.
|
|
// The Write method must be able to accept any amount
|
|
// of data, but it may operate more efficiently if all writes
|
|
// are a multiple of the block size.
|
|
BlockSize() int
|
|
}
|
|
|
|
// Hash32 is the common interface implemented by all 32-bit hash functions.
|
|
type Hash32 interface {
|
|
Hash
|
|
Sum32() uint32
|
|
}
|
|
|
|
// Hash64 is the common interface implemented by all 64-bit hash functions.
|
|
type Hash64 interface {
|
|
Hash
|
|
Sum64() uint64
|
|
}
|