| 1 |
README file for the X Session Manager (xsm) |
| 2 |
------------------------------------------- |
| 3 |
|
| 4 |
xsm is a session manager. A session is a group of applications, each |
| 5 |
of which has a particular state. xsm allows you to create arbitrary |
| 6 |
sessions - for example, you might have a "light" session, a "development" |
| 7 |
session, or an "xterminal" session. Each session can have its own set of |
| 8 |
applications. Within a session, you can perform a "checkpoint" to save |
| 9 |
application state, or a "shutdown" to save state and exit the session. When |
| 10 |
you log back in to the system, you can load a specific session, and you can |
| 11 |
delete sessions you no longer want to keep. |
| 12 |
|
| 13 |
Some session managers simply allow you to manually specify a list of |
| 14 |
applications to be started in a session. xsm is more powerful because it |
| 15 |
lets you run applications and have them automatically become part of the |
| 16 |
session. On a simple level, xsm is useful because it gives you this ability |
| 17 |
to easily define which applications are in a session. The true power of |
| 18 |
xsm, however, can be taken advantage of when more and more applications |
| 19 |
learn to save and restore their state. |
| 20 |
|
| 21 |
This README file discusses the necessary steps you must take to run xsm. To |
| 22 |
learn more about the details of xsm's functionality, read the xsm man page. |
| 23 |
|
| 24 |
Before building xsm, you should make sure you have the following libraries |
| 25 |
built on your system: |
| 26 |
|
| 27 |
libICE - the Inter Client Exchange Library |
| 28 |
libSM - the Session Management Library |
| 29 |
libXt - the X Toolkit with support for session management |
| 30 |
|
| 31 |
Once you are sure all of the required libraries are built, you are ready |
| 32 |
to build xsm. |
| 33 |
|
| 34 |
Before you can run xsm, you must make sure that the following programs are |
| 35 |
built and installed on your system: |
| 36 |
|
| 37 |
smproxy - the session manager proxy for applications that don't support |
| 38 |
R6 style session management |
| 39 |
iceauth - handles storing/retrieving ICE authentication information |
| 40 |
rstart - allows xsm to start applications on remote machines |
| 41 |
twm - window manager that support R6 style session management - takes |
| 42 |
care of saving window configurations in a session |
| 43 |
|
| 44 |
Note that to install rstart, you will need to have root privileges because |
| 45 |
the program must be installed in a system wide default path. |
| 46 |
|
| 47 |
*** rstart and iceauth should be installed on each machine that you expect |
| 48 |
to run applications on that will be part of your session *** |
| 49 |
|
| 50 |
Also note that twm is the default window manager that xsm starts up. If you |
| 51 |
would like to use a different window manager, follow the instructions in the |
| 52 |
xsm man page for defining the default startup applications. Be aware that if |
| 53 |
the window manager you choose has not been modified to support R6 style |
| 54 |
session management, window configurations will not be saved in your sessions. |
| 55 |
|
| 56 |
Once again, for more information about actually using xsm, please read the |
| 57 |
xsm man page. |
| 58 |
|
| 59 |
To learn more about making your applications "session aware", consult the |
| 60 |
X Toolkit Intrinsics documentation. |