.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.1.
.TH EMRUN "1" "February 2022" "emrun 3.1.6~dfsg" "User Commands"
.SH NAME
emrun \- emscripten tool to compile as an HTML page
.SH DESCRIPTION
usage: emrun [emrun_options] filename.html \fB\-\-\fR [html_cmdline_options]
.IP
where emrun_options specifies command line options for emrun itself, whereas
html_cmdline_options specifies startup arguments to the program.
.PP
If you are seeing "unrecognized arguments" when trying to pass
arguments to your page, remember to add `\-\-` between arguments
to emrun itself and arguments to your page.
.SS "positional arguments:"
.IP
serve
cmdlineparams
.SS "optional arguments:"
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-\-kill_start\fR
If true, any previously running instances of the
target browser are killed before starting.
.TP
\fB\-\-kill_exit\fR
If true, the spawned browser process is forcibly
killed when it calls exit(). Note: Using this option
may require explicitly passing the option
\fB\-\-browser=\fR/path/to/browser, to avoid emrun being
detached from the browser process it spawns.
.TP
\fB\-\-no_server\fR
If specified, a HTTP web server is not launched to
host the page to run.
.TP
\fB\-\-no_browser\fR
If specified, emrun will not launch a web browser to
run the page.
.TP
\fB\-\-no_emrun_detect\fR
If specified, skips printing the warning message if
html page is detected to not have been built with
\fB\-\-emrun\fR linker flag.
.TP
\fB\-\-serve_after_close\fR
If true, serves the web page even after the
application quits by user closing the web page.
.TP
\fB\-\-serve_after_exit\fR
If true, serves the web page even after the
application quits by a call to exit().
.TP
\fB\-\-serve_root\fR SERVE_ROOT
If set, specifies the root path that the emrun web
server serves. If not specified, the directory where
the target .html page lives in is served.
.TP
\fB\-\-verbose\fR
Enable verbose logging from emrun internal operation.
.TP
\fB\-\-hostname\fR HOSTNAME
Specifies the hostname the server runs in.
.TP
\fB\-\-port\fR PORT
Specifies the port the server runs in.
.TP
\fB\-\-log_stdout\fR LOG_STDOUT
Specifies a log filename where the browser process
stdout data will be appended to.
.TP
\fB\-\-log_stderr\fR LOG_STDERR
Specifies a log filename where the browser process
stderr data will be appended to.
.TP
\fB\-\-silence_timeout\fR SILENCE_TIMEOUT
If no activity is received in this many seconds, the
browser process is assumed to be hung, and the web
server is shut down and the target browser killed.
Disabled by default.
.TP
\fB\-\-timeout\fR TIMEOUT
If the browser process does not quit or the page
exit() in this many seconds, the browser is assumed to
be hung, and the web server is shut down and the
target browser killed. Disabled by default.
.TP
\fB\-\-timeout_returncode\fR TIMEOUT_RETURNCODE
Sets the exit code that emrun reports back to caller
in the case that a page timeout occurs. Default:
99999.
.TP
\fB\-\-list_browsers\fR
Prints out all detected browser that emrun is able to
use with the \fB\-\-browser\fR command and exits.
.TP
\fB\-\-browser\fR BROWSER
Specifies the browser executable to run the web page
in.
.TP
\fB\-\-browser_args\fR BROWSER_ARGS
Specifies the arguments to the browser executable.
.TP
\fB\-\-android\fR
Launches the page in a browser of an Android device
connected to an USB on the local system. (via adb)
.TP
\fB\-\-system_info\fR
Prints information about the current system at
startup.
.TP
\fB\-\-browser_info\fR
Prints information about the target browser to launch
at startup.
.TP
\fB\-\-json\fR
If specified, \fB\-\-system_info\fR and \fB\-\-browser_info\fR are
outputted in JSON format.
.TP
\fB\-\-safe_firefox_profile\fR
If true, the browser is launched into a new clean
Firefox profile that is suitable for unattended
automated runs. (If target browser != Firefox, this
parameter is ignored)
.TP
\fB\-\-log_html\fR
If set, information lines are printed out an HTMLfriendly format.
.TP
\fB\-\-private_browsing\fR
If specified, opens browser in private/incognito mode.
.TP
\fB\-\-dump_out_directory\fR DUMP_OUT_DIRECTORY
If specified, overrides the directory for dump files
using emrun_file_dump method.