view

view
	Command Reference

Name

view — start a report viewer

Synopsis

view [-h, --help] [-version] -i, --in-file FILENAME [--port PORT] [--timeout SECONDS] [--no-browser]

Description

view diplays an existing report. It runs as a web server serving the report as web pages on a port on the local host. By default it also starts a web browser displaying the report.

view will try to start the default web browser on the system. If you want it to use a different browser you can specify it using the BROWSER environment variable.

Options

-h, --help

Print help message.

--version

Print version information.

-i, --in-file FILENAME

Specifies the input report file.

--port PORT

Launch the web server on the specified port instead of selecting an arbitrary free port.

--timeout SECONDS

Terminate the web server when no activity has been seen from the web browser viewing the report for the specified number of seconds. The default is 10 seconds.

Try increasing the timeout if the web server quits unexpectedly while you are viewing the report.

--no-browser

Do not launch a web browser viewing the report, just start the web server serving it.

Exit Status

0: Successful program execution.
>0: An error occured.

Environment

RW_LICENSE_FILE: Environment variable pointing to the license file. Should only be used to override default license locations.

BROWSER: Web browser to use to display the report.

Files

$HOME/.threadspotter/license: Directory containing per-user license files. Freja looks for license files here if no system wide license file can be found.


report		license