commons-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Andreas Persson (JIRA)" <>
Subject [jira] [Commented] (VFS-368) SFTP documentation implies that "userDirIsRoot" defaults to true (but it defaults to false)
Date Sat, 12 May 2012 09:43:49 GMT


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,
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
> -------------------------------------------------------------------------------------------
>                 Key: VFS-368
>                 URL:
>             Project: Commons VFS
>          Issue Type: Bug
>            Reporter: Brendan Long
>            Priority: Minor
>              Labels: sftp
> On this documentation page:
> 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:!default.jspa
For more information on JIRA, see:


View raw message