This is an automated email from the git hooks/post-receive script. x2go pushed a change to branch master in repository x2gobroker. from 9cfc3b9 Allow for broker clients to send in public SSH keys that the client may use for authentication to X2Go Servers. new 886ad35 Add new man page for x2gobroker-testagent. new 964fe6f allow cmdline option alias '--user' new 0be244e install x2gobroker-testagent into .deb and .rpm packages The 3 revisions listed above as "new" are entirely new to this repository and will be described in separate emails. The revisions listed as "adds" were already present in the repository and have only been added to this reference. Summary of changes: Makefile | 4 +- debian/x2gobroker.install | 1 + debian/x2gobroker.manpages | 1 + man/man8/x2gobroker-testagent.8 | 84 +++++++++++++++++++++++++++++++++++++++ sbin/x2gobroker-testagent | 2 +- x2gobroker.spec | 2 + 6 files changed, 92 insertions(+), 2 deletions(-) create mode 100644 man/man8/x2gobroker-testagent.8 -- Alioth's /srv/git/_hooks_/post-receive-email on /srv/git/code.x2go.org/x2gobroker.git
This is an automated email from the git hooks/post-receive script. x2go pushed a commit to branch master in repository x2gobroker. commit 886ad3525c0c813944ab5c9a200abec760951743 Author: Mike Gabriel <mike.gabriel@das-netzwerkteam.de> Date: Tue Mar 18 23:39:55 2014 +0100 Add new man page for x2gobroker-testagent. --- man/man8/x2gobroker-testagent.8 | 84 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 84 insertions(+) diff --git a/man/man8/x2gobroker-testagent.8 b/man/man8/x2gobroker-testagent.8 new file mode 100644 index 0000000..4f772fc --- /dev/null +++ b/man/man8/x2gobroker-testagent.8 @@ -0,0 +1,84 @@ +'\" -*- coding: utf-8 -*- +.if \n(.g .ds T< \\FC +.if \n(.g .ds T> \\F[\n[.fam]] +.de URL +\\$2 \(la\\$1\(ra\\$3 +.. +.if \n(.g .mso www.tmac +.TH x2gobroker-testagent 8 "Mar 2014" "Version 0.0.3.x" "X2Go Session Broker" +.SH NAME +x2gobroker-testagent \- Session Broker for X2Go (Agent Test Utility) +.SH SYNOPSIS +'nh +.fi +.ad l +\fBx2gobroker-testagent\fR \kx +.if (\nx>(\n(.l/2)) .nr x (\n(.l/5) +'in \n(.iu+\nxu +[ +\fIoptions\fR +] +'in \n(.iu-\nxu +.ad b +'hy +.SH DESCRIPTION +\fBx2gobroker-testagent\fR is a test utility for local/remote X2Go Session Broker Agents. +The \fBx2gobroker-testagent\fR has to run as super-user root. +.PP +The \fBx2gobroker-testagent\fR +tool is normally run on the machine that acts as the X2Go Session Broker. +.PP +The \fBx2gobroker-testagent\fR tries to connect to a local or remote X2Go Session Broker Agent. +X2Go Broker Agents are co-installed on X2Go Server hosts and support the broker in controlling +that X2Go Server. +.PP +The \fBx2gobroker-testagent\fR executes a test task on the broker agent. +The broker agent tries to switch to the given user's context and runs the given task on behalf of that user. +.SH COMMON OPTIONS +\fBx2gobroker-testagent\fR provides help on command line options: +.TP +\*(T<\fB\-h, \-\-help\fR\*(T> +Display a help with all available command line options and exit. +.SH REQUIRED OPTIONS +You can either list the broker agent's tasks that are avilable for testing: +.TP +\*(T<\fB\-\-list\-tasks\fR\*(T> +Render a list of available broker agent tasks. This list shows what can be tested. The capabilities +of the remote agent and the broker server's test code are compared and displayed. +.PP +Or run a given task on behalf of an X2Go user on a local or remote broker agent: +.TP +\*(T<\fB\-u, \-\-user, \-\-username\fR\*(T> +Instruct the broker agent to switch to this user's context when running the given task on +the local/remote host. +.TP +\*(T<\fB\-t TASK, \-\-task TASK\fR\*(T> +The task that shall be test-executed on the remote broker agent. +.SH REMOTE BROKER OPTIONS +The default mode for calling the X2Go Session Broker Agent is "LOCAL". Alternatively, remote broker +agents can be called via mode "SSH". For this, you additionally need to specify the below options: +.TP +\*(T<\fB\-H HOSTNAME, \-\-host HOSTNAME\fR\*(T> +Hostname to connect to via SSH for running remote broker agent test commands. +.TP +\*(T<\fB\-p PORT, \-\-port PORT\fR\*(T> +The TCP/IP port that the remote system's SSH daemon listens on (default: 22). +.SH MISC OPTIONS +\fBx2gobroker-testagent\fR also accepts the following miscellaneous options: +.TP +\*(T<\fB\-d, \-\-debug\fR\*(T> +Enable debugging code. +.TP +\*(T<\fB\-C, \-\-config FILENAME\fR\*(T> +Specify an alternative configuration file name, default is: \fI/etc/x2go/x2gobroker.conf\fR. +.SH "FILES" +/etc/x2go/x2gobroker.conf, /etc/x2go/broker/* (configuration files) +.PP +/etc/x2go/broker/defaults.conf (environment for X2Go Session Broker) +.PP +/var/log/x2gobroker/* (log files of X2Go Session Broker) +.SH "SEE ALSO" +\fB/usr/share/doc/x2gobroker\fR +.SH AUTHOR +This manual has been written for the X2Go project by +Mike Gabriel <mike.gabriel@das-netzwerkteam.de>. -- Alioth's /srv/git/_hooks_/post-receive-email on /srv/git/code.x2go.org/x2gobroker.git
This is an automated email from the git hooks/post-receive script. x2go pushed a commit to branch master in repository x2gobroker. commit 964fe6f085b188285daae6f402aae18f59c14565 Author: Mike Gabriel <mike.gabriel@das-netzwerkteam.de> Date: Tue Mar 18 23:40:25 2014 +0100 allow cmdline option alias '--user' --- sbin/x2gobroker-testagent | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sbin/x2gobroker-testagent b/sbin/x2gobroker-testagent index c22b5a7..4c6a26e 100755 --- a/sbin/x2gobroker-testagent +++ b/sbin/x2gobroker-testagent @@ -53,7 +53,7 @@ if __name__ == "__main__": {'args':['--drop-privileges'], 'default': False, 'action': 'store_true', 'help': 'Drop privileges to user {x2gobroker} (recommended)'.format(x2gobroker=x2gobroker.defaults.X2GOBROKER_DAEMON_USER), }, {'args':['-H','--host'], 'default': 'LOCAL', 'metavar': 'HOSTNAME', 'help': 'Test X2Go Session Broker Agent on this host (default: LOCAL)', }, {'args':['-p','--port'], 'default': 22, 'metavar': 'PORT', 'help': 'For remote agent calls (via SSH) use this port as SSH port (default: 22)', }, - {'args':['-u','--username'], 'default': None, 'metavar': 'USERNAME', 'help': 'When testing the broker agent, test on behalf of this user (default: none)', }, + {'args':['-u','--username', '--user'], 'default': None, 'metavar': 'USERNAME', 'help': 'When testing the broker agent, test on behalf of this user (default: none)', }, {'args':['-t','--task'], 'default': 'PING_ICMP', 'metavar': 'AGENT_TASK', 'help': 'Perform this task on the (remote) broker agent', }, {'args':['--list-tasks'], 'default': False, 'action': 'store_true', 'help': 'List available broker agent tasks', }, ] -- Alioth's /srv/git/_hooks_/post-receive-email on /srv/git/code.x2go.org/x2gobroker.git
This is an automated email from the git hooks/post-receive script. x2go pushed a commit to branch master in repository x2gobroker. commit 0be244e2cf63940a38e420789cb540d5de449724 Author: Mike Gabriel <mike.gabriel@das-netzwerkteam.de> Date: Tue Mar 18 23:40:44 2014 +0100 install x2gobroker-testagent into .deb and .rpm packages --- Makefile | 4 +++- debian/x2gobroker.install | 1 + debian/x2gobroker.manpages | 1 + x2gobroker.spec | 2 ++ 4 files changed, 7 insertions(+), 1 deletion(-) diff --git a/Makefile b/Makefile index 0d90bf3..fcf9dba 100755 --- a/Makefile +++ b/Makefile @@ -137,9 +137,11 @@ install: "${DESTDIR}${MANDIR}/man8" ${INSTALL_FILE} man/man1/x2gobroker{,-testauth}.1* \ "${DESTDIR}${MANDIR}/man1" - ${INSTALL_FILE} man/man8/x2gobroker-keygen.8* \ + ${INSTALL_FILE} man/man8/x2gobroker{-keygen,-testagent}.8* \ "${DESTDIR}${MANDIR}/man8" ${INSTALL_PROGRAM} bin/x2gobroker bin/x2gobroker-testauth \ "${DESTDIR}${BINDIR}/" ${INSTALL_PROGRAM} sbin/x2gobroker-keygen "${DESTDIR}${SBINDIR}/" + ${INSTALL_PROGRAM} bin/x2gobroker bin/x2gobroker-testagent \ + "${DESTDIR}${SBINDIR}/" diff --git a/debian/x2gobroker.install b/debian/x2gobroker.install index bf0e5f5..2ca9256 100644 --- a/debian/x2gobroker.install +++ b/debian/x2gobroker.install @@ -1,3 +1,4 @@ bin/x2gobroker usr/bin/ bin/x2gobroker-testauth usr/bin/ sbin/x2gobroker-keygen usr/sbin/ +sbin/x2gobroker-testagent usr/sbin/ diff --git a/debian/x2gobroker.manpages b/debian/x2gobroker.manpages index 2942f0c..44c2255 100644 --- a/debian/x2gobroker.manpages +++ b/debian/x2gobroker.manpages @@ -1,3 +1,4 @@ man/man1/x2gobroker.1 man/man1/x2gobroker-testauth.1 man/man8/x2gobroker-keygen.8 +man/man8/x2gobroker-testagent.8 diff --git a/x2gobroker.spec b/x2gobroker.spec index d91a937..0be602f 100644 --- a/x2gobroker.spec +++ b/x2gobroker.spec @@ -357,8 +357,10 @@ fi; %_bindir/x2gobroker %_bindir/x2gobroker-testauth %_sbindir/x2gobroker-keygen +%_sbindir/x2gobroker-testagent %_mandir/man1/x2gobroker*.1* %_mandir/man8/x2gobroker-keygen.8* +%_mandir/man8/x2gobroker-testagent.8* %files -n python-x2gobroker -- Alioth's /srv/git/_hooks_/post-receive-email on /srv/git/code.x2go.org/x2gobroker.git