fq/format/asn1/asn1_ber.md

Supports decoding BER, CER and DER (X.690).

- Currently no extra validation is done for CER and DER.
- Does not support specifying a schema.
- Supports `torepr` but without schema all sequences and sets will be arrays.

### Can be used to decode certificates etc

```sh
$ fq -d bytes 'frompem | asn1_ber | d' cert.pem
```

### Can decode nested values

```sh
$ fq -d asn1_ber '.constructed[1].value | asn1_ber' file.ber
```

### Manual schema

```sh
$ fq -d asn1_ber 'torepr as $r | ["version", "modulus", "private_exponent", "private_exponen", "prime1", "prime2", "exponent1", "exponent2", "coefficient"] | with_entries({key: .value, value: $r[.key]})' pkcs1.der
```

### References
- https://www.itu.int/ITU-T/studygroups/com10/languages/X.690_1297.pdf
- https://en.wikipedia.org/wiki/X.690
- https://letsencrypt.org/docs/a-warm-welcome-to-asn1-and-der/
- https://lapo.it/asn1js/
help,doc: Use markdown for format documentation again Markdown is used as is in online documentation and in cli the markdown decoder is used to decode and the some jq code massages it into something cli friendly. Was just too much of a mess to have doc in jq. 2022-09-10 19:28:54 +03:00			`Supports decoding BER, CER and DER (X.690).`

			`- Currently no extra validation is done for CER and DER.`
			`- Does not support specifying a schema.`
			- Supports `torepr` but without schema all sequences and sets will be arrays.

doc,help: Nicer format help and move help tests into each format Also add authors to avro and macho decoders Generated with: for i in $(go run . -r -n '_registry \| [([([.files[][].name \| split(".")[0]] \| unique[]), (.formats[].name)] \| count[] \| select(.[1] == 2)[0]), (.formats[] \| select(.decode_in_arg).name)] \| unique[]'); do DIR=$(dirname $(find format -name $i.go)); echo "$ fq -h $i" > "$DIR/testdata/help_$i.fqtest" ; done 2022-09-22 19:32:13 +03:00			`### Can be used to decode certificates etc`
help,doc: Use markdown for format documentation again Markdown is used as is in online documentation and in cli the markdown decoder is used to decode and the some jq code massages it into something cli friendly. Was just too much of a mess to have doc in jq. 2022-09-10 19:28:54 +03:00
			```sh
raw,bits,bytes: Replace raw format with bits and bytes format that decode to a binary raw format was a hack to skip decoding to be able to get a binary using tobyte etc. Now you can do fq -d bytes ... instead of fq -d raw 'tobytes \| ...' 2022-11-20 21:22:16 +03:00			`$ fq -d bytes 'frompem \| asn1_ber \| d' cert.pem`
help,doc: Use markdown for format documentation again Markdown is used as is in online documentation and in cli the markdown decoder is used to decode and the some jq code massages it into something cli friendly. Was just too much of a mess to have doc in jq. 2022-09-10 19:28:54 +03:00			```

doc: Fix format sections a bit 2022-09-11 10:55:30 +03:00			`### Can decode nested values`
help,doc: Use markdown for format documentation again Markdown is used as is in online documentation and in cli the markdown decoder is used to decode and the some jq code massages it into something cli friendly. Was just too much of a mess to have doc in jq. 2022-09-10 19:28:54 +03:00
			```sh
			`$ fq -d asn1_ber '.constructed[1].value \| asn1_ber' file.ber`
			```

doc: Fix format sections a bit 2022-09-11 10:55:30 +03:00			`### Manual schema`
help,doc: Use markdown for format documentation again Markdown is used as is in online documentation and in cli the markdown decoder is used to decode and the some jq code massages it into something cli friendly. Was just too much of a mess to have doc in jq. 2022-09-10 19:28:54 +03:00
			```sh
			`$ fq -d asn1_ber 'torepr as $r \| ["version", "modulus", "private_exponent", "private_exponen", "prime1", "prime2", "exponent1", "exponent2", "coefficient"] \| with_entries({key: .value, value: $r[.key]})' pkcs1.der`
			```

doc: Fix format sections a bit 2022-09-11 10:55:30 +03:00			`### References`
help,doc: Use markdown for format documentation again Markdown is used as is in online documentation and in cli the markdown decoder is used to decode and the some jq code massages it into something cli friendly. Was just too much of a mess to have doc in jq. 2022-09-10 19:28:54 +03:00			`- https://www.itu.int/ITU-T/studygroups/com10/languages/X.690_1297.pdf`
			`- https://en.wikipedia.org/wiki/X.690`
			`- https://letsencrypt.org/docs/a-warm-welcome-to-asn1-and-der/`
			`- https://lapo.it/asn1js/`