SliTaz Repositories

     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/pages/en/guides/conspy.txt	Sat Feb 26 12:17:18 2011 +0000
     1.3 @@ -0,0 +1,107 @@
     1.4 +====== Conspy : tiny screen or VNC ======
     1.5 +
     1.6 +Slitaz core provides the 10Kb conspy to get remote control of Linux virtual consoles. See http://ace-host.stuart.id.au/russell/files/conspy/
     1.7 +
     1.8 +Slitaz opens 6 virtual consoles which you can access with Ctrl-Alt-F1 to Ctrl-Alt-F6. You can connect to console 1 with //conspy 1// and console n with //conspy n// or the current active console with //conspy// (root user only).
     1.9 +
    1.10 +To exit from conspy (and the virtual console) press the escape key three times in quick succession.
    1.11 +
    1.12 +===== Conspy as screen (session manager) =====
    1.13 +
    1.14 +Linux supports up to 63 virtual consoles. You can have up to 62 (63 - X11 on console 7) sessions. Six sessions are already opened by Slitaz.
    1.15 +You can open a new console / new session (say console 28) with //openvt -c 28 /bin/login// or //openvt -c 28 /bin/ash//.
    1.16 +You can free this virtual console with //deallocvt 28//.
    1.17 +
    1.18 +Example:
    1.19 +<code>
    1.20 +home$ ssh tux@slitazbox
    1.21 +box$ su
    1.22 +box# openvt -c 28 /bin/ash
    1.23 +box# conspy 28
    1.24 +# some commands
    1.25 +...
    1.26 +# <ESC><ESC><ESC>
    1.27 +box# exit
    1.28 +box$ exit
    1.29 +</code>
    1.30 +Later:
    1.31 +<code>
    1.32 +home$ ssh tux@slitazbox
    1.33 +box$ su
    1.34 +box# conspy 28
    1.35 +# more commands
    1.36 +...
    1.37 +# <ESC><ESC><ESC> 
    1.38 +box# exit
    1.39 +box$ exit
    1.40 +</code>
    1.41 +To close the session:
    1.42 +<code>
    1.43 +home$ ssh tux@slitazbox
    1.44 +box$ su
    1.45 +box# conspy 28
    1.46 +# exit
    1.47 +<ESC><ESC><ESC>
    1.48 +box# deallocvt 28
    1.49 +box# exit
    1.50 +box$ exit
    1.51 +</code>
    1.52 +If you prefer to use screen, see http://www.gnu.org/software/screen:
    1.53 +<code>
    1.54 +# tazpkg get-install screen
    1.55 +$ screen -S MySession
    1.56 +</code>
    1.57 +
    1.58 +===== Conspy as VNC (shared console) =====
    1.59 +
    1.60 +You can share a virtual console between two or more users.
    1.61 +Say RemoteUser wants to show some commands to SlitazUser using SlitazBox.
    1.62 +RemoteUser selects SlitazUser's console with //chvt//:
    1.63 +<code>
    1.64 +home$ ssh SlitazBox
    1.65 +SlitazBox$ su
    1.66 +SlitazBox# chvt 1
    1.67 +SlitazBox# conspy 1
    1.68 +</code>
    1.69 +Now both users show the same terminal. A third user can do //conspy 1// too.
    1.70 +
    1.71 +If you prefer to share the X11 display, install x11vnc (VNC server) and x11vnc-extra (java VNC client) see http://www.karlrunge.com/x11vnc/:
    1.72 +<code>
    1.73 +SlitazBox# tazpkg get-install x11vnc
    1.74 +SlitazBox# tazpkg get-install x11vnc-extra
    1.75 +SlitazBox# /etc/init.d/x11vnc start
    1.76 +</code>
    1.77 +<code>
    1.78 +home$ su
    1.79 +home# get-java-jre
    1.80 +home# exit
    1.81 +home$ firefox http://SlitazBox:5800/ultrasigned.vnc
    1.82 +</code>
    1.83 +
    1.84 +===== Conspy and slow connections =====
    1.85 +
    1.86 +Launch a very verbose command into a conspy and the output is displayed at full speed in the virtual console what ever your connection speed to the remote box is, even if your connection is broken. 
    1.87 +===== Conspy and Busybox =====
    1.88 +
    1.89 +Conspy is a busybox applet since busybox 1.17.0. It adds 2.5Kb to busybox, has better terminal support and supports some new options:
    1.90 +  * -c to create missing devices (/dev/vcsaXX and /dev/ttyXX)
    1.91 +  * -d for screen shot<code># conspy -d 28 > screen28.txt</code>
    1.92 +  * -s to launch a shell<code># conspy -cs 28</code> (no more openvt)
    1.93 +  * -x COL -y LINE upper left corner position
    1.94 +  * -f follow cursor with automatic scrollings
    1.95 +
    1.96 +The conspy applet is enabled in the busybox package. The conspy package is no longer more useful than the recent busybox.
    1.97 +
    1.98 +---- 
    1.99 +\\
   1.100 +^  Page Review Section  ^^ 
   1.101 +|Quality| Good  |
   1.102 +|Review| Minor Updates  |
   1.103 +|Priority| Medium |
   1.104 +|Problems| add a [[http://forum.slitaz.org|forum post link]]|
   1.105 +|:::     | OR add a [[http://labs.slitaz.org/issues |lab issue tracker link ]]|
   1.106 +|How to Improve| Suggest briefly|
   1.107 +|::: |  |
   1.108 +
   1.109 +\\
   1.110 +----
   1.111 \ No newline at end of file