zydronium/google-nomulus
1
0
Fork 0
mirror of https://github.com/google/nomulus.git synced 2025-05-03 21:47:51 +02:00
Code Issues Projects Releases Packages Wiki Activity
google-nomulus/third_party/java/jsch/v0_1_44_google
History
mcilwain 5c9e34ea55 Use Markdown version of JSch README file 
-------------
Created by MOE: https://github.com/google/moe
MOE_MIGRATED_REVID=133712124
2016-09-22 14:04:33 -04:00
..
BUILD Import code from internal repository to git 2016-03-01 17:59:16 -05:00
jsch-0.1.44_google-src.jar Import code from internal repository to git 2016-03-01 17:59:16 -05:00
jsch-0.1.44_google.jar Import code from internal repository to git 2016-03-01 17:59:16 -05:00
LICENSE Import code from internal repository to git 2016-03-01 17:59:16 -05:00
README.md Use Markdown version of JSch README file 2016-09-22 14:04:33 -04:00

README.md

JSch

JSch is a library for making SSH and SFTP connections from Java. It is released under a BSD-style license. For more details, see its project page.

Local modifications by Google

Added three new features and one backport. Default behavior is preserved if they aren't used.

Global ThreadFactory instance

This allows the library to be used on Google App Engine (GAE), which doesn't allow apps to call new Thread(). To do this, you must override JSch.threadFactory with something from GAE's ThreadManager. Another global is also provided to disable calls to Thread#setName which always crash on GAE, regardless of ThreadFactory.

Files edited:

  • JSch.java - Defined new threadFactory and useThreadNames fields.
  • Util.java - Updated thread creation code.
  • ChannelDirectTCPIP.java - Updated thread creation code.
  • ChannelSubsystem.java - Updated thread creation code.
  • ChannelShell.java - Updated thread creation code.
  • Session.java - Updated thread creation code.
  • ChannelForwardedTCPIP.java - Updated thread creation code.
  • ChannelExec.java - Updated thread creation code.

Multiple pending requests with SFTP

This is disabled by default. Call SftpChannel.setMaxPendingRequests(n) with n>1 to enable (64 is a reasonable value). Can provide speed improvements of 10-20x if Periscope is disabled, and approximately 7x if Periscope is enabled and write flushing is disabled.

Files edited:

  • ChannelSftp.java - Added alternate methods (fastGet, fastRead) that use new algorithm. If feature is enabled, the local window size will be set to Integer.MAX_VALUE, since flow control is already handled by SFTP, and some servers don't work well with smaller windows.

Allow disabling flushing of writes

Flushing is enabled by default. Call Session.setFlushingEnabled(false) before connecting to disable. Due to Periscope latency, flushing must be disabled to take advantage of multiple pending requests.

Files edited:

  • Session.java - Added simple getter/setter for flushingEnabled boolean.
  • IO.java - Added optional flushingEnabled constructor arg. Disabled flushing when flushingEnabled is false.

Diffie-Hellman Group 14 SHA1 support

Added support for diffie-hellman-group14-sha1 key exchange algorithm to maintain connections to servers using upgraded OpenSSL.

Files edited:

  • JSch.java - Added diffie-hellman-group14-sha1 to kex config.
  • DHG14.java - Added, patched from version 0.1.46.
  • jce/DH.java - Modified to support DH groups >1024 bits by ignoring JDK<8 exception and testing length of keys.