DUMPASN1(1)

πŸ“¦
this version Β· 3 versions
, in debian bookworm, ubuntu jammy, ubuntu noble

πŸ’– DUMPASN1(1) πŸ’–

okay bestie, sit down, we're doing dumpasn1 β€” it lives in the User Commands section of the manual, and it's about to become your new hyperfixation. ✨


🌸 NAME 🌸

dumpasn1 β€” the ASN.1 object dump / syntax check program. that's it, that's the whole vibe. πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

dumpasn1 [-acdefghilmoprstuvwxz] <file>

✨ DESCRIPTION ✨

So basically? This is an ASN.1 object dump program, and what it does is dump data encoded using any of the ASN.1 encoding rules in a whole bunch of user-specified formats. like, you pick the format, it serves the data. no cap. πŸ’–

DumpASN1 β€” ASN.1 object dump/syntax check program. Copyright Peter Gutmann 1997 - 2021. Last updated 12 February 2021. 🫢

πŸ”₯ Input options πŸ”₯

  • - β€” take input from stdin (lowkey, some options may not work properly when you do this πŸ™ˆ)
  • -<number> β€” start <number> bytes into the file
  • -- β€” end of arg list
  • -c<file> β€” read Object Identifier info from an alternate config file
heads up bestie: values from that alternate config will override the equivalents in the global config file. πŸ‘‘

πŸ’œ Output options πŸ’œ

  • -f<file> β€” dump the object at offset -<number> to a file (this is the one that lets you extract data from encapsulating objects πŸŽ€)
  • -w<number> β€” set the width of output, default = 80 columns

πŸŽ€ Display options πŸŽ€

  • -a β€” print all data in long data blocks, not just the first 128 bytes
  • -d β€” print dots to show column alignment
  • -g β€” display the ASN.1 structure outline only (no primitive objects)
  • -h β€” hex dump the object header (tag+length) before the decoded output
  • -hh β€” same as -h but displays more of the object as hex data
  • -i β€” use shallow indenting, for deeply-nested objects
  • -l β€” long format, displays extra info about Object Identifiers
  • -m<number> β€” maximum nesting level for which to display content
  • -p β€” pure ASN.1 output without encoding information
  • -t β€” display text values next to the hex dump of data
  • -v β€” verbose mode, equivalent to -ahlt

🌈 Format options 🌈

  • -e β€” don't print encapsulated data inside OCTET/BIT STRINGs
  • -r β€” print bits in BIT STRING as encoded in reverse order
  • -u β€” don't format UTCTime/GeneralizedTime string data
  • -x β€” display size and offset in hex, not decimal

⭐ Checking options ⭐

  • -o β€” don't check the validity of character strings hidden in octet strings
  • -s β€” syntax check only, don't dump ASN.1 structures
  • -z β€” allow zero-length items
⚠️ real talk: warnings generated by deprecated OIDs require the use of -l to be displayed. and the program return code is the number of errors found, or EXIT_SUCCESS. remember it. ✨

🧚 COMMENT 🧚

This manual page was written by Mathieu Malaterre <malat@debian.org> for the Debian GNU/Linux system, but it may be used by others. sharing is caring fr fr. πŸ’–


πŸ“ FILES πŸ“

$HOME/.dumpasn1.cfg, /etc/dumpasn1/dumpasn1.cfg:

This is the configuration file, and it will be searched in this order. It contains OIDs commonly used. πŸ—‚οΈ


πŸ‘‘ AUTHOR πŸ‘‘

quote from Peter Gutmann:

ASN.1 object dumping code, copyright Peter Gutmann <pgut001@cs.auckland.ac.nz>, based on ASN.1 dump program by David Kemp <dpkemp@missi.ncsc.mil>, with contributions from various people including Matthew Hamrick <hamrick@rsa.com>, Bruno Couillard <bcouillard@chrysalis-its.com>, Hallvard Furuseth <h.b.furuseth@usit.uio.no>, Geoff Thorpe <geoff@raas.co.nz>, David Boyce <d.boyce@isode.com>, John Hughes <john.hughes@entegrity.com>, Life is hard, and then you die <ronald@trustpoint.com>, Hans-Olof Hermansson <hans-olof.hermansson@postnet.se>, Tor Rustad <Tor.Rustad@bbs.no>, Kjetil Barvik <kjetil.barvik@bbs.no>, James Sweeny <jsweeny@us.ibm.com>, and several other people whose names I've misplaced. 😭

dumpasn1 is available at https://www.cs.auckland.ac.nz/~pgut001/ πŸ¦‹


Copyright Peter Gutmann 1997 - 2016. Last updated 22 October 2019.


and that's the whole page, bestie β€” dumpasn1 version 20210212, from January 2022, the DUMPASN1(1) manual. go forth and dump some objects, you absolute icon. πŸ’–βœ¨πŸŽ€πŸ¦‹πŸŒΈ

πŸ“¦ where this page comes from