This is an automated email from the git hooks/post-receive script. x2go pushed a commit to annotated tag 0.1.4.0 in repository x2goclient. commit 7d7b57ab315358f89999767d23f3dc50851303a7 Author: Mike Gabriel <mike.gabriel@das-netzwerkteam.de> Date: Sun May 22 20:57:44 2011 +0200 adds man2html build (so that we have readable man pages in Git) --- .build_man2html/html/pyhoca-cli.1.html | 213 +++++++++++++++++++++++++++++++++ Makefile | 15 +++ debian/control | 1 + debian/pyhoca-cli.docs | 3 +- 4 files changed, 231 insertions(+), 1 deletion(-) diff --git a/.build_man2html/html/pyhoca-cli.1.html b/.build_man2html/html/pyhoca-cli.1.html new file mode 100644 index 00000000..cfa52e0d --- /dev/null +++ b/.build_man2html/html/pyhoca-cli.1.html @@ -0,0 +1,213 @@ +Content-type: text/html + +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<HTML><HEAD><TITLE>Man page of pyhoca-cli</TITLE> +</HEAD><BODY> +<H1>pyhoca-cli</H1> +Section: X2go Application (1)<BR>Updated: 21 May 2011<BR><A HREF="#index">Index</A> +<A HREF="../index.html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +pyhoca-cli - X2go command line client written in Python +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + + + + +<B>pyhoca-cli</B> + + +[ +<I>options</I> +] + + + +<A NAME="lbAD"> </A> +<H2>DESCRIPTION</H2> + +<B>pyhoca-cli</B> aims to be a cross-platform (Windows, Mac OS X, Linux) X2go command line client written +in Python. +<P> + +You can use it +for scripting remote X2go sessions or simply starting, resuming or shadowing X2go sessions from +the command line in a terminal. +<P> + +It supports versatile +command line options as well as parsing <B>x2goclient</B> configuration +files. +<P> + +See the included README and TODO for further information on <B>pyhoca-cli</B>. +<A NAME="lbAE"> </A> +<H2>COMMON OPTIONS</H2> + +<B>pyhoca-cli</B> accepts the following common options: +<DL COMPACT> +<DT><B>-h, --help</B> <DD> +Display a help with all available command line options and exit. +<DT><B>-V, --version</B> <DD> +Output version information and exit. +<DT><B>-d, --debug</B> <DD> +Enable debugging output. +<DT><B>--libdebug</B> <DD> +Enable debugging code of the unterlying Python X2go module. +<DT><B>--libdebug-sftpxfer</B> <DD> +Enable debugging code of Python X2go's sFTP server code (very verbose, and it may even reveal promiscuous data). +</DL> +<A NAME="lbAF"> </A> +<H2>SERVER</H2> + +<DL COMPACT> +<DT><B>--server</B> <I><HOSTNAME_or_IP></I> <DD> +If not in LDAP mode you always have to name the remote X2go server's hostname or IP address. +</DL> +<A NAME="lbAG"> </A> +<H2>ACTIONS</H2> + +<B>pyhoca-cli</B> accepts exclusively one of the listed actions: +<DL COMPACT> +<DT><B>-N, --new</B> <DD> +Start a new X2go session on server (default mode if no mode is explicitly specified). +<DT><B>-R, --resume</B> <I><SESSION_NAME></I> <DD> +Resume existing X2go session <SESSION_NAME> on server. +<DT><B>-S, --suspend</B> <I><SESSION_NAME></I> <DD> +Suspend running X2go session <SESSION_NAME>. +<DT><B>-T, --terminate</B> <I><SESSION_NAME></I> <DD> +Terminate running X2go session <SESSION_NAME> . +<DT><B>-L, --list-sessions</B> <DD> +List user's X2go sessions on server. +</DL> +<A NAME="lbAH"> </A> +<H2>X2GO OPTIONS</H2> + +<DL COMPACT> +<DT><B>--config</B> <I><CONFIG_FILENAME></I> <DD> +NOT IMPLEMENTED YET: X2goclient config file containing x2go client session settings (default: ~/.x2goclient/sessions). +<DT><B>-c, --command</B> <I><CMD></I> <DD> +Command to run with <B>--new</B> mode on server (default: xterm). +<DT><B>-u, --username</B> <I><USERNAME></I> <DD> +Username for the session (default: currently logged in user). +<DT><B>--password</B> <I><PASSWORD></I> <DD> +User password for this session. If a matching private SSH key is available this one will be preferred for +authentication. The cleartext password that has been specified at the command line will be masqueraded in +the systems process list (Linux, MacOS). On Windows systems the usage of the --password option is forbidden. +<DT><B>-p, --remote-ssh-port</B> <I><R_PORT></I> <DD> +Remote X2go server's SSH port (default: 22). +<DT><B>-k, --ssh-privkey</B> <I><SSH_PRIVKEY></I> <DD> +Use file <SSH_PRIVKEY> as private key for SSH connections (default: ~/.ssh/id_rsa). +<DT><B>--add-to-known-hosts</B> <DD> +Add RSA/DSA host key to ~/.ssh/known_hosts if authenticity of server can't be established (default: not set). +<DT><B>--sound</B> <I>{pulse|esd|none}</I> <DD> +X2go server's sound system (default: 'pulse'). +<DT><B>-F, --share-local-folders</B> <I><folder1>[,<folder2>[,...]]</I> <DD> +A comma separated list of local folders that shall be made available in the remote X2go session. +<DT><B>--printing</B> <DD> +Use X2go printing (default: disabled). +<DT><B>--clean-sessions</B> <DD> +Clean all of the user's suspended/running sessions before starting a new one on the named X2go server. +<DT><B>--time-to-wait</B> <DD> +Time to wait for session startup/resume (default: 8s). There should be no need to touch this, unless on very slow network connections. +</DL> +<A NAME="lbAI"> </A> +<H2>LDAP OPTIONS</H2> + +LDAP support is planned to be added into <B>pyhoca-cli</B> in the near future. So stay tuned... +<P> + +<A NAME="lbAJ"> </A> +<H2>NX OPTIONS (Version 3) </H2> + +<DL COMPACT> +<DT><B>-g, --geometry</B> <I>{<WIDTH>x<HEIGHT>|fullscreen}</I> <DD> +Screen geometry (default: '800x600'). +<DT><B>-q, --link</B> <I>{modem|isdn|adsl|wan|lan}</I> <DD> +link quality (default: 'adsl') +<DT><B>-t, --session-type</B> <I>{desktop|application}</I> <DD> +Session type (default: 'application'). Note: there are also some auto-detection +feature for the session type built into the code. +It might not always happen what you expect from setting this option. +<DT><B>-p, --pack</B> <I><PACK_METHOD></I><DD> +Compression method (see below for possible values). +<DT><B>--kbd-layout</B> <I>{us|de|fr|...}</I><DD> +Use keyboard layout (default: 'us'). +<DT><B>--kbd-type</B> <I>{pc105/us|pc105/de|...}</I><DD> +Set Keyboard type (default 'pc105/us'). +</DL> +<A NAME="lbAK"> </A> +<H2>COMPATIBILITY OPTIONS</H2> + +<B>pyhoca-cli</B> aims at being fully compatible with all command line options and session config files of the X2go project's X2go command +line client <B>x2goclient-cli</B> as well as the <B>x2goclient</B> GUI. This is still work in progress. +To achieve this, some compatibility options have already +been added: +<DL COMPACT> +<DT><B>--port</B> <I><R_PORT></I><DD> +Compatibility option, synonymous to <B>--remote-ssh-port</B> <I><R_PORT></I>. +<DT><B>--ssh-key</B> <I><SSH_PRIVKEY></I><DD> +Compatibility option, synonymous to <B>--ssh-privkey</B> <I>SSH_KEY</I>. +<DT><B>--use-sound</B> <I>{yes|no}</I><DD> +Compatibility option, synonymous to <B>--sound</B> <I>{pulse|none}</I>. +<DT><B>--client-ssh-port</B> <I><PORT></I> <DD> +Compatibility option for the x2goclient GUI. PyHoca-Cli (resp. Python X2go) brings its own internal sFTP server. Thus, this option will be ignored. +</DL> +<A NAME="lbAL"> </A> +<H2>NX COMPRESSION METHODS</H2> + +As NX compression methods (<B>--pack</B> option) the following values are possible. The % character must be replaced by a digit 0-9. +<P> + +nopack, 8, 64, 256, 512, 4k, 32k, 64k, 256k, 2m, 16m +256-rdp, 256-rdp-compressed, 32k-rdp, 32k-rdp-compressed, 64k-rdp +64k-rdp-compressed, 16m-rdp, 16m-rdp-compressed +rfb-hextile, rfb-tight, rfb-tight-compressed +8-tight, 64-tight, 256-tight, 512-tight, 4k-tight, 32k-tight +64k-tight, 256k-tight, 2m-tight, 16m-tight +8-jpeg-%, 64-jpeg, 256-jpeg, 512-jpeg, 4k-jpeg, 32k-jpeg +64k-jpeg, 256k-jpeg, 2m-jpeg, 16m-jpeg-% +8-png-jpeg-%, 64-png-jpeg, 256-png-jpeg, 512-png-jpeg, 4k-png-jpeg +32k-png-jpeg, 64k-png-jpeg, 256k-png-jpeg, 2m-png-jpeg, 16m-png-jpeg-% +8-png-%, 64-png, 256-png, 512-png, 4k-png +32k-png, 64k-png, 256k-png, 2m-png, 16m-png-% +16m-rgb-%, 16m-rle-% +<A NAME="lbAM"> </A> +<H2>SEE ALSO</H2> + +<B>/usr/share/doc/python-x2go</B> +<A NAME="lbAN"> </A> +<H2>AUTHOR</H2> + +This manual has been written by for the X2go project (<A HREF="http://www.x2go.org)">http://www.x2go.org)</A> by +<P> +Mike Gabriel <<A HREF="mailto:mike.gabriel@das-netzwerkteam.de">mike.gabriel@das-netzwerkteam.de</A>> +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">DESCRIPTION</A><DD> +<DT><A HREF="#lbAE">COMMON OPTIONS</A><DD> +<DT><A HREF="#lbAF">SERVER</A><DD> +<DT><A HREF="#lbAG">ACTIONS</A><DD> +<DT><A HREF="#lbAH">X2GO OPTIONS</A><DD> +<DT><A HREF="#lbAI">LDAP OPTIONS</A><DD> +<DT><A HREF="#lbAJ">NX OPTIONS (Version 3) </A><DD> +<DT><A HREF="#lbAK">COMPATIBILITY OPTIONS</A><DD> +<DT><A HREF="#lbAL">NX COMPRESSION METHODS</A><DD> +<DT><A HREF="#lbAM">SEE ALSO</A><DD> +<DT><A HREF="#lbAN">AUTHOR</A><DD> +</DL> +<HR> +This document was created by +<A HREF="/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 18:55:01 GMT, May 22, 2011 +</BODY> +</HTML> diff --git a/Makefile b/Makefile new file mode 100644 index 00000000..226b6c86 --- /dev/null +++ b/Makefile @@ -0,0 +1,15 @@ +#!/usr/bin/make -f + +man_pages = pyhoca-cli.1 + +MAN2HTML = man2html +SRC = man +DEST = .build_man2html/html + +all: build + +build: $(man_pages) + +pyhoca-cli.1: + mkdir -p $(DEST) + $(MAN2HTML) -r $(SRC)/$@ > $(DEST)/$@.html diff --git a/debian/control b/debian/control index 795ec9af..020d2090 100644 --- a/debian/control +++ b/debian/control @@ -4,6 +4,7 @@ Priority: optional Maintainer: Mike Gabriel <mike.gabriel@das-netzwerkteam.de> Build-Depends: debhelper (>= 7), + man2html, python, python-setuptools, python-support, diff --git a/debian/pyhoca-cli.docs b/debian/pyhoca-cli.docs index 1d23e9b9..efae7f1a 100644 --- a/debian/pyhoca-cli.docs +++ b/debian/pyhoca-cli.docs @@ -1,2 +1,3 @@ README -TODO \ No newline at end of file +TODO +.build_man2html/html \ No newline at end of file -- Alioth's /home/x2go-admin/maintenancescripts/git/hooks/post-receive-email on /srv/git/code.x2go.org/x2goclient.git