From cfc0614bf25125c89bd75b85ef2d3b7df5dceb5a Mon Sep 17 00:00:00 2001 From: "Charles.Forsyth" Date: Mon, 27 Oct 2008 18:02:37 +0000 Subject: 20081027-1802 --- man/1/grid-localreg | 4 +- man/1/grid-ns | 14 +++---- man/1/grid-query | 2 +- man/1/grid-register | 4 +- man/1/grid-session | 110 ++++++++++++++++++++++++++++++++++++++++++++++++++++ man/1/session | 110 ---------------------------------------------------- 6 files changed, 122 insertions(+), 122 deletions(-) create mode 100644 man/1/grid-session delete mode 100644 man/1/session (limited to 'man') diff --git a/man/1/grid-localreg b/man/1/grid-localreg index e72d8e09..ce1c74b7 100644 --- a/man/1/grid-localreg +++ b/man/1/grid-localreg @@ -1,7 +1,7 @@ .TH GRID-LOCALREG 1 .SH NAME -localreg \- starts a -.IR registry (4) +grid: localreg \- starts a +registry on the local machine .SH SYNOPSIS .B grid/localreg diff --git a/man/1/grid-ns b/man/1/grid-ns index 7cc57252..928d1cb7 100644 --- a/man/1/grid-ns +++ b/man/1/grid-ns @@ -1,7 +1,7 @@ .TH GRID-NS 1 .SH NAME -ns \- exports a selected namespace and serves it on -.I stdin. +grid: ns \- exports a selected namespace and serves it on +standard input .SH SYNOPSIS .BI "grid/srv/ns [ -r " "relpath " "]" " path1 path2...path n" .br @@ -31,8 +31,8 @@ would be listed as and .B /tmp would not be listed at all. - -.IR Register (1) +.PP +.IR Grid-register (1) may be used in conjunction with .I ns to register it with a @@ -56,12 +56,12 @@ if possible and start up the graphical display to show connections to the resour outside of .I runns unless the namespace it provides is required to be accessible in a different way to that provided by -.IR register (1). +.IR grid-register (1). .SH SOURCE .B /appl/grid/srv/ns.b .SH "SEE ALSO" -.IR cpu (4), +.IR grid-cpu (4), .IR grid-monitor (1), .IR grid-register (1), -.IR session (1) +.IR grid-session (1) diff --git a/man/1/grid-query b/man/1/grid-query index 036e250e..4c1c6ed3 100644 --- a/man/1/grid-query +++ b/man/1/grid-query @@ -1,6 +1,6 @@ .TH GRID-QUERY 1 .SH NAME -query \- graphical interface to view resources registered with a known +grid: query \- graphical interface to view resources registered with a known .IR registry (4) .SH SYNOPSIS .B grid/query diff --git a/man/1/grid-register b/man/1/grid-register index 70e32eeb..8eeca460 100644 --- a/man/1/grid-register +++ b/man/1/grid-register @@ -1,6 +1,6 @@ .TH GRID-REGISTER 1 .SH NAME -register \- registers a resource with a known +grid: register \- registers a resource with a known .IR registry (4) .SH SYNOPSIS .B grid/register [ @@ -22,7 +22,7 @@ It then marshals the service by listening for incoming connections and exporting prints out various status messages to .I stdout in the form which may be read by -.IR monitor (1). +.IR grid-monitor (1). .SH OPTIONS .TP 17 .BI -u " maxusers" diff --git a/man/1/grid-session b/man/1/grid-session new file mode 100644 index 00000000..472809d3 --- /dev/null +++ b/man/1/grid-session @@ -0,0 +1,110 @@ +.TH GRID-SESSION 1 +.SH NAME +grid: session \- graphical interface for configuring tasks using +.IR grid-cpu (4) +and +.IR grid-ns (1) +resources +.SH SYNOPSIS +.B grid/session +.SH DESCRIPTION +.I Session +allows the user to build up a single namespace from various different namespace resources and configure a set of commands to be executed within this namespace. The execution then takes place on one or more selected +.IR grid-cpu (4) +resources. +.PP +Once started, +.IR session +presents a heirarchical view of currently registered resources (such as +.IR grid-ns (1)) +which export a Styx (see +.IR intro (5)) +namespace. The top level displays the type of resource e.g. +.BR 'CPU resource' , +whilst the second level shows the name of each individual resource. Descending futher down the tree will reveal the attributes of the selected resource. To mount a resource and see the namespace it exports, click mouse button 3 on the resource name. The view will switch to a split pane view displaying the resource namespace with directories listed on the left and all files in the current directory displayed on the right. +.PP +Clicking mouse button 3 on a file or directory will cause it to be added to the +.I command +or +.I namespace +list at the bottom of the window. Mouse button 3 is again used on items in either of these lists to display a menu containing the name of the resource on which they are located as well as the option to remove them. The +.B Cmd +and +.B Ns +buttons located at the top of the window toggle the view between the selected commands and the selected namespace. The +.B Resources +button returns to the initial view containing the currently registered resources and +.B Refresh +updates the list in case any resources have been added or removed. + +.SS The Command List +This contains a list of all commands to be executed. Any arguments may be entered by clicking on the gap after +.IR args : +and typing into the box. Commands will be executed in order from top (first) to bottom (last). + +.SS The Namespace List +This contains a list of all the directories to be imported in order to create the local namespace of the selected +.IR grid-cpu (4) +resource(s). By default, several directories will be imported from the local machine. To select these, click button 3 on +.B import local namespace +and (un)check the directories as required. To toggle this option on and off, click button 1 on +.B import local namespace. +These default directories are required by many commands for normal execution so it is recommended that they are not disabled unless they are definitely not needed. Importing a directory of the same name as one of the default directories will automatically overwrite the default. Therefore, it is not necessary to disable a default directory if the same name is to be imported from elsewhere. +.PP +A given directory can only be imported once so it is not possible, for example, to import +.B /usr/inferno +from two different machines. +.I Session +will automatically import the directories containing each of the selected commands but any others required must be explicitly imported. For example: If one of the commands is: +.PP +.EX + /usr/inferno/runme.dis -f /appl/lib +.EE +.PP +.I Session +will import +.B /usr/inferno/ +but +.B /appl/lib +would have to be specified in the namespace list. +.SS Execution +Once the command and namespace lists have been configured, click +.B Ok +on the +.I Session +window. This will bring up the +.IR grid-query (1) +window containing a list of the available +.IR grid-cpu (4) +resources. To select one or more of these for execution, click on the name with button 3 and it will be added to the list. If a specific +.IR grid-cpu (4) +resource is not required, click button 3 on +.B CPU resource +and select the number you require by clicking on the number following the list entry and dragging the mouse up or down. +.PP +Once the required +.IR grid-cpu (4) +resources have been selected, click +.B Ok +and execution will commence. + + +.SH SOURCE +.B /appl/grid/session.b +.br +.B /appl/grid/ns.b +.br +.B /appl/grid/monitor.b +.br +.B /appl/grid/query.b +.br +.B /appl/grid/lib/browse.b +.br +.B /appl/grid/lib/srvbrowse.b + +.SH "SEE ALSO" +.IR grid-query (1), +.IR registries (2) +.IR grid-ns (1), +.IR grid-cpu (4), +.IR registry (4) diff --git a/man/1/session b/man/1/session deleted file mode 100644 index 92f8bc42..00000000 --- a/man/1/session +++ /dev/null @@ -1,110 +0,0 @@ -.TH SESSION 1 -.SH NAME -session \- graphical interface for configuring tasks using -.IR cpu (4) -and -.IR ns (1) -resources -.SH SYNOPSIS -.B grid/session -.SH DESCRIPTION -.I Session -allows the user to build up a single namespace from various different namespace resources and configure a set of commands to be executed within this namespace. The execution then takes place on one or more selected -.IR cpu (4) -resources. -.PP -Once started, -.IR session -presents a heirarchical view of currently registered resources (such as -.IR ns (1)) -which export a Styx (see -.IR intro (5)) -namespace. The top level displays the type of resource e.g. -.BR 'CPU resource' , -whilst the second level shows the name of each individual resource. Descending futher down the tree will reveal the attributes of the selected resource. To mount a resource and see the namespace it exports, click mouse button 3 on the resource name. The view will switch to a split pane view displaying the resource namespace with directories listed on the left and all files in the current directory displayed on the right. -.PP -Clicking mouse button 3 on a file or directory will cause it to be added to the -.I command -or -.I namespace -list at the bottom of the window. Mouse button 3 is again used on items in either of these lists to display a menu containing the name of the resource on which they are located as well as the option to remove them. The -.B Cmd -and -.B Ns -buttons located at the top of the window toggle the view between the selected commands and the selected namespace. The -.B Resources -button returns to the initial view containing the currently registered resources and -.B Refresh -updates the list in case any resources have been added or removed. - -.SS The Command List -This contains a list of all commands to be executed. Any arguments may be entered by clicking on the gap after -.IR args : -and typing into the box. Commands will be executed in order from top (first) to bottom (last). - -.SS The Namespace List -This contains a list of all the directories to be imported in order to create the local namespace of the selected -.IR cpu (4) -resource(s). By default, several directories will be imported from the local machine. To select these, click button 3 on -.B import local namespace -and (un)check the directories as required. To toggle this option on and off, click button 1 on -.B import local namespace. -These default directories are required by many commands for normal execution so it is recommended that they are not disabled unless they are definitely not needed. Importing a directory of the same name as one of the default directories will automatically overwrite the default. Therefore, it is not necessary to disable a default directory if the same name is to be imported from elsewhere. -.PP -A given directory can only be imported once so it is not possible, for example, to import -.B /usr/inferno -from two different machines. -.I Session -will automatically import the directories containing each of the selected commands but any others required must be explicitly imported. For example: If one of the commands is: -.PP -.EX - /usr/inferno/runme.dis -f /appl/lib -.EE -.PP -.I Session -will import -.B /usr/inferno/ -but -.B /appl/lib -would have to be specified in the namespace list. -.SS Execution -Once the command and namespace lists have been configured, click -.B Ok -on the -.I Session -window. This will bring up the -.IR query (1) -window containing a list of the available -.IR cpu (4) -resources. To select one or more of these for execution, click on the name with button 3 and it will be added to the list. If a specific -.IR cpu (4) -resource is not required, click button 3 on -.B CPU resource -and select the number you require by clicking on the number following the list entry and dragging the mouse up or down. -.PP -Once the required -.IR cpu (4) -resources have been selected, click -.B Ok -and execution will commence. - - -.SH SOURCE -.B /appl/grid/session.b -.br -.B /appl/grid/ns.b -.br -.B /appl/grid/monitor.b -.br -.B /appl/grid/query.b -.br -.B /appl/grid/lib/browse.b -.br -.B /appl/grid/lib/srvbrowse.b - -.SH "SEE ALSO" -.IR query (1), -.IR registries (2) -.IR ns (1), -.IR cpu (4), -.IR registry (4) -- cgit v1.2.3