IETF I D 작성및등록방법 (2009 년 8 월 ) 경북대학교통신프로토콜연구실 박재완 (jwparkinf8@gmail.com) 요약 Internet Draft 문서는 working group 또는개인이연구를진행하며 IETF를통해발행하는문서중하나이다. 등록이후 6개월 (185일) 간의유효기간을가지며, 그기간동안업데이트가이루어지지않으면폐기된다. 문서를 IETF에 draft 문서로써등록하기위해서는 guideline에맞추어작성및제출되어야한다. 본문서에서는, IETF에서 Draft 문서작성을위한 Template에대한소개에서부터, 제출하는과정에대하여간략하게기술하고있다. 목 차 1. 서론... 2 2. 문서작성하기... 2 2.1 WORD TEMPLATE DOWNLOAD... 2 2.2 DRAFT GUIDELINE... 4 2.2.1 General Considerations... 4 2.2.2 Formatting and Naming... 4 2.2.3 Using the template... 5 3. SUBMISSION... 5 3.1 TEXT FILE 로출력... 5 3.2 PLAIN TEXT 파일로변환및제출... 7 4. 결론... 9 참고문헌... 9 1
1. 서론 Internet Draft 문서는 IETF를통해발행되는문서중하나로, 등록이후 6개월 (185일) 간의업데이트를해주지않으면폐기된다. Draft 문서작성자는, working group으로써, 또는 individual로써의자격으로 draft를제출할수있다. 문서를 IETF에 draft 문서로써등록하기위해서는 guideline(http://www.ietf.org/id info/guidelines.html) 에맞추어작성및제출되어야한다. 본문서에서는, IETF에서 Draft 문서작성을도와주기위하여제공되는 Template에대한소개에서부터작성 Tips, 그리고 draft 문서를 IETF에제출하는과정에대하여기술하도록한다. 2. 문서작성하기 2.1 Word Template Download 본문서에서사용한 Word Template 1 최신버전은 http://www.isi.edu/touch/tools/ 에서제공하고있다. 하단의화면의링크들중에서 The template itself를클릭하여.dot 파일을얻을수있다. 기존의 template을사용하여작성된문서의경우 IPR(Intellectual Property rights) 에관한몇가지변경기준을적용하기위하여최신 boilerplate 2 를사용하여업데이트해주어야한다. 그림 1. Template 다운로드 1 본문서에서사용한문서는 2-Word-v.2.0.template.dot 이다. 2 Template 에포함된여러공적문구들을의미한다. ( 지적재산권이나저작권관련한문구등 ) 2
이파일을바로사용하는것이아니라, word 97 2003 형식으로바꾸어야사용하여야한다. 2007 포맷으로변환할경우, 문서틀의깨짐에관한경고문구를출력한다. (Template 문서가이전기준으로작성되었기때문 ) 따라서, word 최신버전이아닌, 이전버전으로변환을권장한다. 그림 2. Word 97 2003 으로저장 그림 3. Word 2007 format 으로저장시 warning 위와같이저장을하고문서를다시열면, 시간관련 ( 작성일자및만기일자 ) 에관한부분은손대지않아도된다. Template에서파일의저장날짜를기준으로하여자동으로수정이된다. 3
2.2 Draft guideline 2.2.1 General Considerations Draft 작성시에는고려해야할몇가지규칙이있으며, IETF에서는그에관한 guideline을문서로제공하고있다. http://www.ietf.org/id info/guidelines.html을참조하면, 좀더자세한내용을확인할수있다. 대부분은 Template 자체에적용되어있으므로, 제출시에고려할사항은적은편이다. guideline에따르면 draft 왼쪽상단은 INTERNET DRAFT 문구가반드시있어야한다. 이부분은 template에적용되어있지않으므로, 만약제출시에러메시지를보인다면, 직접수정하여제출하면된다. 또한, Draft 문서의 title은문서의진행상태를나타내는용어를사용하는것을피해야한다. 특히다음과같은용어 (Standard, Proposed, Draft, Experimental, Historic, Required, Recommended, Elective, or Restricted) 는피해서작성되어야한다. 2.2.2 Formatting and Naming 각각의 I D 들은 abstract section을포함하고있어야한다. 친절하게도, template을보면작성해야하는영역을표시하고있다. Abstract는일반적으로 5 10줄가량의내용으로써, 문서의내용을잘요약한문장으로이루어져야한다. 그러나만약, 그내용이 3 lines 보다적거나 20 lines를초과하면, 그 I D는 accept되지않는다. 또한, Abstract에서는기본적인용어에대한내용 ( 예를들면, IP, TCP 와같은 ) 을다시설명하지않는것이낫다. I D는 Author에대한이름과연락처등과같은정보를포함해야한다. ( 본문서에서소개하는 template에서는문서의끝에항목이있으므로양식에맞춰기입하면된다.) 또한, I D 문서가 15 page를초과하는경우참조하기쉽도록목차를만드는것을권장한다. Template의지시에만따르면 guideline에대한대부분의내용들은준수하도록되어있다. I D 문서의 naming은몇가지구성으로이루어지는데각각의정보들은하이픈 으로구분하여표기하며, 다음과같은규칙에의해서이루어진다. 1. 모든 draft 문서는 file이름이 draft 로시작한다. 2. 다음은 working group이나개인제출자의경우, 저자들중한명의이름으로구성된다. 3. Document name으로, 무엇에대한 draft인지한, 두단어로요약해서적는다. 4. 나머지두개의십진수로 version을표기한다. 처음제출일경우 00으로시작한다. Ex) 완성된 file name을예로들면, draft jwp xxxx 00.txt와같은형태이다. xxxx는문서의내용을함축하는단어또는약어. 4
2.2.3 Using the template 일단 template를다운받으면, 각각항목들에대하여 instruction들로써설명이잘되어있기때문에, 작성하는데큰어려움이없는편이다. 각기 color는문구의활용여부를나타낸다. 문구의 background color에따라다음과같이활용된다. red인문장은단순 information 제공을위한문장으로, 삭제해도무방 green의경우 info를참고하여사용여부를판단할필요있음 blue는필수적인문장을의미한다. ex) blue인 copyright관련문장은반드시삽입되어있어야한다는것을의미 Yellow는 author가직접수정해야하는항목을의미 그림 4. Template 구성 3. Submission 3.1 Text file로출력 IETF 홈페이지를통해작성된파일을제출하기위해서는, word 파일자체를올리는것이아니라, plain text 형태의파일로제출해야한다. 따라서, 다음과같은방법을통해텍스트파일로출력한후, 생성된.prn 파일을변환한뒤 IETF 홈페이지에서 submission tool을사용하여제출한다. word에서텍스트파일로우선인쇄를하기위해는기존에설치되어있는프린터를이해서파일로출력하기를사용하는것이아니라, 아래그림과같은사전준비가필요하다. Windows Vista를기준으로 (XP또한차이가거의없다.) 제어판 > 프린터 > 프린터추가그리고로컬프린터추가까지클릭을완료하면다음그림과같은화면을볼수있다. 5
그림 5. 프린터포트추가화면 위그림과같은창에서일반적인프린터포트를지정하는것이아니라, 파일로인쇄하는탭을선택한다. 선택후다음을클릭하면, 제조업체및프린터를선택하는창을확인할수있다. 그림 6. 제조업체및프린터선택 정상적으로파일을인쇄하기위해서는위그림과같은창을확인한후에, 제조업체는 Generic을우선선택하고, 프린터목록에서 Generic / Text Only라는항목을선택한후다음을눌러설치를완료면, 텍스트파일로인쇄하기위한준비를끝마쳤다. 6
3.2 Plain text 파일로변환및제출 그림 7. 인쇄할프린터선택 위그림에서프린터이름이일반프린터가아니라 Generic / Text Only로표기된것을확인할수있다. 위와같이선택한후, 확인을누르면.prn 파일로인쇄하는창이뜨고, 위의 guideline 규칙에따라작성한이름으로저장하면텍스트문서로저장이완료된다. 그러나여기서끝이아니라, plain text 파일로변환 3 해주어야하는데, perl을설치해야하는등의까다로움이있으므로, template를다운받은페이지에서그변환서비스를제공하고있다. 그림 8. prn 파일을 plain text 파일로변환 위에서볼수있는것처럼.prn 파일을가지고 submit 하면 txt 파일을다운받을수있다. 3 이과정을 post-processing이라한다. Perl로짜여진코드를내려받아서직접변환하거나, 홈페이지에서그기능을제공받아변환하면된다. 7
이렇게해서얻어진 txt 파일을아래사이트에서제출하면된다. 그림 9. Draft Submission Tool 제출시에문서의규정에맞는지여부를체크하여에러를출력할수도있는데, 그때는에러메시지를참고하여수정하면된다. 이때는제출을하지말고, 하단에생기는 cancel 버튼을눌러취소하면 draft가등록되지않는다. 또한, 이렇게제출하는시도를여러번하여일정횟수 (20번) 을초과하면, DoS를위한메커니즘동작에의해, 동일 I D에대한제출이하루동안금지된다. 따라서, 이때는시간을두고등록을하도록한다. 8
4. 결론본문서에서는, Draft를제출하기위해서어떤절차가있고지켜야할사항들이있는지를살펴보았다. 그리고그형식에맞추기위하여제공되는 word template을어떻게사용하는지에대해서소개하고있으며, text 파일로변환후 IETF에등록하는과정까지를간략하게소개하고있다. 연구에진척을거듭해갈수록, I D 문서로등록하는일이빈번하게일어날것으로생각되기때문에, draft 문서작성및제출방법에대한일정한수준의숙지가필요하다고생각된다. 참고문헌 [1] IETF, http://www.ietf.org/ [2] IETF guideline, http://www.ietf.org/id info/guidelines.html [3] IETF license info, http://trustee.ietf.org/license info 9