rfc-ko

RFC 8174: RFC 2119 키워드의 대문자와 소문자 사이의 모호함 (한국어 번역)

역주: 이 문서의 핵심은 2절 “새 문구”에 들어 있는 고정 문구로, 이후의 RFC 대부분이 앞부분에 이 문구를 인용한다. 문서 안에서 키워드의 이름을 가리킬 때는 원어를 그대로 두었다.


요약

RFC 2119는 프로토콜 명세에서 쓸 수 있는 공통 키워드를 규정한다. 이 문서는 키워드가 대문자로 쓰였을 때에만 정의된 특별한 의미를 갖는다는 점을 분명히 해서 모호함을 줄이고자 한다.

이 메모의 상태

이 메모는 인터넷 현행 모범 관행(Best Current Practice)을 기록한다.

이 문서는 IETF(Internet Engineering Task Force)의 결과물이며 IETF 커뮤니티의 합의를 나타낸다. 이 문서는 공개 검토를 거쳤고 IESG(Internet Engineering Steering Group)의 발행 승인을 받았다. BCP에 대한 자세한 정보는 RFC 7841의 2절에 있다.

이 문서의 현재 상태, 정오표, 의견을 보내는 방법은 http://www.rfc-editor.org/info/rfc8174 에서 확인할 수 있다.

저작권 고지

Copyright (c) 2017 IETF Trust and the persons identified as the document authors. All rights reserved.

This document is subject to BCP 78 and the IETF Trust’s Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.

Copyright (c) 2017 IETF Trust 및 문서 저자로 명시된 사람들. 모든 권리 보유.

이 문서에는 BCP 78과, 이 문서의 발행일에 유효한 IETF 문서 관련 IETF Trust 법적 조항(http://trustee.ietf.org/license-info)이 적용된다. 이 문서들은 이 문서에 대한 독자의 권리와 제한을 설명하므로 주의 깊게 검토하기 바란다. 이 문서에서 추출한 코드 구성 요소(Code Components)에는 Trust 법적 조항 4.e절에 설명된 Simplified BSD License 문구를 포함해야 하며, 이 코드 구성 요소는 Simplified BSD License에 설명된 대로 보증 없이 제공된다.

역주: 원문이 따르는 IETF Trust 법적 조항에 따라 원문의 Copyright Notice를 그대로 두고 그 아래에 한국어 번역을 덧붙였으며, 법적 효력은 원문에 있다.

목차

  1. 소개
  2. 키워드의 대문자 사용 명확화
  3. IANA 고려 사항
  4. 보안 고려 사항
  5. 규범 참고 문헌
    • 저자 주소
    • 번역자

1. 소개

RFC 2119는 프로토콜 명세에서 쓸 수 있는 “MUST”, “SHOULD”, “MAY” 같은 공통 키워드를 규정한다. RFC 2119는 이 키워드들이 “흔히 대문자로 쓴다(are often capitalized)”고 말하는데, 이 때문에 “must”, “should”처럼 대문자로 쓰지 않은 단어를 어떻게 해석해야 하는지 혼란이 생겼다.

이 문서는 키워드가 대문자로 쓰였을 때에만 정의된 특별한 의미를 갖는다는 점을 분명히 하여 RFC 2119를 갱신한다. 이 문서는 BCP 14의 일부다.

2. 키워드의 대문자 사용 명확화

[RFC2119]를 다음과 같이 변경한다.

이전 문구 (=== OLD ===)

많은 표준화 트랙(standards track) 문서에서는 명세의 요구 사항을 나타내기 위해 여러 단어를 사용한다. 이 단어들은 흔히 대문자로 쓴다. 이 문서는 IETF 문서에서 이 단어들을 어떻게 해석해야 하는지 정의한다. 이 지침을 따르는 저자는 문서 앞부분에 다음 문구를 넣는 것이 좋다.

이 문서의 키워드 “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, “OPTIONAL”은 RFC 2119에 설명된 대로 해석한다.

새 문구 (=== NEW ===)

많은 IETF 문서에서는 아래와 같이 모두 대문자로 쓴 여러 단어를 사용해 명세의 요구 사항을 나타낸다. 이 대문자 단어들은 의미가 잘 정의되어 있으므로 문서를 훨씬 명확하고 일관되게 만들어 줄 수 있다. 이 문서는 이 단어들이 모두 대문자로 쓰였을 때 IETF 문서에서 어떻게 해석되는지 정의한다.

이 지침을 따르는 저자는 문서 앞부분에 다음 문구를 넣는 것이 좋다.

이 문서의 키워드 “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, “OPTIONAL”은 여기에 보인 것처럼 모두 대문자로 쓰였을 때, 그리고 그때에만 BCP 14 [RFC2119] [RFC8174]에 설명된 대로 해석한다.

(=== END ===)

역주: 새 문구의 고정 문구에는 RFC 2119 원문에서 빠져 있던 “NOT RECOMMENDED”가 들어가 있다(RFC 2119 정오표 499와 같은 내용).

3. IANA 고려 사항

이 문서는 IANA의 조치를 필요로 하지 않는다.

4. 보안 고려 사항

이 문서는 순전히 절차에 관한 것이므로 관련된 보안 고려 사항이 없다.

5. 규범 참고 문헌

[RFC2119] Bradner, S., “Key words for use in RFCs to Indicate Requirement Levels”, BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, http://www.rfc-editor.org/info/rfc2119.

저자 주소

Barry Leiba
Huawei Technologies

Phone: +1 646 827 0648
Email: barryleiba@computer.org
URI:   http://internetmessagingtechnology.org/

역주: 저자 주소와 URL은 2017년 발행 당시의 정보를 원문 그대로 옮긴 것이다(정오표 6878 참고).

번역자

김마리 (Mariel Kim)
Email:  marikim.code@gmail.com
GitHub: https://github.com/marik0de