-
Notifications
You must be signed in to change notification settings - Fork 26
/
README
177 lines (140 loc) · 5.48 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
JCTerm
JCraft's Term
by [email protected], JCraft,Inc.
http://www.jcraft.com/jcterm/
Last modified: Thu Apr 26 14:01:53 UTC 2012
Description
===========
JCTerm(JCraft's Term) is a pure Java VT100 terminal emulator for
SSH2 sessions. This terminal emulator also allows you to enjoy
port forwarding, X11 forwarding, etc,.
JCTerm is licensed under GNU LGPL and easily integrated into you programs.
Documentation
=============
* README files all over the source tree have info related to the stuff
in the directories.
Directories & Files in the Source Tree
======================================
* src/com/jcraft/jcterm has source trees of JCTerm
Features
========
* JCTerm requires jsch(http://www.jcraft.com/jsch/) 0.1.48.
* JCTerm requires J2SE 1.4.
* JCTermMIDP runs on J2ME/CLDC/MIDP2.0
* JCTermJ2MECDC runs on J2ME/CDC/PP 1.0
* VT100 emulation
* SSH2 protocol support.
* X11 forwarding.
* connection through HTTP proxy.
* connection through SOCKS5 proxy.
* local/remote port forwarding.
* anti-aliasing text.
* sftp support.
* packet compression support.
* OpenSSH's ssh-agent and Putty's pageant support.
* JCTerm is licensed under GNU LGPL.
How To Try
==========
This archive does not include java byte code, so please compile
the source code by your self. Suppose you have jsch-?.?.?.zip.
$ unzip jcterm-?.?.?.zip
$ cd jcterm-?.?.?/
$ mkdir lib/
$ (cd lib; \
wget \
http://sourceforge.net/projects/jsch/files/jsch.jar/0.1.48/jsch-0.1.48.jar)
$ ant
$ java -cp './lib/*.jar:./dist/lib/*.jar' \
com.jcraft.jcterm.JCTermSwingFrame
If you need the packet compression support, you have to put the jar file of
jzlib(http://www.jcraft.com/jzlib) into lib/ .
Using ssh-agent
===============
JCTerm supports OpenSSH's ssh-agent and Putty's pageant by
using jsch-agent-proxy. Here are steps to enable it,
$ pushd /tmp
$ git clone git://github.com/ymnk/jsch-agent-proxy.git
$ cd jsch-agent-proxy
$ mkdir lib
$ (cd lib; \
wget --no-check-certificate \
https://github.com/downloads/twall/jna/jna.jar)
$ (cd lib; \
wget --no-check-certificate \
https://github.com/downloads/twall/jna/platform.jar)
$ (cd lib; \
wget \
http://sourceforge.net/projects/jsch/files/jsch.jar/0.1.48/jsch-0.1.48.jar)
$ ant
$ popd
$ mkdir lib/
$ cp /tmp/jsch-agent-proxy/lib/*.jar lib/
$ cp /tmp/jsch-agent-proxy/jsch-agent-proxy/dist/lib/*.jar lib/
$ ant
$ java -cp './lib/*.jar:./dist/lib/*.jar' \
-Djcterm.config.use_ssh_agent=true \
com.jcraft.jcterm.JCTermSwingFrame
On-Line Demo
============
On-Line demo is available at http://wiredx.net/jcterm/ .
On this page, the digitally signed JCterm applet is provided and
you can try JCterm on the web browser. In starting this applet,
you will receive a Java Security prompt asking to deny/grant to run it.
JCTerm for J2ME/CDC platform
============================
JCTermJ2MECDC is the port of JCTerm to J2ME/CDC platform.
How to Compile
==============
To compile this program, you need BouncyCastle Crypto API
(http://www.bouncycastle.org/) 1.26 or later and JSch for
J2ME/CDC, which is available at http://j2me.jsch.org/ .
Confirmed Devices
=================
We have heard that this program is running on the following device.
* SHARP Zaurus SL-C700
The binary for this device is available at http://j2me.jsch.org/ .
* SHARP Zaurus SL-C760
JCTerm for J2ME/CLDC/MIDP2.0
============================
JCTermMIDP is the port of JCTerm to J2ME/CLDC/MIDP2.0 platform.
How to Compile
==============
To compile this midlet, you need BouncyCastle Crypto API
(http://www.bouncycastle.org/) 1.26 or later and JSch for
J2ME/CLDC/MIDP2.0, which is available at http://j2me.jsch.org/ .
We have confirmed that this midlet is compilable on Sun's Wireless
Toolkit 2.2. You have to delete following files before compilation process,
* src/com/jcraft/jcterm/JCTerm.java
* src/com/jcraft/jcterm/JCTermAWT.java
* src/com/jcraft/jcterm/JCTermApplet.java
* src/com/jcraft/jcterm/JCTermJ2MECDC.java
* src/com/jcraft/jcterm/Sftp.java
* src/com/jcraft/jcterm/Splash.java
The jar and jad files are available at http://j2me.jsch.org/ .
Public-key Authentication
=========================
Current version supports password authentication and public-key
authentication. This midlet will allow you to install private keys
into MIDP's RecordStore. After staring this midlet, you will find
the checkbox 'Install private key', If you select this checkbox and
connect to the remote host with password authentication , following commands
'cat ~/.ssh/id_rsa' and 'cat ~/.ssh/id_dsa'
will be remotely execed and outputs will be stored locally.
In the next time, public-key authentication will be tried.
Of course, we strongly recommend to encrypt id_rsa' and 'id_dsa'.
Confirmed Devices
=================
We have heard that this midlet is running on the following device.
* Motorola c650
TODO
====
* VT100 emulation is incomplete.
Copyrights & Disclaimers
========================
JCterm is copyrighted by JCraft,Inc. and is licensed through the
GNU Library General Public License.
Read the COPYING file for the complete license.
If you have any comments, suggestions and questions, write us
``SSH is a registered trademark and Secure Shell is a trademark of
SSH Communications Security Corp (www.ssh.com)''.