Command Line

Agent Ransack's start up values can be altered through information passed through the command line. If an output file is specified then the actual User Interface is not displayed and the results are streamed directly to the file.

AgentRansack.exe [saved search] | -o [output file] | -of? | -d [folder name] | -c [containing text] | -f [file name] | -cm | -fm | -s | -fd | -fx | -cr | -pa | -po | -ma [datetime] | -mb [datetime] | -h | -?

	-c	Text to search for in specified files (i.e. the Containing Text field)
	-ce?	Contents expr type: -ceb=Boolean, -cex=Regular Expression
	-cm	Match case when contents searching
	-d	Directory(s) to search (i.e. the Look In field), use -dw for current working directory
	-f	File names to search for
	-fe?	File name expr type: -fed=DOS, -fex=Regular Expression
	-fm	Match case when comparing file names
	-fx	File name shows the file names to exclude
	-ma	Modified after date value, pass "now" as the date to use the current date and time
	-mb	Modified before date value, pass "now" as the date to use the current date and time
	-o	Output filename (runs the search without showing the Agent Ransack GUI streaming results directly to the file)
	-oc	Output content lines
	-of?	Output format: -oft = Text (default), -ofc = CSV, -ofb = Tab
	-pa	Always use command line parameters when creating new or opening existing searches
	-pc	Overwrite configuration with configuration stored in saved search criteria file.
	-po	Override values from file when loading from file AND specifying command line parameters
	-r	Start search immediately (implied by -o option)
	-s	Search subfolders

	-h or -?	Show the help dialog

To launch Agent Ransack with the Look In field pre-filled with "C:\Documents and Settings\user\My Documents" the command line arguments would be:

To run a search looking for files that match *.sys in the folder C:\WINDOWS without launching the usual user interface but instead streaming the results directly to an output file the command line arguments would be:

To launch Agent Ransack with Search subfolders switched off and Match case on contents searching switched on the command line arguments would be: