version

Documentation

Overview

Package version defines a mechanism for versioning the RPC protocol.

Index

• Variables
• func ErrorfNoCompatibleVersion(ctx *context.T, format string, lmin uint64, lmax uint64, rmin uint64, ...) error
• func MessageNoCompatibleVersion(ctx *context.T, message string, lmin uint64, lmax uint64, rmin uint64, ...) error
• func NewErrNoCompatibleVersion(ctx *context.T, lmin uint64, lmax uint64, rmin uint64, rmax uint64) error
• func ParamsErrNoCompatibleVersion(argumentError error) (verrorComponent string, verrorOperation string, lmin uint64, lmax uint64, ...)
• type RPCVersion
  • func CommonVersion(ctx *context.T, l, r RPCVersionRange) (RPCVersion, error)
• type RPCVersionRange

Variables

var (
	ErrNoCompatibleVersion = verror.NewIDAction("v.io/v23/rpc/version.NoCompatibleVersion", verror.NoRetry)
)

Functions

func ErrorfNoCompatibleVersion

func ErrorfNoCompatibleVersion(ctx *context.T, format string, lmin uint64, lmax uint64, rmin uint64, rmax uint64) error

ErrorfNoCompatibleVersion calls ErrNoCompatibleVersion.Errorf with the supplied arguments.

func MessageNoCompatibleVersion

func MessageNoCompatibleVersion(ctx *context.T, message string, lmin uint64, lmax uint64, rmin uint64, rmax uint64) error

MessageNoCompatibleVersion calls ErrNoCompatibleVersion.Message with the supplied arguments.

func NewErrNoCompatibleVersion

func NewErrNoCompatibleVersion(ctx *context.T, lmin uint64, lmax uint64, rmin uint64, rmax uint64) error

NewErrNoCompatibleVersion returns an error with the ErrNoCompatibleVersion ID. Deprecated: this function will be removed in the future, use ErrorfNoCompatibleVersion or MessageNoCompatibleVersion instead.

func ParamsErrNoCompatibleVersion

func ParamsErrNoCompatibleVersion(argumentError error) (verrorComponent string, verrorOperation string, lmin uint64, lmax uint64, rmin uint64, rmax uint64, returnErr error)

ParamsErrNoCompatibleVersion extracts the expected parameters from the error's ParameterList.

Types

type RPCVersion

type RPCVersion uint32

RPCVersion represents a version of the RPC protocol.

const (
	// UnknownRPCVersion is used for Min/MaxRPCVersion in an Endpoint when
	// we don't know the relevant version numbers.  In this case the RPC
	// implementation will have to guess the correct values.
	UnknownRPCVersion RPCVersion = iota

	// DeprecatedRPCVersion is used to signal that a version number is no longer
	// relevant and that version information should be obtained elsewhere.
	DeprecatedRPCVersion

	// RPCVersion10 opens a special flow over which discharges for third-party
	// caveats on the server's blessings are sent.
	RPCVersion10

	// RPCVersion11 Optimized authentication.
	RPCVersion11

	// RPCVersion12 adds periodic healthchecks on the channel.
	RPCVersion12

	// RPCVersion13 adds error messages in responses from proxies.
	RPCVersion13

	// RPCVersion14 adds the setup message to the channel binding during
	// connection setup.
	RPCVersion14
)

func CommonVersion

func CommonVersion(ctx *context.T, l, r RPCVersionRange) (RPCVersion, error)

type RPCVersionRange

type RPCVersionRange struct {
	Min, Max RPCVersion
}

RPCVersionRange allows you to optionally specify a range of versions to use when calling FormatEndpoint