|
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:
-
- Precondition:
- N/A
- Postcondition:
- N/A
- See also:
- N/A
Definition at line 927 of file icatGeneralMS.c.
|