Java CGI HOWTO by David H. Silber dhs@orbits.com 1996년 11월 18일 버전 0.4 번역 : 박주희 ( jhpark91@cse.hanyang.ac.kr ) 이 HOWTO 문서는 서버에서 자바로 작성된 CGI 프로그램을 어떻게 셋업하며 또 CGI 프로그램을 작성하기위해 어떻게 자바를 사용하는지를 설명한다. HOWTO 문서는 리눅스 운영체제를 목적으로 작성되지만, 이 문서는 특정한 유닉스 버전에 상관 없이 적용된다. 1. 소개 자바가 디자인된 방식 때문에 프로그래머는 시스템의 환경 변수들을 쉽게 액세스할 수 없다. Java Development Kit (JDK)이 제작된 방식 때문에, 프로그램을 호출하기 위해서는 여러 개의 토큰을 이용해야 하며, 이것도 표준 HTML폼/CGI 작동방식과 잘 맞지 않는다. 이러한 한계에 몇 가지 방법이 있으며, 본인이 그 중 하나를 구현하였다. 자세한 것은 뒤를 더 읽어보라. 1.1. 사전 지식 HTML과 CGI 개념에 관한 일반적 지식과 최소한 HTTP서버에 관하여 기본적인 지식은 알고있다고 가정한다. 물론 자바로 프로그램을 작성하는 법을 알아야 하며 그렇지 못하면 이 문서는 이해하기 힘들다. 1.2 본 문서에 관하여 본 문서의 최근 판은 http://www.orbits.com/software/Java_CGI.html 에서 읽을 수 있다. 1.3 패키지 여기 적힌 패키지는 ftp://ftp.orbits.com/pub/software/java_cgi-0.4.tgz 에서 anonymous FTP로 얻을 수 있다. 이 패키지 배포판에는 본 문서의 SGML 소스도 들어있다. 이 패키지는 GNU Library General Public License조항에 의거해 배포된다. 본 문서는 리눅스 HOWTO 판권 주의사항에 의거해서 배포 된다. 만약 본 소프트웨어를 사용 한다면, 다른 사람들이 이 Java CGI클래스를 발견할 수 있게 http://www.orbits.com/software/Java_CGI.html 의 레퍼런스를 달기 바란다. 1.4 선전 한마디 이 문서는 Stellar Orbits Technology Services에 의해 제공되었다. (우리가 하는 것을 보고 싶다면 http://www.orbits.com/ 를 둘러보라) 2. 자바 CGI프로그램을 실행하기 위해 서버 셋팅하기 (설명과 함께) 이 부분은 여러분의 설치 작업이 어떤 영향을 끼치는지 여러분 자신이 알아보게 하기 위해 풍부한 설명과 함께 본인의 Java CGI패키지를 인스톨 할 것이다.만약 이 프로그램을 인스톨만하고 자질구레한 것은 알기 싫다면 "Java CGI 프로그램들을 실행하기 위해 서버 셋업하기" 로 넘어가라. 2.1. 시스템 요구사항 이 소프트웨어는 Java Development Kit이 인스톨된 대부분의 유닉스 형태의 웹 서버에서 작동한다. 본인은 apache를 HTTP데몬으로 실행시키며 데비안 리눅스를 사용하고 있다. 만약 여러분의 서버에서 작동하지 않으면 dhs@orbits.com으로 연락 해주기 바란다. 불행히도 자바 런타임 인터프리터는 메모리를 많이 필요한 것 처럼 보인다. Java CGI 프로그램들을 여러 번 실행 한다면 몇 메가바이트의 램을 서버에 더 깔아야 될 것이다. 2.2. Java CGI 애드-온 소프트웨어 이 문서에서 설명하려 하는 본인이 작성한 소프트웨어는 Java CGI 라고 한다. ftp://www.orbits.com/pub/software/java_cgi-0.4.tgz 에서 얻을 수 있다. (버전의 숫자는 바뀌었을지도 모른다.) 2.3 소스 압축 풀기 이 패키지를 풀어둘 적당한 디렉토리를 찾아라. ( 다른 패키지를 풀어 둔 일정한 곳이 없다면, /usr/local/src 를 사용하라.) 다음의 명령으로 배포판을 푼다. gzip -dc java_cgi-0.4.tgz | tar -xvf - 이 명령이java_cgi-0.4라는 디렉토리를 생성할 것이다. 거기에 이 다음 단계부터 참고할 파일이 있을 것이다. (버전의 숫자가 바뀌었다면, 지금부터는 그 배포판의 설명을 참고하라) 2.4 여러분의 지역 패스(Local Path)에 관한 방침을 정하라 Java CGI프로그램들을 어디에 둘지 결정하라. 보통, 여러분의 cgi-bin디렉토리에 같이 둘 것이다. 본인의 아파치 서버는 cgi-bin 디렉토리로써 /var/web/cgi-bin을 사용하게 설정되어 있어서, Java CGI 프로그램들을 넣어둘 디렉토리로는 /var/web/javacgi 를 사용한다. 여러분은 지정된 CLASSPATH 디렉토리에 Java CGI 프로그램들을 넣고 싶지 않을 지도 모른다. 시스템 설정을 반영하기 위해 Makefile 을 편집하라. root로 로그인 한 것을 확인하고 make install을 실행하라. 이 명령이 자바 프로그램을 컴파일하고,java.cgi 라는 스크립트를 시스템에 맞게 변경하고 적당한 곳에 그 프로그램들을 인스톨한다. 추가로, 이 문서의 HTML 버전이나 HTML테스트 문서를 원한다면,대신 make all 을 실행하라. 2.5 인스톨 테스트해보기 배포판으로부터 인스톨된 것은 javacgitest.html , javaemailtest.html , javahtmltest.html 이란 HTML문서들이다. 앞에서 쓰여진 그대로 모두 인스톨 했다면, Makefile에서 WEBDIR로 설정된 디렉토리에 이 문서들이 있을 것이다. 그대로 인스톨 하지 않았다면, javacgitest.html-dist, javaemailtest.html-dist, javahtmltest.html-dist 로부터 빌드(build)하기 위해 make test를 실행시켜도 된다. 인스톨한 것이 정확하게 동작할 때, JAVACGI 디렉토리로부터 CGI_Test.class , Email_Test.class , HTML_Test.class를, 또 WEBDIR 디렉토리로 부터는 javacgitest.html , javaemailtest.html , javahtmltest.html 없애고 싶을 것이다. 보통 서버에게만 사용 가능한 사용자 정보를 보여주기 때문이다. 3. 자바 CGI 프로그램을 실행하기 위해 서버 셋업하기 (요약) * ftp://www.orbits.com/pub/software/java_cgi-0.4.tgz로부터 Java CGI 패키지를 받아라 (버전 숫자는 바뀌었을지도 모른다.) * 이 배포판을 다음의 명령어로 압축을 풀어라 gzip -dc java_cgi-0.4.tgz | tar -xvf - (만약 버전의 숫자가 바뀌었다면, 지금부터는 그 배포판 안에 있는 설명을 따르라) * 새로이 생성된 java_cgi-0.4 디렉토리에서 시스템에 맞게 Makefile을 편집하라. * root로써 make install을 실행하라. 이 명령이 자바 프로그램을 컴파일하고, 여러분의 시스템에 관련된 정보들을 적용(apply)시키고 다양한 파일들을 인스톨 한다. 만약 HTML로된 이 문서와 HTML테스트 문서를 원하면, 대신 make all을 실행하라. * 실행시킬 준비가 되었을 것이다. 4. Java CGI 프로그램 실행시키기 4.1. CGI 모델에서 자바 프로그램의 실행을 막는 장애물 웹 서버에서 자바 프로그램을 실행시키는데 있어서 두 가지 문제점이 있다: 4.1.1. 자바 프로그램을 보통 실행파일 처럼 실행시킬 수 없다. 커멘드 라인상에서 자바 런타임 인터프리터를 실행하고 (프로그램이 실행될 수 있도록) 초기화 클래스를 적어주어야 한다. HTML 형태로는 커멘드 라인을 웹 서버에 보낼 수 없다. 4.1.2. 자바는 환경(environment)에 대한 일반적인 액세스를 하지 않는다. 자바 프로그램이 필요로 하는 개개의 환경변수는 정확이 넘겨져야 한다. C 에서의 getenv() 함수 같은 메소드는 없다. 4.2. Java CGI프로그램을 실행할 때의 문제점 극복 위의 두 장애물을 처리하기 위해, 본인은 자바 인터프리터에게 필요한 정보를 주는 쉘 CGI프로그램을 작성하였다. 4.2.1. java.cgi 스크립트 이 쉘 스크립트는 여러분이 사용하고자 하는 Java CGI프로그램과 HTTP데몬 사이의 상호작용(interaction)을 담당하며, 실행되기를 원하는 프로그램의 이름을 서버가 제공하는 데이타로부터 뽑아내고, 임시 파일에 환경 데이타(environment data)를 모두 모은다. 그리고 명령어 줄에 덧붙여진 환경 정보 파일의 이름과 커멘드 라인에 덧붙여진 파일 이름을 가지고 프로자바 런타임 인터프리터를 실행시킨다. Java.cgi 스크립트는 "여러분의 지역 패스(Local Path)에 관한 방침을 정하라 "에서 구성되었고(configured) 인스톨되었다. 4.2.2. HTML form으로 부터 java.cgi 호출하기 Java CGI 프로그램을 사용하는 저자의 폼은 다음과 같이 form action을 명시한다.
/cgi-bin/ 은 여러분의 CGI 바이너리 디렉토리이며, java.cgi는 웹상에서 자바 프로그램을 실행시키게 해주는 자바 front-end 이며, CGI_Test는 실행시킬 자바 프로그램의 이름 중 한 예제이다. 5. Java CGI클래스들 사용하기 현재로써는 "CGI" , "Email" , "HTML" 이라는 세 개의 메인 클래스가 제공된다. 본인은 MIME형태의 입출력을 다루는 각각 MIMEin 과 MIMEout 이라는 클래스를 추가 할 생각 중이다. 지원용(support) 클래스와 테스트 클래스도 몇 개 있다. " CGI_Test" , "Email_Test" , "HTML_Test"는 인스톨을 테스트하기 위한 것이다. 이 클래스는 이 클래스 라이브러리는 사용하는 자바 프로그램에게 시작점(starting- point)처럼 사용될 것이다. "Text" 클래스는 Email 과 HTML클래스의 수퍼클래스이다. 5.1. CGI 5.1.1. 클래스 문법 public class CGI 5.1.2. 클래스 설명 CGI 클래스는 "CGI 정보" (웹 서버가 정한 환경 변수들과 submit 동작이 선택되었을 때 form으로부터 보낸 name/value)를 가진다. 모든 정보는 Properties 클래스 개체에 저장된다. 이 클래스는 "Orbits.net" 패키지에 들어있다. 5.1.3. 멤버 요약 -------------------------------------------------------------------------- CGI( ) // 생성자. getNames( ) // 이름들의 리스트를 얻는다. GetValue( ) // 이름을 명시함으로써 form의 value를 얻는다. -------------------------------------------------------------------------- 5.1.4. 참조 CGI_Test 5.1.5. CGI( ) 목적 사용 가능한 CGI 테이타를 가진 개체를 생성(construct)한다. 문법 public CGI ( ) 설명 CGI 개체가 생성 되었을 때, 모든 사용 가능한 CGI정보가 그 개체에 대해 local 인 storage로 보내진다. 5.1.6. getNames() 목적 해당하는 value를 갖도록 정의된 name들을 리스트 한다. 문법 public Enumeration getKeys () 설명 해당하는 value가 정의된 name의 전체 리스트를 제공한다. 리턴값 정의된 모든 이름의 Enumeration형 5.1.7. getValue() 목적 이름이 명시된 value를 취한다. 문법 public String getValue ( String name ) 설명 HTML form으로부터 보내진 name과 value중 대응하는 것을 리턴함. 파라메터 name value를 선택하는 키 리턴값 value를 담고있는 문자열(String) 5.2. CGI_Test 이 클래스에는 CGI클래스를 어떻게 사용하는지에 관한 예제와 Java CGI 패키지가 정확하게 동작하는지 확인하는데 사용되는 테스트 프로그램이 들어 있다. 5.2.1. 멤버 요약 -------------------------------------------------------------------------- main() // 프로그램 main() -------------------------------------------------------------------------- 5.2.2. 참조 CGI. 5.2.3. main ( ) 목적 main() 메소드를 제공한다. 문법 public static void main( String argv[] ) 설명 사용 가능한 name/value 쌍의 리스트와 현재 그 쌍의 값을 리턴하는 CGI 프로그램에 대한 엔트리 포인트이다. 파라메터 argv[] java.cgi 스크립트에 의해 프로그램에 전달되는 인자들. 현재 사용 안함. 5.3. Email 5.3.1. 클래스 문법 public class Email extends Text 5.3.2. 클래스 설명 메시지는 Text클래스의 add* () 메소드와 이 클래스에 의해 추가된 e-mail 관련(e-mail-specific) 메소드로 만들어진다. 다 마치면, 메시지는 목적지로 보내진다. 이 클래스는 "Orbits.net"패키지에 들어있다. 5.3.3. 멤버 요약 -------------------------------------------------------------------------- Email() // 생성자 send() // e-mail 메시지를 보낸다. sendTo() // 메시지에 목적지를 추가한다. Subject() // 메시지에 주제(Subject: )를 정한다. --------------------------------------------------------------------------- 5.3.4. 참조 Email_Test, Text. 5.3.5. Email () 목적 email 메시지를 가질 개체를 생성한다. 문법 public Email() 설명 Email 메소드로써 완성 될 빈 메시지를 셋업한다. 참조 Text. 5.3.6. send() 목적 e-mail 메시지를 보낸다. 문법 public void send () 설명 메시지를 정형화(format)하고 보낸다. 목적지가 정해지지 않았으면, 아무 일도 하지 않는다. 5.3.7. sendTo() 목적 메시지에 목적지를 추가한다. 문법 public String sendTo ( String address ) 설명 이 메소드의 목적지 리스트에 주소(address)를 추가한다. e-mail 메시지가 가질 수 있는 목적지의 수에는 정해진 한계가 없다. 리스트의 크기를 충분히 크게 만든다면(build up), Mail Transport Agent 가 받아들일 수 있거나 메모리를 사용할 수 있는 파라메터 리스트의 사이즈를 초과할 수 있다. 파라메터 address 이 메시지를 보낼 목적지 5.3.8. subject() 목적 이 메시지의 주제를 정한다. 문법 public void subject ( Sting subject ) 설명 e-mail의 Subject: 줄의 텍스트를 정한다. 만약 한번 이상 call되면, 맨 마지막의 subject가 사용된다. 파라메터 subject 이 메시지의 주제( Subject: )줄의 텍스트 5.4. Email_Test 이 클래스는 Email 클래스를 어떻게 사용하는지에 관한 예제와 Java CGI 패키지가 정확하게 동작하는지 확인하는데 사용되는 테스트 프로그램 예제가 들어있다. 5.4.1. 멤버 요약 -------------------------------------------------------------------------- main() // 프로그램 main() -------------------------------------------------------------------------- 5.4.2. 참조 Email . 5.4.3. main() 목적 main() 메소드를 제공한다. 문법 public static void main( String argv[] ) 설명 사용 가능한 name/value 쌍과 현재 그 쌍의 값을 리턴하는 CGI 프로그램에 대한 엔트리 포인트이다. Email 변수에 명시된 주소(address)에도 이 리스트를 보낸다. 파라메터 argv[] java.cgi 스크립트에 의해 프로그램에 전달되는 인자들. 현재 사용 안함. 5.5. HTML 5.5.1. 클래스 문법 public class HTML extends Text 5.5.2. 클래스 설명 메시지는 Text클래스의 add* () 메소드와 HTML관련(HTML-specific) 메소드로 만들어진다. 완성되면, 메시지는 목적지로 보내진다. 현재, 리스트를 만드는 메소드들이 정확한 순서로 사용되었는지 확신할 에러 체킹을 하지 않아서, 프로그래머가HTML문법을 어기지 않도록 주의해야 한다. 이 클래스는 "Orbits.net"패키지에 들어있다. 5.5.3. 멤버 요약 -------------------------------------------------------------------------- HTML() // 생성자. author() // 저자의 이름을 정한다. definitionList() // 정의 리스트를 시작한다. definitionListTerm() // 정의 리스트에 항목(term)을 추가한다. endList() // 리스트를 끝낸다. listItem() // 리스트에 엔트리를 추가한다. send() // HTML메시지를 보낸다. title() // 문서 제목으로 쓸 텍스트를 정한다. --------------------------------------------------------------------------- 5.5.4. 참조 HTML_Test, Text . 5.5.5. HTML() 목적 HTML메시지를 담을 개체를 생성한다. 문법 public HTML() 설명 HTML 메소드가 완성시킬 빈 메시지를 셋업한다. 참조 Text . 5.5.6. author() 목적 저자의 이름을 정한다. 문법 public void author ( String author ) 설명 author로 저자의 이름을 정한다. 파라메터 author 메시지의 저자이름으로 사용할 텍스트 참조 title() . 5.5.7. definitionList() 목적 정의(definition) 리스트를 시작한다. 문법 public void definitionList() 설명 정의 리스트를 시작한다. 정의 리스트는 리스트 안의 각각의 엔트리가 그 항목(term)의 정의 텍스트(definition text) 다음에 나오는 항목인 리스트이다. 정의 리스트의 시작은 (최소한) 하나의 term/text 쌍을 생성한 이후, 그리고 endList() 메소드가 한번 call된 이후 이어야 한다. 현재, 리스트는 nest 될 수 없다는 것을 주목하라. 참조 definitionListTerm(), endList(), listItem() . 5.5.8. definitionListTerm() 목적 정의 리스트에 목록을 추가한다. 문법 public void definitionListTerm() 설명 정의 리스트에 항목(term)을 추가한다. 현재 리스트 엔트리의 항목부분의 텍스트는 이 메소드가 call된 다음에 그리고 해당되는 listItem메소드가 call 되기 전에 메시지에 덧붙여져야(appended) 한다. 참조 definitionList(), listItem(). 5.5.9. endList() 목적 리스트를 끝낸다. 문법 public void endList() 설명 리스트를 끝낸다. 이 메소드는 리스트를 맺는다(close out). 현재 리스트는 nest 될 수 없음을 주목하라. 참조 definitionList() 5.5.10. listItem() 목적 리스트에 엔트리를 추가한다. 문법 public void listItem() public void listItem(String item) public void listItem(String term, String item) 설명 리스트에 엔트리를 추가한다. 만약 첫번째를 사용한다면 현재 리스트 아이템의 텍스트는, 이 메소드가 call된 다음에 그리고 다른 리스트 메소드가 call되기 전에 메시지에 붙여져야 한다. 두번째와 세번째에서, 아이템 텍스트는 이 메시지에 덧붙여지는 대신에(혹은 추가로) 메소드의 파라메터로써 명시된다.세번째는 정의 리스트에 specific하고, term과 리스트 엔트리의 정의를 제공한다. 파라메터 item 리스트 엔트리의 텍스트 term 정의 리스트 엔트리의 항목(term) 부분의 텍스트 참조 definitionList(), definitionListTerm(), endList(). 5.5.11. send() 목적 HTML메시지를 보낸다. 문법 public void send() 설명 HTML 메시지를 보낸다. 5.5.12. title() 목적 문서의 제목을 위한 텍스트를 정한다. 문법 public void title ( String title ) 설명 문서의 제목을 위한 텍스트를 정한다. 파라메터 title 이 메시지 제목의 텍스트. 참조 author(). 5.6. HTML_Test 이 클래스에는 CGI클래스를 어떻게 사용하는지에 관한 예제와 Java CGI 패키지가 정확하게 동작하는지를 확인하는데 사용되는 테스트 프로그램이 들어있다. 5.6.1. 멤버 요약 --------------------------------------------------------------------- main() // 프로그램 main(). --------------------------------------------------------------------- 5.6.2. 참조 HTML. 5.6.3. main() 목적 main() 메소드를 제공한다. 문법 public static void main( String argv[] ) 설명 HTML문서에서 정의 리스트 원소에서 각각의 name/value의 쌍이 보여지며 사용 가능한 name/value의 쌍의 리스트를 리턴하는 CGI프로그램에 대한 엔트리 포인트이다. 파라메터 argv[] java.cgi 스크립트에 의해 프로그램에 전달되는 인자들. 현재 사용 안함. 5.7. Text 5.7.1. 클래스 문법 public abstract class Text 5.7.2. 클래스 설명 이 클래스는 Email 과 HTML 클래스의 수퍼클래스이다. 메시지는 이 클래스 안의 메소드에 의해 만들어지고 서브클래스의 메소드로써 완성되며(completed) 정형화(formatted)된다. 이 클래스는 "Orbits.text"패키지 안에 들어있다. 5.7.3. 멤버 요약 --------------------------------------------------------------------- Text() // 생성자. add() // 이 개체에 텍스트를 추가한다. addLineBreak() // 계행(line break)을 추가한다. addParagraph() // 문단계행(paragraph break)을 추가한다. ---------------------------------------------------------------------- 5.7.4. 참조 Email, HTML. 5.7.5. add() 목적 이 아이템에 텍스트를 추가한다. 문법 public void add ( char addtion ) public void add ( char addtion ) public void add ( StringBuffer addition ) 설명 이 텍스트 아이템의 내용에 addtion을 추가한다. 파라메터 addtion 텍스트 아이템에 추가될 텍스트. 참조 addLineBreak() , addParagraph(). 5.7.6. addLineBreak() 목적 텍스트의 이 지점에서 계행시킨다. 문법 public void addLineBreak () 설명 이 지점에서 텍스트에 계행을 한다. 참조 add() , addParagraph(). 5.7.7. addParagraph() 목적 새 문단을 시작한다. 문법 public void add () 설명 텍스트의 이 지점에 새 문단을 시작한다. 참조 add() , addLineBreak(). 6. 향후 계획 * Email 클래스에 추가할 것: Email ( int capacity ) 메시지가 할당되기 위해서 얼마나 많은 공간이 필요한지 알고 있을 때 사용. SendTo( String address ) e-mail메시지에 주 목적지(primary destinations) 리스트를 추가한다. SendCc ( String address ) e-mail 메시지에 Carbon-Copy 목적지를 추가한다. SendCc ( String address ) e-mail 메시지에 Carbon-Copy 목적지의 리스트를 추가한다. sendBcc( String address ) e-mail 메시지에 Blind Carbon-Copy 목적지의 리스트를 추가한다. * HTML 클래스에 추가할 것: HTML( int capacity ) 메시지가 할당되기 위해서 얼마나 많은 공간이 필요한지 알 때 사용. public void unorderedList() 정렬되지 않은 리스트를 시작한다. public void orderedList() 정렬된 리스트를 시작한다. public void directoryList() 디렉토리 리스트를 시작한다. public void manuList() 메뉴 리스트를 시작한다. void anchor (String anchorName ) anchor를 명시한다. void link (String url, String text) link를 명시한다. void applet(String url, String altText) 애플릿 link를 명시한다. * HTML 리스트가 nest되게 한다. * HTML 리스트 formatting코드의 올바른 정렬을 수행할 에러 체킹 코드를 추가한다. * Makefile에서 환경 데이타 파일의 위치를 조정(configurable)할 수 있게 한다. * 데이타 전송인 GET메소드를 사용할 때 리스트에서 나타나는 빈 name/value 쌍을 없앤다. * 계속해서 변수 이름을 제공할 ajva.util.Enumeration interface의 CGI로의 구현을 생각중. * 이 패키지에 있는 모든 메소드를 사용하는, Test 클래스를 추가한다. * 디버깅 목적으로 점진적인 테스트를 하기 위해 CGI_Test,Email_Test, HTML_Test 서로가 어떻게 build 되는지 문서화한다. * 어떻게 Test가 이 패키지에서 가능한 모든 기능을 이용하는지 문서화한다. 7. 변화 7.1. 버전 0.3 과 0.4 간의 변화 * 최소한의 기능을 제공하는 HTML 클래스의 골자 배포. * HTML_Test 클래스와 javahtmltest.html-dist 작성. * 정의 리스트를 다루기 위한 HTML 메소드를 추가. 7.2. 버전 0.2 와 0.3 간의 변화 * Text 와 Email 클래스를 추가. HTML 클래스도 추가되었으나, 이 시기에는 시작 정도 였음. * 패키지에 다양한 클래스를 넣음. 주된 클래스는 Orbits.net.*안에 있음, 지원(support) 클래스 Text는 Orbits.text.Text안에 있음. * CGItest 가 CGI_Test 로 바뀜. * Email_Test클래스 추가. 7.3. 버전 0.1 과 0.2 간의 변화 * 환경변수를 자바 인터프리터의 커멘드 라인 안에 넣는 대신에 임시 파일에 놓임. CGI 클래스와 java.cgi가 변했음. * Javacgitest.html 문서가 배포판에 포함됨. * 인스톨 과정의 make에 의해 수정된 텍스트 파일에 -dist로 끝나는 이름을 붙임.