diff options
Diffstat (limited to 'doc/README.solaris')
| -rw-r--r-- | doc/README.solaris | 135 |
1 files changed, 135 insertions, 0 deletions
diff --git a/doc/README.solaris b/doc/README.solaris new file mode 100644 index 000000000..858910076 --- /dev/null +++ b/doc/README.solaris @@ -0,0 +1,135 @@ + + ---------------------- + xine + ---------------------- + + a free video player + + +building xine on solaris +------------------------ + +* The preferred make command to compile xine is GNU make (gmake, + /opt/sfw/bin/gmake). + + Sun's make (/usr/ccs/bin/make, or dmake) may work, too. + + +* On Solaris x86: When xine-lib code is build using GCC as the compiler, + xine-lib tries to use MMX/SSE/3DNOW! instructions of x86 CPUs, which + may not assemble using Solaris' /usr/ccs/bin/as. + + Make sure to use the GNU assembler as the assembler backend for the + GNU C compiler and as a standalone assembler command. + + A quick workaround when using the GCC from Sun's + "Software Companion" CD is to replace /usr/ccs/bin/as with a + link to GNU as, for example like this: + + cd /usr/ccs/bin + ln -s /opt/sfw/bin/gas gnu-as + mv as sun-as + ln -s gnu-as as + + (Use "ln -s gnu-as as" or "ln -s sun-as as" to switch between the + two assemblers) + + +* To get VIS accelerated video decoding and colour space conversion + on Solaris SPARC with an UltraSPARC cpu, download and install Sun's + mediaLib 2.0 before compiling xine. mediaLib is available here: + + http://www.sun.com/sparc/vis/mediaLib.html + + +Known Problems +-------------- + +* Can't use MIT shared memory for local video display + + The default value for the maximum allowed shared memory segment size + (1MByte) and the number of allowed shared memory segments (6) + is very small on solaris. You may want to increase both parameters. + Add the following lines to /etc/system to increase the shmmax parameter + to 8MBytes and the shmseg parameter to at least 32 [*]: + + set shmsys:shminfo_shmmax=8388608 + set shmsys:shminfo_shmseg=32 + + Reboot the machine after modifying /etc/system to activate the new + shared memory defaults. + + [*] Note: 15 shared memory segments is the minimum requirement for + xine's "XShm" video output plugin; 32 gives a bit of extra room + for other applications. The GUI frontend might need more + shared memory segments, see below. + + +* Warnings from xine-ui, when playlist / control / mrl browser panel + is opened (and broken skin image elements in these panels): + + xiTK WARNING: X error received: 'BadShmSeg (invalid shared + segment parameter)' + xiTK WARNING: X error received: 'BadAccess (attempt to access + private resource denied)' + xiTK WARNING: XShmAttach() failed. + + xine-ui tries to use even more shared memory segments for skin + images. + + + Workaround: The problem can be avoided with one of + + - create a text file $HOME/.xitkrc (or /etc/xitkrc) and add the + following line into it + + feature.shm = 0 + + - configure and build xine-ui with option "--disable-shm" + + - increase shmsys:shminfo_shmseg to at least 768 + + +* When using an 8-bit display, xine aborts with the error message: + + IMLIB ERROR: Cannot Find Palette. A Palette is required for this mode + Unable to initialize Imlib + + xine expects an installed Imlib package, installed using the "prefix" / + xine is looking for the global Imlib config file in /etc/imrc. + + If you have the solaris 8 companion CD installed, an Imlib package is + already installed on your system, but it uses the "prefix" /opt/sfw. + + To work around the problem: + + - install a symbolic link /etc/imrc, pointing to /opt/sfw/etc/imrc + (needs root permission) + + # ln -s /opt/sfw/etc/imrc /etc + + or + + - install an ".imrc" file in your home directory, + with the following contents: + + PaletteFile /opt/sfw/etc/im_palette.pal + + +* On Solaris x86, you cannot reliably play DVDs using a capacity >4GB: + + The sd(7D) driver on solaris x86 has a bug when accessing a disk + block >4GB on a device using a logical blocksize != DEV_BSIZE (i.e. + CDROM and DVD media). Due to a 32bit int overflow, a disk address + modulo 4GB is accessed. + + There's no workaround available. + + See the following message for more details about this bug: + + http://groups.yahoo.com/group/solarisonintel/message/22516 + + +--- +version of this file: + $Id: README.solaris,v 1.13 2003/01/05 13:11:53 guenter Exp $ |