Retrieves real path for the symbolic link.

None  

object.RealPath [RemotePath]

The RealPath Method syntax has these parts:

UNIX operating systems (which are usually running SSH and SFTP servers) have something called 'a link' implemented in their file system. Windows has something similar called a 'shortcut' but it isn't such a nice implementation. These files point to another file or a directory and are created by regular users or administrators.

The RealPath method will send a request to the server to 'reveal' information about such link files. For example, if you wish to determine if

/bin/sh

is really an executable file, or it is just a link to

/usr/local/bin/bash

(typically set on newer UNIXes), you could call this method. After the request completes on the server, the ListItems event will be fired containing the real file path that /bin/sh points to. It could be /usr/local/bin/bash, it could be /bin/sh (if it is not a link at all) or could be something else. Check it out.

Even though you should see these link files when you initiate the ListDir method (they are shown like this: /bin/sh -> /usr/local/bin/bash) , it is possible that this information is hidden, because some UNIX operating systems (such as Solaris SunOS) also support hard links in their file system. In this case you will not be aware that something is a link just by using regular directory listings.