命令行選項用於爲 Mozilla 應用程序指定各類啓動選項。例如,您能夠使用命令行配置選項來繞過配置檔管理器並打開一個特定的配置檔(若是您有多個配置檔)。您也能夠控制 Mozilla 應用程序如何打開,初始打開哪一個組件以及當組件打開時要作什麼。這個頁面描述經常使用的選項和如何使用它們。html
語法規則
首先,讓咱們描述一下適用於全部選項的語法規則。web
- 包含空格的命令參數必須以引號括起;例如 "Joel User"。
- 命令操做是不區分大小寫的。
- 命令參數,除了配置檔名稱外都是不區分大小寫的。
- 空格( )用於間隔多個命令和參數。
- 每條消息選項都遵循語法
字段=值
,例如:to=
foo@nowhere.net
subject=cool page
attachment=www.mozilla.org
attachment='file:///c:/test.txt'
body=check this page
- 多個消息選項用逗號(,)間隔,例如:
"to=foo@nowhere.net,subject=cool page"。逗號分隔符必定不能尾隨或前綴空格
( )。要指派多個值給一個字段,使用單引號(')閉合值,例如:"to='foo@nowhere.net,foo@foo.de',subject=cool page"
。
使用命令行選項
命令行選項在啓動應用程序的命令後輸入。某些選項選項有參數。它們在命令行選項後輸入。某些選項有縮寫替代。例如,命令行選項 "-editor" 能夠縮寫爲 "-edit"。(其中可用的縮寫將會在下面的文本中闡述) 在某些狀況下,選項參數必須用引號括起。(這會在如下的選項描述中註明。) 能夠指定多個命令行選項。一般,語法以下:chrome
應用程序 -選項 -選項 "參數" -選項 參數
示例
下列示例顯示 "-ProfileManager" 命令的使用,它將會在啓動 Firefox 或 Thunderbird 前打開配置檔管理器:shell
Windows
從 Windows 開始菜單中選擇運行,輸入:瀏覽器
firefox -ProfileManager
Mac OS X
轉到 Applications > Utilities,打開終端並輸入:網絡
cd /Applications/Firefox.app/Contents/MacOS
./firefox -ProfileManager
Linux
打開終端並輸入:app
cd Thunderbird 安裝目錄
./thunderbird -ProfileManager
以上示例調用 "-ProfileManager" 命令行選項用於 Mozilla 的 Thunderbird 郵件客戶端。less
用戶配置檔
-CreateProfile profile_name
建立一個名爲profile_name 的配置檔,而不啓動程序。profile_name 必定不能包含空格( )。編輯器
firefox -CreateProfile JoelUser
-CreateProfile "profile_name profile_dir"
在目錄 profile_dir 中建立一個名爲 profile_name 的配置檔而不啓動應用程序。注意 profile_name 和 profile_dir 必須括在一塊兒。(在 SeaMonkey1.x 中未有)ide
注: profile_dir 必須存在並且您必須還未有稱爲 profile_name 的配置檔。
firefox -CreateProfile "JoelUser c:\internet\moz-profile"
-ProfileManager
使用配置檔管理器啓動。
-SelectProfile
使用配置檔選擇對話框啓動。僅用於 SeaMonkey1.x。
-ProfileWizard
使用配置檔嚮導啓動。僅用於 SeaMonkey1.x。
-P "profile_name"
繞過配置檔管理器並使用名爲profile_name 的配置檔啓動。對於處理多個配置檔頗有用。注意profile_name 是區分大小寫的。若是您未指定一個配置檔名稱,那麼就會打開配置檔管理器。在 L:inux 上,您必須使用大寫字母 P,由於小寫調用 Purify 模式(內存和泄露探測)。其它平臺大小寫都接受。
firefox -P "Joel User"
-profile "profile_path"
使用給出路徑的配置檔啓動。僅用於 Firefox、Thunderbird 和 SeaMonkey2.x。
"profile_path"
能夠是一個絕對路徑("/path/to/profile"
) 或一個相對路徑("path/to/profile"
).
-no-remote
容許同一事件打開多個應用程序副本。(在 SeaMonkey1.x 中無效,它僅支持 MOZ_NO_REMOTE=1
)。
firefox -no-remote -P "另外一個配置檔"
-migration
使用導入嚮導啓動。(SeaMonkey1.x 中無效)
-installer
使用 Netscape 4.x 遷移窗口啓動。僅用於 SeaMonkey1.x。
-resetPref preference
重置指定的首選項(逗號間隔)爲默認值。僅用於 SeaMonkey1.x。
seamonkey -resetPref browser.startup.homepage
-override /path/to/override.ini
加載指定的 override.ini
文件以覆蓋 application.ini
(browser/app/application.ini
)中的配置。經過加載下列 override.ini
能夠抑制在啓動時的遷移向導。僅用於 Firefox。
[XRE]
EnableProfileMigrator=0
瀏覽器
-browser
使用 browser(瀏覽器)組件啓動。僅用於 Firefox 和 SeaMonkey。
-url URL
根據瀏覽器選項,在新標籤頁或窗口中打開 URL。-url
能夠省略。僅用於 Firefox 和 SeaMonkey。注: 當打開多個 URLs 時,Firefox 老是把它們打開爲一個新窗口中的選項頁。
firefox www.mozilla.com
-private
以私密瀏覽模式打開 Firefox,而不考慮當前的用戶首選項。僅用於 Firefox 3.6 和之後版本。
-new-tab URL
在新標籤頁中打開 URL。僅用於 Firefox 和 SeaMonkey2.x。
-new-window URL
在新窗口中打開 URL。僅用於 Firefox 和 SeaMonkey2.x。
-search term
使用您的默認搜索引擎搜索 term。僅用於 Firefox 和 SeaMonkey2.x 及之後的版本。
-preferences
打開選項/首選項窗口。僅用於 Firefox 和 SeaMonkey2.x。
-setDefaultBrowser
設置應用程序爲默認的瀏覽器。僅用於 Firefox。
郵件/新聞
-mail
使用郵件客戶端啓動。僅用於 Thunderbird 和 SeaMonkey。
-mail mailto_URL
爲給出的 mailto_URL 啓動撰寫消息的窗口。僅用於 Thunderbird。
thunderbird -mail mailto:me@isp.net?subject=hi
-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 日期
顯示給出的日期的您的計劃安排。僅用於 Sunbird。
sunbird -showdate 08/04/2008
其它組件
-editor URL
或 -edit URL
爲給出的 URL 使用編輯器(撰寫器)啓動(其中 URL 是可選的)。僅用於 SeaMonkey。
seamonkey -edit www.mozilla.org
-jsconsole
使用錯誤控制檯啓動應用程序.
-inspector URL
使用 DOM Inspector 啓動(若是已安裝的話),並觀察給出的 URL (其中 URL 是可選的)。
-venkman
使用 JavaScript 調試器 Venkman 啓動(若是已安裝的話)。
-chat
使用 IRC 客戶端 ChatZilla 啓動(若是已安裝的話)。
XULRunner
-app /path/to/application.ini
啓動一個新進程運行在指定路徑 path/to 處的 XULRunner 應用程序。僅用於 Firefox 版本 3 和以上。
Chrome
-chrome chrome_URL
加載指定的 chrome。
firefox -chrome chrome://inspector/content
-register chrome_URL
註冊指定的 chrome,而不啓動應用程序。
擴展附件
-install-global-extension /path/to/extension
安裝擴展到應用程序目錄。參數是擴展的路徑。您必須有管理權限。(在 SeaMonkey1.x 中無效,可是某些擴展已經把這個做爲一個安裝時的選項)。
-install-global-theme /path/to/theme
和上面相似,可是隻用於主題。您必須有管理權限。(在 SeaMonkey1.x 中無效,可是某些擴展已經把這個做爲一個安裝時的選項)。
-safe-mode
禁用全部的擴展啓動應用程序,僅用於啓動。(擴展不會加載,可是不會在擴展管理器數據源中永久禁用)。(在 SeaMonkey1.x 中無效)
語種
-UILocale locale
以 locale 資源做爲用戶界面的語種。
firefox -UILocale en-US
啓動
-turbo
Launch application in Quick Launch mode. SeaMonkey1.x only.
-nosplash
or -quiet
Suppresses display of the splash screen. To show splash screen, use the -splash
command. Note the splash screen is disabled by default on some systems.SeaMonkey1.x only.
遠程控制
-remote 遠程命令
在一個已經運行的應用程序進程中執行遠程命令(查看遠程控制)。注: Unix/Linux 僅適用於 SeaMonkey1.x
firefox -remote "openURL(www.mozilla.org, new-tab)"
其它
-silent
不打開默認窗口。對於那些打開它們本身窗口可是未防止默認窗口打開的那些命令行參數頗有用。僅適用於 Firefox、Thunderbird3.x 和 SeaMonkey2.x。
-console
使用一個調試控制檯啓動應用程序。注:僅適用於 Windows。
-h
或 -help
或 -?
顯示全部可用的命令行參數的列表。注意,在 Windows 上僅對調試構建版本(bug 355889)有效。這個選項僅在命令行控制檯中可用。
-v
或 -version
打印應用程序版本。注意,在 Windows 上僅對調試構建版本(bug 355889)有效。
-osint
告訴應用程序它是被 OS SHell 啓動的。這個不該該指定,除非調用者在啓動應用程序時,提供了 OS Shell 的全部功能。(bug 384384).
-requestPending
Tells the application that there will be a Windows DDE request to open the same url specified on the command line. This should not be specified unless the caller provides all of the functionality provided by the OS shell when launching the application (bug 354005).
X11 options
These options are only available for an application build for and running atop the X11/X.org display and window system to be found on Linux and other Unices.
--display=DISPLAY
設置要使用的 X display
--sync
使 X 調用同步
--g-fatal-warnings
使全部警告視爲嚴重
其它須要編寫文檔的選項
-print-xpcom-dir
-print-xpcom-dirlist
-kill
-killAll
-f
-ftimeout
-fwait
-unsetDefaultMail
-foreground
- GTK options