ASNTOOL(1)

💖 ASNTOOL(1) — the NCBI Tools User's Manual glow-up 💖

okay bestie, sit down, hydrate, and let me tell you about asntool — it's from the NCBI Tools User's Manual and it's literally the moment your ASN.1 module specs get read, validated, and shown off. main character energy fr fr 🦋

✨ NAME ✨

asntool — process ASN.1 module specifications 💅

🎀 SYNOPSIS 🎀

asntool [-] [-B filename] [-D N] [-F N] [-G] [-I str] [-J type] [-K str]
[-L str] [-M filename,...] [-N N] [-P str] [-Q] [-S filename]
[-T filename] [-U N] [-V] [-X filename] [-Z] [-b N] [-d filename]
[-e filename] [-f filename] [-l filename] -m filename [-o filename]
[-p filename] [-t str] [-v filename] [-w N] [-x filename]

heads up: -m filename is not in brackets, bestie. it's required. the rest are optional. periodt.

🌸 DESCRIPTION 🌸

asntool reads, validates, and displays ASN.1 module specifications. that's it, that's the whole vibe check — it takes your ASN.1 modules, checks they're not a mess, and shows you what's up. 👑

🌈 OPTIONS 🌈

here's the summary of options, and yes, we're going through every single one. no skipping, no summarizing, we don't do that here. 💖

• - — print the usage message. just a lil dash, doing a whole lot. 🫶
• -B filename — generate objects and code into files named filename.* ✨
• -D N — debugging level for code generation, pick your chaos:
  • 0 — no debugging (this is the default, the calm option)
  • 1 — shallow debugging
  • 2 — deep debugging
  • 3-9 — same as 2, so like, whatever, same energy 💀
• -F N — fix non-printing characters, choose your fighter:
  • 0 — replace with #, post ERROR (default!)
  • 1 — replace with # silently 🤫
  • 2 — pass through silently
  • 3 — replace with #, post FATAL 😭
• -G — generate object loader .c and .h files 🔥
• -I str — put "#include str" in the generated .c file
• -J type — register type type with the object manager 👑
• -K str — in the generated .c, force the name of the #included asn header to str
• -L str — label the registered type as str 🏷️
• -M filename,... — search the ASN.1 modules in filename,... for external references
• -N N — UTF8 input conversion, the whole menu:
  • 0 — convert silently (default)
  • 1 — convert, post WARNING the first time
  • 2 — convert, post WARNING each time
  • 3 — do not convert 🙈
• -P str — XML module prefix for DOCTYPE
• -Q — use the quoted syntax form for generated include files 💅
• -S filename — send debugging output to filename instead of stderr
• -T filename — dump the ASN.1 tree to filename 🌳
• -U N — UTF8 output conversion, same lil menu as input:
  • 0 — convert silently (default)
  • 1 — convert, post WARNING the first time
  • 2 — convert, post WARNING each time
  • 3 — do not convert 🙈
• -V — force CHOICE objects to use custom structures rather than ValNodePtrs, for compatibility with some old hand-coded object loaders. it's giving legacy support, we respect it 🫡
• -X filename — write the XML DTD to filename. if filename is "m", print each module to a separate file. cute, organized, obsessed. ✨
• -Z — bit twiddle for optional zero value base slots
• -b N — use N-byte buffers (default = 1024; anything between 512 and 10000 is legal) 📏
• -d filename — read binary values from filename (requires -t, bestie, don't forget it)
• -e filename — write binary values to filename
• -f filename — write the ASN.1 module to filename
• -l filename — write the ASN.1 loader to filename
• -m filename — read the ASN.1 module from filename. the required one. the star of the show. 🌟
• -o filename — write the header to filename
• -p filename — write print values to filename
• -t str — expect binary values to have type str
• -v filename — read print values from filename
• -w N — limit values in #defines to N bits (default = 31; anything between 31 and 128 is legal) 📏
• -x filename — write XML data to filename

👑 AUTHOR 👑

The National Center for Biotechnology Information. icons, honestly. 🫶

okay that's the whole page, bestie — courtesy of NCBI, dated 2016-09-01, and yeah it's still serving. go read, validate, and display those ASN.1 modules. slay. 💖✨🎀🦋