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