home *** CD-ROM | disk | FTP | other *** search
- #!/bin/sh
- #
- # Orca
- #
- # Copyright 2006 Sun Microsystems Inc.
- #
- # This library is free software; you can redistribute it and/or
- # modify it under the terms of the GNU Library General Public
- # License as published by the Free Software Foundation; either
- # version 2 of the License, or (at your option) any later version.
- #
- # This library 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. See the GNU
- # Library General Public License for more details.
- #
- # You should have received a copy of the GNU Library General Public
- # License along with this library; if not, write to the
- # Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- # Boston, MA 02111-1307, USA.
-
- # This script performs some clean up and will run Orca. It will also
- # rerun Orca if it detects that Orca died an unnatural death.
-
- # __id__ = "$Id: orca.in,v 1.14 2006/08/18 22:19:46 wwalker Exp $"
- # __version__ = "$Revision: 1.14 $"
- # __date__ = "$Date: 2006/08/18 22:19:46 $"
- # __copyright__ = "Copyright (c) 2005-2006 Sun Microsystems Inc."
- # __license__ = "LGPL"
-
- # If you set RUNONCE to "true", then this will just run Orca once and quit.
- #
- RUNONCE="false"
-
- # A value of 1 means to run Orca. A value of 0 means quit.
- #
- RUN=1
-
- # Initially there will be no watchdog process id.
- #
- watchdog_pid=0
-
- # Save the arguments away.
- #
- ARGS="$*"
-
- # The watchdog will periodically ping Orca to see if it is responding.
- # If orca isn't responding, the watchdog will kill the Orca process.
- # The watchdog logic requires 'wget', so we won't do it if we can't
- # find wget in the path. Note also that you can force WATCHDOG=0 if you
- # do not want a background process that periodically pings Orca to see
- # if it is responding.
- #
- IFS=:
- WGETCMD=
- WATCHDOG=0
- for dir in $PATH:/usr/sfw/bin:/usr/local/bin; do
- test -x "$dir/wget" && {
- WGETCMD="$dir/wget"
- WATCHDOG=1
- break
- }
- done
-
- # Cleans up any orca-related processes that might be running,
- # restricting it to those processes owned by the user. These include
- # orca itself, any gnome-speech synthesis drivers, and festival
- # processes running in server mode.
- #
- cleanup()
- {
- USERID=`id | cut -f2 -d= | cut -f1 -d\(`
- PIDS=`ps -eo pid,ruid,args | grep $USERID | egrep "orca[.]orca|synthesis-driver|festival [-][-]server" | grep -v grep | awk '{ print $1 }'`
-
- IFS='
- '
- PIDS=`echo $PIDS`
-
- if [ "x$PIDS" != "x" ]
- then
- kill -9 $PIDS > /dev/null
- fi
- }
-
- # Runs orca.
- #
- runOrca()
- {
- cleanup
- exec_prefix=/usr
- PYTHONPATH=${exec_prefix}/lib/python2.4/site-packages
- export PYTHONPATH
- /usr/bin/python -c "import orca.orca; orca.orca.main()" "$ARGS"
- }
-
- # Runs a watchdog process in the background. It merely attempts to
- # get to Orca via some other means than the AT-SPI. Here we use
- # Orca's http server at port 20433. If it doesn't respond, then
- # we assume Orca is dead.
- #
- watchdog()
- {
- (
- sleep 30 # Give orca a chance to start.
- while [ "$WATCHDOG" -gt 0 ]
- do
- sleep 5
- USERID=`id | cut -f2 -d= | cut -f1 -d\(`
- PID=`ps -eo pid,ruid,args | grep $USERID | egrep "orca[.]orca" | grep -v grep | awk '{ print $1 }'`
-
- if [ "x$PID" = "x" ]
- then
- exit
- else
- $WGETCMD -q -t 0 -O /dev/null -w 2 "http://localhost:20433" || {
- echo Orca watchdog detected something bad. Cleaning up.
- cleanup
- }
- fi
- done
- ) &
- }
-
- kill_orca()
- {
- cleanup
- if [ "x$watchdog_pid" != x0 ]
- then
- kill -9 $watchdog_pid > /dev/null
- fi
- exit
- }
-
- hup_orca()
- {
- cleanup
- }
-
- main()
- {
- if [ "$WATCHDOG" -gt 0 ]
- then
- watchdog
- watchdog_pid=$!
- fi
- while [ "$RUN" -gt 0 ]
- do
- runOrca &
- orca_pid=$!
- wait $orca_pid
-
- RUN=$? # quit on a normal exit status from Orca
-
- # We will stop re-running Orca on SEGV's (139 = SEGV + 128).
- # The reason for this is that there are cases where Python
- # will SEGV when Orca attempts to exit normally. This happens
- # because of something going on in pyorbit. This should be
- # fixed in pyorbit 2.14.1, but not everyone has that.
- # So...we'll check for it.
- #
- if [ "$RUN" -eq 139 ]
- then
- RUN=0
- fi
- done
- kill_orca
- }
-
- trap kill_orca QUIT TERM INT ABRT
- trap hup_orca HUP
-
- # Orca will fall into a text-based question and answer session if the
- # user has not configured orca and/or accessibility yet. We will
- # force that to happen in the foreground (i.e., RUNONCE=true). In
- # addition, if the user passes any command line arguments to orca, we
- # will run it in the foreground as well to avoid a situation where
- # orca dumps itself into the text-based setup utility.
- #
- ACCESSIBILITY_ENABLED=`gconftool-2 --get /desktop/gnome/interface/accessibility`
- if [ "x$ACCESSIBILITY_ENABLED" != "xtrue" ]
- then
- RUNONCE="true"
- fi
-
- if [ "x$RUNONCE" = "xfalse" -a "x$ARGS" = "x" ]
- then
- main
- else
- runOrca
- fi
-