1*b1cdbd2cSJim Jagielski#************************************************************** 2*b1cdbd2cSJim Jagielski# 3*b1cdbd2cSJim Jagielski# Licensed to the Apache Software Foundation (ASF) under one 4*b1cdbd2cSJim Jagielski# or more contributor license agreements. See the NOTICE file 5*b1cdbd2cSJim Jagielski# distributed with this work for additional information 6*b1cdbd2cSJim Jagielski# regarding copyright ownership. The ASF licenses this file 7*b1cdbd2cSJim Jagielski# to you under the Apache License, Version 2.0 (the 8*b1cdbd2cSJim Jagielski# "License"); you may not use this file except in compliance 9*b1cdbd2cSJim Jagielski# with the License. You may obtain a copy of the License at 10*b1cdbd2cSJim Jagielski# 11*b1cdbd2cSJim Jagielski# http://www.apache.org/licenses/LICENSE-2.0 12*b1cdbd2cSJim Jagielski# 13*b1cdbd2cSJim Jagielski# Unless required by applicable law or agreed to in writing, 14*b1cdbd2cSJim Jagielski# software distributed under the License is distributed on an 15*b1cdbd2cSJim Jagielski# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16*b1cdbd2cSJim Jagielski# KIND, either express or implied. See the License for the 17*b1cdbd2cSJim Jagielski# specific language governing permissions and limitations 18*b1cdbd2cSJim Jagielski# under the License. 19*b1cdbd2cSJim Jagielski# 20*b1cdbd2cSJim Jagielski#************************************************************** 21*b1cdbd2cSJim Jagielski 22*b1cdbd2cSJim Jagielski 23*b1cdbd2cSJim JagielskiOverview of URE installation 24*b1cdbd2cSJim Jagielski----------------------------- 25*b1cdbd2cSJim Jagielski 26*b1cdbd2cSJim JagielskiLinux x86, Solaris x86, and Solaris SPARC: 27*b1cdbd2cSJim Jagielski 28*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/LICENSE 29*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/THIRDPARTYLICENSEREADME.html 30*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/README 31*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/bin/uno 32*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/bin/regcomp 33*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/bin/regmerge 34*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/bin/regview 35*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/bin/javaldx 36*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libuno_cppu.so.3 37*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libuno_cppuhelpergcc3.so.3 [Linux x86 only] 38*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libuno_cppuhelperC52.so.3 [Solaris only] 39*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libuno_purpenvhelpergcc3.so.3 [Linux x86 only] 40*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libuno_purpenvhelperC52.so.3 [Solaris only] 41*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libuno_sal.so.3 42*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libuno_salhelpergcc3.so.3 [Linux x86 only] 43*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libuno_salhelperC52.so.3 [Solaris only] 44*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libstlport_gcc.so [Linux x86 only] 45*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libstlport_sunpro.so [Solaris only] 46*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/share/java/unoloader.jar 47*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/share/java/juh.jar 48*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/share/java/jurt.jar 49*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/share/java/ridl.jar 50*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/share/misc/types.rdb 51*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/share/misc/services.rdb 52*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libxml2.so.2 [external] 53*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/bin/startup.sh [private] 54*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/bin/uno.bin [private] 55*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/bin/regcomp.bin [private] 56*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/unorc [private] 57*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libreg.so.3 [private] 58*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libstore.so.3 [private] 59*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libxmlreader.so [private] 60*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libjvmaccessgcc3.so.3 [private; Linux x86 only] 61*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libjvmaccessC52.so.3 [private; Solaris only] 62*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libjvmfwk.so.3 [private] 63*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/sunjavaplugin.so [private] 64*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/JREProperties.class [private] 65*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/jvmfwk3rc [private] 66*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libgcc3_uno.so [private; Linux x86 only] 67*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libsunpro5_uno.so [private; Solaris only] 68*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libjava_uno.so [private] 69*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libunsafe_uno_uno.so [private] 70*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libaffine_uno_uno.so [private] 71*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/liblog_uno_uno.so [private] 72*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libjpipe.so [private] 73*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libjuh.so [private] 74*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/libjuhx.so [private] 75*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/acceptor.uno.so [private] 76*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/binaryurp.uno.so [private] 77*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/bootstrap.uno.so [private] 78*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/connector.uno.so [private] 79*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/introspection.uno.so [private] 80*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/invocadapt.uno.so [private] 81*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/invocation.uno.so [private] 82*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/javaloader.uno.so [private] 83*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/javavm.uno.so [private] 84*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/namingservice.uno.so [private] 85*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/proxyfac.uno.so [private] 86*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/reflection.uno.so [private] 87*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/streams.uno.so [private] 88*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/textinstream.uno.so [private] 89*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/textoutstream.uno.so [private] 90*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/stocservices.uno.so [private] 91*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/lib/uuresolver.uno.so [private] 92*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/share/java/java_uno.jar [private] 93*b1cdbd2cSJim Jagielski/opt/openoffice.org/ure/share/misc/javavendors.xml [private] 94*b1cdbd2cSJim Jagielski 95*b1cdbd2cSJim JagielskiWindows: 96*b1cdbd2cSJim Jagielski 97*b1cdbd2cSJim JagielskiProgram Files\URE\LICENSE 98*b1cdbd2cSJim JagielskiProgram Files\URE\THIRDPARTYLICENSEREADME.html 99*b1cdbd2cSJim JagielskiProgram Files\URE\README 100*b1cdbd2cSJim JagielskiProgram Files\URE\bin\uno.exe 101*b1cdbd2cSJim JagielskiProgram Files\URE\bin\regcomp.exe 102*b1cdbd2cSJim JagielskiProgram Files\URE\bin\regmerge.exe 103*b1cdbd2cSJim JagielskiProgram Files\URE\bin\regview.exe 104*b1cdbd2cSJim JagielskiProgram Files\URE\bin\cppu3.dll 105*b1cdbd2cSJim JagielskiProgram Files\URE\bin\cppuhelper3MSC.dll 106*b1cdbd2cSJim JagielskiProgram Files\URE\bin\purpenvhelper3MSC.dll 107*b1cdbd2cSJim JagielskiProgram Files\URE\bin\sal3.dll 108*b1cdbd2cSJim JagielskiProgram Files\URE\bin\salhelper3MSC.dll 109*b1cdbd2cSJim JagielskiProgram Files\URE\bin\stlport_vc7145.dll 110*b1cdbd2cSJim JagielskiProgram Files\URE\java\unoloader.jar 111*b1cdbd2cSJim JagielskiProgram Files\URE\java\juh.jar 112*b1cdbd2cSJim JagielskiProgram Files\URE\java\jurt.jar 113*b1cdbd2cSJim JagielskiProgram Files\URE\java\ridl.jar 114*b1cdbd2cSJim JagielskiProgram Files\URE\misc\types.rdb 115*b1cdbd2cSJim JagielskiProgram Files\URE\misc\services.rdb 116*b1cdbd2cSJim JagielskiProgram Files\URE\bin\libxml2.dll [external] 117*b1cdbd2cSJim JagielskiProgram Files\URE\bin\uno.ini [private] 118*b1cdbd2cSJim JagielskiProgram Files\URE\bin\reg3.dll [private] 119*b1cdbd2cSJim JagielskiProgram Files\URE\bin\store3.dll [private] 120*b1cdbd2cSJim JagielskiProgram Files\URE\bin\xmlreader.dll [private] 121*b1cdbd2cSJim JagielskiProgram Files\URE\bin\jvmaccess3MSC.dll [private] 122*b1cdbd2cSJim JagielskiProgram Files\URE\bin\jvmfwk3.dll [private] 123*b1cdbd2cSJim JagielskiProgram Files\URE\bin\sunjavaplugin.dll [private] 124*b1cdbd2cSJim JagielskiProgram Files\URE\bin\JREProperties.class [private] 125*b1cdbd2cSJim JagielskiProgram Files\URE\bin\jvmfwk3.ini [private] 126*b1cdbd2cSJim JagielskiProgram Files\URE\bin\msci_uno.dll [private] 127*b1cdbd2cSJim JagielskiProgram Files\URE\bin\java_uno.dll [private] 128*b1cdbd2cSJim JagielskiProgram Files\URE\bin\cli_uno.dll [private] 129*b1cdbd2cSJim JagielskiProgram Files\URE\bin\unsafe_uno_uno.dll [private] 130*b1cdbd2cSJim JagielskiProgram Files\URE\bin\affine_uno_uno.dll [private] 131*b1cdbd2cSJim JagielskiProgram Files\URE\bin\log_uno_uno.dll [private] 132*b1cdbd2cSJim JagielskiProgram Files\URE\bin\jpipe.dll [private] 133*b1cdbd2cSJim JagielskiProgram Files\URE\bin\jpipx.dll [private] 134*b1cdbd2cSJim JagielskiProgram Files\URE\bin\juh.dll [private] 135*b1cdbd2cSJim JagielskiProgram Files\URE\bin\juhx.dll [private] 136*b1cdbd2cSJim JagielskiProgram Files\URE\bin\acceptor.uno.dll [private] 137*b1cdbd2cSJim JagielskiProgram Files\URE\bin\binaryurp.uno.dll [private] 138*b1cdbd2cSJim JagielskiProgram Files\URE\bin\bootstrap.uno.dll [private] 139*b1cdbd2cSJim JagielskiProgram Files\URE\bin\connector.uno.dll [private] 140*b1cdbd2cSJim JagielskiProgram Files\URE\bin\introspection.uno.dll [private] 141*b1cdbd2cSJim JagielskiProgram Files\URE\bin\invocadapt.uno.dll [private] 142*b1cdbd2cSJim JagielskiProgram Files\URE\bin\invocation.uno.dll [private] 143*b1cdbd2cSJim JagielskiProgram Files\URE\bin\javaloader.uno.dll [private] 144*b1cdbd2cSJim JagielskiProgram Files\URE\bin\javavm.uno.dll [private] 145*b1cdbd2cSJim JagielskiProgram Files\URE\bin\namingservice.uno.dll [private] 146*b1cdbd2cSJim JagielskiProgram Files\URE\bin\proxyfac.uno.dll [private] 147*b1cdbd2cSJim JagielskiProgram Files\URE\bin\reflection.uno.dll [private] 148*b1cdbd2cSJim JagielskiProgram Files\URE\bin\streams.uno.dll [private] 149*b1cdbd2cSJim JagielskiProgram Files\URE\bin\textinstream.uno.dll [private] 150*b1cdbd2cSJim JagielskiProgram Files\URE\bin\textoutstream.uno.dll [private] 151*b1cdbd2cSJim JagielskiProgram Files\URE\bin\stocservices.uno.dll [private] 152*b1cdbd2cSJim JagielskiProgram Files\URE\bin\uuresolver.uno.dll [private] 153*b1cdbd2cSJim JagielskiProgram Files\URE\bin\uwinapi.dll [private] 154*b1cdbd2cSJim JagielskiProgram Files\URE\java\java_uno.jar [private] 155*b1cdbd2cSJim JagielskiProgram Files\URE\misc\javavendors.xml [private] 156*b1cdbd2cSJim Jagielski 157*b1cdbd2cSJim Jagielski%windir%\assembly\cli_basetypes.dll [GAC] 158*b1cdbd2cSJim Jagielski%windir%\assembly\cli_ure.dll [GAC] 159*b1cdbd2cSJim Jagielski%windir%\assembly\cli_uretypes.dll [GAC] 160*b1cdbd2cSJim Jagielski%windir%\assembly\cli_cppuhelper.dll [GAC] 161*b1cdbd2cSJim Jagielski%windir%\assembly\policy.1.0.cli_basetypes.dll [GAC] 162*b1cdbd2cSJim Jagielski%windir%\assembly\policy.1.0.cli_ure.dll [GAC] 163*b1cdbd2cSJim Jagielski%windir%\assembly\policy.1.0.cli_uretypes.dll [GAC] 164*b1cdbd2cSJim Jagielski%windir%\assembly\policy.1.0.cli_cppuhelper.dll [GAC] 165*b1cdbd2cSJim Jagielski 166*b1cdbd2cSJim JagielskiFiles marked as [external] are included in the URE installation because the URE 167*b1cdbd2cSJim Jagielskineeds them and it cannot be guaranteed that they are available on a given 168*b1cdbd2cSJim Jagielskisystem. Applications using the URE may need those files too, so they are made 169*b1cdbd2cSJim Jagielskiavailable as non-private files of the URE installation. However, in an ideal 170*b1cdbd2cSJim Jagielskiworld, those files would not need to be included in the URE installation. 171*b1cdbd2cSJim Jagielski 172*b1cdbd2cSJim JagielskiFiles marked as [private] are private to the URE installation. To avoid 173*b1cdbd2cSJim Jagielskistability issues, applications that use the URE should not access the 174*b1cdbd2cSJim Jagielskifunctionality of these files. 175*b1cdbd2cSJim Jagielski 176*b1cdbd2cSJim JagielskiFiles marked as [GAC] are installed in the Global Assembly Cache on Windows. The 177*b1cdbd2cSJim Jagielskifile path reflects the path as seen in the Explorer with the Assembly 178*b1cdbd2cSJim JagielskiCache Viewer Tool (Shfusion.dll) installed. The actual paths are different. 179*b1cdbd2cSJim Jagielski 180*b1cdbd2cSJim Jagielski 181*b1cdbd2cSJim JagielskiPublic Files in a URE Installation 182*b1cdbd2cSJim Jagielski---------------------------------- 183*b1cdbd2cSJim Jagielski 184*b1cdbd2cSJim JagielskiA URE installation contains the following public files: 185*b1cdbd2cSJim Jagielski 186*b1cdbd2cSJim Jagielski- uno is the executable file that runs UNO components. For more details, see 187*b1cdbd2cSJim Jagielskithe SDK Developer's Guide. 188*b1cdbd2cSJim Jagielski 189*b1cdbd2cSJim Jagielski- regcomp, regmerge, and regview are tools that work with binary registries that 190*b1cdbd2cSJim Jagielskicontain UNO type or UNO service information. For more details, see the SDK 191*b1cdbd2cSJim JagielskiDeveloper's Guide. 192*b1cdbd2cSJim Jagielski 193*b1cdbd2cSJim Jagielski- javaldx is a helper program on Linux x86, Solaris x86, and Solaris SPARC that 194*b1cdbd2cSJim Jagielskienables Java executables to use a Java VM, such as the Sun JDK/JRE. Executables 195*b1cdbd2cSJim Jagielskisuch as uno and regcomp run this helper automatically. 196*b1cdbd2cSJim Jagielski 197*b1cdbd2cSJim Jagielski- cppu, cppuhelper, purpenvhelper, sal, and salhelper are the public C++ UNO 198*b1cdbd2cSJim Jagielskiruntime dynamic libraries that client code can call. For details on the 199*b1cdbd2cSJim Jagielskifunctionality that these libraries offer, see the "C++ Reference" section of the 200*b1cdbd2cSJim JagielskiSDK HTML documentation. The corresponding C++ header files are not in the URE, 201*b1cdbd2cSJim Jagielskibut rather in the SDK. 202*b1cdbd2cSJim Jagielski 203*b1cdbd2cSJim Jagielski- stlport is the dynamic library of STLport 4.5, which is used in the public 204*b1cdbd2cSJim Jagielskiinterface of cppuhelper and salhelper, and thus also has to be part of the 205*b1cdbd2cSJim Jagielskipublic interface of the URE. The corresponding C++ header files are not in the 206*b1cdbd2cSJim JagielskiURE, but rather in the SDK. 207*b1cdbd2cSJim Jagielski 208*b1cdbd2cSJim Jagielski- unoloader.jar, juh.jar, jurt.jar, and ridl.jar are the public Java UNO runtime 209*b1cdbd2cSJim JagielskiJava[tm] Archives (JARs) that client code can call. For details on the 210*b1cdbd2cSJim Jagielskifunctionality that these files offer, see the "Java UNO Runtime Reference" 211*b1cdbd2cSJim Jagielskisection of the SDK HTML documentation. 212*b1cdbd2cSJim Jagielski 213*b1cdbd2cSJim Jagielski- types.rdb and services.rdb are preconfigured UNO type and service registries. 214*b1cdbd2cSJim JagielskiFor more details, see the "Deploying a URE" section of this README. 215*b1cdbd2cSJim Jagielski 216*b1cdbd2cSJim Jagielski 217*b1cdbd2cSJim JagielskiDeploying a URE 218*b1cdbd2cSJim Jagielski--------------- 219*b1cdbd2cSJim Jagielski 220*b1cdbd2cSJim JagielskiBy default, the URE is installed in /opt/openoffice.org/ure on Linux x86, 221*b1cdbd2cSJim JagielskiSolaris x86, and Solaris SPARC, and in Program Files\URE on Windows. If you 222*b1cdbd2cSJim Jagielskiwant, you can override this location when you install the URE, for example, with 223*b1cdbd2cSJim Jagielskirpm --relocate on Linux. The URE is designed so that multiple instances of the 224*b1cdbd2cSJim JagielskiURE can coexist on a single system in different locations. 225*b1cdbd2cSJim Jagielski 226*b1cdbd2cSJim JagielskiOn Windows, the path to the installed URE is stored in the registry under the 227*b1cdbd2cSJim Jagielskipath "HKEY_CLASSES_ROOT\Software\OpenOffice.org\URE" and key "Path". 228*b1cdbd2cSJim Jagielski 229*b1cdbd2cSJim Jagielski 230*b1cdbd2cSJim JagielskiUNO Deployment Variables 231*b1cdbd2cSJim Jagielski------------------------ 232*b1cdbd2cSJim Jagielski 233*b1cdbd2cSJim JagielskiThe URE installation is preconfigured with several UNO types and UNO services. 234*b1cdbd2cSJim JagielskiThe available types and services are listed in the types.rdb and services.rdb 235*b1cdbd2cSJim Jagielskifiles respectively. The location of these files is stored by two UNO deployment 236*b1cdbd2cSJim Jagielskivariables, namely UNO_TYPES and UNO_SERVICES. These variables are set up by a 237*b1cdbd2cSJim Jagielskiunorc or uno.ini that is private to the URE installation. This private file 238*b1cdbd2cSJim Jagielskialso contains the private deployment variables URE_INTERNAL_LIB_DIR, 239*b1cdbd2cSJim JagielskiURE_INTERNAL_JAVA_DIR, and URE_INTERNAL_JAVA_CLASSPATH, which are required by 240*b1cdbd2cSJim Jagielskithe URE. 241*b1cdbd2cSJim Jagielski 242*b1cdbd2cSJim JagielskiThe UNO_TYPES and UNO_SERVICES variables automatically search the following 243*b1cdbd2cSJim Jagielskilocations for types.rdb and services.rdb files: 244*b1cdbd2cSJim Jagielski 245*b1cdbd2cSJim JagielskiLinux x86, Solaris x86, and Solaris SPARC: 246*b1cdbd2cSJim Jagielski 247*b1cdbd2cSJim Jagielski- <URE installation>/share/misc/ types.rdb and services.rdb, respectively 248*b1cdbd2cSJim Jagielski- /etc/opt/ure/ types.rdb and services.rdb, respectively 249*b1cdbd2cSJim Jagielski- ~/.ure/ types.rdb and services.rdb, respectively 250*b1cdbd2cSJim Jagielski- any URLs listed in the public deployment variables URE_MORE_TYPES and 251*b1cdbd2cSJim Jagielski URE_MORE_SERVICES, respectively 252*b1cdbd2cSJim Jagielski 253*b1cdbd2cSJim JagielskiWindows: 254*b1cdbd2cSJim Jagielski 255*b1cdbd2cSJim Jagielski- <URE installation>\misc\ types.rdb and services.rdb, respectively 256*b1cdbd2cSJim Jagielski- Documents and Settings\<User Name>\Application Data\URE\ types.rdb and 257*b1cdbd2cSJim Jagielski services.rdb, respectively 258*b1cdbd2cSJim Jagielski- any URLs listed in the public deployment variables URE_MORE_TYPES and 259*b1cdbd2cSJim Jagielski URE_MORE_SERVICES, respectively 260*b1cdbd2cSJim Jagielski 261*b1cdbd2cSJim JagielskiNOTE: The URE on Windows does not support a system-wide deployment of additional 262*b1cdbd2cSJim Jagielskitypes.rdb and services.rdb files. That is, you cannot store additional 263*b1cdbd2cSJim Jagielskitypes.rdb and services.rdb files in a Documents and Settings\All 264*b1cdbd2cSJim JagielskiUsers\Application Data\URE directory. 265*b1cdbd2cSJim Jagielski 266*b1cdbd2cSJim JagielskiThe Java UNO environment needs type information in the form of Java class files 267*b1cdbd2cSJim Jagielskiinstead of rdb files. Additional types are searched for in any URLs listed in 268*b1cdbd2cSJim Jagielskithe public deployment variable URE_MORE_JAVA_TYPES. 269*b1cdbd2cSJim Jagielski 270*b1cdbd2cSJim JagielskiFor details on how to override the UNO deployment variables, see the SDK 271*b1cdbd2cSJim JagielskiDeveloper's Guide or go to http://udk.openoffice.org/common/man/concept/ 272*b1cdbd2cSJim Jagielskimicro_deployment.html. 273*b1cdbd2cSJim Jagielski 274*b1cdbd2cSJim JagielskiIf you want to deploy additional UNO types and services, use regcomp. 275*b1cdbd2cSJim Jagielski 276*b1cdbd2cSJim JagielskiCAUTION: Do not deploy these types and services to the types.rdb and 277*b1cdbd2cSJim Jagielskiservices.rdb in the URE installation. 278*b1cdbd2cSJim Jagielski 279*b1cdbd2cSJim Jagielski 280*b1cdbd2cSJim JagielskiURE Java Framework 281*b1cdbd2cSJim Jagielski------------------ 282*b1cdbd2cSJim Jagielski 283*b1cdbd2cSJim JagielskiWhen a URE executable, such as uno, starts a Java VM, the URE Java Framework 284*b1cdbd2cSJim Jagielskisearches for a suitable JDK/JRE installation. For more information on the URE 285*b1cdbd2cSJim JagielskiJava Framework, go to http://udk.openoffice.org/common/man/spec/ 286*b1cdbd2cSJim Jagielskijavavendorextension.sxw. The private javavendors.xml file in a URE installation 287*b1cdbd2cSJim Jagielskiprovides preconfigured support for various JDK/JRE versions. The private 288*b1cdbd2cSJim Jagielskijvmfwk3rc or jvmfwk3.ini file specifies the location of a suitable JDK/JRE 289*b1cdbd2cSJim Jagielskiinstallation. When an executable tries to start a Java VM, the URE searches the 290*b1cdbd2cSJim Jagielskirelevant Java settings file for information on a suitable JDK/JRE version. 291*b1cdbd2cSJim Jagielski 292*b1cdbd2cSJim JagielskiNOTE: On any platform, you can delete the javasettings_${_OS}_${_ARCH}.xml file 293*b1cdbd2cSJim Jagielskiif the file contains problematic stale data. 294*b1cdbd2cSJim Jagielski 295*b1cdbd2cSJim JagielskiBy default, the URE searches for a Java settings file in the following 296*b1cdbd2cSJim Jagielskilocations: 297*b1cdbd2cSJim Jagielski 298*b1cdbd2cSJim JagielskiLinux x86, Solaris x86, and Solaris SPARC: 299*b1cdbd2cSJim Jagielski 300*b1cdbd2cSJim Jagielski- /etc/opt/ure/javasettings_${_OS}_${_ARCH}.xml 301*b1cdbd2cSJim Jagielski- ~/.ure/javasettings_${_OS}_${_ARCH}.xml 302*b1cdbd2cSJim Jagielski 303*b1cdbd2cSJim JagielskiNOTE: If these files do not contain information about a JDK/JRE, the URE 304*b1cdbd2cSJim Jagielskisearches for a suitable JDK/JRE installation and stores the relevant information 305*b1cdbd2cSJim Jagielskiin the ~/.ure/javasettings_${_OS}_${_ARCH}.xml file. If you want all users to 306*b1cdbd2cSJim Jagielskiaccess the same JDK/JRE, log on as root and copy an existing 307*b1cdbd2cSJim Jagielski~/.ure/javasettings_${_OS}_${_ARCH}.xml to 308*b1cdbd2cSJim Jagielski/etc/opt/ure/javasettings_${_OS}_${_ARCH}.xml. 309*b1cdbd2cSJim Jagielski 310*b1cdbd2cSJim JagielskiWindows: 311*b1cdbd2cSJim Jagielski 312*b1cdbd2cSJim Jagielski- Documents and Settings\<User Name>\Application 313*b1cdbd2cSJim Jagielski Data\URE\javasettings_${_OS}_${_ARCH}.xml 314*b1cdbd2cSJim Jagielski 315*b1cdbd2cSJim JagielskiNOTE: If this file does not contain information about a JDK/JRE, the URE 316*b1cdbd2cSJim Jagielskisearches for a suitable JDK/JRE installation and stores the relevant information 317*b1cdbd2cSJim Jagielskiin the Documents and Settings\<User Name>\Application 318*b1cdbd2cSJim JagielskiData\URE\javasettings_${_OS}_${_ARCH}.xml file. The URE on Windows does not 319*b1cdbd2cSJim Jagielskiby default support a system-wide deployment of the Java settings file. That is, 320*b1cdbd2cSJim Jagielskiyou cannot store the file in a Documents and Settings\All Users\Application 321*b1cdbd2cSJim JagielskiData\URE directory. 322*b1cdbd2cSJim Jagielski 323*b1cdbd2cSJim JagielskiYou can override these paths by setting the URE_OVERRIDE_JAVA_JFW_SHARED_DATA 324*b1cdbd2cSJim Jagielskiand URE_OVERRIDE_JAVA_JFW_USER_DATA deployment variables. You can also use the 325*b1cdbd2cSJim JagielskiUNO_JAVA_JFW_JREHOME deployment variable to specify the location of a JDK/JRE 326*b1cdbd2cSJim Jagielskiinstallation. For more information on this variable, see 327*b1cdbd2cSJim Jagielskihttp://udk.openoffice.org/common/man/spec/javavendorextension.sxw. 328*b1cdbd2cSJim Jagielski 329*b1cdbd2cSJim JagielskiThe URE allows clients to extend the content of UNO_JAVA_JFW_CLASSPATH_URLS (see 330*b1cdbd2cSJim Jagielskihttp://udk.openoffice.org/common/man/spec/javavendorextension.sxw): The content 331*b1cdbd2cSJim Jagielskiof the public deployment variable URE_MORE_JAVA_CLASSPATH_URLS, if set, is 332*b1cdbd2cSJim Jagielskiadded to the end of the URE's UNO_JAVA_JFW_CLASSPATH_URLS list. 333*b1cdbd2cSJim Jagielski 334*b1cdbd2cSJim JagielskiYou might experience problems in an SDK environment that uses different JDK/JRE 335*b1cdbd2cSJim Jagielskiversions for the SDK and the URE. This problem arises when the OO_SDK_JAVA_HOME 336*b1cdbd2cSJim JagielskiSDK environment variable specifies a different Java VM than the Java VM that is 337*b1cdbd2cSJim Jagielskiused in the URE Java Framework. See the "Installation Guide" section of the SDK 338*b1cdbd2cSJim JagielskiHTML documentation to find out how to set the OO_SDK_JAVA_HOME environment 339*b1cdbd2cSJim Jagielskivariable. 340*b1cdbd2cSJim Jagielski 341*b1cdbd2cSJim Jagielski 342*b1cdbd2cSJim JagielskiGNU Compiler Collection on Linux x86 343*b1cdbd2cSJim Jagielski------------------------------------ 344*b1cdbd2cSJim Jagielski 345*b1cdbd2cSJim JagielskiOn Linux x86, the URE uses libgcc_s.so.1 to run binary UNO components that were 346*b1cdbd2cSJim Jagielskicompiled with the GNU Compiler Collection (GCC), to GCC 3.4.1 as 347*b1cdbd2cSJim Jagielskibuilt on a glibc 2.2.4 system. To avoid GCC compatibility issues, use the same 348*b1cdbd2cSJim JagielskiGCC version (or later) when you compile the UNO binaries. 349*b1cdbd2cSJim JagielskiOtherwise, use LD_PRELOAD to replace the libgcc_s.so.1 in URE with a matching 350*b1cdbd2cSJim Jagielskiversion. 351*b1cdbd2cSJim Jagielski 352*b1cdbd2cSJim Jagielski 353*b1cdbd2cSJim JagielskiC++ and Java UNO Components 354*b1cdbd2cSJim Jagielski--------------------------- 355*b1cdbd2cSJim Jagielski 356*b1cdbd2cSJim JagielskiC++ UNO components run from within the uno executable can depend on an 357*b1cdbd2cSJim Jagielskienvironment in which the public C++ UNO runtime dynamic libraries (cppu, 358*b1cdbd2cSJim Jagielskicppuhelper, purpenvhelper, sal, salhelper, stlport) and the external dynamic 359*b1cdbd2cSJim Jagielskilibraries (libxml2 etc.) are already available (that is, on Linux x86, Solaris 360*b1cdbd2cSJim Jagielskix86, and Solaris SPARC, a component dynamic library need not make sure that the 361*b1cdbd2cSJim JagielskiUNO runtime dynamic libraries it needs can be found on its RPATH). 362*b1cdbd2cSJim Jagielski 363*b1cdbd2cSJim JagielskiSimilarly, Java UNO components can depend on an environment in which the public 364*b1cdbd2cSJim JagielskiJava UNO runtime JARs are already available (that is, a component JAR need not 365*b1cdbd2cSJim Jagielskilist in its manifest Class-Path the UNO runtime JARs it needs). 366*b1cdbd2cSJim Jagielski 367*b1cdbd2cSJim JagielskiIf a Java UNO component requires additional UNO types, use the UNO-Type-Path 368*b1cdbd2cSJim Jagielskimanifest entry to specify the location of the UNO types. The UNO-Type-Path is 369*b1cdbd2cSJim Jagielskisimilar to the Class-Path manifest entry and can contain URLs of JARs and 370*b1cdbd2cSJim Jagielskidirectories that contain the Java classes that represent additional UNO types. 371*b1cdbd2cSJim JagielskiThe UnoClassLoader evaluates the UNO-Type-Path manifest entry to ensure that the 372*b1cdbd2cSJim Jagielskiadditional UNO types are available to the Java UNO environment. 373*b1cdbd2cSJim Jagielski 374*b1cdbd2cSJim JagielskiThe UNO-Type-Path can have the following entries: 375*b1cdbd2cSJim Jagielski 376*b1cdbd2cSJim Jagielski- UNO-Type-Path: 377*b1cdbd2cSJim JagielskiCurrent JAR does not contain UNO types. 378*b1cdbd2cSJim Jagielski 379*b1cdbd2cSJim Jagielski- UNO-Type-Path: <> 380*b1cdbd2cSJim JagielskiCurrent JAR contains UNO types. 381*b1cdbd2cSJim Jagielski 382*b1cdbd2cSJim Jagielski- UNO-Type-Path: any/other/jar.jar yet/another/jar.jar 383*b1cdbd2cSJim JagielskiCurrent JAR brings other JARs that contain UNO types. 384*b1cdbd2cSJim Jagielski 385*b1cdbd2cSJim Jagielski- UNO-Type-Path: any/other/jar.jar <> yet/another/jar.jar 386*b1cdbd2cSJim JagielskiCurrent JAR and other JARs that the current JARs uses contain UNO types. 387*b1cdbd2cSJim Jagielski 388*b1cdbd2cSJim JagielskiNOTE: If you do not include the UNO-Type-Path manifest entry, the URE assumes 389*b1cdbd2cSJim Jagielskithat the current JAR contains UNO types. 390*b1cdbd2cSJim Jagielski 391*b1cdbd2cSJim JagielskiIf a Java application requires the Java UNO environment, the UnoClassLoader must 392*b1cdbd2cSJim Jagielskibe set up to load the relevant Java classes. For example, Runner.java in the 393*b1cdbd2cSJim Jagielskiuretest bundle is packed as runner.jar, which the makefiles use to launch the 394*b1cdbd2cSJim Jagielskijavaclient.jar application. For more information, see 395*b1cdbd2cSJim Jagielskicom.sun.star.lib.unoloader.UnoClassLoader and 396*b1cdbd2cSJim Jagielskicom.sun.star.lib.unoloader.UnoLoader in the "Java UNO Runtime Reference" section 397*b1cdbd2cSJim Jagielskiof the SDK HTML documentation. 398