Security-57740.51.3.tar.gz

[apple/security.git] / OSX / libsecurity_authorization / lib / Authorization.h

diff --git a/OSX/libsecurity_authorization/lib/Authorization.h b/OSX/libsecurity_authorization/lib/Authorization.h
index 068a5e221c030289231c3e684299e947df344bb6..1c6e9a3b27997560cea930a744d42fd8b042a9f0 100644 (file)
--- a/OSX/libsecurity_authorization/lib/Authorization.h
+++ b/OSX/libsecurity_authorization/lib/Authorization.h
@@ -54,7 +54,7 @@ CF_ASSUME_NONNULL_BEGIN
        
        If any of the operations that the preference panel wishes to perform are currently not allowed the lock icon in the window would show up in the locked state.  Otherwise it would show up unlocked.
        
-       When the user locks the lock AuthorizationFree() is called with the kAuthorizationFlagDestroyRights to destroy any authorization rights that have been aquired.
+       When the user locks the lock AuthorizationFree() is called with the kAuthorizationFlagDestroyRights to destroy any authorization rights that have been acquired.
        
        When the user unlocks the lock AuthorizationCreate() is called with the kAuthorizationFlagInteractionAllowed and kAuthorizationFlagExtendRights flags to obtain all required rights.  The old authorization object can be freed by calling AuthorizationFree() with no flags.
 
@@ -176,7 +176,7 @@ typedef struct {
 } AuthorizationItemSet;
 
 
-
+static const size_t kAuthorizationExternalFormLength = 32;
 /*!
        @struct AuthorizationExternalForm
        An AuthorizationExternalForm structure can hold the externalized form of
@@ -188,8 +188,6 @@ typedef struct {
        SECURITY NOTE: Applications should take care to not disclose the AuthorizationExternalForm to
        potential attackers since it would authorize rights to them.
 */
-static const size_t kAuthorizationExternalFormLength = 32;
-
 typedef struct {
        char bytes[kAuthorizationExternalFormLength];
 } AuthorizationExternalForm;
@@ -232,7 +230,7 @@ typedef AuthorizationItemSet AuthorizationEnvironment;
     @param rights (input/optional) An AuthorizationItemSet containing rights for which authorization is being requested.  If none are specified the resulting AuthorizationRef will authorize nothing at all.
     @param environment (input/optional) An AuthorizationItemSet containing environment state used when making the autorization decision.  See the AuthorizationEnvironment type for details.
     @param flags (input) options specified by the AuthorizationFlags enum.  set all unused bits to zero to allow for future expansion.
-    @param authorization (output optional) A pointer to an AuthorizationRef to be returned.  When the returned AuthorizationRef is no longer needed AuthorizationFree should be called to prevent anyone from using the aquired rights.  If NULL is specified no new rights are returned, but the system will attempt to authorize all the requested rights and return the appropriate status.
+    @param authorization (output optional) A pointer to an AuthorizationRef to be returned.  When the returned AuthorizationRef is no longer needed AuthorizationFree should be called to prevent anyone from using the acquired rights.  If NULL is specified no new rights are returned, but the system will attempt to authorize all the requested rights and return the appropriate status.
 
     @result errAuthorizationSuccess 0 authorization or all requested rights succeeded.