PXDMCP

Copyright (c) 2005 Peter Eriksson <pen@lysator.liu.se>

This is the README file for PXDMCP, an XDMCP standalone client that can be used to request an X11 Display Manager (XDM, GDM, CDE dtlogin etc) to start a new terminal session (normally used to bring up a login window) using the XDMCP protocol. This in effect does the same thing as an X server does when started with the "-query" argument but can be used in circumstances where that might be impractical.

WARNING:

Do NOT simply run the client without directing it to the right X server since it by default will try to utilize the server pointed out by the DISPLAY variable which normally is your current display - then you'll probably find that your desktop has been taken over by a remote session or deadlock until you login from another computer and kill the xdmcp client!

COMPILATION

Edit the Makefile (probably only need to change the LIBS and XAUTH definitions) and then compile and build it with "make".

USAGE

The client can be used in various ways, but here's an example using the Xvnc server:

Xvnc :50 -auth /var/tmp/authfile &

xdmcp -k2 -v -Duname -n:50 -A/var/tmp/authfile xdm-server

By default the client will check the DISPLAY and XAUTHORITY environment variables and use those values if you don't supply the -D and -A flags.

If the DISPLAY variable is of the form ":DPY[.SCR]" then the client will compute a new DISPLAY variable by prepending the official hostname of the system before submitting this value to the remote XDMCP server.

Please note that this might not be the correct value for your application!

If you omit the XDM server argument then it by default will try to contact an XDM server on the local host.

COMMAND LINE OPTIONS

-h Print a short summary of valid switches -V Print the version -d[<n>] Enable debugging output -v[<n>] Enable verbose output -D<d> Display for the manager to contact -A<f> X authentication file to update -a<p> Path to the xauth program -k<n> Keepalive mode (0 = disabled, 1 = send, 2 = send & monitor)