Add getRealPath parameter to GetCanonized function

Author: Fernando Bedoya Ortecho

src/Renci.SshNet/Sftp/ISftpSession.cs

@@ -35,10 +35,11 @@ internal interface ISftpSession : ISubsystemSession
         /// Resolves a given path into an absolute path on the server.
         /// </summary>
         /// <param name="path">The path to resolve.</param>
+        /// <param name="getRealPath">Boolean determining whether to get the ral path.</param>
         /// <returns>
         /// The absolute path.
         /// </returns>
-        string GetCanonicalPath(string path);
+        string GetCanonicalPath(string path, bool getRealPath = true);
 
         Task<string> GetCanonicalPathAsync(string path, CancellationToken cancellationToken);
 

src/Renci.SshNet/Sftp/SftpSession.cs

@@ -89,13 +89,20 @@ internal void SendMessage(SftpMessage sftpMessage)
         /// Resolves a given path into an absolute path on the server.
         /// </summary>
         /// <param name="path">The path to resolve.</param>
+        /// <param name="getRealPath">Boolean determining whether to get the real path.</param>
         /// <returns>
         /// The absolute path.
         /// </returns>
-        public string GetCanonicalPath(string path)
+        public string GetCanonicalPath(string path, bool getRealPath = true)
         {
             var fullPath = GetFullRemotePath(path);
 
+            if (!getRealPath)
+            {
+                // getRealPath set to false allows us to get a reference to the symbolic link itself and not to the file it points to.
+                return fullPath;
+            }
+
             var canonizedPath = string.Empty;
 
             var realPathFiles = RequestRealPath(fullPath, nullOnError: true);