Опции командной строки

В этой статье
  1. Правила синтаксиса
  2. Использование опций командной строки
    1. Примеры
      1. Windows
      2. Mac OS X
      3. Linux
  3. Профиль пользователя
    1. -CreateProfile profile_name
    2. -CreateProfile "profile_name profile_dir"
    3. -ProfileManager
    4. -P "profile_name"
    5. -profile "profile_path"
    6. -new-instance
    7. -no-remote
    8. -migration
    9. -override /path/to/override.ini
  4. Браузер
    1. -browser
    2. -url URL
    3. -private
    4. -private-window
    5. -private-window URL
    6. -new-tab URL
    7. -new-window URL
    8. -search term
    9. -preferences
    10. -setDefaultBrowser
  5. Почта и новости
    1. -mail
    2. -news news_URL
    3. -compose message_options
    4. -addressbook
    5. -options
    6. -offline
    7. -setDefaultMail
  6. Календарь
    1. -calendar
    2. -subscribe URL или -url URL
    3. -showdate date
  7. Другие компоненты
    1. -editor URL или -edit URL
    2. -jsdebugger
    3. -jsconsole
    4. -start-debugger-server port
    5. -inspector URL
    6. -venkman
    7. -purgecaches
    8. -chat
  8. XULRunner
    1. -app /path/to/application.ini
    2. --register-global
    3. --register-user
    4. --unregister-global
    5. --unregister-user
    6. --install-app path/to/myapplication.(xpi|xulapp)
  9. Chrome
    1. -chrome chrome_URL
    2. -register chrome_URL
  10. Дополнения
    1. -install-global-extension /path/to/extension
    2. -install-global-theme /path/to/theme
    3. -safe-mode
  11. Локализация
    1. -UILocale locale
  12. Удаленное управление
    1. -remote remote_command
  13. Разное
    1. -tray
    2. -silent
    3. -console
    4. -attach-console
    5. -h, -help или -?
    6. -v или -version
    7. -osint
    8. -requestPending
    9. Опции X11
      1. --display=DISPLAY
      2. --class=WM_CLASS
      3. --sync
      4. --g-fatal-warnings
  14. Другие опции, нуждающиеся в документировании
  15. Ссылки
  16. Original Document Information

Опции командной строки используются для определения различных параметров запуска приложений Mozilla. Например, вы можете использовать опции командной строки, чтобы обойти Менеджер Профилей и открыть определенный профиль (если у вас их несколько). Также вы можете управлять тем, как открыть приложения Mozilla, какие компоненты открыть на начальном этапе, и что делать, когда они открываются. На этой странице описаны часто используемые опции и их применение.

Правила синтаксиса

Сначала давайте опишем синтаксические правила, которые применяются ко всем опциям.

  • Параметры команд, содержащие пробелы, должны быть заключены в кавычки, например "Joel User".
  • Действия команд не зависят от регистра.
  • Параметры команд (кроме имени профиля) не зависят от регистра.
  • Команды и параметры разделяются пробелами.
  • Для полей сообщений используется синтаксис поле=значение, например:
    • to=foo@nowhere.net
    • subject=cool page
    • attachment=www.mozilla.org
    • attachment='file:///c:/test.txt'
    • body=проверьте эту страницу
  • Несколько полей сообщения разделяются запятой (,), например: "to=foo@nowhere.net,subject=классная страница". Перед или после разделяющей запятой не должно быть пробелов. Чтобы задать несколько значений для поля, заключите значения в одиночные кавычки ('), например: "to='foo@nowhere.net,foo@foo.de',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").

Примечание: Указание относительного пути на Mac OS X больше не поддерживается из-за регрессии, начиная с Firefox 4.0 и выше, см. ошибка 673955.

-new-instance

Запускает новый экземпляр приложения вместо нового окна в уже запущенном приложении, что позволяет держать одновременно открытыми несколько копий приложения.

firefox -new-instance -P "Another Profile"

Примечание: Недоступно на Windows, см. ошибка 855899.

-no-remote

Не разрешает принимать или посылать удалённые команды; неявное применение опции -new-instance.

firefox -no-remote -P "Another Profile"
Примечание: Начиная с Firefox 9, это действительно означает то, что подразумевается, на всех платформах, т.е. экземпляры, созданные с помощью этого параметра не принимают и не отправляют удалённых команд, см. ошибка 650078. Это означает то, что такие экземпляры не могут быть переиспользованы. Также при использовании этого аргумента в любом случае создаётся новый экземпляр.

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

Примечание: При открытии нескольких URL, Firefox всегда открывает их как вкладки в новом окне.
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 "to=foo@nowhere.net"

-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

Регистрирует указанный хром, но не запускает приложение.

Дополнения

Gecko 1.9.2 note
Опции -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

Ссылки

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.

Метки документа и участники

 Внесли вклад в эту страницу: Alxzaur, genai05
 Обновлялась последний раз: Alxzaur,