xref: /freebsd/contrib/libder/derdump/derdump.1 (revision f3087bef11543b42e0d69b708f367097a4118d24)
1.\"
2.\" SPDX-Copyright-Identifier: BSD-2-Clause
3.\"
4.\" Copyright (C) 2024 Kyle Evans <kevans@FreeBSD.org>
5.\"
6.Dd March 4, 2024
7.Dt DERDUMP 1
8.Os
9.Sh NAME
10.Nm derdump
11.Nd dumping contents of DER encoded files
12.Sh SYNOPSIS
13.Nm
14.Ar file1
15.Oo Ar fileN ... Oc
16.Sh DESCRIPTION
17The
18.Nm
19utility dumps the contents of one or more DER encoded
20Ar file
21in a more human readable format.
22This is similar to the
23.Xr asn1parse 1
24utility distributed with OpenSSL when used with the
25.Fl inform
26.Ar DER
27option.
28.Pp
29A representation of the object will be output to
30.Em stdout ,
31with indentation to denote objects that are encoded within other constructed
32objects.
33Note that
34.Nm
35does not make much attempt to interpret the contents of any particular object.
36If an object uses one of the universal types, then a friendly name will be
37displayed for that object.
38If an object uses any other type, then
39.Nm
40will display the raw hex value of the type used.
41Values of primitive objects are output as raw hex, and no effort is made to
42try and print a friendly representation.
43.Sh SEE ALSO
44.Xr asn1parse 1 ,
45.Xr libder 3
46.Sh BUGS
47.Nm
48does not currently make any attempt to render a type that uses the long encoded
49format.
50Instead, it will render as
51.Dq { ... } .
52