diff options
Diffstat (limited to 'README')
| -rw-r--r-- | README | 90 |
1 files changed, 90 insertions, 0 deletions
@@ -0,0 +1,90 @@ +$Xorg: README,v 1.3 2000/08/17 19:55:04 cpqbld Exp $ + +README file for the X Session Manager (xsm) +------------------------------------------- + +xsm is a session manager. A session is a group of applications, each +of which has a particular state. xsm allows you to create arbitrary +sessions - for example, you might have a "light" session, a "development" +session, or an "xterminal" session. Each session can have its own set of +applications. Within a session, you can perform a "checkpoint" to save +application state, or a "shutdown" to save state and exit the session. When +you log back in to the system, you can load a specific session, and you can +delete sessions you no longer want to keep. + +Some session managers simply allow you to manually specify a list of +applications to be started in a session. xsm is more powerful because it +lets you run applications and have them automatically become part of the +session. On a simple level, xsm is useful because it gives you this ability +to easily define which applications are in a session. The true power of +xsm, however, can be taken advantage of when more and more applications +learn to save and restore their state. + +This README file discusses the necessary steps you must take to run xsm. To +learn more about the details of xsm's functionality, read the xsm man page. + +Before building xsm, you should make sure you have the following libraries +built on your system with all fix-trackers patches applied: + +libICE - the Inter Client Exchange Library +libSM - the Session Management Library +libXt - the X Toolkit with support for session management + +To build these libraries, you would change your current directory to +lib/ICE, lib/SM, or lib/Xt and do the following: + +make Makefile +make includes +make depend +make + + +Once you are sure all of the required libraries are built, you are ready +to build xsm. + +Change your current directory to workInProgress + +make Makefiles SUBDIRS=xsm +cd xsm +make includes +make depend +make install + + +Before you can run xsm, you must make sure that the following programs are +built and installed on your system with all fix-trackers patches applied: + +smproxy - the session manager proxy for applications that don't support + R6 style session management +iceauth - handles storing/retrieving ICE authentication information +rstart - allows xsm to start applications on remote machines +twm - window manager that support R6 style session management - takes + care of saving window configurations in a session + +To build and install these programs, you would change your current directory +to programs/smproxy, programs/iceauth, programs/rstart, or programs/twm and +do the following: + +make Makefile +make includes +make depend +make install + + +Note that to install rstart, you will need to have root privileges because +the program must be installed in a system wide default path. + +*** rstart and iceauth should be installed on each machine that you expect + to run applications on that will be part of your session *** + +Also note that twm is the default window manager that xsm starts up. If you +would like to use a different window manager, follow the instructions in the +xsm man page for defining the default startup applications. Be aware that if +the window manager you choose has not been modified to support R6 style +session management, window configurations will not be saved in your sessions. + +Once again, for more information about actually using xsm, please read the +xsm man page. + +To learn more about making your applications "session aware", consult the +X Toolkit Intrinsics documentation. |