# Benchmark

This command runs edktool in benchmarking mode. This mode runs multiple concurrent extraction sessions, several times to test the performance of a grammar. The input document is read once and fed into each session. Timing information is produced once all runs are complete.

The following table describes the parameters for this command.

`-l <licensefile>` | The file containing a valid license key for Eduction. If you do not specify a license key, edktool attempts to load the license `licensekey.dat` in its current working directory. You must specify the license parameter if your license is in a different location.
`-i <inputfile>` | The file to perform entity extraction on. The input file must be plaintext.
`-c <configfile>` | A configuration file controlling the extraction. See Eduction Configuration File. You can specify one or more grammar files and one or more entities in place of a configuration file. Specifying a configuration file overrides the grammar or entity parameters.
`-g <grammarfile>` | A grammar file to use. If you have set a configuration file with `-c`, this option is ignored. If you provide a grammar file but do not specify any entities with `-e`, Eduction extracts all entities in the grammar file. NOTE: You can use the `MinScore` parameter only if you use `-c`. This means that, although you can specify a grammar that supports scoring, edktool does not filter out matches based on those scores. You can use wildcard expressions in this parameter. See Wildcard Expressions in edktool.
`-e <entity>` | The entities to extract. Separate multiple entities with a comma. If you have set a configuration file with `-c`, this option is ignored. You can use wildcard expressions in this parameter. See Wildcard Expressions in edktool.
`-d` | (Optional) Return details of the matching strings and their locations in the input file.
`-s <sessions>` | The number of sessions to run concurrently during each iteration of the benchmarking test.
`-n <number>` | The number of iterations of the benchmarking test to run.
`-b` | Set this parameter to read the input file in binary mode, rather than text mode. If you create a grammar file that matches entities with only Windows (CR LF) line endings and you run edktool on Windows, edktool must read the input file in binary mode for it to find any matches. Micro Focus recommends that you create grammar files capable of handling both Windows and Unix line endings.

The benchmarking option runs the specified number of concurrent sessions and iterations and then displays the timing for each run, with a summary showing the total number of observations, maximum and minimum times, and the standard deviation.

© Copyright 2013-2020 Micro Focus or one of its affiliates | Send documentation feedback Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a mail client, and then send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm