Options de ligne de commande

Les options de ligne de commande sont utilisées servent à spécifier des options de démarrage des applications Mozilla. Par exemple, vous pouvez utilisez une option pour outrepasser le gestionnaire de profils et ouvrir un profil spécifique (si vous en avez plusieurs). Vous pouvez aussi contrôler la façon dont les applications Mozilla s'ouvrent, quels composants sont lancés au démarrage et ce qu'ils font à leur ouverture. Cette page décrit les options les plus courantes et comment les utiliser. Vous pouvez ouvrir l'interface de ligne de commande en appuyant sur Maj + F2

Règles de syntaxe

Commençons par décrire les règles syntaxiques applicables à toutes les options.

  • les paramètres d'option contenant des espaces doivent être encadrés par des guillemets anglais, par exemple : "Utilisateur Lambda" ;
  • les options ne sont pas sensibles à la casse ;
  • les paramètres d'option, exceptés les noms de profils, ne sont pas sensibles à la casse ;
  • les options et leurs paramètres sont séparés par des espaces ;
  • le paramètre de l'option compos est constitué d'options de message, qui suivent la syntaxe champ=valeur, par exemple :
    • to=foo@nowhere.net
    • subject=cool page
    • attachment=www.mozilla.org
    • attachment='file:///c:/test.txt'
    • body=check this page
  • les options de message sont séparées par des virgules (,), par exemple : "to=foo@nowhere.net,subject=cool page". Les virgules de séparation ne doivent pas être suivies ni précédées d'espaces. Pour assigner plusieurs valeurs à un champ, encadrez les valeurs par des apostrophes droites ('), par exemple : "to='foo@nowhere.net,foo@foo.de',subject=cool page" .

Utilisation des options de ligne de commande

