direktori cari
archive archive/tar archive/zip bufio bufio(缓存) builtin builtin(内置包) bytes bytes(包字节) compress compress/bzip2(压缩/bzip2) compress/flate(压缩/flate) compress/gzip(压缩/gzip) compress/lzw(压缩/lzw) compress/zlib(压缩/zlib) container container/heap(容器数据结构heap) container/list(容器数据结构list) container/ring(容器数据结构ring) context context(上下文) crypto crypto(加密) crypto/aes(加密/aes) crypto/cipher(加密/cipher) crypto/des(加密/des) crypto/dsa(加密/dsa) crypto/ecdsa(加密/ecdsa) crypto/elliptic(加密/elliptic) crypto/hmac(加密/hmac) crypto/md5(加密/md5) crypto/rand(加密/rand) crypto/rc4(加密/rc4) crypto/rsa(加密/rsa) crypto/sha1(加密/sha1) crypto/sha256(加密/sha256) crypto/sha512(加密/sha512) crypto/subtle(加密/subtle) crypto/tls(加密/tls) crypto/x509(加密/x509) crypto/x509/pkix(加密/x509/pkix) database database/sql(数据库/sql) database/sql/driver(数据库/sql/driver) debug debug/dwarf(调试/dwarf) debug/elf(调试/elf) debug/gosym(调试/gosym) debug/macho(调试/macho) debug/pe(调试/pe) debug/plan9obj(调试/plan9obj) encoding encoding(编码) encoding/ascii85(编码/ascii85) encoding/asn1(编码/asn1) encoding/base32(编码/base32) encoding/base64(编码/base64) encoding/binary(编码/binary) encoding/csv(编码/csv) encoding/gob(编码/gob) encoding/hex(编码/hex) encoding/json(编码/json) encoding/pem(编码/pem) encoding/xml(编码/xml) errors errors(错误) expvar expvar flag flag(命令行参数解析flag包) fmt fmt go go/ast(抽象语法树) go/build go/constant(常量) go/doc(文档) go/format(格式) go/importer go/parser go/printer go/scanner(扫描仪) go/token(令牌) go/types(类型) hash hash(散列) hash/adler32 hash/crc32 hash/crc64 hash/fnv html html html/template(模板) image image(图像) image/color(颜色) image/color/palette(调色板) image/draw(绘图) image/gif image/jpeg image/png index index/suffixarray io io io/ioutil log log log/syslog(日志系统) math math math/big math/big math/bits math/bits math/cmplx math/cmplx math/rand math/rand mime mime mime/multipart(多部分) mime/quotedprintable net net net/http net/http net/http/cgi net/http/cookiejar net/http/fcgi net/http/httptest net/http/httptrace net/http/httputil net/http/internal net/http/pprof net/mail net/mail net/rpc net/rpc net/rpc/jsonrpc net/smtp net/smtp net/textproto net/textproto net/url net/url os os os/exec os/signal os/user path path path/filepath(文件路径) plugin plugin(插件) reflect reflect(反射) regexp regexp(正则表达式) regexp/syntax runtime runtime(运行时) runtime/debug(调试) runtime/internal/sys runtime/pprof runtime/race(竞争) runtime/trace(执行追踪器) sort sort(排序算法) strconv strconv(转换) strings strings(字符串) sync sync(同步) sync/atomic(原子操作) syscall syscall(系统调用) testing testing(测试) testing/iotest testing/quick text text/scanner(扫描文本) text/tabwriter text/template(定义模板) text/template/parse time time(时间戳) unicode unicode unicode/utf16 unicode/utf8 unsafe unsafe
watak

  • 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
Artikel sebelumnya: Artikel seterusnya: