Copyright © 2002-2004 Sun Microsystems, Inc. All Rights Reserved.
Java 소프트웨어
java [ options ] class [ argument ... ]
java [ options ] -jar file.jar [ argument ... ]
javaw [ options ] class [ argument ... ]
javaw [ options ] -jar file.jar [ argument ... ]
options- 커멘드행 옵션
class- 불려 가는 클래스의 이름
file.jar- 불려 가는 JAR 파일의 이름. 반드시
-jar와 함께 사용한다argument- main 함수에게 건네지는 인수
java 툴은, Java 어플리케이션을 기동합니다. java 툴은, Java Runtime Environment 를 기동한 뒤, 지정된 클래스를 로드해, 그 클래스의 main 메소드를 호출하는 것으로, Java 어플리케이션을 기동합니다.이 메소드는, public 및 static 로서 선언할 필요가 있습니다. 또, 값을 돌려주어 되지 않습니다. 게다가
String배열을 파라미터로서 지정할 수 없으면 안됩니다. 메소드의 선언은, 다음과 같이 되지 않으면 안됩니다.public static void main(String args[])디폴트에서는, 커멘드행 옵션 이외의 최초의 인수가, 불려 가는 클래스의 이름이 됩니다. 이 이름에는, 완전 지정의 클래스명을 사용할 필요가 있습니다. -jar 옵션을 지정했을 경우, 커멘드행 옵션 이외의 최초의 인수가, 어플리케이션의 클래스 파일과 resource file를 포함한 JAR 어카이브(archive)의 이름이 됩니다. 이 경우, 마니페스트의 Main-Class 헤더로 지정된 클래스가 기동 클래스가 됩니다.Java Runtime 는, bootstrap 클래스 패스, 인스톨형 확장 기능, 및 유저 클래스 패스의 3 개소로부터 기동 클래스와 다른 사용되고 있는 클래스를 검색합니다.
클래스명 또는 JAR 파일명의 후에 있는, 커멘드행 옵션 이외의 인수는,main 함수에게 건네집니다.
javaw 커멘드는, 콘솔 윈도우가 없는 이외는,java 커멘드와 같습니다. javaw 는, 커멘드 prompt 윈도우를 표시할 필요가 없을 때에 사용합니다. 다만,javaw 기동 툴에서는, 어떠한 이유로써 기동에 실패하면(자), 에러 정보를 나타내는 다이알로그 박스가 표시됩니다.
기동 툴에는, 현재의 실행 환경 및 장래의 릴리스로 서포트되는표준 옵션이 있습니다. 또, 디폴트의 Java HotSpot VM 에서는,비표준 옵션세트도 제공됩니다. 이것은, 장래의 릴리스로 변경될 가능성이 있습니다.
- -client
- Java HotSpot Client VM 를 선택합니다.
상세한 것에 대하여는,「서버 - 클래스 머신의 검출」을 참조해 주세요.
- -server
- Java HotSpot Server VM 를 선택합니다.
상세한 것에 대하여는,「서버 - 클래스 머신의 검출」을 참조해 주세요.
- -agentlib:libname[=options]
- 네이티브 에이전트 라이브러리 libname 를 로드합니다. 예를 들어 다음과 같이 지정합니다.
-agentlib:hprof
-agentlib:jdwp=help
-agentlib:hprof=help
상세한 것에 대하여는,「JVMTI 에이전트의 커멘드행 옵션」을 참조해 주세요.
- -agentpath:pathname[=options]
- 풀 패스명을 사용해, 네이티브 에이전트 라이브러리를 로드합니다. 상세한 것에 대하여는,「JVMTI 에이전트의 커멘드행 옵션」을 참조해 주세요.
- -classpath classpath
- -cp classpath
- 클래스 파일을 검색하는 디렉토리, JAR 어카이브(archive), 및 ZIP 어카이브(archive)의 리스트를 지정합니다. 클래스 패스의 각 엔트리는, 세미콜론 (;)으로 단락짓습니다. -classpath 또는 -cp 를 지정하면(자), 이 옵션의 값에 의해 CLASSPATH 환경 변수의 설정이 오버라이드(override) 됩니다.
-classpath 도 -cp 도 사용되지 않고,CLASSPATH 도 설정되어 있지 않은 경우, 유저 클래스 패스는 현재의 디렉토리 (
.)(이)가 됩니다.클래스 패스의 자세한 것은,「클래스 패스의 설정」을 참조해 주세요.
- -Dproperty=value
- 시스템 프로퍼티의 값을 설정합니다. value 가, 스페이스를 포함한 캐릭터 라인인 경우는, 캐릭터 라인을 다음과 같이 이중 인용부호로 둘러쌀 필요가 있습니다.
java -Dfoo="some string" SomeClass- -enableassertions[:<package name>"..."| :<class name> ]
- -ea[:<package name>"..."| :<class name> ]
- assertion를 유효하게 합니다. assertion는, 디폴트에서는 무효가 되어 있습니다.
인수 없음의 enableassertions 또는 -ea 를 지정하면(자), assertion가 유효하게 됩니다. 「...」(으)로 끝나는 인수를 1 개 지정하면(자), 지정한 패키지와 그 서브 패키지내에서 assertion가 유효하게 됩니다. 인수로서 「...」만을 지정하면(자), 현재의 작업 디렉토리에 있는 이름이 없는 패키지내에서 assertion가 유효하게 됩니다. 「...」(으)로 끝나지 않는 인수를 1 개 지정하면(자), 지정한 클래스내에서 assertion가 유효하게 됩니다.
단일 커멘드행에 이러한 스윗치의 인스턴스를 복수 지정했을 경우는, 지정한 스윗치가 차례로 처리되고 나서 클래스가 로드 됩니다. 따라서, 예를 들어, 패키지 com.wombat.fruitbat (서브 패키지를 포함한다) 내에서만 assertion를 유효하게 해 프로그램을 실행하려면 , 다음과 같은 커멘드를 사용합니다.
java -ea:com.wombat.fruitbat...<Main Class>-enableassertions 및 -ea 스윗치는, 모든 클래스 로더 및 시스템 클래스에 적용됩니다. 시스템 클래스에는 클래스 로더는 없습니다. 다만, 이 규칙에는 예외가 1 개 있습니다. 그것은, 인수없이 이 스윗치를 지정하면(자), 그 지정은 시스템 클래스에는 적용되지 않는, 이라고 하는 것입니다. 이 예외를 이용하면, 시스템 클래스를 제외한 모든 클래스에서 assertion를 간단하게 유효하게 할 수가 있습니다. 모든 시스템 클래스에서 assertion를 유효하게 하기 위해서, 다른 스윗치가 준비되어 있습니다. 이후에의 -enablesystemassertions 를 참조해 주세요.
- -disableassertions[:<package name>"..."| :<class ; ]
- -da[:<package name>"..."| :<class name> ]
- assertion를 무효로 합니다. 이것은 디폴트의 설정입니다.
인수 없음의 disableassertions 또는 -da 를 지정하면(자), assertion가 무효가 됩니다. 「...」(으)로 끝나는 인수를 1 개 지정하면(자), 지정한 패키지와 그 서브 패키지내에서 assertion가 무효가 됩니다. 인수로서 「...」만을 지정하면(자), 현재의 작업 디렉토리에 있는 이름이 없는 패키지내에서 assertion가 무효가 됩니다. 「...」(으)로 끝나지 않는 인수를 1 개 지정하면(자), 지정한 클래스내에서 assertion가 무효가 됩니다.
패키지 com.wombat.fruitbat 내에서는 assertion를 유효하게 해, 클래스 com.wombat.fruitbat.Brickbat 내에서는 assertion를 무효로 한 데다가, 프로그램을 실행하려면 , 다음과 같은 커멘드를 사용합니다.
java -ea:com.wombat.fruitbat...-da:com.wombat.fruitbat.Brickbat <Main Class>-disableassertions 및 -da 스윗치는, 모든 클래스 로더 및 시스템 클래스에 적용됩니다. 시스템 클래스에는 클래스 로더는 없습니다. 다만, 이 규칙에는 예외가 1 개 있습니다. 그것은, 인수없이 이 스윗치를 지정하면(자), 그 지정은 시스템 클래스에는 적용되지 않는, 이라고 하는 것입니다. 이 예외를 이용하면, 시스템 클래스를 제외한 모든 클래스에서 assertion를 간단하게 유효하게 할 수가 있습니다. 모든 시스템 클래스에서 assertion를 무효로 하기 위해서(때문에), 다른 스윗치가 준비되어 있습니다. 이후에의 -disablesystemassertions 를 참조해 주세요.
- -enablesystemassertions
- -esa
- 모든 시스템 클래스내에서 assertion를 유효하게 합니다. 즉, 시스템 클래스에 도착해 assertion의 디폴트 스테이터스를 true 로 설정합니다.
- -disablesystemassertions
- -dsa
- 모든 시스템 클래스내에서 assertion를 무효로 합니다.
- -jar
- JAR 파일에 캡슐화된 프로그램을 실행합니다. 최초의 인수는, 기동 클래스의 이름은 아니고, JAR 파일의 이름으로 합니다. 이 옵션이 기능하려면 , JAR 파일의 마니페스트에「Main-Class:classname」라고 하는 형식의 행을 지정할 필요가 있습니다. 다만,classname 에는, 어플리케이션의 개시 위치로서 기능하는 public static void main(String[] args) 메소드를 포함한 클래스를 지정합니다. JAR 파일과 그 마니페스트에 대해서는,jar 툴의 레퍼런스 페이지와Java 튜토리얼의 「Trail: Jar Files」를 참조해 주세요.
이 옵션을 사용하면(자), 지정한 JAR 파일이 모든 유저 클래스의 소스가 되어, 유저 클래스 패스외의 설정은 무시됩니다.
- -javaagent:jarpath[=options]
- Java 프로그램 언어 에이전트를 로드합니다. java.lang.instrument 를 참조해 주세요.
- -verbose
- -verbose:class
- 클래스가 로드 될 때마다 클래스에 관한 정보를 표시합니다.
- -verbose:gc
- 가베지 콜렉션 이벤트가 발생할 때마다 보고합니다.
- -verbose:jni
- 네이티브 메소드의 사용 및 그 외의 Java Native Interface (JNI) 액티버티에 관한 정보를 보고합니다.
- -version
- 버젼 정보를 표시해 종료합니다.
- -showversion
- 버젼 정보를 표시해 속행합니다.
- -?
- -help
- 사용법을 표시해 종료합니다.
- -X
- 비표준 옵션에 관한 정보를 표시해 종료합니다.
- -Xint
- interpreter 전용 모드로 동작합니다. native code에의 컴파일은 무효가 되어, 모든 바이트 코드가 interpreter에 의해 실행됩니다. Java HotSpot Client VM 대응의 컴파일러가 제공하는 퍼포먼스상의 이점은, 이 모드에서는 실현되지 않습니다.
- -Xbatch
- 백그라운드 컴파일을 무효로 합니다. 통상, VM 에서는, 백그라운드 컴파일이 종료할 때까지, 메소드를 백그라운드 태스크로서 컴파일 해, interpreter 모드로 메소드를 실행합니다. -Xbatch 플래그를 지정하면(자), 백그라운드 컴파일이 무효가 되어, 모든 메소드의 컴파일이 완료할 때까지 foreground 태스크로서 처리됩니다.
- -Xdebug
- JVMDI 의 서포트를 유효하게 해 개시합니다. JVMDI 는 추천 되고 있지 않습니다. 또, J2SE 5.0 에서의 디버그에는 사용되지 않습니다. 따라서, J2SE 5.0 에서의 디버그에는, 이 옵션은 필요 없습니다.
- -Xbootclasspath:bootclasspath
- 부트 클래스 파일을 검색하는 디렉토리, JAR 어카이브(archive), 및 ZIP 어카이브(archive)를 세미콜론으로 단락지은 리스트로 지정합니다. 지정한 패스에 존재하는 부트 클래스 파일이, Java 2 SDK 에 포함되는 부트 클래스 파일 대신에 사용됩니다. 주: rt.jar 내의 클래스를 오버라이드(override) 하는 목적으로 이 옵션을 사용하는 어플리케이션은, 시스템에 배치하지 말아 주세요. Java 2 Runtime Environment 바이너리코드 라이센스 위반이 됩니다.
- -Xbootclasspath/a:path
- 디렉토리, JAR 어카이브(archive), 및 ZIP 어카이브(archive)의 패스를 세미콜론으로 단락지어 지정합니다. 패스는 디폴트의 bootstrap 클래스 패스의 뒤로 추가됩니다.
- -Xbootclasspath/p:path
- 디렉토리, JAR 어카이브(archive), 및 ZIP 어카이브(archive)의 패스를 세미콜론으로 단락지어 지정합니다. 패스는 디폴트의 bootstrap 클래스 패스전에 추가됩니다. 주: rt.jar 내의 클래스를 오버라이드(override) 하는 목적으로 이 옵션을 사용하는 어플리케이션은, 시스템에 배치하지 말아 주세요. Java 2 Runtime Environment 바이너리코드 라이센스 위반이 됩니다.
- -Xcheck:jni
- Java Native Interface (JNI) 기능에 대해서 추가 체크를 실시합니다. 구체적으로는, Java 가상 머신은 JNI 요구를 처리하기 전에, JNI 함수에게 건네지는 파라미터와 실행 환경의 데이터를 검증합니다. 무효인 데이터가 발견되었을 경우는, native code에 문제가 있는 것을 나타내고 있기 (위해)때문에, Java 가상 머신은 치명적 에러를 발생해 종료합니다. 이 옵션을 사용하면(자), 퍼포먼스 저하가 예상됩니다.
- -Xfuture
- 클래스와 파일의 형식을 엄밀하게 체크합니다. 하위 호환성을 유지하기 (위해)때문에, Java 2 SDK 의 가상 머신이 실행하는 디폴트의 형식 체크는, JDK 소프트웨어의 버젼 1.1.x 가 실행하는 체크와 동일한 정도의 엄밀함이 되어 있습니다. -Xfuture 플래그를 지정하면(자), 클래스 파일 형식의 사양에의 준거를 강화하기 위한보다 엄밀한 체크가 유효하게 됩니다. Java 어플리케이션 기동 툴의 장래의 릴리스에서는, 보다 엄밀한 체크가 디폴트가 되기 (위해)때문에, 새로운 코드를 개발할 경우에는 이 플래그를 사용하는 것을 추천합니다.
- -Xnoclassgc
- 클래스의 가베지 콜렉션을 무효로 합니다.
- -Xincgc
- 인크리멘타르가베이지코레크타를 유효하게 합니다. 인크리멘타르가베이지코레크타는, 디폴트에서는 무효가 되어 있습니다. 유효하게 하면(자), 프로그램의 실행중에 가베지 콜렉션에 의한 일시정지가 발생하지 않게 됩니다. 인크리멘타르가베이지코레크타는, 프로그램과 동시에 실행하는 일이 있어, 이 경우, 프로그램의 이용할 수 있는 프로세서 능력이 저하합니다.
- -Xloggc:file
- -verbose:gc 와 같게 가베지 콜렉션 이벤트가 발생할 때마다 보고합니다만, 그 데이터를 file 에 기록합니다. -verbose:gc 를 지정했을 때에 보고되는 정보 외에, 보고되는 각 이벤트의 선두에, 최초의 가베지 콜렉션 이벤트로부터의 경과시간 (초단위)을 덧붙일 수 있습니다.
네트워크의 응답 시간에 의해 JVM 의 실행 속도가 저하하는 것을 피하기 (위해)때문에, 이 파일의 포함처는, 항상 로컬 파일 시스템으로 해 주세요. 파일 시스템이 만배가 되면(자), 파일은 잘라 버릴 수 있어 그 파일에 데이터가 계속해 기록됩니다. 이 옵션과 -verbose:gc 의 양쪽 모두가 커멘드행으로 지정되고 있는 경우는, 이 옵션이 우선됩니다.
|
Copyright © 2002-2004 Sun Microsystems, Inc. All Rights Reserved. |
Java 소프트웨어 |