browser/docs/CommandLineParameters.rst

   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``.