You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@commons.apache.org by "Brendan Long (Created) (JIRA)" <ji...@apache.org> on 2011/10/13 19:11:12 UTC
[jira] [Created] (VFS-368) SFTP documentation implies that
"userDirIsRoot" defaults to true (but it defaults to false)
SFTP documentation implies that "userDirIsRoot" defaults to true (but it defaults to false)
-------------------------------------------------------------------------------------------
Key: VFS-368
URL: https://issues.apache.org/jira/browse/VFS-368
Project: Commons VFS
Issue Type: Bug
Reporter: Brendan Long
Priority: Minor
On this documentation page:
http://commons.apache.org/vfs/filesystems.html#SFTP
It says:
SFTP
Provides access to the files on an SFTP server (that is, an SSH or SCP server).
URI Format
sftp://[ username[: password]@] hostname[: port][ absolute-path]
Examples
sftp://myusername:mypassword@somehost/pub/downloads/somefile.tgz
The default is actually that the path is relative from the user's home directory. This can be changed by running:
SftpFileSystemConfigBuilder
.getInstance()
.setUserDirIsRoot(options, false);
I suggest changing the documentation to say [ relative-path ] and adding a note about absolute paths (but I'm not sure how to make it fit the style of this page).
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] [Updated] (VFS-368) SFTP documentation implies that
"userDirIsRoot" defaults to true (but it defaults to false)
Posted by "Gary D. Gregory (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/VFS-368?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Gary D. Gregory updated VFS-368:
--------------------------------
Comment: was deleted
(was: How much of a surprise would this change be for current implementations that use the defaults?
IOW, how much would this break existing apps?)
> SFTP documentation implies that "userDirIsRoot" defaults to true (but it defaults to false)
> -------------------------------------------------------------------------------------------
>
> Key: VFS-368
> URL: https://issues.apache.org/jira/browse/VFS-368
> Project: Commons VFS
> Issue Type: Bug
> Reporter: Brendan Long
> Priority: Minor
> Labels: sftp
>
> On this documentation page:
> http://commons.apache.org/vfs/filesystems.html#SFTP
> It says:
> SFTP
> Provides access to the files on an SFTP server (that is, an SSH or SCP server).
> URI Format
> sftp://[ username[: password]@] hostname[: port][ absolute-path]
> Examples
> sftp://myusername:mypassword@somehost/pub/downloads/somefile.tgz
> The default is actually that the path is relative from the user's home directory. This can be changed by running:
> SftpFileSystemConfigBuilder
> .getInstance()
> .setUserDirIsRoot(options, false);
> I suggest changing the documentation to say [ relative-path ] and adding a note about absolute paths (but I'm not sure how to make it fit the style of this page).
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] [Commented] (VFS-368) SFTP documentation implies that
"userDirIsRoot" defaults to true (but it defaults to false)
Posted by "Gary D. Gregory (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/VFS-368?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13274071#comment-13274071 ]
Gary D. Gregory commented on VFS-368:
-------------------------------------
How much of a surprise would this change be for current implementations that use the defaults?
IOW, how much would this break existing apps?
> SFTP documentation implies that "userDirIsRoot" defaults to true (but it defaults to false)
> -------------------------------------------------------------------------------------------
>
> Key: VFS-368
> URL: https://issues.apache.org/jira/browse/VFS-368
> Project: Commons VFS
> Issue Type: Bug
> Reporter: Brendan Long
> Priority: Minor
> Labels: sftp
>
> On this documentation page:
> http://commons.apache.org/vfs/filesystems.html#SFTP
> It says:
> SFTP
> Provides access to the files on an SFTP server (that is, an SSH or SCP server).
> URI Format
> sftp://[ username[: password]@] hostname[: port][ absolute-path]
> Examples
> sftp://myusername:mypassword@somehost/pub/downloads/somefile.tgz
> The default is actually that the path is relative from the user's home directory. This can be changed by running:
> SftpFileSystemConfigBuilder
> .getInstance()
> .setUserDirIsRoot(options, false);
> I suggest changing the documentation to say [ relative-path ] and adding a note about absolute paths (but I'm not sure how to make it fit the style of this page).
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
[jira] [Commented] (VFS-368) SFTP documentation implies that
"userDirIsRoot" defaults to true (but it defaults to false)
Posted by "Andreas Persson (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/VFS-368?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13273908#comment-13273908 ]
Andreas Persson commented on VFS-368:
-------------------------------------
The same is true for ftps. (But not for ftp, unless the patch in VFS-265 is accepted.)
(Note that the behavior was changed: before the patch in VFS-264 the default value for UserDirIsRoot in sftp actually was false. I found that a bit strange, as VFS-264 was about ftps, not sftp. I asked the author of that patch if the sftp change was intentional, and indeed it wasn't, see http://mail-archives.apache.org/mod_mbox/commons-dev/201101.mbox/%3c1DCE895F45843C42B615CA046BA82158142CA258DB@walle%3e. No action was made in spite of this, so VFS 2.0 shipped with UserDirIsRoot default true for sftp and ftps, but false for ftp.)
> SFTP documentation implies that "userDirIsRoot" defaults to true (but it defaults to false)
> -------------------------------------------------------------------------------------------
>
> Key: VFS-368
> URL: https://issues.apache.org/jira/browse/VFS-368
> Project: Commons VFS
> Issue Type: Bug
> Reporter: Brendan Long
> Priority: Minor
> Labels: sftp
>
> On this documentation page:
> http://commons.apache.org/vfs/filesystems.html#SFTP
> It says:
> SFTP
> Provides access to the files on an SFTP server (that is, an SSH or SCP server).
> URI Format
> sftp://[ username[: password]@] hostname[: port][ absolute-path]
> Examples
> sftp://myusername:mypassword@somehost/pub/downloads/somefile.tgz
> The default is actually that the path is relative from the user's home directory. This can be changed by running:
> SftpFileSystemConfigBuilder
> .getInstance()
> .setUserDirIsRoot(options, false);
> I suggest changing the documentation to say [ relative-path ] and adding a note about absolute paths (but I'm not sure how to make it fit the style of this page).
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira