Some small editorialization on the protocol documentation for GSSAPI/SSPI
authorTom Lane <tgl@sss.pgh.pa.us>
Fri, 8 Feb 2008 18:18:05 +0000 (18:18 +0000)
committerTom Lane <tgl@sss.pgh.pa.us>
Fri, 8 Feb 2008 18:18:05 +0000 (18:18 +0000)
authentication.

doc/src/sgml/protocol.sgml

index c26cccc45fd1982620efb72f087918e95e70130d..14b5e9ac199beb76e125637fa2faad010a4f3aef 100644 (file)
     For all authentication methods except GSSAPI and SSPI, there is at most
     one request and one response. In some methods, no response
     at all is needed from the frontend, and so no authentication request
-    occurs. For GSSAPI and SSPI, multiple iterations of packets may be needed to 
-    complete the authentication.
+    occurs. For GSSAPI and SSPI, multiple exchanges of packets may be needed
+    to complete the authentication.
    </para>
 
    <para>
         or a previous AuthenticationGSSContinue). If the GSSAPI 
         or SSPI data in this message
         indicates more data is needed to complete the authentication,
-        the frontend must send this data as another PasswordMessage. If
-        GSSAPI authentication is completed by this message, the server
-        will also send AuthenticationOk to indicate successful authentication
+        the frontend must send that data as another PasswordMessage. If
+        GSSAPI or SSPI authentication is completed by this message, the server
+        will next send AuthenticationOk to indicate successful authentication
         or ErrorResponse to indicate failure.
        </para>
       </listitem>
@@ -1808,7 +1808,7 @@ AuthenticationGSSContinue (B)
 </term>
 <listitem>
 <para>
-                Specifies that this message contains GSSAPI data.
+                Specifies that this message contains GSSAPI or SSPI data.
 </para>
 </listitem>
 </varlistentry>
@@ -3514,7 +3514,10 @@ PasswordMessage (F)
 <listitem>
 <para>
                 Identifies the message as a password response. Note that
-                this is also used by GSSAPI response messages.
+                this is also used for GSSAPI and SSPI response messages
+                (which is really a design error, since the contained data
+                is not a null-terminated string in that case, but can be
+                arbitrary binary data).
 </para>
 </listitem>
 </varlistentry>