Les options sont entrées après la commande servant à lancer l'application. Si les options contiennent des arguments, saisir le paramètre après l'option. Certaines options peuvent être abrégées. Par exemple, l'option « -editor » peut être abrégée en « -edit ». Quand une abréviation est disponible, elle est décrite ci-dessous avec l'option. De même pour le cas des paramètres qui dans certains cas doivent être encadrés par des guillemets droits anglais ("). Plusieurs options de ligne de commande peuvent être spécifiées. En général, la syntaxe est comme suit :

application -option -option "paramètre" -option paramètre

Exemples

Les exemples qui suivent montrent l'usage de l'option « -ProfileManager », qui ouvre le gestionnaire de profils avant de démarrer Firefox ou Thunderbird :

Windows

Sélectionner « Exécuter » depuis le « Menu démarrer ». Puis taper :

firefox -ProfileManager

Mac OS X

Aller à « Applications > Utilitaires > Ouvrir un terminal » et taper :

cd /Applications/Firefox.app/Contents/MacOS
./firefox -ProfileManager

Linux

Ouvrir un terminal (invite de commandes) et taper :

cd Thunderbird installation directory
./thunderbird -ProfileManager

L'exemple ci-dessus appelle l'option « -ProfileManager » pour Mozilla Thunderbird.

Profil utilisateur

-allow-downgrade

La protection contre la rétrogradation de Firefox 67 empêche de démarrer accidentellement Firefox avec un profil ayant été exécuté dans une version plus récente de Firefox. Selon les changements entre les deux versions, certains fichiers figurant dans un profil peuvent ne pas être rétrocompatibles. Ajouter cette option outrepasse la protection contre la rétrogradation .

-CreateProfile nom_du_profil

Crée un nouveau profil dans le dossier par défaut sans démarrer l'application. Le profil s'appellera  nom_du_profil dans le gestionnaire de profils. nom_du_profil ne doit pas contenir d'espaces ( ). Pour utiliser cette option correctement, aucune instance de l'application ne doit être en cours d'exécution ou alors l'option -no-remote doit être utilisée.

firefox -CreateProfile UtilisateurJoel

-CreateProfile "nom_du_profil nom_du_dossier"

Crée un nouveau profil dans le dossier nom_du_dossier sans démarrer l'application. Le profil s'appellera  nom_du_profil dans le gestionnaire de profils. Attention : nom_du_profil et nom_du_dossier sont encadrés ensemble par des guillemets droits anglais et sont séparés par une seule espace (comme précédemment, nom_du_profil ne doit pas contenir d'espaces). Pour utiliser cette option correctement, l'application ne doit pas être en cours d'exécution ou alors l'option -no-remote doit être utilisée.

Note : nom_du_dossier doit exister et il ne doit pas déjà exister de profil appelé nom_du_profil.

firefox -CreateProfile " UtilisateurJoel c:\internet\utilisateurjoel-moz-profil"

-migration

Démarre avec l'assistant d'importation.

-new-instance

Ouvre une nouvelle instance et pas une nouvelle fenêtre dans l'instance en cours d'exécution, ce qui permet que plusieurs copies de l'application soient ouvertes en même temps.

firefox -no-remote -P "un autre profil"

Note: non disponible pour Windows, voir bug 855899.

-no-remote

N'accepte pas ni n'envoie de commandes distantes. Implique -new-instance.

firefox -no-remote -P "un autre profil"

Note : Depuis Firefox 9, cela signifie réellement ce que son nom implique pour toutes les plateformes, c.-à-d. que les instances créées avec cette option n'acceptent pas et n'envoient pas de commandes distantes, voir bug 650078. Cela signifie que de telles instances ne sont pas réutilisables. Utiliser cette option crée systématiquement de nouvelles instances.

-override /chemin/vers/override.ini

Charge le fichier override.ini spécifié pour outrepasser application.ini (browser/app/application.ini). Cette option peut être utilisée pour faire disparaître le gestionnaire de migration au démarrage en chargeant l’override.ini qui suit. Uniquement pour Firefox.

[XRE]
EnableProfileMigrator=0

-ProfileManager

Lance le gestionnaire de profils. Abréviation : -P sans nom de profil.

-P "nom_du_profil"

Outrepasse le gestionnaire de profils et lance l'application avec le compte nom_du_profil. Ceci est utile pour gérer plusieurs profils. Attention : la chaîne nom_du_profil est sensible à la casse. Si vous ne précisez pas de nom de profil, le gestionnaire de profils sera lancé. Vous devez utiliser un P majuscule sous Linux avec les versions antérieures à la 7.x, vu que l'option p (minuscule) sert à lancer le mode Purify (test des fuites et de la mémoire). Les autres plateformes acceptent aussi bien la minuscule que la majuscule.

firefox -P "Utilisateur Joel"

-profile "chemin_du_profil"

Démarre avec le profil fourni depuis le chemin spécifié. Seulement pour Firefox, Thunderbird et SeaMonkey 2.x.

"chemin_du_profil" peut aussi bien être un chemin absolu ("/chemin/du/profil")  que relatif ("/chemin/du/profil").

Note : sur Mac OS X, utiliser un chemin relatif n'est plus pris en charge depuis Firefox 4.0 à cause d'une régression, voir bug 673955.

Navigateur

-browser

Démarre le navigateur. Seulement pour Firefox et SeaMonkey.

-url URL

Ouvre l'URL dans un nouvel onglet ou une nouvelle fenêtre, dépendant de l'absence ou de la présence de l'option browser. -url peut être omis. Vous pouvez charger plusieurs URL, separées par des espaces. Pour Firefox et SeaMonkey seulement.

Note: Quand vous ouvrez plusieurs URL, Firefox les ouvre dans des onglets d'une seule nouvelle fenêtre.
firefox www.mozilla.com
firefox www.mozilla.com developer.mozilla.org

-private

Ouvre Firefox en « fenêtre privée » de manière permanente. Pour Firefox 3.6 et ultérieur.

Pourrait ne pas fonctionner pour Firefox 20 et précédents sous Ubuntu. Fonctionnement correct confirmé sous Ubuntu 14.04.

-private-window

Ouvre Firefox en « fenêtre privée » dans une instance déja en cours. Pour Firefox 20 et ultérieur.

-private-window URL

Ouvre l'URL dans une nouvelle « fenêtre privée ». Si une fenêtre privée est déja ouverte, ouvre un nouvel onglet. Firefox 29 et ultérieur seulement. Non fonctionnel pour Firefox 31 sous Linux Mint 17 (qui ouvre l'URL dans une fenêtre normale).

-new-tab URL

Ouvre l'URL dans un nouvel onglet. Firefox et SeaMonkey2.x seulement.

-new-window URL

Ouvre l'URL dans une nouvelle fenêtre. Firefox et SeaMonkey2.x seulement.

-search Mot

Recherche Mot avec le moteur de recherche par défaut. Firefox et SeaMonkey 2.1 et ultérieur.

-preferences

Ouvre la fenêtre des Préférences/Options. Firefox et SeaMonkey2.x seulement.

-setDefaultBrowser

Définit l'application comme navigateur par défaut. Firefox seulement.

-foreground

Fait de l'instance l'application active.

Courriel/Nouvelles

-mail

Démarre le client courriel. Thunderbird et SeaMonkey seulement.

-news news_URL

Démarre le client de nouvelles. Si news_URL (optionnel) est spécifié, ouvre le groupe de nouvelles spécifié. Thunderbird et SeaMonkey seulement.

thunderbird -news news://server/group

-compose options_du_message

Démarre l'outil de création de courriel. Voyez les régles de syntaxe. Thunderbird et SeaMonkey seulement.

thunderbird -compose "to=foo@nowhere.net"

-addressbook

Démarre le carnet d'adresses. Thunderbird et SeaMonkey seulement.

-options

Ouvre la fenêtre des Préférences. Thunderbird seulement.

-offline

Démarre le logiciel en mode déconnecté. Thunderbird et SeaMonkey seulement.

-setDefaultMail

Définit l'application comme client courriel par défaut. Thunderbird seulement.

Calendrier

-calendar

Démarre le client d'agenda. Sunbird seulement.

-subscribe URL or -url URL

S'abonne à l'URL. Sunbird seulement.

-showdate date

Affiche la date dans l'agenda. Sunbird seulement.

sunbird -showdate 08/04/2008

Autres composants

-editor URL or -edit URL

Démarre avec l'éditeur (compositeur) pour l'URL spécifiée (URL est optionnel). SeaMonkey seulement.

seamonkey -edit www.mozilla.org

-jsdebugger

Démarre l'application avec Browser Toolbox (auparavant Browser Debugger). Ce débogueur est différent du Venkman (voyez l'option -venkman).

