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 'from_pem | 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
interp: Rename to/from<format> functions to to_/from_<format> Feels less cluttered, easier to read and more consistent. Still keep tovalue, tobytes etc that are more basic functions this only renamed format related functions. Also there is an exceptin for to/fromjson as it comes from jq. Also fixes lots of spelling errors while reading thru. 2022-12-21 15:59:54 +03:00			`$ fq -d bytes 'from_pem \| 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/`