usr.bin/clang/llvm-pdbutil/llvm-pdbutil.1

   1 .\" $FreeBSD$
   2 .\" Man page generated from reStructuredText.
   3 .
   4 .TH "LLVM-PDBUTIL" "1" "2018-08-02" "7" "LLVM"
   5 .SH NAME
   6 llvm-pdbutil \- PDB File forensics and diagnostics
   7 .
   8 .nr rst2man-indent-level 0
   9 .
  10 .de1 rstReportMargin
  11 \\$1 \\n[an-margin]
  12 level \\n[rst2man-indent-level]
  13 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
  14 -
  15 \\n[rst2man-indent0]
  16 \\n[rst2man-indent1]
  17 \\n[rst2man-indent2]
  18 ..
  19 .de1 INDENT
  20 .\" .rstReportMargin pre:
  21 . RS \\$1
  22 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
  23 . nr rst2man-indent-level +1
  24 .\" .rstReportMargin post:
  25 ..
  26 .de UNINDENT
  27 . RE
  28 .\" indent \\n[an-margin]
  29 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
  30 .nr rst2man-indent-level -1
  31 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
  32 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
  33 ..
  34 .INDENT 0.0
  35 .IP \(bu 2
  36 \fI\%Synopsis\fP
  37 .IP \(bu 2
  38 \fI\%Description\fP
  39 .IP \(bu 2
  40 \fI\%Subcommands\fP
  41 .INDENT 2.0
  42 .IP \(bu 2
  43 \fI\%pretty\fP
  44 .INDENT 2.0
  45 .IP \(bu 2
  46 \fI\%Summary\fP
  47 .IP \(bu 2
  48 \fI\%Options\fP
  49 .INDENT 2.0
  50 .IP \(bu 2
  51 \fI\%Filtering and Sorting Options\fP
  52 .IP \(bu 2
  53 \fI\%Symbol Type Options\fP
  54 .IP \(bu 2
  55 \fI\%Other Options\fP
  56 .UNINDENT
  57 .UNINDENT
  58 .IP \(bu 2
  59 \fI\%dump\fP
  60 .INDENT 2.0
  61 .IP \(bu 2
  62 \fI\%Summary\fP
  63 .IP \(bu 2
  64 \fI\%Options\fP
  65 .INDENT 2.0
  66 .IP \(bu 2
  67 \fI\%MSF Container Options\fP
  68 .IP \(bu 2
  69 \fI\%Module & File Options\fP
  70 .IP \(bu 2
  71 \fI\%Symbol Options\fP
  72 .IP \(bu 2
  73 \fI\%Type Record Options\fP
  74 .IP \(bu 2
  75 \fI\%Miscellaneous Options\fP
  76 .UNINDENT
  77 .UNINDENT
  78 .IP \(bu 2
  79 \fI\%bytes\fP
  80 .INDENT 2.0
  81 .IP \(bu 2
  82 \fI\%Summary\fP
  83 .IP \(bu 2
  84 \fI\%Options\fP
  85 .INDENT 2.0
  86 .IP \(bu 2
  87 \fI\%MSF File Options\fP
  88 .IP \(bu 2
  89 \fI\%PDB Stream Options\fP
  90 .IP \(bu 2
  91 \fI\%DBI Stream Options\fP
  92 .IP \(bu 2
  93 \fI\%Module Options\fP
  94 .IP \(bu 2
  95 \fI\%Type Record Options\fP
  96 .UNINDENT
  97 .UNINDENT
  98 .IP \(bu 2
  99 \fI\%pdb2yaml\fP
 100 .INDENT 2.0
 101 .IP \(bu 2
 102 \fI\%Summary\fP
 103 .IP \(bu 2
 104 \fI\%Options\fP
 105 .UNINDENT
 106 .IP \(bu 2
 107 \fI\%yaml2pdb\fP
 108 .INDENT 2.0
 109 .IP \(bu 2
 110 \fI\%Summary\fP
 111 .IP \(bu 2
 112 \fI\%Options\fP
 113 .UNINDENT
 114 .IP \(bu 2
 115 \fI\%merge\fP
 116 .INDENT 2.0
 117 .IP \(bu 2
 118 \fI\%Summary\fP
 119 .IP \(bu 2
 120 \fI\%Options\fP
 121 .UNINDENT
 122 .UNINDENT
 123 .UNINDENT
 124 .SH SYNOPSIS
 125 .sp
 126 \fBllvm\-pdbutil\fP [\fIsubcommand\fP] [\fIoptions\fP]
 127 .SH DESCRIPTION
 128 .sp
 129 Display types, symbols, CodeView records, and other information from a
 130 PDB file, as well as manipulate and create PDB files.  \fBllvm\-pdbutil\fP
 131 is normally used by FileCheck\-based tests to test LLVM\(aqs PDB reading and
 132 writing functionality, but can also be used for general PDB file investigation
 133 and forensics, or as a replacement for cvdump.
 134 .SH SUBCOMMANDS
 135 .sp
 136 \fBllvm\-pdbutil\fP is separated into several subcommands each tailored to
 137 a different purpose.  A brief summary of each command follows, with more detail
 138 in the sections that follow.
 139 .INDENT 0.0
 140 .INDENT 3.5
 141 .INDENT 0.0
 142 .IP \(bu 2
 143 \fI\%pretty\fP \- Dump symbol and type information in a format that
 144 tries to look as much like the original source code as possible.
 145 .IP \(bu 2
 146 \fI\%dump\fP \- Dump low level types and structures from the PDB
 147 file, including CodeView records, hash tables, PDB streams, etc.
 148 .IP \(bu 2
 149 \fI\%bytes\fP \- Dump data from the PDB file\(aqs streams, records,
 150 types, symbols, etc as raw bytes.
 151 .IP \(bu 2
 152 \fI\%yaml2pdb\fP \- Given a yaml description of a PDB file, produce
 153 a valid PDB file that matches that description.
 154 .IP \(bu 2
 155 \fI\%pdb2yaml\fP \- For a given PDB file, produce a YAML
 156 description of some or all of the file in a way that the PDB can be
 157 reconstructed.
 158 .IP \(bu 2
 159 \fI\%merge\fP \- Given two PDBs, produce a third PDB that is the
 160 result of merging the two input PDBs.
 161 .UNINDENT
 162 .UNINDENT
 163 .UNINDENT
 164 .SS pretty
 165 .sp
 166 \fBIMPORTANT:\fP
 167 .INDENT 0.0
 168 .INDENT 3.5
 169 The \fBpretty\fP subcommand is built on the Windows DIA SDK, and as such is not
 170 supported on non\-Windows platforms.
 171 .UNINDENT
 172 .UNINDENT
 173 .sp
 174 USAGE: \fBllvm\-pdbutil\fP pretty [\fIoptions\fP] <input PDB file>
 175 .SS Summary
 176 .sp
 177 The \fIpretty\fP subcommand displays a very high level representation of your
 178 program\(aqs debug info.  Since it is built on the Windows DIA SDK which is the
 179 standard API that Windows tools and debuggers query debug information, it
 180 presents a more authoritative view of how a debugger is going to interpret your
 181 debug information than a mode which displays low\-level CodeView records.
 182 .SS Options
 183 .SS Filtering and Sorting Options
 184 .sp
 185 \fBNOTE:\fP
 186 .INDENT 0.0
 187 .INDENT 3.5
 188 \fIexclude\fP filters take priority over \fIinclude\fP filters.  So if a filter
 189 matches both an include and an exclude rule, then it is excluded.
 190 .UNINDENT
 191 .UNINDENT
 192 .INDENT 0.0
 193 .TP
 194 .B \-exclude\-compilands=<string>
 195 When dumping compilands, compiland source\-file contributions, or per\-compiland
 196 symbols, this option instructs \fBllvm\-pdbutil\fP to omit any compilands that
 197 match the specified regular expression.
 198 .UNINDENT
 199 .INDENT 0.0
 200 .TP
 201 .B \-exclude\-symbols=<string>
 202 When dumping global, public, or per\-compiland symbols, this option instructs
 203 \fBllvm\-pdbutil\fP to omit any symbols that match the specified regular
 204 expression.
 205 .UNINDENT
 206 .INDENT 0.0
 207 .TP
 208 .B \-exclude\-types=<string>
 209 When dumping types, this option instructs \fBllvm\-pdbutil\fP to omit any types
 210 that match the specified regular expression.
 211 .UNINDENT
 212 .INDENT 0.0
 213 .TP
 214 .B \-include\-compilands=<string>
 215 When dumping compilands, compiland source\-file contributions, or per\-compiland
 216 symbols, limit the initial search to only those compilands that match the
 217 specified regular expression.
 218 .UNINDENT
 219 .INDENT 0.0
 220 .TP
 221 .B \-include\-symbols=<string>
 222 When dumping global, public, or per\-compiland symbols, limit the initial
 223 search to only those symbols that match the specified regular expression.
 224 .UNINDENT
 225 .INDENT 0.0
 226 .TP
 227 .B \-include\-types=<string>
 228 When dumping types, limit the initial search to only those types that match
 229 the specified regular expression.
 230 .UNINDENT
 231 .INDENT 0.0
 232 .TP
 233 .B \-min\-class\-padding=<uint>
 234 Only display types that have at least the specified amount of alignment
 235 padding, accounting for padding in base classes and aggregate field members.
 236 .UNINDENT
 237 .INDENT 0.0
 238 .TP
 239 .B \-min\-class\-padding\-imm=<uint>
 240 Only display types that have at least the specified amount of alignment
 241 padding, ignoring padding in base classes and aggregate field members.
 242 .UNINDENT
 243 .INDENT 0.0
 244 .TP
 245 .B \-min\-type\-size=<uint>
 246 Only display types T where sizeof(T) is greater than or equal to the specified
 247 amount.
 248 .UNINDENT
 249 .INDENT 0.0
 250 .TP
 251 .B \-no\-compiler\-generated
 252 Don\(aqt show compiler generated types and symbols
 253 .UNINDENT
 254 .INDENT 0.0
 255 .TP
 256 .B \-no\-enum\-definitions
 257 When dumping an enum, don\(aqt show the full enum (e.g. the individual enumerator
 258 values).
 259 .UNINDENT
 260 .INDENT 0.0
 261 .TP
 262 .B \-no\-system\-libs
 263 Don\(aqt show symbols from system libraries
 264 .UNINDENT
 265 .SS Symbol Type Options
 266 .INDENT 0.0
 267 .TP
 268 .B \-all
 269 Implies all other options in this category.
 270 .UNINDENT
 271 .INDENT 0.0
 272 .TP
 273 .B \-class\-definitions=<format>
 274 Displays class definitions in the specified format.
 275 .INDENT 7.0
 276 .INDENT 3.5
 277 .sp
 278 .nf
 279 .ft C
 280 =all      \- Display all class members including data, constants, typedefs, functions, etc (default)
 281 =layout   \- Only display members that contribute to class size.
 282 =none     \- Don\(aqt display class definitions (e.g. only display the name and base list)
 283 .ft P
 284 .fi
 285 .UNINDENT
 286 .UNINDENT
 287 .UNINDENT
 288 .INDENT 0.0
 289 .TP
 290 .B \-class\-order
 291 Displays classes in the specified order.
 292 .INDENT 7.0
 293 .INDENT 3.5
 294 .sp
 295 .nf
 296 .ft C
 297 =none            \- Undefined / no particular sort order (default)
 298 =name            \- Sort classes by name
 299 =size            \- Sort classes by size
 300 =padding         \- Sort classes by amount of padding
 301 =padding\-pct     \- Sort classes by percentage of space consumed by padding
 302 =padding\-imm     \- Sort classes by amount of immediate padding
 303 =padding\-pct\-imm \- Sort classes by percentage of space consumed by immediate padding
 304 .ft P
 305 .fi
 306 .UNINDENT
 307 .UNINDENT
 308 .UNINDENT
 309 .INDENT 0.0
 310 .TP
 311 .B \-class\-recurse\-depth=<uint>
 312 When dumping class definitions, stop after recursing the specified number of times.  The
 313 default is 0, which is no limit.
 314 .UNINDENT
 315 .INDENT 0.0
 316 .TP
 317 .B \-classes
 318 Display classes
 319 .UNINDENT
 320 .INDENT 0.0
 321 .TP
 322 .B \-compilands
 323 Display compilands (e.g. object files)
 324 .UNINDENT
 325 .INDENT 0.0
 326 .TP
 327 .B \-enums
 328 Display enums
 329 .UNINDENT
 330 .INDENT 0.0
 331 .TP
 332 .B \-externals
 333 Dump external (e.g. exported) symbols
 334 .UNINDENT
 335 .INDENT 0.0
 336 .TP
 337 .B \-globals
 338 Dump global symbols
 339 .UNINDENT
 340 .INDENT 0.0
 341 .TP
 342 .B \-lines
 343 Dump the mappings between source lines and code addresses.
 344 .UNINDENT
 345 .INDENT 0.0
 346 .TP
 347 .B \-module\-syms
 348 Display symbols (variables, functions, etc) for each compiland
 349 .UNINDENT
 350 .INDENT 0.0
 351 .TP
 352 .B \-sym\-types=<types>
 353 Type of symbols to dump when \-globals, \-externals, or \-module\-syms is
 354 specified. (default all)
 355 .INDENT 7.0
 356 .INDENT 3.5
 357 .sp
 358 .nf
 359 .ft C
 360 =thunks \- Display thunk symbols
 361 =data   \- Display data symbols
 362 =funcs  \- Display function symbols
 363 =all    \- Display all symbols (default)
 364 .ft P
 365 .fi
 366 .UNINDENT
 367 .UNINDENT
 368 .UNINDENT
 369 .INDENT 0.0
 370 .TP
 371 .B \-symbol\-order=<order>
 372 For symbols dumped via the \-module\-syms, \-globals, or \-externals options, sort
 373 the results in specified order.
 374 .INDENT 7.0
 375 .INDENT 3.5
 376 .sp
 377 .nf
 378 .ft C
 379 =none \- Undefined / no particular sort order
 380 =name \- Sort symbols by name
 381 =size \- Sort symbols by size
 382 .ft P
 383 .fi
 384 .UNINDENT
 385 .UNINDENT
 386 .UNINDENT
 387 .INDENT 0.0
 388 .TP
 389 .B \-typedefs
 390 Display typedef types
 391 .UNINDENT
 392 .INDENT 0.0
 393 .TP
 394 .B \-types
 395 Display all types (implies \-classes, \-enums, \-typedefs)
 396 .UNINDENT
 397 .SS Other Options
 398 .INDENT 0.0
 399 .TP
 400 .B \-color\-output
 401 Force color output on or off.  By default, color if used if outputting to a
 402 terminal.
 403 .UNINDENT
 404 .INDENT 0.0
 405 .TP
 406 .B \-load\-address=<uint>
 407 When displaying relative virtual addresses, assume the process is loaded at the
 408 given address and display what would be the absolute address.
 409 .UNINDENT
 410 .SS dump
 411 .sp
 412 USAGE: \fBllvm\-pdbutil\fP dump [\fIoptions\fP] <input PDB file>
 413 .SS Summary
 414 .sp
 415 The \fBdump\fP subcommand displays low level information about the structure of a
 416 PDB file.  It is used heavily by LLVM\(aqs testing infrastructure, but can also be
 417 used for PDB forensics.  It serves a role similar to that of Microsoft\(aqs
 418 \fIcvdump\fP tool.
 419 .sp
 420 \fBNOTE:\fP
 421 .INDENT 0.0
 422 .INDENT 3.5
 423 The \fBdump\fP subcommand exposes internal details of the file format.  As
 424 such, the reader should be familiar with /PDB/index before using this
 425 command.
 426 .UNINDENT
 427 .UNINDENT
 428 .SS Options
 429 .SS MSF Container Options
 430 .INDENT 0.0
 431 .TP
 432 .B \-streams
 433 dump a summary of all of the streams in the PDB file.
 434 .UNINDENT
 435 .INDENT 0.0
 436 .TP
 437 .B \-stream\-blocks
 438 In conjunction with \fI\%\-streams\fP, add information to the output about
 439 what blocks the specified stream occupies.
 440 .UNINDENT
 441 .INDENT 0.0
 442 .TP
 443 .B \-summary
 444 Dump MSF and PDB header information.
 445 .UNINDENT
 446 .SS Module & File Options
 447 .INDENT 0.0
 448 .TP
 449 .B \-modi=<uint>
 450 For all options that dump information from each module/compiland, limit to
 451 the specified module.
 452 .UNINDENT
 453 .INDENT 0.0
 454 .TP
 455 .B \-files
 456 Dump the source files that contribute to each displayed module.
 457 .UNINDENT
 458 .INDENT 0.0
 459 .TP
 460 .B \-il
 461 Dump inlinee line information (DEBUG_S_INLINEELINES CodeView subsection)
 462 .UNINDENT
 463 .INDENT 0.0
 464 .TP
 465 .B \-l
 466 Dump line information (DEBUG_S_LINES CodeView subsection)
 467 .UNINDENT
 468 .INDENT 0.0
 469 .TP
 470 .B \-modules
 471 Dump compiland information
 472 .UNINDENT
 473 .INDENT 0.0
 474 .TP
 475 .B \-xme
 476 Dump cross module exports (DEBUG_S_CROSSSCOPEEXPORTS CodeView subsection)
 477 .UNINDENT
 478 .INDENT 0.0
 479 .TP
 480 .B \-xmi
 481 Dump cross module imports (DEBUG_S_CROSSSCOPEIMPORTS CodeView subsection)
 482 .UNINDENT
 483 .SS Symbol Options
 484 .INDENT 0.0
 485 .TP
 486 .B \-globals
 487 dump global symbol records
 488 .UNINDENT
 489 .INDENT 0.0
 490 .TP
 491 .B \-global\-extras
 492 dump additional information about the globals, such as hash buckets and hash
 493 values.
 494 .UNINDENT
 495 .INDENT 0.0
 496 .TP
 497 .B \-publics
 498 dump public symbol records
 499 .UNINDENT
 500 .INDENT 0.0
 501 .TP
 502 .B \-public\-extras
 503 dump additional information about the publics, such as hash buckets and hash
 504 values.
 505 .UNINDENT
 506 .INDENT 0.0
 507 .TP
 508 .B \-symbols
 509 dump symbols (functions, variables, etc) for each module dumped.
 510 .UNINDENT
 511 .INDENT 0.0
 512 .TP
 513 .B \-sym\-data
 514 For each symbol record dumped as a result of the \fI\%\-symbols\fP option,
 515 display the full bytes of the record in binary as well.
 516 .UNINDENT
 517 .SS Type Record Options
 518 .INDENT 0.0
 519 .TP
 520 .B \-types
 521 Dump CodeView type records from TPI stream
 522 .UNINDENT
 523 .INDENT 0.0
 524 .TP
 525 .B \-type\-extras
 526 Dump additional information from the TPI stream, such as hashes and the type
 527 index offsets array.
 528 .UNINDENT
 529 .INDENT 0.0
 530 .TP
 531 .B \-type\-data
 532 For each type record dumped, display the full bytes of the record in binary as
 533 well.
 534 .UNINDENT
 535 .INDENT 0.0
 536 .TP
 537 .B \-type\-index=<uint>
 538 Only dump types with the specified type index.
 539 .UNINDENT
 540 .INDENT 0.0
 541 .TP
 542 .B \-ids
 543 Dump CodeView type records from IPI stream.
 544 .UNINDENT
 545 .INDENT 0.0
 546 .TP
 547 .B \-id\-extras
 548 Dump additional information from the IPI stream, such as hashes and the type
 549 index offsets array.
 550 .UNINDENT
 551 .INDENT 0.0
 552 .TP
 553 .B \-id\-data
 554 For each ID record dumped, display the full bytes of the record in binary as
 555 well.
 556 .UNINDENT
 557 .INDENT 0.0
 558 .TP
 559 .B \-id\-index=<uint>
 560 only dump ID records with the specified hexadecimal type index.
 561 .UNINDENT
 562 .INDENT 0.0
 563 .TP
 564 .B \-dependents
 565 When used in conjunction with \fI\%\-type\-index\fP or \fI\%\-id\-index\fP,
 566 dumps the entire dependency graph for the specified index instead of just the
 567 single record with the specified index.  For example, if type index 0x4000 is
 568 a function whose return type has index 0x3000, and you specify
 569 \fI\-dependents=0x4000\fP, then this would dump both records (as well as any other
 570 dependents in the tree).
 571 .UNINDENT
 572 .SS Miscellaneous Options
 573 .INDENT 0.0
 574 .TP
 575 .B \-all
 576 Implies most other options.
 577 .UNINDENT
 578 .INDENT 0.0
 579 .TP
 580 .B \-section\-contribs
 581 Dump section contributions.
 582 .UNINDENT
 583 .INDENT 0.0
 584 .TP
 585 .B \-section\-headers
 586 Dump image section headers.
 587 .UNINDENT
 588 .INDENT 0.0
 589 .TP
 590 .B \-section\-map
 591 Dump section map.
 592 .UNINDENT
 593 .INDENT 0.0
 594 .TP
 595 .B \-string\-table
 596 Dump PDB string table.
 597 .UNINDENT
 598 .SS bytes
 599 .sp
 600 USAGE: \fBllvm\-pdbutil\fP bytes [\fIoptions\fP] <input PDB file>
 601 .SS Summary
 602 .sp
 603 Like the \fBdump\fP subcommand, the \fBbytes\fP subcommand displays low level
 604 information about the structure of a PDB file, but it is used for even deeper
 605 forensics.  The \fBbytes\fP subcommand finds various structures in a PDB file
 606 based on the command line options specified, and dumps them in hex.  Someone
 607 working on support for emitting PDBs would use this heavily, for example, to
 608 compare one PDB against another PDB to ensure byte\-for\-byte compatibility.  It
 609 is not enough to simply compare the bytes of an entire file, or an entire stream
 610 because it\(aqs perfectly fine for the same structure to exist at different
 611 locations in two different PDBs, and "finding" the structure is half the battle.
 612 .SS Options
 613 .SS MSF File Options
 614 .INDENT 0.0
 615 .TP
 616 .B \-block\-range=<start[\-end]>
 617 Dump binary data from specified range of MSF file blocks.
 618 .UNINDENT
 619 .INDENT 0.0
 620 .TP
 621 .B \-byte\-range=<start[\-end]>
 622 Dump binary data from specified range of bytes in the file.
 623 .UNINDENT
 624 .INDENT 0.0
 625 .TP
 626 .B \-fpm
 627 Dump the MSF free page map.
 628 .UNINDENT
 629 .INDENT 0.0
 630 .TP
 631 .B \-stream\-data=<string>
 632 Dump binary data from the specified streams.  Format is SN[:Start][@Size].
 633 For example, \fI\-stream\-data=7:3@12\fP dumps 12 bytes from stream 7, starting
 634 at offset 3 in the stream.
 635 .UNINDENT
 636 .SS PDB Stream Options
 637 .INDENT 0.0
 638 .TP
 639 .B \-name\-map
 640 Dump bytes of PDB Name Map
 641 .UNINDENT
 642 .SS DBI Stream Options
 643 .INDENT 0.0
 644 .TP
 645 .B \-ec
 646 Dump the edit and continue map substream of the DBI stream.
 647 .UNINDENT
 648 .INDENT 0.0
 649 .TP
 650 .B \-files
 651 Dump the file info substream of the DBI stream.
 652 .UNINDENT
 653 .INDENT 0.0
 654 .TP
 655 .B \-modi
 656 Dump the modi substream of the DBI stream.
 657 .UNINDENT
 658 .INDENT 0.0
 659 .TP
 660 .B \-sc
 661 Dump section contributions substream of the DBI stream.
 662 .UNINDENT
 663 .INDENT 0.0
 664 .TP
 665 .B \-sm
 666 Dump the section map from the DBI stream.
 667 .UNINDENT
 668 .INDENT 0.0
 669 .TP
 670 .B \-type\-server
 671 Dump the type server map from the DBI stream.
 672 .UNINDENT
 673 .SS Module Options
 674 .INDENT 0.0
 675 .TP
 676 .B \-mod=<uint>
 677 Limit all options in this category to the specified module index.  By default,
 678 options in this category will dump bytes from all modules.
 679 .UNINDENT
 680 .INDENT 0.0
 681 .TP
 682 .B \-chunks
 683 Dump the bytes of each module\(aqs C13 debug subsection.
 684 .UNINDENT
 685 .INDENT 0.0
 686 .TP
 687 .B \-split\-chunks
 688 When specified with \fI\%\-chunks\fP, split the C13 debug subsection into a
 689 separate chunk for each subsection type, and dump them separately.
 690 .UNINDENT
 691 .INDENT 0.0
 692 .TP
 693 .B \-syms
 694 Dump the symbol record substream from each module.
 695 .UNINDENT
 696 .SS Type Record Options
 697 .INDENT 0.0
 698 .TP
 699 .B \-id=<uint>
 700 Dump the record from the IPI stream with the given type index.
 701 .UNINDENT
 702 .INDENT 0.0
 703 .TP
 704 .B \-type=<uint>
 705 Dump the record from the TPI stream with the given type index.
 706 .UNINDENT
 707 .SS pdb2yaml
 708 .sp
 709 USAGE: \fBllvm\-pdbutil\fP pdb2yaml [\fIoptions\fP] <input PDB file>
 710 .SS Summary
 711 .SS Options
 712 .SS yaml2pdb
 713 .sp
 714 USAGE: \fBllvm\-pdbutil\fP yaml2pdb [\fIoptions\fP] <input YAML file>
 715 .SS Summary
 716 .sp
 717 Generate a PDB file from a YAML description.  The YAML syntax is not described
 718 here.  Instead, use \fI\%llvm\-pdbutil pdb2yaml\fP and
 719 examine the output for an example starting point.
 720 .SS Options
 721 .INDENT 0.0
 722 .TP
 723 .B \-pdb=<file\-name>
 724 .UNINDENT
 725 .sp
 726 Write the resulting PDB to the specified file.
 727 .SS merge
 728 .sp
 729 USAGE: \fBllvm\-pdbutil\fP merge [\fIoptions\fP] <input PDB file 1> <input PDB file 2>
 730 .SS Summary
 731 .sp
 732 Merge two PDB files into a single file.
 733 .SS Options
 734 .INDENT 0.0
 735 .TP
 736 .B \-pdb=<file\-name>
 737 .UNINDENT
 738 .sp
 739 Write the resulting PDB to the specified file.
 740 .SH AUTHOR
 741 Maintained by The LLVM Team (http://llvm.org/).
 742 .SH COPYRIGHT
 743 2003-2018, LLVM Project
 744 .\" Generated by docutils manpage writer.
 745 .