Эта статья нуждается в редакционном обзоре. Как вы можете помочь.
Опции командной строки используются для определения различных параметров запуска приложений Mozilla. Например, вы можете использовать опции командной строки, чтобы обойти Менеджер Профилей и открыть определенный профиль (если у вас их несколько). Также вы можете управлять тем, как открыть приложения Mozilla, какие компоненты открыть на начальном этапе, и что делать, когда они открываются. На этой странице описаны часто используемые опции и их применение.
Правила синтаксиса
Сначала давайте опишем синтаксические правила, которые применяются ко всем опциям.
- Параметры команд, содержащие пробелы, должны быть заключены в кавычки, например
"Joel User"
. - Действия команд не зависят от регистра.
- Параметры команд (кроме имени профиля) не зависят от регистра.
- Команды и параметры разделяются пробелами.
- Для полей сообщений используется синтаксис поле=значение, например:
to=
[email protected]
subject=cool page
attachment=www.mozilla.org
attachment='file:///c:/test.txt'
body=проверьте эту страницу
- Несколько полей сообщения разделяются запятой
(,)
, например:"[email protected],subject=классная страница"
. Перед или после разделяющей запятой не должно быть пробелов. Чтобы задать несколько значений для поля, заключите значения в одиночные кавычки(')
, например:"to='[email protected],[email protected]',subject=классная страница"
.
Использование опций командной строки
Опции командной строки указываются после команды для запуска приложения. Некоторые опции имеют аргументы. Они указываются после опции командной строки. Некоторые опции имеют сокращения. Например, опция командной строки "-editor"
может быть указана в сокращённой форме как "-edit"
. (Доступные сокращения описаны в тексте ниже). В некоторых случаях аргументы опций должны быть заключены в кавычки. (Это отмечено в описаниях опций ниже). Могут быть указаны несколько опций командной строки. В общем случае, их синтаксис следующий:
application -option -option "argument" -option argument
Примеры
Следующие примеры иллюстрируют использование опции "-ProfileManager"
, которая открывает Менеджер профилей перед запуском Firefox или Thunderbird:
Windows
Выберите «Выполнить» в меню «Пуск» Windows и введите:
firefox -ProfileManager
Mac OS X
Перейдите в Applications > Utilities. Откройте терминал и введите:
/Applications/Firefox.app/Contents/MacOS ./firefox -ProfileManager
Linux
Откройте терминал и введите:
cd Thunderbird installation directory ./thunderbird -ProfileManager
Пример выше использует опцию командной строки "-ProfileManager"
для почтового клиента Mozilla Thunderbird.
Профиль пользователя
-CreateProfile profile_name
Создаёт новый профиль с именем profile_name
в директории по умолчанию, но не запускает приложение. Значение profile_name
не должно содержать пробелов ( )
.
Для успешного использования не должно быть уже запущенных экземпляров приложения или использоваться опция -no-remote
.
firefox -CreateProfile JoelUser
-CreateProfile "profile_name profile_dir"
Создаёт новый профиль profile_name в директории profile_dir, но не запускает приложение. Обратите внимание, что profile_name и profile_dir заключены в кавычки вместе, и разделяются ровно одним пробелом ( )
.
Для успешного использования не должно быть уже запущенных экземпляров приложения или использоваться опция -no-remote
.
Примечание: Директория profile_dir не должна быть существующей и вы не должны иметь существующего профиля с именем profile_name.
firefox -CreateProfile "JoelUser c:\internet\moz-profile"
-ProfileManager
Запуск Менеджера профилей. Короткая форма: -P
(без имени пользователя).
-P "profile_name"
Пропускает запуск менеджера профилей и запускает приложение с профилем profile_name. Полезно при работе с несколькими профилями. Обратите внимание, что имя профиля profile_name регистрозависимо. Если имя профиля не указано, будет запущен диспетчер профилей. Вы должны использовать P
в верхнем регистре на Linux с версиями меньше, чем 7.x, так как в нижнем регистре это приведёт к запуску в режиме очистки (обнаружения утечек памяти). На других платформах допустимо указание как в верхнем, так и в нижнем регистре.
firefox -P "Joel User"
-profile "profile_path"
Запуск с профилем с указанным путём. Только Firefox, Thunderbird и SeaMonkey2.x.
Путь "profile_path"
может быть как абсолютным ("/path/to/profile"
), так и относительным ("path/to/profile"
).
-new-instance
Запускает новый экземпляр приложения вместо нового окна в уже запущенном приложении, что позволяет держать одновременно открытыми несколько копий приложения.
firefox -new-instance -P "Another Profile"
Примечание: Недоступно на Windows, см. ошибка 855899.
-no-remote
Не разрешает принимать или посылать удалённые команды; неявное применение опции -new-instance
.
firefox -no-remote -P "Another Profile"
-migration
Запуск приложения с Мастером миграции.
-override /path/to/override.ini
Загружает указанный файл override.ini
для переопределения application.ini
(browser/app/application.ini
). Это может быть использовано для подавления Мастера миграции при запуске загрузкой следующего файла override.ini
. Только Firefox.
[XRE] EnableProfileMigrator=0
Браузер
-browser
Запуск компонента браузера. Только Firefox и SeaMonkey.
-url URL
Открывает URL в новом окне или вкладке, в зависимости от настроек браузера. Имя опции -url
может быть опущено. Допускается указание нескольких URL, разделённых пробелами. Только Firefox и SeaMonkey.
firefox www.mozilla.com firefox www.mozilla.com developer.mozilla.org
-private
Открывает Firefox в режиме приватного просмотра. Только Firefox 3.6 и позже.
Неприменимо в Ubuntu для Firefox 20 и позже.
-private-window
Открывает новое приватное окно существующего экземпляра Firefox. Только Firefox 20 и позже.
-private-window URL
Открывает URL в новом окне в режиме приватности. Если приватное окно уже открыто, будет открыта новая вкладка в существующем окне. Только Firefox 29 и позже. Не работает в Firefox 31 на linux mint 17 (страница открывается в неприватном окне).
-new-tab URL
Открывает URL в новой вкладке. Только Firefox и SeaMonkey2.x.
-new-window URL
Открывает URL в новом окне. Только Firefox и SeaMonkey2.x.
-search term
Поиск term в поисковом движке по умолчанию. Только Firefox и SeaMonkey 2.1 и позже.
-preferences
Открывает окно настроек. Только Firefox и SeaMonkey2.x.
-setDefaultBrowser
Устанавливает приложение браузером по умолчанию. Только Firefox.
Почта и новости
-mail
Запускает почтовый клиент. Только Thunderbird и SeaMonkey.
-news
news_URL
Запускает новостной клиент. Если указан news_URL (необязательный), открывает указанную группу новостей. Только Thunderbird и SeaMonkey.
thunderbird -news news://server/group
-compose message_options
Открывает редактор почтовых сообщений. См. правила синтаксиса. Только Thunderbird и SeaMonkey.
thunderbird -compose "[email protected]"
-addressbook
Открывает адресную книгу. Только Thunderbird и SeaMonkey.
-options
Открывает окно «Инструменты/Настройки». Только Thunderbird.
-offline
Запуск в режиме автономной работы. Только Thunderbird и SeaMonkey.
-setDefaultMail
Устанавливает приложение почтовым клиентом по умолчанию. Только Thunderbird.
Календарь
-calendar
Запускает приложение календаря. Только Sunbird.
-subscribe URL
или -url URL
Подписаться на указанный URL. Только Sunbird.
-showdate date
Показать ваше расписание на указанную дату date. Только Sunbird.
sunbird -showdate 08/04/2008
Другие компоненты
-editor URL
или -edit URL
Запускает редактор для указанного URL (где URL — необязательный параметр). Только SeaMonkey.
seamonkey -edit www.mozilla.org
-jsdebugger
Запуск приложения с панелью инструментов браузера (ранее — отладчик браузера). Это отличается от отладчика Venkman (см. опцию -venkman
).
-jsconsole
Запускает приложение с открытой консолью ошибок или, в случае Firefox, консолью браузера.
-start-debugger-server port
Только Firefox. Запускает сервер отладки на порте port
. Разрешает запуск ещё одного экземпляра Firefox для подключения инструментов разработки Firefox к данному экземпляру Firefox. См. статью об удалённой отладке Firefox.
-inspector URL
Запуск инспектора DOM, если он установлен, и просмотр указанного URL (где URL — необязательный параметр).
-venkman
Запуск с отладчиком JavaScript Venkman, если он установлен.
-purgecaches
Очистка JavaScript-кэша Gecko (движка браузера) при запуске.
-chat
Запуск с IRC-клиентом ChatZilla, если он установлен.
XULRunner
-app /path/to/application.ini
Запускает новый процесс XULRunner в расположении path/to. Также работает для Firefox версии 3 и выше.
--register-global
Регистрирует XULRunner в системе для всех пользователей. Должен быть запущен с правами root или администратора.
--register-user
Регистрирует XULRunner для отдельного пользователя.
--unregister-global
Отменяет регистрацию XULRunner для всех пользователей.
--unregister-user
Отменяет регистрацию XULRunner для отдельного пользователя.
--install-app path/to/myapplication.(xpi|xulapp)
Устанавливает в системе приложение XULRunner в расположение path/to. Приложения устанавливаются в расположение по умолчанию для вашей системы (Program files|Applications|usr/lib) в папку vendorname/applicationName. Приложения могут быть удалены используемым вашей системой способом.
"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
Загружает указанный хром.
firefox -chrome chrome://inspector/content
-register chrome_URL
Регистрирует указанный хром, но не запускает приложение.
Дополнения
-install-global-extension
и -install-global-theme
были удалены из Gecko 1.9.2 и выше.-install-global-extension /path/to/extension
Устанавливает расширение в папку приложения. В качестве параметра указывается путь к расширению. Для установки необходимо иметь права администратора.
-install-global-theme /path/to/theme
То же, что и выше, по отношению к темам. Для установки необходимо иметь права администратора.
Примечание: Начиная с Firefox 2.0.0.7, использование опций командной строки -install-global-extension
и -install-global-theme
было ограничено установкой только тех дополнений, которые находятся на локальном или сетевом диске. Установка напрямую из общего сетевого ресурса больше не разрешается.
-safe-mode
Запускает приложение с отключёнными дополнениями только для данного сеанса. (Расширения не загружаются, но не отключены постоянно в менеджере расширений).
Локализация
-UILocale locale
Запуск с языком пользователького интерфейса, указанным в locale.
firefox -UILocale en-US
Удаленное управление
-remote remote_command
Примечание: Эта функция была удалена в Firefox 36.0, восстановлена в 36.0.1 и снова удалена в версии 39.0. См. ошибка 1080319.
Выполняет удалённую команду remote_command в уже запущенном процессе приложения (см. remote control).
firefox -remote "openURL(www.mozilla.org, new-tab)"
Примечание: Эта опция доступна только для UNIX-платформ под управлением X-Windows.
Разное
-tray
Запуск приложения свёрнутым в трей. Полезно при автозапуске.
-silent
Не открывать окна по умолчанию. Полезно при использовании с опциями, открывающими собственные окна, но не препятствующими открыванию окон по умолчанию. Только Firefox, Thunderbird3.x и SeaMonkey2.x.
-console
Запуск приложения с консолью отладки.
Примечание: Поддерживается только для Windows.
-attach-console
Записывать сообщения в консоль отладки окна, которое запустило приложение, вместо открытия нового окна для сообщений отладки.
Примечание: Поддерживается только для Windows.
-h
, -help
или -?
Выводит список всех доступных опций командной строки. Обратите внимание, что на Windows эта опция работает только с перенаправлением |more
(ошибка 355889):
C:\Program Files\Mozilla Firefox>firefox -help | more
Эта опция доступна только из командной строки.
-v
или -version
Выводит версию приложения. Обратите внимание, что на Windows эта опция работает только с перенаправлением |more
(ошибка 355889, см. пример выше). Эта опция доступна только из командной строки.
-osint
Указывает приложению, что оно было запущено из системной консоли. Не должно указываться, если вызывающая сторона предоставляет все функциональные возможности, предоставляемые консолью операционной системы при запуске приложения (ошибка 384384).
-requestPending
Указывает приложению, что был послан запрос Windows DDE для открытия ссылки, переданной в командной строке. Не должно указываться, если вызывающая сторона предоставляет все функциональные возможности, предоставляемые консолью операционной системы при запуске приложения (ошибка 354005).
Опции X11
Следующие опции доступны только для приложения, собранного и запущенного в системе окон X11/X.org на Linux и других UNIX-подобных системах.
--display=DISPLAY
Установить отображение X для использования.
--class=WM_CLASS
Установить класс ресурсов WM_CLASS окон X11, созданных приложением.
--sync
Сделать все вызовы X синхронными.
--g-fatal-warnings
Сделать все предупреждения фатальными.
Другие опции, нуждающиеся в документировании
-print-xpcom-dir
-print-xpcom-dirlist
-kill
-killAll
-f
-ftimeout
-fwait
-unsetDefaultMail
-foreground
-new-instance
- GTK options
Ссылки
- Chrome: Command Line
- Test Documentation for Command-line Features (mozilla.org)
toolkit/xre/nsAppRunner.cpp
browser/components/nsBrowserContentHandler.js
suite/browser/nsBrowserContentHandler.js
mail/components/nsMailDefaultHandler.js
- Installer command line options
Original Document Information
- Author(s): Ben Goodger, Steffen Wilberg, Seth Spitzer, Daniel Wang
- Copyright Information: Portions of this content are © 1998–2007 by individual mozilla.org contributors; content available under a Creative Commons license | Details.