SourceFiles.org - Use the Source, Luke

PXDMCP

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 and/or deadlock until you login from another computer and kill the xdmcp client!

LICENSE

This program is free software; you can redistribute it and/or modify it as you wish - as long as you don't claim that you wrote it.

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.

COMPILATION

Run the "configure" script (this is not Gnu autoconf!) and/or edit the Makefile and then compile and build it with "make".

INSTALLATION

Copy the binary wherever you want...

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 -D`uname -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)

-t<a>[,<b>] Set timeout (a = min, b = max) values

EXIT CODES

0 = Normal exit (KEEPALIVE returned not running, or MANAGE returned FAILED) 1 = Usage or unexpected (system) error
2 = QUERY returned UNWILLING
3 = REQUEST returned DECLINE