encoding/asn1

• import "encoding/asn1"

• 概述

• 索引

概述

按照 ITU-T Rec X.690 的规定，asn1 包实现了对 DER 编码的 ASN.1 数据结构的解析。

另见“ ASN.1，BER 和 DER 子集的外行指南”，http：//luca.ntop.org/Teaching/Appunti/asn1.html。

索引

• 常量

• 变量

• func Marshal(val interface{}) ([]byte, error)

• func Unmarshal(b []byte, val interface{}) (rest []byte, err error)

• func UnmarshalWithParams(b []byte, val interface{}, params string) (rest []byte, err error)

• type BitString

• func (b BitString) At(i int) int

• func (b BitString) RightAlign() []byte

• type Enumerated

• type Flag

• type ObjectIdentifier

• func (oi ObjectIdentifier) Equal(other ObjectIdentifier) bool

• func (oi ObjectIdentifier) String() string

• type RawContent

• type RawValue

• type StructuralError

• func (e StructuralError) Error() string

• type SyntaxError

• func (e SyntaxError) Error() string

包文件

asn1.go common.go marshal.go

常量

ASN.1 标签表示以下对象的类型。

const (
        TagBoolean         = 1
        TagInteger         = 2
        TagBitString       = 3
        TagOctetString     = 4
        TagNull            = 5
        TagOID             = 6
        TagEnum            = 10
        TagUTF8String      = 12
        TagSequence        = 16
        TagSet             = 17
        TagPrintableString = 19
        TagT61String       = 20
        TagIA5String       = 22
        TagUTCTime         = 23
        TagGeneralizedTime = 24
        TagGeneralString   = 27
)

ASN.1 类类型表示标签的名称空间。

const (
        ClassUniversal       = 0
        ClassApplication     = 1
        ClassContextSpecific = 2
        ClassPrivate         = 3
)

变量

NullBytes 包含表示 DER 编码的 ASN.1 NULL 类型的字节。

var NullBytes = []byte{TagNull, 0}

NullRawValue 是一个 RawValue，其标签设置为 ASN.1 NULL 类型 tag(5)。

var NullRawValue = RawValue{Tag: TagNull}

func Marshal（查看源代码）

func Marshal(val interface{}) ([]byte, error)

Marshal 返回 val 的 ASN.1 编码。

除了由 Unmarshal 识别的结构标签之外，还可以使用以下内容：

ia5：导致字符串被封送为ASN.1，IA5String值
omitempty：导致跳过空切片
printable：导致字符串被封送为ASN.1，PrintableString值
utf8：导致字符串被封送为ASN.1，UTF8String值
utc：导致time.Time被封送为ASN.1，UTCTime值
generalized：导致time.Time被封送为ASN.1，GeneralizedTime值

func Unmarshal（查看源代码）

func Unmarshal(b []byte, val interface{}) (rest []byte, err error)

Unmarshal 分析 DER 编码的 ASN.1 数据结构 b 并使用反射包填充 val 指向的任意值。由于 Unmarshal 使用反射包，因此写入的结构必须使用大写字段名称。

ASN.1 INTEGER 可以写入 int，int32，int64 或 *big.Int（来自 math/big package）。如果编码值不适合 Go 类型，Unmarshal 会返回解析错误。

一个 ASN.1 BIT STRING 可以写入一个 BitString。

ASN.1 OCTET STRING 可以写入 []byte。

一个 ASN.1 OBJECT IDENTIFIER 可以写入一个 ObjectIdentifier。

一个 ASN.1 枚举可以被写入枚举。

一次 ASN.1 UTCTIME 或 GENERALIZEDTIME 可写入一次。

ASN.1 PrintableString 或 IA5String 可写入字符串。

任何上面的 ASN.1 值都可以写入 interface{}。存储在接口中的值具有相应的 Go 类型。对于整数，该类型是 int64。

如果可以将 x 写入片段的元素类型，则可以将 x 或 x 的 ASN.1 序列写入片段。

如果可以将序列中的每个元素写入结构中的相应元素，则可以将 ASN.1 SEQUENCE 或 SET 写入结构。

结构字段上的以下标记对 Unmarshal 具有特殊意义：

application指定使用APPLICATION标记
default：x设置可选整数字段的默认值（仅在可选的整数字段存在时使用）
explicit指定附加的显式标记包装隐式标记
可选标记该字段为ASN.1可选
set会导致SET，而不是SEQUENCE类型
tag：x指定ASN.1标记号; 暗示ASN.1特定背景

如果结构的第一个字段的类型是 RawContent，那么该结构的原始 ASN1 内容将被存储在其中。

如果一个切片元素的类型名称以“SET”结尾，那么它将被视为设置了“set”标签。这可以用于无法给出 struct 标记的嵌套切片。

其他 ASN.1 类型不受支持；如果遇到，Unmarshal 将返回一个分析错误。

func UnmarshalWithParams（查看源代码）

func UnmarshalWithParams(b []byte, val interface{}, params string) (rest []byte, err error)

UnmarshalWithParams 允许为顶层元素指定字段参数。参数的形式与字段标签相同。

type BitString（查看源代码）

当您需要 ASN.1 BIT STRING 类型时，BitString 是要使用的结构。位串被填充到内存中最近的字节并记录有效位的数量。填充位将为零。

type BitString struct {
        Bytes     []byte // 比特打包成字节。
        BitLength int    // 比特长度。
}

func (BitString) At（查看源代码）

func (b BitString) At(i int) int

返回给定索引处的位。如果索引超出范围，则返回 false。

func (BitString) RightAlign（查看源代码）

func (b BitString) RightAlign() []byte

RightAlign 返回填充位在开始位置的片。切片可以与 BitString 共享内存。

type Enumerated（查看源代码）

Enumerated 被表示为一个纯（plain） int。

type Enumerated int

type Flag（查看源代码）

Flag 接受任何数据，如果存在则设置为 true。

type Flag bool

type ObjectIdentifier（查看源代码）

一个 ObjectIdentifier 表示一个 ASN.1 对象标识符。

type ObjectIdentifier []int

func (ObjectIdentifier) Equal（查看源代码）

func (oi ObjectIdentifier) Equal(other ObjectIdentifier) bool

平等报告 oi 和其他是否表示相同的标识符。

func (ObjectIdentifier) String（查看源代码）

func (oi ObjectIdentifier) String() string

type RawContent（查看源代码）

RawContent 用于表示未解码的 DER 数据需要为结构体保留。要使用它，结构的第一个字段必须有这种类型。任何其他字段都有这种类型的错误。

type RawContent []byte

type RawValue（查看源代码）

一个 RawValue 表示一个未解码的 ASN.1 对象。

type RawValue struct {
        Class, Tag int
        IsCompound bool
        Bytes      []byte
        FullBytes  []byte // 包括标签和长度
}

type StructuralError（查看源代码）

StructuralError 表明 ASN.1 数据是有效的，但是接收它的 Go 类型不匹配。

type StructuralError struct {
        Msg string
}

func (StructuralError) Error（查看源代码）

func (e StructuralError) Error() string

type SyntaxError（查看源代码）

SyntaxError 表明 ASN.1 数据无效。

type SyntaxError struct {
        Msg string
}

func (SyntaxError) Error（查看源代码）

func (e SyntaxError) Error() string