Re: [media-types] sslkeylogfile review request

[Martin Thomson <[e-mail]>]

Thanks Martin.  I'll make the suggested changes.

https://github.com/tlswg/sslkeylogfile/pull/12 includes those.

On Tue, Apr 16, 2024, at 15:36, Martin J. Dürst wrote:
> Hello Martin,
>
> A few comments below.
>
> On 2024-04-15 13:19, Martin Thomson wrote:
>> Hi Paul,
>> 
>> Type name:
>>      application
>> Subtype name:
>>      sslkeylogfile
>> Required parameters:
>>      N/A
>> Optional parameters:
>>      N/A
>> Encoding considerations:
>>      8bit (Unicode without BOM or ASCII only)
>
> This would be slightly easier to read if it were
> "UTF-8 without BOM, or ASCII only".
>
> The change from Unicode to UTF-8 (I hope that's what's intended) is 
> important because both UTF-8 and UTF-16 (and UTF-32) can use a BOM.
>
> Without the comma, it's syntactically possible to read this as
> "UTF-8 without (BOM or ASCII) only", and one has to engage the semantic 
> level to guess that it should be read as "(UTF-8 without BOM) or (ASCII 
> only)".
>
>> Security considerations:
>>      See Section 3.
>> Interoperability considerations:
>>      Line endings might differ from platform convention
>> Published specification:
>>      This document
>
> Please change that to something like "RFC XXXX" with a note to the RFC 
> Editor to change this to the actual number on publication. This makes 
> sure the registration template can stand on its own.
>
>> Applications that use this media type:
>>      Diagnostic and analysis tools that need to decrypt data that is otherwise protected by TLS.
>> Fragment identifier considerations:
>>      N/A
>> Additional information:
>>      Deprecated alias names for this type:
>>          N/A
>>     Magic number(s):
>>         N/A
>>     File extension(s):
>>         N/A
>>     Macintosh file type code(s):
>>         N/A
>> Person & email address to contact for further information:
>>      See the Authors' Addresses section.
>
> Again, please replace this with the actual information so that the 
> registration template can stand on its own.
>
>> Intended usage:
>>      COMMON
>> Restrictions on usage:
>>      N/A
>> Author:
>>      See the Authors' Addresses section.
>
> Same here.
>
> Regards,   Martin.
>
>> Change controller:
>>      IESG
>> 
>> On Sun, Apr 14, 2024, at 20:58, Paul Libbrecht wrote:
>>> Hey Martin,
>>>
>>> Please provide the complete registration text in the mailing-list so
>>> the object of discussion is unambiguous.
>>>
>>> Thanks in advance.
>>>
>>> Paul
>>>
>>> On 14 Apr 2024, at 12:14, Martin Thomson wrote:
>>>
>>>> SSLKEYLOGFILE is a text file format used in diagnosing TLS connections.
>>>>
>>>> https://datatracker.ietf.org/doc/html/draft-ietf-tls-keylogfile-01#name-iana-considerations
>>>>
>>>> Any feedback on the registration?
>>>>
>>>> media-types mailing list
>>>> [e-mail]
>>>> https://www.ietf.org/mailman/listinfo/media-types
>>>>
>> 
>> _______________________________________________
>> media-types mailing list
>> [e-mail]
>> https://www.ietf.org/mailman/listinfo/media-types