plan9front_-_drawterm_rio_and_stats []

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== drawterm, rio and stats ======

===== drawterm =====

^ Command ^ 9front Drawterm output ^
|''$ ./drawterm <nowiki>--</nowiki>help''|''usage: drawterm [-GBO] [**-h** host] [**-u** user] [-a authserver] [-s secstore] [-e 'crypt hash'] [-k keypattern] [-p] [-t timeout] [-r root] [-c cmd <nowiki>...</nowiki>]''|

^ 9front Drawterm option ^ 9front Drawterm option description ^
|  ''-G''  |//''Start drawterm in text-only mode (no graphics).''//|
|  ''-B''  |//''Disable kbdfs.''//|
|  ''-O''  |//''Use the old cpu(1) to connect to the cpu server rather than rcpu(1).''//|
|  ''-p''  |//''Aan is usually run automatically through the -p option or rimport, rexport, and rcpu(1)//;// protect the connection against connection resets by establishing aan(8) tunnel.''//|
|  ''-t''  |Add -t //timeout-in-seconds//, if more than the default (24 hours///86400// seconds) is needed; //''set the timeout for aan(8) to a value in seconds (default is one day).''//|
|  ''-r''  |//''Specifies the root directory on the client. The default is /root and all further paths are relative thereto.''//|

^   ^ aan, aanuke – always available network ^^
|  AAN:  |//''Aan tunnels traffic between a client and a server through a persistent network connection.''//|http://man.9front.org/8/aan|
|  AANUKE:  |//''Aanuke prints commands that will cause all processes called aan that are owned by the current user and do not have an active tcp connection to be terminated.''// //Aanuke prints commands// that look similar to the //slay// commands, in the [[plan9front_-_broke_and_slay#slay|mentioned slay example]].|"  |

| 1. |[[boot_camp_9p_resource|Plan 9 Boot Camp 9p.sdf.org tutorial:]]|
|**9p...**|''$ ./drawterm -a 9p.sdf.org -h 9p.sdf.org -u USER''|

