diff options
Diffstat (limited to 'base/util/src/netscape/security/acl')
8 files changed, 49 insertions, 49 deletions
diff --git a/base/util/src/netscape/security/acl/AclEntryImpl.java b/base/util/src/netscape/security/acl/AclEntryImpl.java index 46365f5d8..878eacb68 100644 --- a/base/util/src/netscape/security/acl/AclEntryImpl.java +++ b/base/util/src/netscape/security/acl/AclEntryImpl.java @@ -28,7 +28,7 @@ import java.util.Vector; * This is a class that describes one entry that associates users * or groups with permissions in the ACL. * The entry may be used as a way of granting or denying permissions. - * + * * @author Satish Dharmaraj */ public class AclEntryImpl implements AclEntry { @@ -39,7 +39,7 @@ public class AclEntryImpl implements AclEntry { /** * Construct an ACL entry that associates a user with permissions * in the ACL. - * + * * @param user The user that is associated with this entry. */ public AclEntryImpl(Principal user) { @@ -56,7 +56,7 @@ public class AclEntryImpl implements AclEntry { * Sets the principal in the entity. If a group or a * principal had already been set, a false value is * returned, otherwise a true value is returned. - * + * * @param user The user that is associated with this entry. * @return true if the principal is set, false if there is * one already. @@ -87,7 +87,7 @@ public class AclEntryImpl implements AclEntry { /** * A principal or a group can be associated with multiple * permissions. This method adds a permission to the ACL entry. - * + * * @param permission The permission to be associated with * the principal or the group in the entry. * @return true if the permission was added, false if the @@ -106,7 +106,7 @@ public class AclEntryImpl implements AclEntry { /** * The method disassociates the permission from the Principal * or the Group in this ACL entry. - * + * * @param permission The permission to be disassociated with * the principal or the group in the entry. * @return true if the permission is removed, false if the @@ -119,7 +119,7 @@ public class AclEntryImpl implements AclEntry { /** * Checks if the passed permission is part of the allowed * permission set in this entry. - * + * * @param permission The permission that has to be part of * the permission set in the entry. * @return true if the permission passed is part of the diff --git a/base/util/src/netscape/security/acl/AclImpl.java b/base/util/src/netscape/security/acl/AclImpl.java index 76750b7b9..75ff02083 100644 --- a/base/util/src/netscape/security/acl/AclImpl.java +++ b/base/util/src/netscape/security/acl/AclImpl.java @@ -30,7 +30,7 @@ import java.util.Vector; /** * An Access Control List (ACL) is encapsulated by this class. - * + * * @author Satish Dharmaraj */ public class AclImpl extends OwnerImpl implements Acl { @@ -59,7 +59,7 @@ public class AclImpl extends OwnerImpl implements Acl { /** * Sets the name of the ACL. - * + * * @param caller the principal who is invoking this method. * @param name the name of the ACL. * @exception NotOwnerException if the caller principal is @@ -75,7 +75,7 @@ public class AclImpl extends OwnerImpl implements Acl { /** * Returns the name of the ACL. - * + * * @return the name of the ACL. */ public String getName() { @@ -90,7 +90,7 @@ public class AclImpl extends OwnerImpl implements Acl { * or positive) already in the table, a false value is returned. * The caller principal must be a part of the owners list of * the ACL in order to invoke this method. - * + * * @param caller the principal who is invoking this method. * @param entry the ACL entry that must be added to the ACL. * @return true on success, false if the entry is already present. @@ -116,7 +116,7 @@ public class AclImpl extends OwnerImpl implements Acl { * Removes an ACL entry from this ACL. * The caller principal must be a part of the owners list of the ACL * in order to invoke this method. - * + * * @param caller the principal who is invoking this method. * @param entry the ACL entry that must be removed from the ACL. * @return true on success, false if the entry is not part of the ACL. @@ -139,10 +139,10 @@ public class AclImpl extends OwnerImpl implements Acl { * This method returns the set of allowed permissions for the * specified principal. This set of allowed permissions is calculated * as follows: - * + * * If there is no entry for a group or a principal an empty permission * set is assumed. - * + * * The group positive permission set is the union of all * the positive permissions of each group that the individual belongs to. * The group negative permission set is the union of all @@ -151,18 +151,18 @@ public class AclImpl extends OwnerImpl implements Acl { * the postive permission set and the negative permission set, * it is removed from both. The group positive and negatoive permission * sets are calculated. - * + * * The individial positive permission set and the individual negative * permission set is then calculated. Again abscence of an entry means * the empty set. - * + * * The set of permissions granted to the principal is then calculated using * the simple rule: Individual permissions always override the Group permissions. * Specifically, individual negative permission set (specific * denial of permissions) overrides the group positive permission set. * And the individual positive permission set override the group negative * permission set. - * + * * @param user the principal for which the ACL entry is returned. * @return The resulting permission set that the principal is allowed. */ @@ -211,7 +211,7 @@ public class AclImpl extends OwnerImpl implements Acl { * permission false is returned, a true value is returned otherwise. * This method does not authenticate the principal. It presumes that * the principal is a valid authenticated principal. - * + * * @param principal the name of the authenticated principal * @param permission the permission that the principal must have. * @return true of the principal has the permission desired, false @@ -253,10 +253,10 @@ public class AclImpl extends OwnerImpl implements Acl { } // - // Find the table that this entry belongs to. There are 4 - // tables that are maintained. One each for postive and - // negative ACLs and one each for groups and users. - // This method figures out which + // Find the table that this entry belongs to. There are 4 + // tables that are maintained. One each for postive and + // negative ACLs and one each for groups and users. + // This method figures out which // table is the one that this AclEntry belongs to. // private Hashtable<Principal, AclEntry> findTable(AclEntry entry) { diff --git a/base/util/src/netscape/security/acl/AllPermissionsImpl.java b/base/util/src/netscape/security/acl/AllPermissionsImpl.java index f2b57742f..df3ff6451 100644 --- a/base/util/src/netscape/security/acl/AllPermissionsImpl.java +++ b/base/util/src/netscape/security/acl/AllPermissionsImpl.java @@ -21,7 +21,7 @@ import java.security.acl.Permission; /** * This class implements the principal interface for the set of all permissions. - * + * * @author Satish Dharmaraj */ public class AllPermissionsImpl extends PermissionImpl { @@ -33,7 +33,7 @@ public class AllPermissionsImpl extends PermissionImpl { /** * This function returns true if the permission passed matches the permission represented in * this interface. - * + * * @param another The Permission object to compare with. * @return true always */ diff --git a/base/util/src/netscape/security/acl/GroupImpl.java b/base/util/src/netscape/security/acl/GroupImpl.java index ed087a544..d28e83f00 100644 --- a/base/util/src/netscape/security/acl/GroupImpl.java +++ b/base/util/src/netscape/security/acl/GroupImpl.java @@ -24,7 +24,7 @@ import java.util.Vector; /** * This class implements a group of principals. - * + * * @author Satish Dharmaraj */ public class GroupImpl implements Group { @@ -33,7 +33,7 @@ public class GroupImpl implements Group { /** * Constructs a Group object with no members. - * + * * @param groupName the name of the group */ public GroupImpl(String groupName) { @@ -42,7 +42,7 @@ public class GroupImpl implements Group { /** * adds the specified member to the group. - * + * * @param user The principal to add to the group. * @return true if the member was added - false if the * member could not be added. @@ -61,7 +61,7 @@ public class GroupImpl implements Group { /** * removes the specified member from the group. - * + * * @param user The principal to remove from the group. * @param true if the principal was removed false if * the principal was not a member @@ -80,7 +80,7 @@ public class GroupImpl implements Group { /** * This function returns true if the group passed matches * the group represented in this interface. - * + * * @param another The group to compare this group to. */ public boolean equals(Group another) { @@ -103,7 +103,7 @@ public class GroupImpl implements Group { /** * returns true if the passed principal is a member of the group. - * + * * @param member The principal whose membership must be checked for. * @return true if the principal is a member of this group, * false otherwise @@ -133,7 +133,7 @@ public class GroupImpl implements Group { // // This function is the recursive search of groups for this // implementation of the Group. The search proceeds building up - // a vector of already seen groups. Only new groups are considered, + // a vector of already seen groups. Only new groups are considered, // thereby avoiding loops. // boolean isMemberRecurse(Principal member, Vector<Group> alreadySeen) { @@ -147,12 +147,12 @@ public class GroupImpl implements Group { return true; } else if (p instanceof GroupImpl) { // - // if not recurse if the group has not been checked already. - // Can call method in this package only if the object is an - // instance of this class. Otherwise call the method defined - // in the interface. (This can lead to a loop if a mixture of - // implementations form a loop, but we live with this improbable - // case rather than clutter the interface by forcing the + // if not recurse if the group has not been checked already. + // Can call method in this package only if the object is an + // instance of this class. Otherwise call the method defined + // in the interface. (This can lead to a loop if a mixture of + // implementations form a loop, but we live with this improbable + // case rather than clutter the interface by forcing the // implementation of this method.) // GroupImpl g = (GroupImpl) p; diff --git a/base/util/src/netscape/security/acl/OwnerImpl.java b/base/util/src/netscape/security/acl/OwnerImpl.java index 3f47a1dd8..0e6e13e52 100644 --- a/base/util/src/netscape/security/acl/OwnerImpl.java +++ b/base/util/src/netscape/security/acl/OwnerImpl.java @@ -28,7 +28,7 @@ import java.util.Enumeration; * Class implementing the Owner interface. The * initial owner principal is configured as * part of the constructor. - * + * * @author Satish Dharmaraj */ public class OwnerImpl implements Owner { @@ -45,7 +45,7 @@ public class OwnerImpl implements Owner { * The caller principal must be a part of the owners list of the ACL in * order to invoke this method. The initial owner is configured * at ACL construction time. - * + * * @param caller the principal who is invoking this method. * @param owner The owner that should be added to the owners list. * @return true if success, false if already an owner. @@ -66,7 +66,7 @@ public class OwnerImpl implements Owner { * raised. * The caller principal must be a part of the owners list of the ACL in * order to invoke this method. - * + * * @param caller the principal who is invoking this method. * @param owner The owner to be removed from the owners list. * @return true if the owner is removed, false if the owner is not part @@ -95,7 +95,7 @@ public class OwnerImpl implements Owner { /** * returns if the given principal belongs to the owner list. - * + * * @param owner The owner to check if part of the owners list * @return true if the passed principal is in the owner list, false if not. */ diff --git a/base/util/src/netscape/security/acl/PermissionImpl.java b/base/util/src/netscape/security/acl/PermissionImpl.java index 2e73d3c7e..b20570a81 100644 --- a/base/util/src/netscape/security/acl/PermissionImpl.java +++ b/base/util/src/netscape/security/acl/PermissionImpl.java @@ -22,7 +22,7 @@ import java.security.acl.Permission; /** * The PermissionImpl class implements the permission * interface for permissions that are strings. - * + * * @author Satish Dharmaraj */ public class PermissionImpl implements Permission { @@ -31,7 +31,7 @@ public class PermissionImpl implements Permission { /** * Construct a permission object using a string. - * + * * @param permission the stringified version of the permission. */ public PermissionImpl(String permission) { @@ -41,7 +41,7 @@ public class PermissionImpl implements Permission { /** * This function returns true if the object passed matches the permission * represented in this interface. - * + * * @param another The Permission object to compare with. * @return true if the Permission objects are equal, false otherwise */ @@ -56,7 +56,7 @@ public class PermissionImpl implements Permission { /** * Prints a stringified version of the permission. - * + * * @return the string representation of the Permission. */ public String toString() { diff --git a/base/util/src/netscape/security/acl/PrincipalImpl.java b/base/util/src/netscape/security/acl/PrincipalImpl.java index 25fa11095..54de845d0 100644 --- a/base/util/src/netscape/security/acl/PrincipalImpl.java +++ b/base/util/src/netscape/security/acl/PrincipalImpl.java @@ -21,7 +21,7 @@ import java.security.Principal; /** * This class implements the principal interface. - * + * * @author Satish Dharmaraj */ public class PrincipalImpl implements Principal { @@ -30,7 +30,7 @@ public class PrincipalImpl implements Principal { /** * Construct a principal from a string user name. - * + * * @param user The string form of the principal name. */ public PrincipalImpl(String user) { @@ -40,7 +40,7 @@ public class PrincipalImpl implements Principal { /** * This function returns true if the object passed matches * the principal represented in this implementation - * + * * @param another the Principal to compare with. * @return true if the Principal passed is the same as that * encapsulated in this object, false otherwise diff --git a/base/util/src/netscape/security/acl/WorldGroupImpl.java b/base/util/src/netscape/security/acl/WorldGroupImpl.java index 2f885cbec..a8eea8a7e 100644 --- a/base/util/src/netscape/security/acl/WorldGroupImpl.java +++ b/base/util/src/netscape/security/acl/WorldGroupImpl.java @@ -21,7 +21,7 @@ import java.security.Principal; /** * This class implements a group of principals. - * + * * @author Satish Dharmaraj */ public class WorldGroupImpl extends GroupImpl { @@ -32,7 +32,7 @@ public class WorldGroupImpl extends GroupImpl { /** * returns true for all passed principals - * + * * @param member The principal whose membership must be checked in this Group. * @return true always since this is the "world" group. */ |