[X2Go-Commits] page changed: usage:pyhoca-cli

wiki-admin at x2go.org wiki-admin at x2go.org
Thu Mar 14 22:20:21 CET 2013


A page in your DokuWiki was added or changed. Here are the details:

Date        : 2013/03/14 21:20
Browser     : Mozilla/5.0 (X11; Linux x86_64; rv:18.0) Gecko/20100101 Firefox/18.0 Iceweasel/18.0.1
IP-Address  : 46.142.39.109
Hostname    : 109-39-142-46.pool.kielnet.net
Old Revision: http://wiki.x2go.org/doku.php/usage:pyhoca-cli?rev=1363039916
New Revision: http://wiki.x2go.org/doku.php/usage:pyhoca-cli
Edit Summary: removed
User        : sunweaver

@@ -1,93 +1 @@
- ====== Using PyHoca-CLI ======
  
- The name PyHoca is a word play combining two powerful entities: Python and Phoca (mascot of X2go, Latin species name for seals). 
- 
- PyHoca-CLI is a client implementation for X2Go using [[wiki:libs:python-x2go|the project's Python API]] (Python module). PyHoca-CLI can be operated completely from the command line and the goal is to reflect the full functionality spectrum of [[wiki:libs:python-x2go]]. 
- 
- ===== PyHoca-CLI Command Line Arguments =====
- 
- PyHoca-CLI has a man page.

- 
- On your GNU/Linux system execute 
- 
-      $ man pyhoca-cli
- 
- An always up-to-date html version of the pyhoca-cli man page can be be retrieved from the X2go Git repository: [[http://code.x2go.org/doc/pyhoca-cli/man/man1/pyhoca-cli.1.html|man pyhoca-cli]].
- 
- //Security notice:// amongst many options PyHoca-CLI offers a ''--password'' option. You should never use this password option from the command line, directly (as it will probably appear in the command history of your terminal shell). However, it might be handy for some of you to use this option when calling ''pyhoca-cli'' from within your own scripts.
- 
- The ''--password'' value (i.e. the actual password passed to PyHoca-CLI) will also be obfuscated in the process list of your system (*nix operating systems only).
- 
- Note: On Windows systems the ''--password'' option is disabled, and so not available.
- 
- ===== Starting PyHoca-CLI =====
- 
- To start an X2go session for remote user ''foo'' on X2go server
''myserver.local'' with PyHoca-CLI open a terminal window and execute the following command:
- 
- <code>
- $ pyhoca-cli --server myserver.local -N -c GNOME --user foo --add-to-known-hosts
- </code>
- 
- If you have a valid X2go session profile configuration ($HOME/.x2goclient/sessions file) you can also use the ''--session-profile'' option. For a session profile in x2goclient's ''sessions'' file named //MyProfile// use this command:
- 
- <code>
- $ pyhoca-cli --session-profile MyProfile
- </code>
- 
- ===== Desktop Sharing with PyHoca-CLI =====
- 
- To share an already running local or remote X2Go desktop session of user //foo// on X2Go Server ''myserver.local'' with PyHoca-CLI open a terminal window and execute the following commands:
- 
- <code>
- $ pyhoca-cli --server myserver.local --list-desktops --user foo --add-to-known-hosts
- </code>
- 
- Now a list of available/sharable desktop sessions will be shown (your///foo//'s own desktops are always sharable), e.g. ''foo@:0'' (local
desktop on the server):
- 
- <code>
- someone at client:~$ pyhoca-cli --server myserver.local --list-desktops
- pyhoca-cli[20238] NOTICE: preparing requested X2Go session
- pyhoca-cli[20238] (PyHocaCLI) NOTICE: preparing requested X2Go session
- pyhoca-cli[20238] (x2gosessregistry-pylib) NOTICE: registering X2Go session Pyhoca-Client_Session...
- pyhoca-cli[20238] (x2goclient-pylib) NOTICE: initializing X2Go session...
- pyhoca-cli[20238] (x2gocontrolsession-pylib) NOTICE: connecting to myserver.local
- 
- X2Go desktops available for sharing
- ===================================
- Host: myserver.local - [<ip-address>]:<port>
- Username: foo
- 
- foo@:0
- foo@:51
- bar@:52
- </code>
- 
- To view //foo//'s local desktop session ''foo@:0'' use this command line:
- 
- <code>
- someone at client:~$ pyhoca-cli --server myserver.local --share-desktop foo@:0 --user foo --add-to-known-hosts
- </code>
- 
- The next change in the command line (''--share-mode 1'') will enable you to access //foo//'s
local desktop in full (read-write) access mode...
- 
- <code>
- someone at client:~$ pyhoca-cli --server myserver.local --share-desktop foo@:0 --share-mode 1 --user foo --add-to-known-hosts
- </code>
- 
- If //foo// is logged in via X2Go on desktop ''foo@:51'', you could connect to that desktop as well...
- 
- <code>
- someone at client:~$ pyhoca-cli --server myserver.local --share-desktop foo@:51 --share-mode 1 --user foo --add-to-known-hosts
- </code>
- 
- And if another user //bar// on your X2Go Server has enabled desktop sharing (more info [[:wiki:components:desktop-sharing|here]]), then you could use this command to let user //foo// view user //bar//'s desktop session...
- 
- <code>
- someone at client:~$ pyhoca-cli --server myserver.local --share-desktop bar@:52 --user foo --add-to-known-hosts
- </code>
- 
- 
- ===== Further Readings =====
- 
- For further readings, please consult the README and TODO documentation files in the PyHoca-CLI source tree on the
[[http://code.x2go.org/gitweb?p=pyhoca-cli.git;a=tree|X2Go Git site]].
-  



-- 
This mail was generated by DokuWiki at
http://wiki.x2go.org/




More information about the x2go-commits mailing list