Print done when done.

3 files changed, 339 insertions, 0 deletions

diff --git a/indra/newview/linux_tools/client-readme.txt b/indra/newview/linux_tools/client-readme.txt
new file mode 100644
index 0000000000..4748eaffbe
--- /dev/null
+++ b/indra/newview/linux_tools/client-readme.txt
@@ -0,0 +1,202 @@
+Second Life - Linux Alpha README
+-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
+
+This document contains information about the Second Life Linux
+client, and isn't meant to serve as an introduction to Second
+Life itself - please see <http://www.secondlife.com/whatis/>.
+
+1. Introduction
+2. System Requirements
+3. Installing & Running
+4. Known Issues
+5. Troubleshooting
+6. Advanced Troubleshooting
+7. Getting more help, and reporting problems
+
+
+1. INTRODUCTION
+-=-=-=-=-=-=-=-
+
+Hi!  This is an ALPHA release of the Second Life client for Linux.
+The 'alpha' status means that not everything is implemented yet and
+we're still hard at work on this version of the client, but many
+residents find that it already works well 'out of the box' for accessing
+Second Life.
+
+We encourage you to try it out and let us know of its compatibility
+with your system.  Be aware that although the client itself is provided
+for testing purposes, any changes you make within the Second Life world
+are permanent.
+
+Please enjoy!
+
+
+2. SYSTEM REQUIREMENTS
+-=-=-=-=-=-=-=-=-=-=-=
+
+Minimum requirements:
+    * Internet Connection: Cable or DSL
+    * Computer Processor: 800MHz Pentium III or Athlon, or better
+    * Computer Memory: 256MB or better
+    * Linux Operating System: A reasonably modern 32-bit Linux environment
+          is required.  If you are running a 64-bit Linux distribution, you
+          may need a set of 32-bit compatibility libraries.
+    * Video/Graphics Card:
+          o nVidia GeForce 2, GeForce 4mx, or better
+          o OR ATI Radeon 8500, 9250, or better
+
+      **NOTE**: Second Life absolutely requires you to have recent, correctly-
+      configured OpenGL 3D drivers for your hardware - the graphics drivers
+      that came with your operating system may not be good enough!  See the
+      TROUBLESHOOTING section if you encounter problems starting Second Life.
+
+For a more comfortable experience, the RECOMMENDED hardware for the Second
+Life Linux client is very similar to that for Windows, as detailed at:
+<https://secondlife.com/corporate/sysreqs.php>
+
+
+3. INSTALLING & RUNNING
+-=-=-=-=-=-=-=-=-=-=-=-
+
+The Second Life Linux client entirely runs out of the directory you have
+unpacked it into - no installation step is required.
+
+Run ./secondlife from the installation directory to start Second Life.
+
+User data is stored in the hidden directory ~/.secondlife by default; you may
+override this location with the SECONDLIFE_USER_DIR environment variable if
+you wish.
+
+
+4. KNOWN ISSUES
+-=-=-=-=-=-=-=-
+
+The following user-visible features are currently not fully implemented on
+the Linux client and are therefore known not to work properly:
+  * QuickTime movie playback and movie recording
+  * F1 Help
+  * Embedded Web Profiles and HTML Login Screen
+  * Video memory detection
+  * Full Unicode font rendering
+  * Auto-updater
+
+* UPDATING - when the client detects that a new version of Second Life
+  is available, it will ask you if you wish to download the new version.
+  This option is not implemented; to upgrade, you should manually download a
+  new version from the Second Life web site, <http://www.secondlife.com/>.
+
+* UPLOAD / SAVE / COLOR-PICKER DIALOGS - These only function when the client
+  is in 'windowed' mode, not 'fullscreen' mode.
+
+* GRAPHICAL SPEED/QUALITY - as many Linux graphics drivers are not as robust
+  as their counterparts for some other operating systems, advanced Second Life
+  graphical features have been disabled to aid stability.  See PROBLEM 3 in the
+  TROUBLESHOOTING section if you wish to turn these on to enhance your
+  experience.
+
+
+5. TROUBLESHOOTING
+-=-=-=-=-=-=-=-=-=
+
+The client prints a lot of diagnostic information to the console it was
+run from.  Most of this is also replicated in ~/.secondlife/logs/SecondLife.log
+- this is helpful to read when troubleshooting, especially 'WARNING' lines.
+
+PROBLEM 1:- Second Life fails to start up, with a warning on the console like:
+   'Error creating window.' or
+   'Unable to create window, be sure screen is set at 32-bit color' or
+   'SDL: Couldn't find matching GLX visual.'
+SOLUTION:- Usually this indicates that your graphics card does not meet
+   the minimum requirements, or that your system's OpenGL 3D graphics driver is
+   not updated and configured correctly.  If you believe that your graphics
+   card DOES meet the minimum requirements then you likely need to install the
+   official so-called 'non-free' nVidia or ATI (fglrx) graphics drivers; we
+   suggest one of the following options:
+ * Consult your Linux distribution's documentation for installing these
+   official drivers.  For example, Ubuntu provides documentation here:
+   <https://help.ubuntu.com/community/BinaryDriverHowto>
+ * If your distribution does not make it easy, then you can download the
+   required Linux drivers straight from your graphics card manufacturer:
+   - nVidia cards: <http://www.nvidia.com/object/unix.html>
+   - ATI cards: <http://ati.amd.com/support/driver.html>
+
+PROBLEM 2:- My whole system seems to hang when running Second Life.
+SOLUTION:- This is typically a hardware/driver issue.  The first thing to
+   do is to check that you have the most recent official drivers for your
+   graphics card.
+SOLUTION:- Some residents with ATI cards have reported that running
+   'sudo aticonfig --locked-userpages=off' before running Second Life solves
+   their stability issues.
+SOLUTION:- As a last resort, you can disable most of Second Life's advanced
+   graphics features by editing the 'secondlife' script and removing the '#'
+   from the line which reads '#export LL_GL_NOEXT=x'
+
+PROBLEM 3:- Performance or graphical quality are not as high as I expect.
+PROBLEM:- I can't turn on Anisotropic Filtering, Ripple Water, or AGP.
+PROBLEM:- 'Shiny' doesn't work.
+SOLUTION:- Some graphics performance features in Second Life are disabled
+   by default for the Linux version due to stability issues with some common
+   Linux graphic drivers.  You can re-enable these features at the slight
+   risk of decreasing system stability.  To do so:
+   * Edit the 'secondlife' script.  Comment-out these lines by putting a '#'
+     in front of them: 'export LL_GL_BASICEXT=x', 'export LL_GL_NOEXT=x',
+     'export LL_GL_BLACKLIST=abcdefghijklmno'.
+   * Now start Second Life.  Some advanced performance features will now be
+     automatically used, and some new options in Preferences will now be
+     available to you; there is no guarantee, however, that they will
+     positively affect performance!
+
+PROBLEM 4:- Sound effects seem to 'lag' a fraction of a second behind
+   actions.
+SOLUTION:- You may uncomment the 'LL_BAD_ESD' line in the 'secondlife' script
+   to get more responsive audio.  However, if you do this then you may
+   encounter audio issues or a hang during login, so beware.
+
+
+6. ADVANCED TROUBLESHOOTING
+-=-=-=-=-=-=-=-=-=-=-=-=-=-
+
+The 'secondlife' script which launches Second Life contains some
+configuration options for advanced troubleshooters.
+
+* AUDIO - Edit the 'secondlife' script and you will see three audio
+  options: LL_BAD_ESD, LL_BAD_OSS, LL_BAD_ALSA.  Second Life tries to
+  use ESD, OSS, then ALSA audio drivers in this order; you may uncomment
+  the corresponding LL_BAD_* option to skip an audio driver which you
+  believe may be causing you trouble.
+
+* OPENGL - For advanced troubleshooters, the LL_GL_BLACKLIST option lets
+  you disable specific GL extensions, each of which is represented by a
+  letter ("a"-"o").  If you can narrow down a stability problem on your system
+  to just one or two GL extensions then please post details of your hardware
+  (and drivers) to the Linux Client Alpha Testers forum (see link below) along
+  with the minimal LL_GL_BLACKLIST which solves your problems.  This will help
+  us to improve stability for your hardware while minimally impacting
+  performance.
+  LL_GL_BASICEXT and LL_GL_NOEXT should be commented-out for this to be useful.
+
+
+7. GETTING MORE HELP AND REPORTING PROBLEMS
+-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
+
+For general help and support with Second Life:
+<http://secondlife.com/community/support.php>
+
+In-world help: Please use the 'Help' menu in the client for general
+non-Linux-specific Second Life help including live support from the fabulous
+Live Help team.
+
+In-world discussion: There is a 'Linux Client Users' group
+inside Second Life which is free to join.  You can find it by pressing
+the 'Search' button at the bottom of the window and then selecting the
+'Groups' tab and searching for 'Linux'.  This group is useful for discussing
+Linux issues with fellow Linux client users who are online.
+
+Linux Client Alpha Testers forum:
+<http://forums.secondlife.com/forumdisplay.php?forumid=263>
+This is a good place for discussing Linux-specific Second Life problems
+if you find that the Troubleshooting section in this file hasn't helped.
+When reporting problems here, please include information about the
+Second Life version you are running, your graphics card, graphics driver,
+and Linux distribution.
+
diff --git a/indra/newview/linux_tools/launch_url.sh b/indra/newview/linux_tools/launch_url.sh
new file mode 100755
index 0000000000..564e834939
--- /dev/null
+++ b/indra/newview/linux_tools/launch_url.sh
@@ -0,0 +1,87 @@
+#!/bin/sh
+# bash v1.14+ expected
+
+# This script loads a web page in the 'default' graphical web browser.
+# It MUST return immediately (or soon), so the browser should be
+# launched in the background (thus no text-only browsers).
+# This script does not trust the URL to be well-escaped or shell-safe.
+#
+# On Unixoids we try, in order of decreasing priority:
+# - $BROWSER if set (preferred)
+# - kfmclient openURL
+# - x-www-browser
+# - opera
+# - firefox
+# - mozilla
+# - netscape
+
+URL="$1"
+
+if [ -z "$URL" ]; then
+    echo Usage: $0 URL
+    exit
+fi
+
+# if $BROWSER is defined, use it.
+XBROWSER=`echo "$BROWSER" |cut -f1 -d:`
+if [ ! -z "$XBROWSER" ]; then
+    XBROWSER_CMD=`echo "$XBROWSER" |cut -f1 -d' '`
+    # look for $XBROWSER_CMD either literally or in PATH
+    if [ -x "$XBROWSER_CMD" ] || which $XBROWSER_CMD >/dev/null; then
+        # check for %s string, avoiding bash2-ism of [[ ]]
+	if echo "$XBROWSER" | grep %s >/dev/null; then
+	    # $XBROWSER has %s which needs substituting
+	    echo "$URL" | xargs -r -i%s $XBROWSER &
+	    exit
+	fi
+        # $XBROWSER has no %s, tack URL on the end instead
+	$XBROWSER "$URL" &
+	exit
+    fi
+    echo "Couldn't find the browser specified by \$BROWSER ($BROWSER)"
+    echo "Trying some others..."
+fi
+
+# else kfmclient
+# (embodies KDE concept of 'preferred browser')
+if which kfmclient >/dev/null; then
+    kfmclient openURL "$URL" &
+    exit
+fi
+
+# else x-www-browser
+# (Debianesque idea of a working X browser)
+if which x-www-browser >/dev/null; then
+    x-www-browser "$URL" &
+    exit
+fi
+
+# else opera
+# (if user has opera in their path, they probably went to the
+# trouble of installing it -> prefer it)
+if which opera >/dev/null; then
+    opera "$URL" &
+    exit
+fi
+
+# else firefox
+if which firefox >/dev/null; then
+    firefox "$URL" &
+    exit
+fi
+
+# else mozilla
+if which mozilla >/dev/null; then
+    mozilla "$URL" &
+    exit
+fi
+
+# else netscape
+if which netscape >/dev/null; then
+    netscape "$URL" &
+    exit
+fi
+
+echo 'Failed to find a known browser.  Please consider setting the $BROWSER environment variable.'
+
+# end.
diff --git a/indra/newview/linux_tools/wrapper.sh b/indra/newview/linux_tools/wrapper.sh
new file mode 100755
index 0000000000..222ce98c73
--- /dev/null
+++ b/indra/newview/linux_tools/wrapper.sh
@@ -0,0 +1,50 @@
+#!/bin/sh
+## Here are some configuration options for Linux Client Alpha Testers.
+## These options are for self-assisted troubleshooting during this alpha
+## testing phase; you should not usually need to touch them.
+
+## - Avoids using the ESD audio driver.
+#export LL_BAD_ESD=x
+
+## - Avoids using the OSS audio driver.
+#export LL_BAD_OSS=x
+
+## - Avoids using the ALSA audio driver.
+#export LL_BAD_ALSA=x
+
+## - Avoids the optional OpenGL extensions which have proven most problematic
+##   on some hardware.  Disabling this option may cause crashes and hangs on
+##   some unstable combinations of drivers and hardware.
+export LL_GL_BASICEXT=x
+
+## - Avoids *all* optional OpenGL extensions.  This is the safest and least-
+##   exciting option.  Enable this if you experience stability issues, and
+##   report whether it helps in the Linux Client Alpha Testers forum.
+#export LL_GL_NOEXT=x
+
+## - For advanced troubleshooters, this lets you disable specific GL
+##   extensions, each of which is represented by a letter a-o.  If you can
+##   narrow down a stability problem on your system to just one or two
+##   extensions then please post details of your hardware (and drivers) to
+##   the Linux Client Alpha Testers forum along with the minimal
+##   LL_GL_BLACKLIST which solves your problems.
+#export LL_GL_BLACKLIST=abcdefghijklmno
+
+## - Avoids an often-buggy X feature that doesn't really benefit us anyway.
+export SDL_VIDEO_X11_DGAMOUSE=0
+
+## Nothing worth editing below this line.
+##-------------------------------------------------------------------
+
+RUN_PATH=`dirname "$0" || echo .`
+cd "${RUN_PATH}"
+LD_LIBRARY_PATH="`pwd`"/lib:"${LD_LIBRARY_PATH}" bin/do-not-directly-run-secondlife-bin `cat gridargs.dat` $@ | cat
+
+echo
+echo '*********************************************************'
+echo 'This is an ALPHA release of the Second Life linux client.'
+echo 'Thank you for testing!'
+echo 'You can visit the Linux Client Alpha Testers forum at:'
+echo 'http://forums.secondlife.com/forumdisplay.php?forumid=263'
+echo 'Please see README-linux.txt before reporting problems.'
+echo