EMRUN(1) User Commands EMRUN(1)
NAME
emrun - emscripten tool to compile as an HTML page
DESCRIPTION
usage: emrun [emrun_options] filename.html -- [html_cmdline_options]
where emrun_options specifies command line options for emrun it-
self, whereas html_cmdline_options specifies startup arguments
to the program.
If you are seeing "unrecognized arguments" when trying to pass argu-
ments to your page, remember to add `--` between arguments to emrun it-
self and arguments to your page.
positional arguments:
serve cmdlineparams
options:
-h, --help
show this help message and exit
--kill_start
If true, any previously running instances of the target browser
are killed before starting.
--kill_exit
If true, the spawned browser process is forcibly killed when it
calls exit(). Note: Using this option may require explicitly
passing the option --browser=/path/to/browser, to avoid emrun
being detached from the browser process it spawns.
--no_server
If specified, a HTTP web server is not launched to host the page
to run.
--no_browser
If specified, emrun will not launch a web browser to run the
page.
--no_emrun_detect
If specified, skips printing the warning message if html page is
detected to not have been built with --emrun linker flag.
--serve_after_close
If true, serves the web page even after the application quits by
user closing the web page.
--serve_after_exit
If true, serves the web page even after the application quits by
a call to exit().
--serve_root 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.
--verbose
Enable verbose logging from emrun internal operation.
--hostname HOSTNAME
Specifies the hostname the server runs in.
--port PORT
Specifies the port the server runs in.
--log_stdout LOG_STDOUT
Specifies a log filename where the browser process stdout data
will be appended to.
--log_stderr LOG_STDERR
Specifies a log filename where the browser process stderr data
will be appended to.
--silence_timeout 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.
--timeout 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.
--timeout_returncode TIMEOUT_RETURNCODE
Sets the exit code that emrun reports back to caller in the case
that a page timeout occurs. Default: 99999.
--list_browsers
Prints out all detected browser that emrun is able to use with
the --browser command and exits.
--browser BROWSER
Specifies the browser executable to run the web page in.
--browser_args BROWSER_ARGS
Specifies the arguments to the browser executable.
--android
Launches the page in a browser of an Android device connected to
an USB on the local system. (via adb)
--system_info
Prints information about the current system at startup.
--browser_info
Prints information about the target browser to launch at
startup.
--json If specified, --system_info and --browser_info are outputted in
JSON format.
--safe_firefox_profile
If true, the browser is launched into a new clean Firefox pro-
file that is suitable for unattended automated runs. (If target
browser != Firefox, this parameter is ignored)
--log_html
If set, information lines are printed out an HTMLfriendly for-
mat.
--private_browsing
If specified, opens browser in private/incognito mode.
--dump_out_directory DUMP_OUT_DIRECTORY
If specified, overrides the directory for dump files using em-
run_file_dump method.
emrun 3.1.6~dfsg July 2022 EMRUN(1)
Generated by dwww version 1.15 on Sat Jun 29 02:07:10 CEST 2024.