---
name: "fstminer"
section: "1"
platform: "linux"
package: "gtkwave"
version: "3.3.128-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/fstminer"
---

# fstminer(1)

Data mining of FST files

## NAME

fst2miner - Data mining of FST files

## SYNTAX

fstminer \[*option*\]... \[*FSTFILE*\]

## DESCRIPTION

Mines FST files for specific data values and generates gtkwave save files to stdout for future reload.

## OPTIONS

- **-d,--dumpfile** \<*filename*\>

  Specify FST input dumpfile.

- **-m,--match** \<*value*\>

  Specifies "bitwise" match data (binary, real, string)

- **-x,--hex** \<*value*\>

  Specifies hexadecimal match data that will automatically be converted to binary for searches

- **-n,--namesonly**

  Indicates that only facnames should be printed in a gtkwave savefile compatible format.  By doing this, the file can be used to specify which traces are to be imported into gtkwave.

- **-c,--comprehensive**

  Indicates that results are not to stop after the first match.  This can be used to extract all the matching values in the trace.

- **-h,--help**

  Show help screen.

## EXAMPLES

fstminer dumpfile.fst --hex 20470000 -n

- This attempts to match the hex value 20470000 across all facilities and when the value is encountered, the facname only is printed to stdout in order to generate a gtkwave compatible save file.

  ## LIMITATIONS

*fstminer* only prints the first time a value is encountered for a specific net.  This is done in order to  cut down on the size of output files and to aid in following data such as addresses through a simulation model.

## AUTHORS

Anthony Bybell \<bybell@rocketmail.com\>

## SEE ALSO

[*vztminer*(1)](/vztminer/1.md) [*lxt2miner*(1)](/lxt2miner/1.md) [*fst2vcd*(1)](/fst2vcd/1.md) [*vcd2fst*(1)](/vcd2fst/1.md) [*gtkwave*(1)](/gtkwave/1.md)