-jsconsole

Démarre l'application avec la console d'erreur, ou, dans le cas de Firefox, la console du navigateur.

-start-debugger-server port

Firefox seulement. Démarre le serveur du débogueur avec le port. Ceci permet à une autre instance de Firefox de connecter ses outils de développement à l'instance visée. Voyez l'article sur le débogage à distance du bureau Firefox.

Le paramètre port est optionnel ; par défaut, le port 6000 est utilisé.

-inspector URL

Démarre l'inspecteur de DOM (s'il est installé) et inspecte l'URL spécifiée (URL est optionnel).

-venkman

Démarre le débogueur JavaScript, Venkman, s'il est installé.

-purgecaches

Vide le cache JavaScript de Gecko (le moteur de mise en page). Normalement le cache survit au redémarrage.

-chat

Démarre le client de clavardage IRC, ChatZilla, s'il est installé.

XULRunner

-app /chemin/vers/application.ini

Démarre un nouveau processus XULRunner pour l'application se trouvant à chemin/vers. Fonctionne aussi pour Firefox version 3 et ultérieur.

--register-global

Inscrit XULRunner avec le système pour tous les usagers. Exige les privilèges admin / root.

--register-user

Inscrit XULRunner pour l'utilisateur en cours.

--unregister-user

Désinscrit XULRunner pour tous les utilisateurs.

--unregister-user

Désinscrit XULRunner pour l'utilisateur en cours.

--install-app chemin/vers/myapplication.(xpi|xulapp)