| 2. |[[vps_-_9front#front_drawterm|Plan 9 Boot Camp private VPS tutorial section:]]|
|**VPS**|''$ ./drawterm -a YOUR_IP -h YOUR_IP -u glenda''|

{{:plan9-drawterm-1.png?nolink|typing your Drawterm password}}

After typing your //Drawterm// password, the initial Rio display is a blank grey screen. The passing //cpu: failed to chdir to// message is not uncommon.

{{:plan9-drawterm-2.png?nolink|The initial Rio display is a blank grey screen. At the Rio blank grey screen, press the right button of your mouse.}}

At the Rio blank grey screen, press the right button of your mouse. A menu should appear. Then, release the button over the “**New**” option.

There is a “**Delete**” option (above) in addition to the “**New**” option. This “**Delete**” option is useful. It will delete a window gracefully.

{{:plan9-drawterm-3.png?nolink|Drag the mouse to the lower-right before releasing the button, drawing a rectangle.}}

Now, press the right button again near the upper-left corner of Drawterm, and drag the mouse to the lower-right before releasing the button, drawing a rectangle.

{{:plan9-drawterm-4.png?nolink|You should now have a Rio terminal window, and rc prompt (%).}}

You should now have a Rio terminal window, and rc prompt (%). The first thing you can do is to type “''cat readme.rio''” (or read it from [[http://sdf.org/tutorials/misc/readme.rio|here if it's missing]]).

^ rio Exit menu option (plan9front) ^
|There is an “Exit” option in addition to the “Delete” option. This “Exit” option is useful. It will delete ''rio'' gracefully.|

|   New   |	|
|   Resize   |	|
|   Move   |	|
|   Delete   |	|
|   Hide   |	|
^   Exit   ^ <= exit ''rio'' ^

| **1.** |At the rio grey screen, press the right button of your mouse. A menu (above) should appear.\\ Then, release the button over the ''Exit'' option. A //skull face// pointer (☠) will appear.|
| a. |Cancel the ''Exit'' with a mouse button 1, or button 2 press. The previous pointer will appear.|
| i. |Confirm the ''Exit'' with a mouse button 3 press.|
| b. |Press the ''Enter'' key once to locate the prompt (%).|
| i. |At the prompt (%) type ''exit'', then press the ''Enter'' key, to **exit drawterm**. :!: The mentioned //''exit''//\\ is intended as a topic for Boot Camp [[vps_-_9front#communication_resources|discussion]]. Review [[vps_-_9front#closing_drawterm|closing drawterm]], the way to quit Plan 9 drawterm.|
| ii. |At the prompt (%) type ''rio'', then press the ''Enter'' key, to start rio.|
| **2.** |Try item **1.**, or ''Exit'', while running ''rio'' inside another ''rio'' window.|

[[vps_-_9front#front_drawterm|Drawterm]]<sup>1</sup> is essentially a BLIT terminal emulator which allows you to connect to your Plan 9 system and load the //Rio// windowing system. Rio is a direct successor of UNIX 'layers' and Plan 9 '8½'.

|Although missing from the “''$ ./drawterm <nowiki>--</nowiki>help''” output, the “-r /path/to/local/directory” option will show the “/path/to/local/directory” files in “/mnt/term”. Example: “$ ./drawterm -a YOUR_IP -c YOUR_IP -u glenda -r /path/to/local/directory”.|

^ client /root or option -r path ^^^
|  ''/''|  or|  ''/path/to/local/directory''|
^ plan9front Drawterm /mnt/term and client created dir foo ^^^
|  ''/mnt/term/foo''|  and|  ''/path/to/local/directory/foo''|

<code>

  cpu% pwd
  /mnt/term
  cpu% lc -l | grep foo
  d-rwx------ M ???? user user ???? Sep  5 06:45 foo/

</code>

^ Tilde Expansion ^^
|//[[https://www.gnu.org/software/bash/manual/html_node/Tilde-Expansion.html|3.5.2 Tilde Expansion]]//||
| **''~''** | //The value of ''$HOME''//  |
|**Example:** ''$ ./drawterm -a 9p.sdf.org -h 9p.sdf.org -u USER -r ~/directory''||

Verify the Drawterm command line syntax with the “''<nowiki>--</nowiki>help''” option, if needed. A 9front<sup>2</sup> Drawterm comparison is provided.

^ Plan 9 Drawterm command ^ Plan 9 Drawterm output ^
|''$ ./drawterm <nowiki>--</nowiki>help''|''usage: drawterm [**-a** authserver] [**-c** cpuserver] [-s secstore] [**-u** user]''|

^ 9front Drawterm command ^ 9front Drawterm option //-h// and Plan 9 Drawterm option //-c// comparison ^
|''$ ./drawterm <nowiki>--</nowiki>help''|''usage: drawterm [**-a** authserver] [**-h** cpuserver] [-s secstore] [**-u** user]''|

^ 9front Drawterm command ^ 9front Drawterm output ^
|''$ ./drawterm <nowiki>--</nowiki>help''|''usage: drawterm [-GBO] [**-h** host] [**-u** user] [**-a** authserver] [-s secstore] [-e 'crypt hash'] [-k keypattern] [-p] [-t timeout] [-r root] [-c cmd <nowiki>...</nowiki>]''|

=== plumb to web: ===

|x|Notes about [[vps_-_9front#plumb_to_web|plumb to web]].\\ //• Users connecting with linux Drawterm may find this plumber rule useful.//|

<sup>1</sup> //Drawterm is a X11 application that allows one to connect to a remote Plan 9 server...; a graphical client for Plan 9 CPU servers//. https://directory.fsf.org/wiki/Drawterm <sup>2</sup> [[vps_-_9front#install_or_build_drawterm|DRAWTERM]] http://git.9front.org/plan9front/drawterm

==== network delay ====

^ Reduce the Drawterm [[boot_camp_9p_resource|9p]] network connection delay ^^
|This will reduce the number of user processes, and\\ decrease any Drawterm network connection delay.||
| **1.** |Keep the Drawterm //blank grey screen// small.|
| **2.** |Create one rio rc window for [[boot_camp_9p_resource#commode_example|com]].|
| **3.** |Delete the unnecessary rio rc windows.|

==== persistent network ====

^ Reduce the Drawterm [[boot_camp_9p_resource|9p]] persistent network connection ^^^
|This will reduce the number of user processes, and enable\\ further Drawterm network connection testing without [[plan9front_-_drawterm_rio_and_stats#drawterm|aan]].|||
| **1.** |Create a 9p [[plan9front_-_drawterm_rio_and_stats#drawterm|Drawterm]] connection without the option //- p//||
| **2.** |run ''aanuke'' for the [[plan9front_-_broke_and_slay#slay|slay]] information.||
| **3.** |[[plan9front_-_broke_and_slay#slay|send]] to ''rc''||
| //a.// |Optional: This method can remove unused //aan// resources.||
| //b.// |Optional: view the //aan// processes.| ''% psu -a | grep aan''|

===== full screen =====

^ Full-screen from the rio Exit menu option (plan9front) ^
|There is an “Exit” option in addition to the “Delete” option. This “Exit” option is useful. It will delete ''rio'' gracefully.|

|   New   |	|
|   Resize   |	|
|   Move   |	|
|   Delete   |	|
|   Hide   |	|
^   Exit   ^ <= exit ''rio'' ^

| **1.** |At the rio grey screen, press the right button of your mouse. A menu (above) should appear.\\ Then, release the button over the ''Exit'' option. A //skull face// pointer (☠) will appear.|
| a. |Cancel the ''Exit'' with a mouse button 1, or button 2 press. The previous pointer will appear.|
| i. |**Confirm** the ''Exit'' with a mouse button 3 press.|
| b. |Press the ''Enter'' key once to locate the prompt (%).|
| **2.** |At the prompt (%) type ''games/glendy'', then press the ''Enter'' key, to start ''glendy''.|
| b. |Press the ''Delete'' key once to end the game and access the prompt (%).|
| **3.** |At the prompt (%) type ''rio'', then press the ''Enter'' key, to start rio.|
| a. |At a ''rio'' prompt (cpu%) type ''man games'', then press the ''Enter'' key, to review the ''games/glendy'' information.|

<code>

  cpu% man games

</code>

===== rio =====

|RIO|usage:|''rio [-b] [-f font] [-i initcmd] [-k kbdcmd] [-s]''|http://man.9front.org/1/rio|
|"|"|"|http://man.9front.org/4/rio|
|RIO|Introduction to Rio||https://sdf.org/tutorials/misc/readme.rio|

|x|rio customization|
|x|When you have found a window layout that you like, you might like that persisted between sessions, so that you don't have to place the windows again. We can start rio using multiple ways. When we drawterm in our 9front vps the ''$home/lib/profile'' script is executed. Since the service type (''echo $service'') is of type //cpu// we see that rio is started as ''rio -i riostart'' . Looking at the manual page we see that the -i option takes certain “window” commands that instruct rio in what positions to load the windows and which application to run in them, it also mentions the ''wloc'' command which prints the window layout for the current session. By putting the contents of wloc in the ''$home/bin/rc/riostart'' script then we can have a persistent layout on all rio sessions.|

{{::wloc.png?800|The results of ‘wloc’ in the lower left rio rc window.}}

===== stats =====

|STATS|usage:|''stats -lmisce''|http://man.9front.org/8/stats|

<code>

  cpu% stats -lmisce

</code>

A ''[[vps_-_9front#command_reminder|winwatch -e]]'' //stats// note:

<code>

  cpu% winwatch -e '^(winwatch|stats|faces)'

</code>

Reference:

|9front Drawterm|//9front Drawterm// – [[vps_-_9front#front_drawterm|vps_-_9front#front_drawterm]]|
|Command reminder //(includes screenshot section)//|//Command reminder// – [[vps_-_9front#command_reminder|vps_-_9front#command_reminder]]|