CommandLineParameters.rst (1300B)
1 ======================= 2 Command Line Parameters 3 ======================= 4 5 Firefox recognizes many (many!) command line parameters. Overview 6 documentation of these parameters lives here. 7 8 Known parameters 9 ---------------- 10 11 .. list-table:: 12 :widths: 20 80 13 :header-rows: 1 14 15 * - Parameter 16 - Description 17 * - ``-osint`` 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``.