package internal
import "google.golang.org/grpc/internal"
Package internal contains gRPC-internal code, to avoid polluting the godoc of the top-level grpc package. It must not import any grpc symbols to avoid circular dependencies.
Index ¶
Constants ¶
const ( // CredsBundleModeFallback switches GoogleDefaultCreds to fallback mode. CredsBundleModeFallback = "fallback" // CredsBundleModeBalancer switches GoogleDefaultCreds to grpclb balancer // mode. CredsBundleModeBalancer = "balancer" // CredsBundleModeBackendFromBalancer switches GoogleDefaultCreds to mode // that supports backend returned by grpclb balancer. CredsBundleModeBackendFromBalancer = "backend-from-balancer" )
Variables ¶
var ( // WithHealthCheckFunc is set by dialoptions.go WithHealthCheckFunc interface{} // func (HealthChecker) DialOption // HealthCheckFunc is used to provide client-side LB channel health checking HealthCheckFunc HealthChecker // BalancerUnregister is exported by package balancer to unregister a balancer. BalancerUnregister func(name string) // KeepaliveMinPingTime is the minimum ping interval. This must be 10s by // default, but tests may wish to set it lower for convenience. KeepaliveMinPingTime = 10 * time.Second // NewRequestInfoContext creates a new context based on the argument context attaching // the passed in RequestInfo to the new context. NewRequestInfoContext interface{} // func(context.Context, credentials.RequestInfo) context.Context // NewClientHandshakeInfoContext returns a copy of the input context with // the passed in ClientHandshakeInfo struct added to it. NewClientHandshakeInfoContext interface{} // func(context.Context, credentials.ClientHandshakeInfo) context.Context // ParseServiceConfigForTesting is for creating a fake // ClientConn for resolver testing only ParseServiceConfigForTesting interface{} // func(string) *serviceconfig.ParseResult // EqualServiceConfigForTesting is for testing service config generation and // parsing. Both a and b should be returned by ParseServiceConfigForTesting. // This function compares the config without rawJSON stripped, in case the // there's difference in white space. EqualServiceConfigForTesting func(a, b serviceconfig.Config) bool // GetCertificateProviderBuilder returns the registered builder for the // given name. This is set by package certprovider for use from xDS // bootstrap code while parsing certificate provider configs in the // bootstrap file. GetCertificateProviderBuilder interface{} // func(string) certprovider.Builder // GetXDSHandshakeInfoForTesting returns a pointer to the xds.HandshakeInfo // stored in the passed in attributes. This is set by // credentials/xds/xds.go. GetXDSHandshakeInfoForTesting interface{} // func (*attributes.Attributes) *xds.HandshakeInfo // GetServerCredentials returns the transport credentials configured on a // gRPC server. An xDS-enabled server needs to know what type of credentials // is configured on the underlying gRPC server. This is set by server.go. GetServerCredentials interface{} // func (*grpc.Server) credentials.TransportCredentials )
Types ¶
type HealthChecker ¶
type HealthChecker func(ctx context.Context, newStream func(string) (interface{}, error), setConnectivityState func(connectivity.State, error), serviceName string) error
HealthChecker defines the signature of the client-side LB channel health checking function.
The implementation is expected to create a health checking RPC stream by calling newStream(), watch for the health status of serviceName, and report it's health back by calling setConnectivityState().
The health checking protocol is defined at: https://github.com/grpc/grpc/blob/master/doc/health-checking.md
Source Files ¶
internal.go
Directories ¶
Path | Synopsis |
---|---|
internal/admin | Package admin contains internal implementation for admin service. |
internal/backoff | Package backoff implement the backoff strategy for gRPC. |
internal/balancer | |
internal/balancerload | Package balancerload defines APIs to parse server loads in trailers. |
internal/balancer/stub | Package stub implements a balancer for testing purposes. |
internal/binarylog | Package binarylog implementation binary logging as defined in https://github.com/grpc/proposal/blob/master/A16-binary-logging.md. |
internal/buffer | Package buffer provides an implementation of an unbounded buffer. |
internal/cache | Package cache implements caches to be used in gRPC. |
internal/channelz | Package channelz defines APIs for enabling channelz service, entry registration/deletion, and accessing channelz data. |
internal/credentials | Package credentials defines APIs for parsing SPIFFE ID. |
internal/credentials/xds | Package xds contains non-user facing functionality of the xds credentials. |
internal/envconfig | Package envconfig contains grpc settings configured by environment variables. |
internal/googlecloud | Package googlecloud contains internal helpful functions for google cloud. |
internal/grpclog | Package grpclog (internal) defines depth logging for grpc. |
internal/grpcrand | Package grpcrand implements math/rand functions in a concurrent-safe way with a global random source, independent of math/rand's global source. |
internal/grpcsync | Package grpcsync implements additional synchronization primitives built upon the sync package. |
internal/grpctest | Package grpctest implements testing helpers. |
internal/grpcutil | Package grpcutil provides a bunch of utility functions to be used across the gRPC codebase. |
internal/hierarchy | Package hierarchy contains functions to set and get hierarchy string from addresses. |
internal/leakcheck | Package leakcheck contains functions to check leaked goroutines. |
internal/metadata | Package metadata contains functions to set and get metadata from addresses. |
internal/profiling | Package profiling contains two logical components: buffer.go and profiling.go. |
internal/profiling/buffer | Package buffer provides a high-performant lock free implementation of a circular buffer used by the profiling code. |
internal/proto | |
internal/proto/grpc_service_config | |
internal/resolver | Package resolver provides internal resolver-related functionality. |
internal/resolver/dns | Package dns implements a dns resolver to be installed as the default resolver in grpc. |
internal/resolver/passthrough | Package passthrough implements a pass-through resolver. |
internal/resolver/unix | Package unix implements a resolver for unix targets. |
internal/serviceconfig | Package serviceconfig contains utility functions to parse service config. |
internal/status | Package status implements errors returned by gRPC. |
internal/stubserver | Package stubserver is a stubbable implementation of google.golang.org/grpc/test/grpc_testing for testing purposes. |
internal/syscall | Package syscall provides functionalities that grpc uses to get low-level operating system stats/info. |
internal/testutils | Package testutils contains testing helpers. |
internal/transport | Package transport defines and implements message oriented communication channel to complete various transactions (e.g., an RPC). |
internal/transport/networktype | Package networktype declares the network type to be used in the default dailer. |
internal/wrr | Package wrr contains the interface and common implementations of wrr algorithms. |
internal/xds | Package xds contains types that need to be shared between code under google.golang.org/grpc/xds/... |
internal/xds/env | Package env acts a single source of definition for all environment variables related to the xDS implementation in gRPC. |
- Version
- v1.37.0
- Published
- Apr 7, 2021
- Platform
- darwin/amd64
- Imports
- 4 packages
- Last checked
- 1 hour ago –
Tools for package owners.