readLink

Reads a junction link and returns a list of physical volume instances. Note that there can be multiple volumeInfo elements in the response.

Request

<readLink>
   <pathName/>
</readLink>

Reply

<readLink>
   <result value="">
      <description/>
   </result>
   <junction>
      <managementContext>
         <ndsObject/>
         <tgtTree/>
      </managementContext>
      <dfsGUID/>
      <volumeInfo>
         <server/>
         <tgtTree/>
         <volumeName/>
      </volumeInfo>
   </junction>
   <symlink>
      <nameSpace/>
      <pathName/>
   </symlink>
   <unc>
      <pathName/>
   </unc>
   <url> 
      <pathName/>
   </url>
</readLink>

Elements

pathName: Specifies the link file to modify.
tgtTree: (Optional)
result: Specifies an error value or 0 (for no error).
description: Specifies a text description of the result.

Example

<nssRequest>
   <dfs>
      <readLink>
         <result value="0">
            <description/>success</description>
         </result>
         <junction>            <!-- File is a junction -->
            <managementContext>
               <ndsObject>nss.prv.novell</ndsObject>
               <tgtTree>novell_inc</tgtTree>
            </managementContext>
            <dfsGUID>C2EAAA00-3211-11D6-B7-C7-00C04FA33547</dfsGUID>
            <volumeInfo>
               <server>vldb-master.novell</server>
               <tgtTree>novell_inc</tgtTree>
               <volumeName>VOL1</volumeName>
            </volumeInfo>
         </junction>

         <symlink>            <!-- File is a symlink -->
            <nameSpace>long</nameSpace>
            <pathName>abc/def</pathName>
         </symlink>

         <unc>               <!-- File is a UNC link -->
            <pathName>\\ServName\VolName\foo.bar</pathName>
         </unc>

         <url>               <!-- File is a URL link -->
            <pathName>http://nss.provo.novell.com/dfs</pathName>
         </url>
      </readLink>
   </dfs>
</nssReply>