[newlib-cygwin] Cygwin: cygheap: better comment impersonation tokens

[newlib-cygwin] Cygwin: cygheap: better comment impersonation tokens

[Corinna Vinschen]

https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=9db6048c0fe7c35586f762ee2cdc1d0f92a041ea

commit 9db6048c0fe7c35586f762ee2cdc1d0f92a041ea
Author: Corinna Vinschen <corinna@vinschen.de>
Date:   Sat Feb 23 17:28:12 2019 +0100

    Cygwin: cygheap: better comment impersonation tokens
    
    Signed-off-by: Corinna Vinschen <corinna@vinschen.de>

Diff:
---
 winsup/cygwin/cygheap.h | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/winsup/cygwin/cygheap.h b/winsup/cygwin/cygheap.h
index be088b2..99d2e53 100644
--- a/winsup/cygwin/cygheap.h
+++ b/winsup/cygwin/cygheap.h
@@ -101,12 +101,11 @@ public:
   gid_t real_gid;       /* Ditto */
   user_groups groups;   /* Primary and supp SIDs */
 
-  /* token is needed if set(e)uid should be called. It can be set by a call
-     to `set_impersonation_token()'. */
-  HANDLE external_token;
-  HANDLE internal_token;
-  HANDLE curr_primary_token;
-  HANDLE curr_imp_token;
+  HANDLE external_token;	 /* token from set_impersonation_token call */
+  HANDLE internal_token;	 /* password-less token fetched in seteuid32 */
+  HANDLE curr_primary_token;	 /* Just a copy of external or internal token */
+  HANDLE curr_imp_token;	 /* impersonation token derived from primary
+				    token */
   bool ext_token_is_restricted;  /* external_token is restricted token */
   bool curr_token_is_restricted; /* curr_primary_token is restricted token */
   bool setuid_to_restricted;     /* switch to restricted token by setuid () */