addTrustee

Adds a trustee to a file or directory.

Request

<trustees>
   <addTrustee>
      <name/>
      <userID/>
         <rights>
            <supervisor/>
            <read/>
            <write/>
            <create/>
            <erase/>
            <modify/>
            <fileScan/>
            <accessControl/>
            <salvage/>
            <secure/>
            <symlink/>
         </rights>
         <fileName/>
         <nameSpace/>
      </addTrustee>
   </trustees>

Reply

<trustees>
   <addTrustee>
      <result value=" ">
         <description/>
      </result>
   </addTrustee>
</trustees>

Elements

name: Specifies a name with the full context (including the tree name). The name can be delimited with either dots or slashes. If user ID is mentioned, user name is optional.
userID: Specifies the unique NDS User GUID. If both the userID and user name are passed, both the values should refer to the same user. If user name is mentioned, user ID is optional.
rights: Specifies the rights to assign to the file for the specified user.
fileName: Specifies the file name to add rights to.
nameSpace: Specifies the name space of the file. nameSpace is an optional tag and is required only when the file name is specified as NSS path.
result: Specifies an error value or 0 (for no error).
description: Specifies a text description of the result.
(Optional) symLink: Specifies not to follow the link.

Example

<virtualIO>
   <datastream name="command"/>
</virtualIO>

<fileRequest>
   <trustees>
      <addTrustee>
         <name><![CDATA[.CN=admin.O=novell.T=MYTREE.]]></name>
         <userID>78c19abc-d416-4eba-2f-81-bc9ac17816d4</userID>
            <rights>
               <supervisor/>
            </rights>
         <fileName>sys:\setup\test.txt</fileName>
         <nameSpace>unix</nameSpace>
      </addTrustee>
   </trustees>
</fileRequest>