XOWNROOT(1)                          BSD                           XOWNROOT(1)



NAME
     xownroot - switch between X and DM ownership of the root while the X
     server is running

SYNOPSIS
     xownroot [-help] [-display display] [-on] [-off]

DESCRIPTION
     The xownroot program lets you transfer ownership of the background root
     window between the shared X server and the Apollo DM.  You can perform
     the switch between the two environments (between Xapollo(1)'s s+r+ and
     s+r- modes) while the shared X server is running without needing to kill
     and restart it.

     xownroot calls XapolloGetRectangleForWindow to discover the Rectangle
     Manager rectangle id for the root window.  It then either "disowns" the
     root window with XapolloDisownWindow or takes responsibility for it by
     "owning" it with XapolloOwnRectangle. xownroot is thus neither taking the
     root away from anything specific, nor giving it to anything specific.
     You must manually turn on/off X window management by starting/killing an
     X window manager such as uwm. Similarly, you must explicitly tell the DM
     to assume/give up responsibility for the root window and turn on/off its
     window management functions with the wmgr -on/off commands.  Indeed, the
     system taking responsibility for the root and window management need not
     necessarily be the DM.

     Trying to run both systems' window managers at once is likely to lead to
     abnormal behavior and possible hangs.   Problems with displaying the root
     background or other abnormalities might occur if both systems own the
     root window.  If X owns the root, use an X window manager; if DM owns the
     root, use the DM as the window  manager.


     xownroot is thus expected to exist within a shell script such as:

     tox:
          #! /bin/csh
          /com/xdmc wmgr -off
          xownroot -on
          uwm &

     todm:
          #! /bin/csh
          set wmpid=`/bin/ps ax|grep "*wm"|head -1|/bin/awk '{print $1}'`
          while ( $wmpid != "")
              kill $wmpid;   sleep 3
              set wmpid=`/bin/ps ax|grep "*wm"|head -1|/bin/awk '{print $1}'`
          end
          usr/X11/bin/xownroot -off
          usr/apollo/bin/xdmc wmgr -on

     If no options are specified, the current mode is toggled.

OPTIONS
     The various options are as follows:

     -help
          Print a usage message and exit.

     -on  Own the root window.

     -off Disown the root window.

     -display display
          Specifies the server to connect to; see X(1).

SEE ALSO
     X(1), Xapollo(1)

COPYRIGHT
     Copyright 1988, 1989, Apollo Computer, Inc.
     See X(1) for a full statement of rights and permissions.

AUTHOR
     Joe Bowbeer, Apollo Computer, Inc.