msiSetACL ( msParam_t *  recursiveFlag,
msParam_t *  accessLevel,
msParam_t *  userName,
msParam_t *  pathName,
ruleExecInfo_t *  rei 
)
Description:
This microservice changes the ACL for a given pathname, either a collection or a data object.
Module:
core
Since:
2.3
Author:
Jean-Yves Nief
Date:
2010-02-11
Note:
This microservice modifies the access rights on a given iRODS object or collection. For the collections, the modification can be recursive and the inheritence bit can be changed as well. For admin mode, add MOD_ADMIN_MODE_PREFIX to the access level string, e.g: msiSetACL("default", "admin:read", "rods", *path)
Example Usage:
See clients/icommands/test/rules3.0/
Parameters:
[in] recursiveFlag - a STR_MS_T, either "default" or "recursive". "recursive" is only relevant if set with accessLevel set to "inherit".
[in] accessLevel - a STR_MS_T containing one of the following:

  • read
  • write
  • own
  • inherit
  • null
[in] userName - a STR_MS_T, the user name or group name who will have ACL changed.
[in] pathName - a STR_MS_T, the collection or data object that will have its ACL changed.
[in,out] rei - The RuleExecInfo structure that is automatically handled by the rule engine. The user does not include rei as a parameter in the rule invocation.
Session Variables Used:
$userName and/or $objPath and/or $collName
Session Variables Modified:
none
iCAT Attributes Used:
none
iCAT Attributes Modified:
none
Side Effect:
none
Returns:
integer
Return values:
0 on success
Precondition:
N/A
Postcondition:
N/A
See also:
N/A

Definition at line 875 of file icatGeneralMS.c.

Generated on Mon Jun 25 14:02:15 2012 for iRODS Documentation by  doxygen 1.6.3