Installe l'application XULRunner se trouvant à chemin/vers sur le système. Les applications sont installées à l'emplacement par défaut du système (program files|Applications|usr/lib) sous nom_du_vendeur/nom_de_l_application. Les applications peuvent être désinstallées par les méthodes habituelles du système.

"C:\Program Files\Mozilla XULRunner\1.8.0.4\xulrunner\xulrunner.exe" --install-app "C:\Users\Billdo\Desktop\myapplication.xpi"
/opt/xulrunner/1.8.0.4/xulrunner/xulrunner --install-app ~/Desktop/myapplication.xulapp
/Library/Frameworks/XUL.framework/xulrunner-bin --install-app ~/Desktop/myapplication.xpi

Chrome

-chrome chrome_URL

Charge le chrome spécifié.

firefox -chrome chrome://inspector/content

-register chrome_URL

Inscrit le chrome spécifié, sans démarrer l'application.

Modules complémentaires

Gecko 1.9.2 note
-install-global-extension et -install-global-theme ont été retirés de Gecko 1.9.2 et ultérieur.

-install-global-extension /chemin/vers/extension

Installe l'extension spécifiée dans le dossier d l'application. Le paramètre donne le chemin menant au module. Vous devez disposer des privilèges administrateur.

-install-global-theme /chemin/vers/theme

Installe le thème spécifié. Vous devez disposer des privilèges administratifs.

Note : Depuis Firefox 2.0.0.7, les options -install-global-extension et -install-global-theme ne peuvent installer que depuis le stockage local (incluant le stockage réseau monté localement). L'installation directe depuis un stockage réseau échouera.

-safe-mode

Démarre l'application avec toutes les extensions désactivées, cette fois-ci seulement (les extensions ne sont pas chargées, mais ne sont pas non plus désactivées de façon permanente par le gestionnaire de modules complémentaires).

Locale

-UILocale locale

Démarre avec l'interface régionalisée en locale.

firefox -UILocale en-US

Contrôle à distance

-remote remote_command

Note : Cette option a été retirée de Firefox 36.0, puis restaurée avec 36.0.1 pour être retirée définitivement avec 39.0. Voyez bug 1080319.

Exécute la remote_command spécifiée dans un processus déja actif (voyez contrôle à distance).

firefox -remote "openURL(www.mozilla.org, new-tab)"

Note : Cette option n'est disponible que pour les plateformes X-windows Unix.

Divers

-tray

Démarre l'application minimisée dans la zone de notification du système. Utile avec le démarrage automatique.

-silent

N'ouvre pas les fenêtres par défaut. Utile pour les options qui ouvrent leurs propres fenêtres sans empêcher les fenêtres par défaut de s'ouvrir. Firefox, Thunderbird3.x et SeaMonkey2.x seulement.

-console

Démarre l'application avec la console de déboguage. Note : Windows seulement.

-attach-console

Détourne les messages destinés à la console de débogage vers la fenêtre qui a lancé l'application. Note : Windows seulement.

-h or -help or -?

Affiche la liste des options et paramètres disponibles. Sous Windows, cette option ne fonctionne qu'avec une redirection |more (bug 355889). Cette option n'est disponible qu'en ligne de commande.

-v or -version

Affiche la version de l'application. Sous Windows, cette option ne fonctionne qu'avec une redirection |more (bug 355889). Cette option n'est disponible qu'en ligne de commande.

-osint

Indique à l'application qu'elle est lancée par l'invite de commande du système. Cette option ne doit être spécifiée que si l'application invocatrice prend en charge toutes les fonctionnalités de l'invite de commande du système (bug 384384).

-requestPending

Indique à l'application qu'il y aura une requête DDE (Dynamic Data Exchange, Windows seulement) pour l'ouverture du même URL que celui spécifié par la ligne de commande. Cette option ne doit être spécifiée que si l'application invocatrice prend en charge toutes les fonctionnalités de l'invite de commande du système (bug 354005).

options X11

Ces options ne sont disponibles que pour une application roulant sous le système graphique X11 / X.org (Linux et autres systèmes Unix).

--display=DISPLAY

Définit l'affichage X à utiliser.

--class=WM_CLASS

