1 =======================
2 Command Line Parameters
3 =======================
5 Firefox recognizes many (many!) command line parameters. Overview
6 documentation of these parameters lives here.
18 - On Windows, ``-osint`` serves two purposes. Most importantly, it signals
19 that the command line is untrusted and must be sanitized. Command lines
20 with ``-osint`` are rejected unless they have a very specific structure,
21 usually ``firefox.exe -osint -url URL`` or ``firefox.exe -osint
22 -private-window URL``: refer to `the EnsureCommandLineSafe function
23 <https://searchfox.org/mozilla-central/rev/ead7da2d9c5400bc7034ff3f06a030531bd7e5b9/toolkit/xre/CmdLineAndEnvUtils.h#196>`_.
24 These command lines are produced by apps delegating to Firefox, and the
25 resulting URL may not be correctly quoted. The sanitization process
26 ensures that maliciously chosen URLs do not add additional parameters to
27 Firefox. Secondarily, the ``-osint`` parameter signals that Firefox is
28 being invoked by Windows to handle a URL: generally a registered file
29 type, e.g., ``.html``, or protocol, e.g., ``https``.