Imports #
encoding_asn1 "encoding/asn1"
"fmt"
"math/big"
"reflect"
"time"
"golang.org/x/crypto/cryptobyte/asn1"
"errors"
"fmt"
cryptobyte
Imports
Constants & Variables
bigOne var #
var bigOne = *ast.CallExprdefaultUTCTimeFormatStr const #
const defaultUTCTimeFormatStr = "060102150405Z0700"generalizedTimeFormatStr const #
const generalizedTimeFormatStr = "20060102150405Z0700"Type Aliases
BuilderContinuation type #
BuilderContinuation is a continuation-passing interface for building length-prefixed byte sequences. Builder methods for length-prefixed sequences (AddUint8LengthPrefixed etc) will invoke the BuilderContinuation supplied to them. The child builder passed to the continuation can be used to build the content of the length-prefixed sequence. For example: parent := cryptobyte.NewBuilder() parent.AddUint8LengthPrefixed(func (child *Builder) { child.AddUint8(42) child.AddUint8LengthPrefixed(func (grandchild *Builder) { grandchild.AddUint8(5) }) }) It is an error to write more bytes to the child than allowed by the reserved length prefix. After the continuation returns, the child must be considered invalid, i.e. users must not store any copies or references of the child that outlive the continuation. If the continuation panics with a value of type BuildError then the inner error will be returned as the error from Bytes. If the child panics otherwise then Bytes will repanic with the same value.
type BuilderContinuation func(child *Builder)String type #
String represents a string of bytes. It provides methods for parsing fixed-length and length-prefixed values from it.
type String []byteInterfaces
MarshalingValue interface #
A MarshalingValue marshals itself into a Builder.
type MarshalingValue interface {
Marshal(b *Builder) error
}Structs
BuildError struct #
BuildError wraps an error. If a BuilderContinuation panics with this value, the panic will be recovered and the inner error will be returned from Builder.Bytes.
type BuildError struct {
Err error
}Builder struct #
A Builder builds byte strings from fixed-length and length-prefixed values. Builders either allocate space as needed, or are ‘fixed’, which means that they write into a given buffer and produce an error if it's exhausted. The zero value is a usable Builder that allocates space as needed. Simple values are marshaled and appended to a Builder using methods on the Builder. Length-prefixed values are marshaled by providing a BuilderContinuation, which is a function that writes the inner contents of the value to a given Builder. See the documentation for BuilderContinuation for details.
type Builder struct {
err error
result []byte
fixedSize bool
child *Builder
offset int
pendingLenLen int
pendingIsASN1 bool
inContinuation *bool
}Functions
AddASN1 method #
AddASN1 appends an ASN.1 object. The object is prefixed with the given tag. Tags greater than 30 are not supported and result in an error (i.e. low-tag-number form only). The child builder passed to the BuilderContinuation can be used to build the content of the ASN.1 object.
func (b *Builder) AddASN1(tag asn1.Tag, f BuilderContinuation)AddASN1BigInt method #
AddASN1BigInt appends a DER-encoded ASN.1 INTEGER.
func (b *Builder) AddASN1BigInt(n *big.Int)AddASN1BitString method #
AddASN1BitString appends a DER-encoded ASN.1 BIT STRING. This does not support BIT STRINGs that are not a whole number of bytes.
func (b *Builder) AddASN1BitString(data []byte)AddASN1Boolean method #
func (b *Builder) AddASN1Boolean(v bool)AddASN1Enum method #
AddASN1Enum appends a DER-encoded ASN.1 ENUMERATION.
func (b *Builder) AddASN1Enum(v int64)AddASN1GeneralizedTime method #
AddASN1GeneralizedTime appends a DER-encoded ASN.1 GENERALIZEDTIME.
func (b *Builder) AddASN1GeneralizedTime(t time.Time)AddASN1Int64 method #
AddASN1Int64 appends a DER-encoded ASN.1 INTEGER.
func (b *Builder) AddASN1Int64(v int64)AddASN1Int64WithTag method #
AddASN1Int64WithTag appends a DER-encoded ASN.1 INTEGER with the given tag.
func (b *Builder) AddASN1Int64WithTag(v int64, tag asn1.Tag)AddASN1NULL method #
func (b *Builder) AddASN1NULL()AddASN1ObjectIdentifier method #
func (b *Builder) AddASN1ObjectIdentifier(oid encoding_asn1.ObjectIdentifier)AddASN1OctetString method #
AddASN1OctetString appends a DER-encoded ASN.1 OCTET STRING.
func (b *Builder) AddASN1OctetString(bytes []byte)AddASN1UTCTime method #
AddASN1UTCTime appends a DER-encoded ASN.1 UTCTime.
func (b *Builder) AddASN1UTCTime(t time.Time)AddASN1Uint64 method #
AddASN1Uint64 appends a DER-encoded ASN.1 INTEGER.
func (b *Builder) AddASN1Uint64(v uint64)AddBytes method #
AddBytes appends a sequence of bytes to the byte string.
func (b *Builder) AddBytes(v []byte)AddUint16 method #
AddUint16 appends a big-endian, 16-bit value to the byte string.
func (b *Builder) AddUint16(v uint16)AddUint16LengthPrefixed method #
AddUint16LengthPrefixed adds a big-endian, 16-bit length-prefixed byte sequence.
func (b *Builder) AddUint16LengthPrefixed(f BuilderContinuation)AddUint24 method #
AddUint24 appends a big-endian, 24-bit value to the byte string. The highest byte of the 32-bit input value is silently truncated.
func (b *Builder) AddUint24(v uint32)AddUint24LengthPrefixed method #
AddUint24LengthPrefixed adds a big-endian, 24-bit length-prefixed byte sequence.
func (b *Builder) AddUint24LengthPrefixed(f BuilderContinuation)AddUint32 method #
AddUint32 appends a big-endian, 32-bit value to the byte string.
func (b *Builder) AddUint32(v uint32)AddUint32LengthPrefixed method #
AddUint32LengthPrefixed adds a big-endian, 32-bit length-prefixed byte sequence.
func (b *Builder) AddUint32LengthPrefixed(f BuilderContinuation)AddUint48 method #
AddUint48 appends a big-endian, 48-bit value to the byte string.
func (b *Builder) AddUint48(v uint64)AddUint64 method #
AddUint64 appends a big-endian, 64-bit value to the byte string.
func (b *Builder) AddUint64(v uint64)AddUint8 method #
AddUint8 appends an 8-bit value to the byte string.
func (b *Builder) AddUint8(v uint8)AddUint8LengthPrefixed method #
AddUint8LengthPrefixed adds a 8-bit length-prefixed byte sequence.
func (b *Builder) AddUint8LengthPrefixed(f BuilderContinuation)AddValue method #
AddValue calls Marshal on v, passing a pointer to the builder to append to. If Marshal returns an error, it is set on the Builder so that subsequent appends don't have an effect.
func (b *Builder) AddValue(v MarshalingValue)Bytes method #
Bytes returns the bytes written by the builder or an error if one has occurred during building.
func (b *Builder) Bytes() ([]byte, error)BytesOrPanic method #
BytesOrPanic returns the bytes written by the builder or panics if an error has occurred during building.
func (b *Builder) BytesOrPanic() []byteCopyBytes method #
CopyBytes copies len(out) bytes into out and advances over them. It reports whether the copy operation was successful
func (s *String) CopyBytes(out []byte) boolEmpty method #
Empty reports whether the string does not contain any bytes.
func (s String) Empty() boolMarshalASN1 method #
MarshalASN1 calls encoding_asn1.Marshal on its input and appends the result if successful or records an error if one occurred.
func (b *Builder) MarshalASN1(v interface{})NewBuilder function #
NewBuilder creates a Builder that appends its output to the given buffer. Like append(), the slice will be reallocated if its capacity is exceeded. Use Bytes to get the final buffer.
func NewBuilder(buffer []byte) *BuilderNewFixedBuilder function #
NewFixedBuilder creates a Builder that appends its output into the given buffer. This builder does not reallocate the output buffer. Writes that would exceed the buffer's capacity are treated as an error.
func NewFixedBuilder(buffer []byte) *BuilderPeekASN1Tag method #
PeekASN1Tag reports whether the next ASN.1 value on the string starts with the given tag.
func (s String) PeekASN1Tag(tag asn1.Tag) boolReadASN1 method #
ReadASN1 reads the contents of a DER-encoded ASN.1 element (not including tag and length bytes) into out, and advances. The element must match the given tag. It reports whether the read was successful. Tags greater than 30 are not supported (i.e. low-tag-number format only).
func (s *String) ReadASN1(out *String, tag asn1.Tag) boolReadASN1BitString method #
ReadASN1BitString decodes an ASN.1 BIT STRING into out and advances. It reports whether the read was successful.
func (s *String) ReadASN1BitString(out *encoding_asn1.BitString) boolReadASN1BitStringAsBytes method #
ReadASN1BitStringAsBytes decodes an ASN.1 BIT STRING into out and advances. It is an error if the BIT STRING is not a whole number of bytes. It reports whether the read was successful.
func (s *String) ReadASN1BitStringAsBytes(out *[]byte) boolReadASN1Boolean method #
ReadASN1Boolean decodes an ASN.1 BOOLEAN and converts it to a boolean representation into out and advances. It reports whether the read was successful.
func (s *String) ReadASN1Boolean(out *bool) boolReadASN1Bytes method #
ReadASN1Bytes reads the contents of a DER-encoded ASN.1 element (not including tag and length bytes) into out, and advances. The element must match the given tag. It reports whether the read was successful.
func (s *String) ReadASN1Bytes(out *[]byte, tag asn1.Tag) boolReadASN1Element method #
ReadASN1Element reads the contents of a DER-encoded ASN.1 element (including tag and length bytes) into out, and advances. The element must match the given tag. It reports whether the read was successful. Tags greater than 30 are not supported (i.e. low-tag-number format only).
func (s *String) ReadASN1Element(out *String, tag asn1.Tag) boolReadASN1Enum method #
ReadASN1Enum decodes an ASN.1 ENUMERATION into out and advances. It reports whether the read was successful.
func (s *String) ReadASN1Enum(out *int) boolReadASN1GeneralizedTime method #
ReadASN1GeneralizedTime decodes an ASN.1 GENERALIZEDTIME into out and advances. It reports whether the read was successful.
func (s *String) ReadASN1GeneralizedTime(out *time.Time) boolReadASN1Int64WithTag method #
ReadASN1Int64WithTag decodes an ASN.1 INTEGER with the given tag into out and advances. It reports whether the read was successful and resulted in a value that can be represented in an int64.
func (s *String) ReadASN1Int64WithTag(out *int64, tag asn1.Tag) boolReadASN1Integer method #
ReadASN1Integer decodes an ASN.1 INTEGER into out and advances. If out does not point to an integer, to a big.Int, or to a []byte it panics. Only positive and zero values can be decoded into []byte, and they are returned as big-endian binary values that share memory with s. Positive values will have no leading zeroes, and zero will be returned as a single zero byte. ReadASN1Integer reports whether the read was successful.
func (s *String) ReadASN1Integer(out interface{}) boolReadASN1ObjectIdentifier method #
ReadASN1ObjectIdentifier decodes an ASN.1 OBJECT IDENTIFIER into out and advances. It reports whether the read was successful.
func (s *String) ReadASN1ObjectIdentifier(out *encoding_asn1.ObjectIdentifier) boolReadASN1UTCTime method #
ReadASN1UTCTime decodes an ASN.1 UTCTime into out and advances. It reports whether the read was successful.
func (s *String) ReadASN1UTCTime(out *time.Time) boolReadAnyASN1 method #
ReadAnyASN1 reads the contents of a DER-encoded ASN.1 element (not including tag and length bytes) into out, sets outTag to its tag, and advances. It reports whether the read was successful. Tags greater than 30 are not supported (i.e. low-tag-number format only).
func (s *String) ReadAnyASN1(out *String, outTag *asn1.Tag) boolReadAnyASN1Element method #
ReadAnyASN1Element reads the contents of a DER-encoded ASN.1 element (including tag and length bytes) into out, sets outTag to is tag, and advances. It reports whether the read was successful. Tags greater than 30 are not supported (i.e. low-tag-number format only).
func (s *String) ReadAnyASN1Element(out *String, outTag *asn1.Tag) boolReadBytes method #
ReadBytes reads n bytes into out and advances over them. It reports whether the read was successful.
func (s *String) ReadBytes(out *[]byte, n int) boolReadOptionalASN1 method #
ReadOptionalASN1 attempts to read the contents of a DER-encoded ASN.1 element (not including tag and length bytes) tagged with the given tag into out. It stores whether an element with the tag was found in outPresent, unless outPresent is nil. It reports whether the read was successful.
func (s *String) ReadOptionalASN1(out *String, outPresent *bool, tag asn1.Tag) boolReadOptionalASN1Boolean method #
ReadOptionalASN1Boolean attempts to read an optional ASN.1 BOOLEAN explicitly tagged with tag into out and advances. If no element with a matching tag is present, it sets "out" to defaultValue instead. It reports whether the read was successful.
func (s *String) ReadOptionalASN1Boolean(out *bool, tag asn1.Tag, defaultValue bool) boolReadOptionalASN1Integer method #
ReadOptionalASN1Integer attempts to read an optional ASN.1 INTEGER explicitly tagged with tag into out and advances. If no element with a matching tag is present, it writes defaultValue into out instead. Otherwise, it behaves like ReadASN1Integer.
func (s *String) ReadOptionalASN1Integer(out interface{}, tag asn1.Tag, defaultValue interface{}) boolReadOptionalASN1OctetString method #
ReadOptionalASN1OctetString attempts to read an optional ASN.1 OCTET STRING explicitly tagged with tag into out and advances. If no element with a matching tag is present, it sets "out" to nil instead. It reports whether the read was successful.
func (s *String) ReadOptionalASN1OctetString(out *[]byte, outPresent *bool, tag asn1.Tag) boolReadUint16 method #
ReadUint16 decodes a big-endian, 16-bit value into out and advances over it. It reports whether the read was successful.
func (s *String) ReadUint16(out *uint16) boolReadUint16LengthPrefixed method #
ReadUint16LengthPrefixed reads the content of a big-endian, 16-bit length-prefixed value into out and advances over it. It reports whether the read was successful.
func (s *String) ReadUint16LengthPrefixed(out *String) boolReadUint24 method #
ReadUint24 decodes a big-endian, 24-bit value into out and advances over it. It reports whether the read was successful.
func (s *String) ReadUint24(out *uint32) boolReadUint24LengthPrefixed method #
ReadUint24LengthPrefixed reads the content of a big-endian, 24-bit length-prefixed value into out and advances over it. It reports whether the read was successful.
func (s *String) ReadUint24LengthPrefixed(out *String) boolReadUint32 method #
ReadUint32 decodes a big-endian, 32-bit value into out and advances over it. It reports whether the read was successful.
func (s *String) ReadUint32(out *uint32) boolReadUint48 method #
ReadUint48 decodes a big-endian, 48-bit value into out and advances over it. It reports whether the read was successful.
func (s *String) ReadUint48(out *uint64) boolReadUint64 method #
ReadUint64 decodes a big-endian, 64-bit value into out and advances over it. It reports whether the read was successful.
func (s *String) ReadUint64(out *uint64) boolReadUint8 method #
ReadUint8 decodes an 8-bit value into out and advances over it. It reports whether the read was successful.
func (s *String) ReadUint8(out *uint8) boolReadUint8LengthPrefixed method #
ReadUint8LengthPrefixed reads the content of an 8-bit length-prefixed value into out and advances over it. It reports whether the read was successful.
func (s *String) ReadUint8LengthPrefixed(out *String) boolSetError method #
SetError sets the value to be returned as the error from Bytes. Writes performed after calling SetError are ignored.
func (b *Builder) SetError(err error)Skip method #
Skip advances the String by n byte and reports whether it was successful.
func (s *String) Skip(n int) boolSkipASN1 method #
SkipASN1 reads and discards an ASN.1 element with the given tag. It reports whether the operation was successful.
func (s *String) SkipASN1(tag asn1.Tag) boolSkipOptionalASN1 method #
SkipOptionalASN1 advances s over an ASN.1 element with the given tag, or else leaves s unchanged. It reports whether the operation was successful.
func (s *String) SkipOptionalASN1(tag asn1.Tag) boolUnwrite method #
Unwrite rolls back non-negative n bytes written directly to the Builder. An attempt by a child builder passed to a continuation to unwrite bytes from its parent will panic.
func (b *Builder) Unwrite(n int)add method #
func (b *Builder) add(bytes ...byte)addASN1Signed method #
func (b *Builder) addASN1Signed(tag asn1.Tag, v int64)addBase128Int method #
func (b *Builder) addBase128Int(n int64)addLengthPrefixed method #
func (b *Builder) addLengthPrefixed(lenLen int, isASN1 bool, f BuilderContinuation)asn1Signed function #
func asn1Signed(out *int64, n []byte) boolasn1Unsigned function #
func asn1Unsigned(out *uint64, n []byte) boolcallContinuation method #
func (b *Builder) callContinuation(f BuilderContinuation, arg *Builder)checkASN1Integer function #
func checkASN1Integer(bytes []byte) boolflushChild method #
func (b *Builder) flushChild()isValidOID function #
func isValidOID(oid encoding_asn1.ObjectIdentifier) boolread method #
read advances a String by n bytes and returns them. If less than n bytes remain, it returns nil.
func (s *String) read(n int) []bytereadASN1 method #
func (s *String) readASN1(out *String, outTag *asn1.Tag, skipHeader bool) boolreadASN1BigInt method #
func (s *String) readASN1BigInt(out *big.Int) boolreadASN1Bytes method #
func (s *String) readASN1Bytes(out *[]byte) boolreadASN1Int64 method #
func (s *String) readASN1Int64(out *int64) boolreadASN1Uint64 method #
func (s *String) readASN1Uint64(out *uint64) boolreadBase128Int method #
func (s *String) readBase128Int(out *int) boolreadLengthPrefixed method #
func (s *String) readLengthPrefixed(lenLen int, outChild *String) boolreadUnsigned method #
func (s *String) readUnsigned(out *uint32, length int) boolGenerated with Arrow