Attachment 28548 Details for Bug 23271 – The man page of xqproxy

The man page of xqproxy

xqproxy.1 (text/plain), 3.52 KB, created by Vic Lee on 2009-08-12 07:25:53 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Vic Lee

Created: 2009-08-12 07:25:53 UTC

Size: 3.52 KB

patch

obsolete

>.\" xqproxy - XDMCP Query Proxy
>.\" Copyright (C) 2009 - Vic Lee 
>.\" 
>.\" This program is free software; you can redistribute it and/or modify
>.\" it under the terms of the GNU General Public License as published by
>.\" the Free Software Foundation; either version 2 of the License, or
>.\" (at your option) any later version.
>.\"
>.\" This program is distributed in the hope that it will be useful,
>.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
>.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
>.\" GNU General Public License for more details.
>.\"
>.\" You should have received a copy of the GNU General Public License
>.\" along with this program; if not, write to the Free Software
>.\" Foundation, Inc., 59 Temple Place, Suite 330, 
>.\" Boston, MA 02111-1307, USA.
>.\"
>.de EX		\"Begin example
>.ne 5
>.if n .sp 1
>.if t .sp .5
>.nf
>.in +.5i
>..
>.de EE
>.fi
>.in -.5i
>.if n .sp 1
>.if t .sp .5
>..
>.TH XQPROXY 1 "xqproxy 0.1.0" "X Version 11"
>.SH NAME
>xqproxy \- XDMCP Query Proxy
>.SH SYNOPSIS
>.B xqproxy
>[-display n] [-host hostname] [-port port] [-timeout seconds] [-query [-xauth]]
>[-manage [-sessionid session-id]]
>.SH DESCRIPTION
>.I xqproxy
>is a proxy program that can send XDMCP query to a display manager to establish
>XDM session for an existing local X display.
>.SH OPTIONS
>.PP
>.TP 8
>.B \-display n
>The local display number. Default is 0.
>.PP
>.TP 8
>.B \-host hostname
>The hostname of the remote display manager. Default is localhost.
>.PP
>.TP 8
>.B \-port port
>The XDMCP UDP port of the remote display manager. Default is 177.
>.PP
>.TP 8
>.B \-timeout seconds
>Timeout value while waiting for response from the server.
>.PP
>.TP 8
>.B \-query
>Sends QUERY and REQUEST to the display manager to request a new session. The
>session id and magic cookie will be printed in stdout.
>.PP
>.TP 8
>.B \-xauth
>When use together with -query option, xqproxy will call xauth to add the magic
>cookie to local .Xauthority database.
>.PP
>.TP 8
>.B \-manage
>Sends MANAGE to the display manager to start the session. If this option is
>used together with -query, it will always use the session id returned from the
>display manager. Otherwise, it will uses the session id assigned by -sessionid
>argument.
>.PP
>.TP 8
>.B \-sessionid session-id
>The new session id returned from the display manager. This option is useful
>only if -manage option is used separately.
>.SH EXAMPLES
>.PP
>The following command request the display manager on REMOTEHOST to establish
>an XDM session directly to a local X server on display :1 :
>.PP
>	xqproxy -display 1 -host \fIREMOTEHOST\fP -query -xauth -manage
>.PP
>The following shell script request the display manager supplied by the first
>argument to establish an XDM session over a secure SSH tunnel on a local
>display supplied by the second argument (note that xqproxy runs on the server)
>:
>.PP
>	#!/bin/sh
>.br
>	# Usage: xqssh <server> <local_display_number>
>.br
>	SSH=$(which ssh)
>.br
>	if [ "x$SSH" = "x" ]; then
>.br
>	    echo openssh is required in order to use xqssh.
>.br
>	    exit 1
>.br
>	fi
>.br
>	QUERY=$(ssh $1 xqproxy -display $2 -query)
>.br
>	echo "$QUERY"
>.br
>	SESSIONID=$(echo "$QUERY" | awk '/ACCEPT/ {print substr($3,12)}')
>.br
>	COOKIE=$(echo "$QUERY" | awk '/ACCEPT/ {print substr($7,12,32)}')
>.br
>	if [ "x$SESSIONID" = "x" ] || [ "x$COOKIE" = "x" ]; then
>.br
>	    exit 1
>.br
>	fi
>.br
>	xauth add :$2 MIT-MAGIC-COOKIE-1 $COOKIE
>.br
>	PORT=$(expr 6000 + $2)
>.br
>	ssh -R $PORT:localhost:$PORT -fN $1
>.br
>	ssh $1 xqproxy -display $2 -manage -sessionid $SESSIONID
>.br
>	exit 0
>.PP
>.SH "SEE ALSO"
>ssh(1)
>.SH BUGS
>.PP
>Please send bugs to Vic Lee <llyzs@163.com>
>.SH AUTHORS
>Vic Lee
>

Actions: View

Attachments on bug 23271: 28548 | 29349

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.