java啟動參數共分為三類;
其一是標准參數(-),所有的JVM實現都必須實現這些參數的功能,而且向后兼容;
其二是非標准參數(-X),默認jvm實現這些參數的功能,但是並不保證所有jvm實現都滿足,且不保證向后兼容;
其三是非Stable參數(-XX),此類參數各個jvm實現會有所不同,將來可能會隨時取消,需要慎重使用;
一.標准參數
-client | 設置jvm使用client模式,特點是啟動速度比較快,但運行時性能和內存管理效率不高,通常用於客戶端應用程序或者PC應用開發和調試。 |
-server | 設置jvm使server模式,特點是啟動速度比較慢,但運行時性能和內存管理效率很高,適用於生產環境。在具有64位能力的jdk環境下將默認啟用該模式,而忽略-client參數。 |
-jar | 指定以jar包的形式執行一個應用程序。 要這樣執行一個應用程序,必須讓jar包的manifest文件中聲明初始加載的Main-class,當然那Main-class必須有public static void main(String[] args)方法。 |
-agentlib:libname [=options] |
用於裝載本地lib包; 其中 libname為本地代理庫文件名,默認搜索路徑為環境變量PATH中的路徑,options為傳給本地庫啟動時的參數,多個參數之間用逗號分隔。在 Windows平台上jvm搜索本地庫名為libname.dll的文件,在linux上jvm搜索本地庫名為libname.so的文件,搜索路徑環境變量在不同系統上有所不同,比如Solaries上就默認搜索LD_LIBRARY_PATH。 比如:-agentlib:hprof用來獲取jvm的運行情況,包括CPU、內存、線程等的運行數據,並可輸出到指定文件中;windows中搜索路徑為JRE_HOME/bin/hprof.dll。 |
-agentpath: pathname [=options] |
按全路徑裝載本地庫,不再搜索PATH中的路徑;其他功能和agentlib相同;更多的信息待續,在后續的JVMTI部分會詳述。 |
-javaagent:jarpath [=options] |
指定jvm啟動時裝入java語言設備代理。 Jarpath 文件中的mainfest文件必須有Agent-Class屬性。代理類也必須實現公共的靜態public static void premain(String agentArgs, Instrumentation inst)方法(和main方法類似)。當jvm初始化時,將按代理類的說明順序調用premain方法;具體參見 java.lang.instrument軟件包的描述。 |
-classpath classpath 或 -cp classpath |
告知jvm搜索目錄名、jar文檔名、zip文檔名,之間用分號;分隔;使用-classpath后jvm將不再使用CLASSPATH中的類搜索路徑,如果-classpath和CLASSPATH都沒有設置,則jvm使用當前路徑(.)作為類搜索路徑。 jvm搜索類的方式和順序為:Bootstrap,Extension,User。 |
-Dproperty=value |
設置系統屬性名/值對,運行在此jvm之上的應用程序可用System.getProperty("property")得到value的值。 |
-verbose -verbose:class |
輸出jvm載入類的相關信息,當jvm報告說找不到類或者類沖突時可此進行診斷。 |
-verbose:gc | 輸出每次GC的相關情況。 |
-verbose:jni | 輸出native方法調用的相關情況,一般用於診斷jni調用錯誤信息。 |
-version | 輸出java的版本信息,比如jdk版本、vendor、model。 |
二.非標准參數
-Xmsn | 指定jvm堆的初始大小,默認為物理內存的1/64,最小為1M;可以指定單位,比如k、m,若不指定,則默認為字節。 |
-Xmxn | 指定jvm堆的最大值,默認為物理內存的1/4或者1G,最小為2M;單位與-Xms一致。 |
-Xmnn | 指定jvm堆中年輕代的大小 |
-Xssn | 設置單個線程棧的大小,一般默認為512k。 |
-Xint | 設置jvm以解釋模式運行,所有的字節碼將被直接執行,而不會編譯成本地碼。 |
-Xbatch | 關閉后台代碼編譯,強制在前台編譯,編譯完成之后才能進行代碼執行; 默認情況下,jvm在后台進行編譯,若沒有編譯完成,則前台運行代碼時以解釋模式運行。 |
-Xbootclasspath: bootclasspath |
讓jvm從指定路徑(可以是分號分隔的目錄、jar、或者zip)中加載bootclass,用來替換jdk的rt.jar;若非必要,一般不會用到; |
-Xbootclasspath /a:path |
將指定路徑的所有文件追加到默認bootstrap路徑中; |
-Xbootclasspath /p:path |
讓jvm優先於bootstrap默認路徑加載指定路徑的所有文件; |
-Xcheck:jni | 對JNI函數進行附加check;此時jvm將校驗傳遞給JNI函數參數的合法性,在本地代碼中遇到非法數據時,jmv將報一個致命錯誤而終止;使用該參數后將造成性能下降,請慎用。 |
-Xfuture | 讓jvm對類文件執行嚴格的格式檢查(默認jvm不進行嚴格格式檢查),以符合類文件格式規范,推薦開發人員使用該參數。 |
-Xnoclassgc | 關閉針對class的gc功能;因為其阻止內存回收,所以可能會導致OutOfMemoryError錯誤,慎用; |
-Xincgc | 開啟增量gc(默認為關閉);這有助於減少長時間GC時應用程序出現的停頓;但由於可能和應用程序並發執行,所以會降低CPU對應用的處理能力。 |
-Xloggc:file | 與-verbose:gc功能類似,只是將每次GC事件的相關情況記錄到一個文件中,文件的位置最好在本地,以避免網絡的潛在問題。 若與verbose命令同時出現在命令行中,則以-Xloggc為准。 |
-Xprof | 跟蹤正運行的程序,並將跟蹤數據在標准輸出輸出;適合於開發環境調試。 |
-Xrs | 減少jvm對操作系統信號(signals)的使用,該參數從1.3.1開始有效; 從jdk1.3.0開始,jvm允許程序在關閉之前還可以執行一些代碼(比如關閉數據庫的連接池),即使jvm被突然終止; jvm 關閉工具通過監控控制台的相關事件而滿足以上的功能;更確切的說,通知在關閉工具執行之前,先注冊控制台的控制handler,然后對 CTRL_C_EVENT, CTRL_CLOSE_EVENT,CTRL_LOGOFF_EVENT, and CTRL_SHUTDOWN_EVENT這幾類事件直接返回true。 但如果jvm以服務的形式在后台運行(比如servlet引擎),他能接收CTRL_LOGOFF_EVENT事件,但此時並不需要初始化關閉程序;為了避免類似沖突的再次出現,從jdk1.3.1開始提供-Xrs參數;當此參數被設置之后,jvm將不接收控制台的控制handler,也就是說他不監控和處理CTRL_C_EVENT, CTRL_CLOSE_EVENT, CTRL_LOGOFF_EVENT, orCTRL_SHUTDOWN_EVENT事件。 |
三.非Stable參數
前面我們提到用-XX作為前綴的參數列表在jvm中可能是不健壯的,SUN也不推薦使用,后續可能會在沒有通知的情況下就直接取消了;但是由於這些參數中的確有很多是對我們很有用的,比如我們經常會見到的-XX:PermSize、-XX:MaxPermSize等等;
下面我們將就Java HotSpot VM中-XX:的可配置參數列表進行描述;
這些參數可以被松散的聚合成三類:
行為參數(Behavioral Options):用於改變jvm的一些基礎行為;
性能調優(Performance Tuning):用於jvm的性能調優;
調試參數(Debugging Options):一般用於打開跟蹤、打印、輸出等jvm參數,用於顯示jvm更加詳細的信息;
由於sun官方文檔中對各參數的描述也都非常少(大多只有一句話),而且大多涉及OS層面的東西,很難描述清楚,所以以下是挑選了一些我們開發中可能會用得比較多的配置項,若需要查看所有參數列表,可以點擊HotSpot VM Specific Options.查看原文;
首先來介紹行為參數:
-XX:-DisableExplicitGC |
禁止調用System.gc();但jvm的gc仍然有效 |
-XX:+MaxFDLimit |
最大化文件描述符的數量限制 |
-XX:+ScavengeBeforeFullGC |
新生代GC優先於Full GC執行 |
-XX:+UseGCOverheadLimit |
在拋出OOM之前限制jvm耗費在GC上的時間比例 |
-XX:-UseConcMarkSweepGC |
對老生代采用並發標記交換算法進行GC |
-XX:-UseParallelGC |
啟用並行GC |
-XX:-UseParallelOldGC |
對Full GC啟用並行,當-XX:-UseParallelGC啟用時該項自動啟用 |
-XX:-UseSerialGC |
啟用串行GC |
-XX:+UseThreadPriorities |
啟用本地線程優先級 |
上面表格中黑體的三個參數代表着jvm中GC執行的三種方式,即串行、並行、並發;
串行(SerialGC)是jvm的默認GC方式,一般適用於小型應用和單處理器,算法比較簡單,GC效率也較高,但可能會給應用帶來停頓;
並行(ParallelGC)是指GC運行時,對應用程序運行沒有影響,GC和app兩者的線程在並發執行,這樣可以最大限度不影響app的運行;
並發(ConcMarkSweepGC)是指多個線程並發執行GC,一般適用於多處理器系統中,可以提高GC的效率,但算法復雜,系統消耗較大;
性能調優參數列表:
參數及其默認值 |
描述 |
-XX:LargePageSizeInBytes=4m |
設置用於Java堆的大頁面尺寸 |
-XX:MaxHeapFreeRatio=70 |
GC后java堆中空閑量占的最大比例 |
-XX:MaxNewSize=size |
新生成對象能占用內存的最大值 |
-XX:MaxPermSize=64m |
老生代對象能占用內存的最大值 |
-XX:MinHeapFreeRatio=40 |
GC后java堆中空閑量占的最小比例 |
-XX:NewRatio=2 |
新生代內存容量與老生代內存容量的比例 |
-XX:SurvivorRatio |
新生代中survivor區和eden區的比例 |
-XX:NewSize=2.125m |
新生代對象生成時占用內存的默認值 |
-XX:ReservedCodeCacheSize=32m |
保留代碼占用的內存容量 |
-XX:ThreadStackSize=512 |
設置線程棧大小,若為0則使用系統默認值 |
-XX:+UseLargePages |
使用大頁面內存 |
調試參數列表:
參數及其默認值 |
描述 |
-XX:-CITime |
打印消耗在JIT編譯的時間 |
-XX:ErrorFile=./hs_err_pid<pid>.log |
保存錯誤日志或者數據到文件中 |
-XX:-ExtendedDTraceProbes |
開啟solaris特有的dtrace探針 |
-XX:HeapDumpPath=./java_pid<pid>.hprof |
指定導出堆信息時的路徑或文件名 |
-XX:-HeapDumpOnOutOfMemoryError |
當首次遭遇OOM時導出此時堆中相關信息 |
-XX:OnError="" |
出現致命ERROR之后運行自定義命令 |
-XX:OnOutOfMemoryError="" |
當首次遭遇OOM時執行自定義命令 |
-XX:-PrintClassHistogram |
遇到Ctrl-Break后打印類實例的柱狀信息,與jmap -histo功能相同 |
-XX:-PrintConcurrentLocks |
遇到Ctrl-Break后打印並發鎖的相關信息,與jstack -l功能相同 |
-XX:-PrintCommandLineFlags |
打印在命令行中出現過的標記 |
-XX:-PrintCompilation |
當一個方法被編譯時打印相關信息 |
-XX:-PrintGC |
每次GC時打印相關信息 |
-XX:-PrintGC Details |
每次GC時打印詳細信息 |
-XX:-PrintGCTimeStamps |
打印每次GC的時間戳 |
-XX:-TraceClassLoading |
跟蹤類的加載信息 |
-XX:-TraceClassLoadingPreorder |
跟蹤被引用到的所有類的加載信息 |
-XX:-TraceClassResolution |
跟蹤常量池 |
-XX:-TraceClassUnloading |
跟蹤類的卸載信息 |
-XX:-TraceLoaderConstraints |
跟蹤類加載器約束的相關信息 |