Re: [kitten] Fwd: [Editorial Errata Reported] RFC2743 (3797)

[[e-mail] (Martin Rex)]

Stephen Farrell wrote:
> 
> FYI, comments welcome, if any. I assume this should
> be approved.
 
> http://www.rfc-editor.org/errata_search.php?rfc=2743&eid=3797
> Type: Editorial
> Reported by: Benjamin Kaduk <[e-mail]>
> 
> Section: 2.4.5  GSS_Import_name
>
>  [compressed summary of the change]
>
> -    o  GSS_S_COMPLETE indicates that a valid name representation is
> -    output in output_name and described by the type value in
> -    output_name_type.
>
> +    o  GSS_S_COMPLETE indicates that a valid name representation is
> +    output in output_name.

I agree that the reference to the non-existing parameter output_name_type
is a defect in the description for the GSS_S_COMPLETE result of
GSS_Import_name.


I'm slighlty confused by the expression "valid name representation is output".
Admittedly, the descriptions of GSS_S_COMPLETE for the two calls
GSS_Inquire_cred and GSS_Inquire_cred_by_mech also employ "represents":
"the output cred_name .. represents .. the credentials's associated principal
name"
whereas other calls (GSS_Accept_sec_context, GSS_Inquire_context,
GSS_Canonicalize_name, GSS_Duplicate_name) use expressions like
"returns src_name", "src_name is valid" or
"returns another reference (dest_name)" 

How about:

   o  GSS_S_COMPLETE indicates that input_name_string was converted
   to an internal name and returned as output_name


-Martin