Documentation forKiwi Log Viewer

Command line arguments

Kiwi Log Viewer can be controlled from the command line using the following command:

KiwiLogViewer [-option ["Option Value"]]

Where -option can be:

Option Option Value Description
-t   Enable file tailing mode (no filters applied). No parameters required.
-th   Enable filtered file tailing in Memory Mode showing only the rows that match the highlights. No parameters required.
-tf RegExp InvertMatch IgnoreCase "String to match"

Enable filtered file tailing in Memory Mode showing only the rows that match the specified string. All 4 parameters are required.

  • RegExp can be 0 or 1
  • InvertMatch can be 0 or 1
  • IgnoreCase can be 0 or 1
  • String to match must be specified in double quotes.

For example:

  • -tf 0 0 1 "some text to match"
  • -tf 1 0 0 "some regular expression"
  • -tf 0 1 1 "all rows NOT matching this text"
-f "Path\File name" Open specified file. If the path or file name contains spaces, you will need to enclose the entire path and file name with quotes.
-d decimal number between 0 and 255

Specifies an alternate column delimiter character value. Normally, Kiwi Log Viewer splits each row of data into columns based on the tab delimiter (ASCII character 9). If your file uses something different to delimit each column, you can specify the ASCII character value to look for with the -d argument.

  • If your columns are delimited by pipe (|) characters, use -d 124
  • If your columns are delimited by null characters, use -d 0
  • If your columns are delimited by colon characters, use -d 58
-h "Name of highlight" Load and use the specified favorite highlight items. The list of highlight favorite names can be found on the Highlights setup page (Options | Highlighting menu).
-p 1 to 6

Specifies the screen position and sizing.

  • 1=Top third of the screen
  • 2=Middle third of the screen
  • 3=Bottom third of the screen
  • 4=Top half of the screen
  • 5=Bottom half of the screen
  • 6=Fit to screen size (full screen)

Examples

To start the program normally:

KiwiLogViewer

Open a file, go into full screen mode and use the "PIX VPN logins" highlights favorite:

KiwiLogViewer -f "C:\Logs\CiscoPixLog.txt" -p 6 -h "PIX VPN logins"

Open a file, use the top third of the screen and use the "404 errors" highlights favorite:

KiwiLogViewer -f "C:\Logs\ApacheWebLog.txt" -p 1 -h "404 errors"

Open a file, use the top half of the screen and tail the file as it is updated:

KiwiLogViewer -f "C:\Logs\ActiveLog" -p 4 -t

Open and tail a file in memory mode while only showing highlighted rows:

KiwiLogViewer -th -f "C:\Logs\ApacheWebLog.txt"

Open and tail a file in memory mode while only showing rows that contain the words "link down":

KiwiLogViewer -tf 0 0 1 "link down" -f "C:\Logs\CiscoRouter.txt"

Open and tail a file in memory mode while only showing rows that match the regular expression:

KiwiLogViewer -tf 1 0 0 "(192\.168\.55\.1).*(10\.10\.67\.89)" -f "C:\Logs\CiscoRouter.txt"

Open a pipe delimited text file:

KiwiLogViewer -f "C:\Logs\PipeDelimitedFile.txt" -d 124