Définit WM_CLASS comme étant la classe de ressource X11 des fenêtres créées par l'application.

--sync

Rend les appels X synchrones.

--g-fatal-warnings

Rend tous les avertissements fatals.

Autre options restant à documenter

  • -print-xpcom-dir
  • -print-xpcom-dirlist
  • -kill
  • -killAll
  • -f
  • -ftimeout
  • -fwait
  • -unsetDefaultMail
  • options GTK

Références

Information sur le document d'origine

  • Auteurs : Ben Goodger, Steffen Wilberg, Seth Spitzer, Daniel Wang
  • Information sur le droit d'auteur : des parties de ce contenu sont © 1998–2007 par des contributeurs individuels de mozilla.org ; contenu disponible sous licence Creative Commons | Détails.
  • Traduction : Gautier Castelain, Daniel U. Thibault

<tmpopup style="top: 2357px; left: 116.283px;"><tmpopupcolor id="tmpopupcolor--2" style="background: rgb(255, 204, 0) none repeat scroll 0% 0%;"></tmpopupcolor><tmpopupcolor id="tmpopupcolor--3" style="background: rgb(0, 255, 102) none repeat scroll 0% 0%;"></tmpopupcolor><tmpopupcolor id="tmpopupcolor--m" style="background: rgb(255, 238, 0) none repeat scroll 0% 0%;"></tmpopupcolor></tmpopup><tmpopup style="top: 2357px; left: 116.283px;"><tmpopupcolor id="tmpopupcolor--2" style="background: rgb(255, 204, 0) none repeat scroll 0% 0%;"></tmpopupcolor><tmpopupcolor id="tmpopupcolor--3" style="background: rgb(0, 255, 102) none repeat scroll 0% 0%;"></tmpopupcolor><tmpopupcolor id="tmpopupcolor--m" style="background: rgb(255, 238, 0) none repeat scroll 0% 0%;"></tmpopupcolor></tmpopup>


<tmpopup style="top: 3818px; left: 297.9px;"><tmpopupcolor id="tmpopupcolor--2" style="background: rgb(255, 204, 0) none repeat scroll 0% 0%;"></tmpopupcolor><tmpopupcolor id="tmpopupcolor--3" style="background: rgb(0, 255, 102) none repeat scroll 0% 0%;"></tmpopupcolor><tmpopupcolor id="tmpopupcolor--m" style="background: rgb(255, 238, 0) none repeat scroll 0% 0%;"></tmpopupcolor></tmpopup><tmpopup style="top: 3818px; left: 297.9px;"><tmpopupcolor id="tmpopupcolor--2" style="background: rgb(255, 204, 0) none repeat scroll 0% 0%;"></tmpopupcolor><tmpopupcolor id="tmpopupcolor--3" style="background: rgb(0, 255, 102) none repeat scroll 0% 0%;"></tmpopupcolor><tmpopupcolor id="tmpopupcolor--m" style="background: rgb(255, 238, 0) none repeat scroll 0% 0%;"></tmpopupcolor></tmpopup><tmpopup style="top: 4751px; left: 480.9px;"><tmpopupcolor id="tmpopupcolor--2" style="background: rgb(255, 204, 0) none repeat scroll 0% 0%;"></tmpopupcolor><tmpopupcolor id="tmpopupcolor--3" style="background: rgb(0, 255, 102) none repeat scroll 0% 0%;"></tmpopupcolor><tmpopupcolor id="tmpopupcolor--m" style="background: rgb(255, 238, 0) none repeat scroll 0% 0%;"></tmpopupcolor></tmpopup><tmpopup style="top: 4751px; left: 480.9px;"><tmpopupcolor id="tmpopupcolor--2" style="background: rgb(255, 204, 0) none repeat scroll 0% 0%;"></tmpopupcolor><tmpopupcolor id="tmpopupcolor--3" style="background: rgb(0, 255, 102) none repeat scroll 0% 0%;"></tmpopupcolor><tmpopupcolor id="tmpopupcolor--m" style="background: rgb(255, 238, 0) none repeat scroll 0% 0%;"></tmpopupcolor></tmpopup>