OpenOffice.org runtime environment variables
This page documents environment variables you can export in your environment to change the OpenOffice.org behaviour at runtime. It does not include variables used by the configuration system, or by the build system in general.
Environment variables for users
Variables that users could use, or should know about.
"Users" includes people developping applications based on OOo (macros, UNO applications).
|DISPLAY||unx||system||X11 display string (ex "localhost:0")|
|HOME||unx||system||User's personal directory|
|MOZILLA_CERTIFICATE_FOLDER||unx||system||Speicify where digital certificates detection should look for, override auto detection in mozilla/firefox/thunderbird's user profile path.|
|OOO_FORCE_DESKTOP||unx||ooo||Override the desktop detection (also implies usage of the appropriate plugin, see SAL_USE_VCLPLUGIN). Possible values: "kde" (KDE), "gnome" (Gnome), "none" (other)|
|SAL_USE_VCLPLUGIN||unx||ooo||The VCL plugin to use. Possible values: "kde" (KDE) or "gtk" (Gnome) or "gen" (generic X11)|
|SAL_VISUAL||unx||ooo||Explicitly set the X11 visual id to use. See xdpyinfo(1) for information on available X11 visuals and the current default visual. There are only some very rare cases where an X11 server would offer multiple visuals and the default visual would not be suitable for use with OOo. But in these cases this variable provides a method to override the default visual for OOo.|
|SystemRoot||win||system||OS specific variable pointing to OS System Directory. If not set external UNO communication to the OOo process will not work. This is relevant when using OOo as component in other applications, for example.|
|LANG||unx||system||This variable determines the locale category for native language, local customs and coded character set in the absence of the LC_ALL and other LC_* (LC_COLLATE, LC_CTYPE, LC_MESSAGES, ...) environment variables. This can be used by applications to determine the language to use for error messages and instructions, collating sequences, date formats, and so forth. See environ(5) for details.|
|LC_ALL||unx||system||This variable determines the values for all locale categories. The value of the LC_ALL environment variable has precedence over any of the other environment variables starting with LC_ (LC_COLLATE, LC_CTYPE, LC_MESSAGES, ...) and the LANG environment variable. See environ(5) for details.|
|LC_COLLATE||unx||system||This variable determines the locale category for character collation. It determines collation information for regular expressions and sorting, including equivalence classes and multi-character collating elements. See environ(5) for details.|
|LC_CTYPE||unx||system||This variable determines the locale category for character handling functions, such as tolower(), toupper() and isalpha(). This environment variable determines the interpretation of sequences of bytes of text data as characters (for example, single- as opposed to multi-byte characters), the classification of characters (for example, alpha, digit, graph) and the behaviour of character classes. See environ(5) for details.|
|LC_MESSAGES||unx||system||This variable determines the locale category for processing affirmative and negative responses and the language and cultural conventions in which messages should be written. See environ(5) for details.|
Environment variables for OOo developers
For testing, debugging, getting system information, etc.
|all||ooo||Is used by the sample configuration logger implementation from configmgr/source/workben/logger. This logger service can be used to get diagnostic output from the configuration services. By default that logger logs to stderr. If CFG_LOGFILE is set to a file name or path, the log output is redirected there.|
|CFG_LOGLEVEL||all||ooo||Is used by the sample configuration logger implementation (see CFG_LOGFILE) to control how much detail should be logged. See API documentation for com.sun.star.util.logging.LogLevel  for available values. Only numeric values are accepted. Default is to log messages from WARNING(=900) and up. Use lower numbers for more detail.|
|DISABLE_SAL_DBGBOX||all||ooo||Disable the OSL assertion dialogs for the non-product builds|
|ENVCFGFLAGS||all||ooo||Will be deprecated or obsoleted soon! Controls an older trace output facility in configmgr that is active only in non-product builds or debug versions of the library. Has a rather obscure syntax.|
|help_debug||all||ooo||Enables additional debug facilities of the help system. In particular, if you press Shift-F1 and hover over an element in the OOo UI, the tooltip will now show you the help id of the element, and the help module where its help text is looked up.|
|OOO_CALC_GENPARCLASSDOC||all||ooo||If Calc's sc/source/core/tool/parclass.cxx was compiled with OSL_DEBUG_LEVEL defined > 1 and this variable is set, generate Calc's parameter classification documentation to stdout, similar to what's available at http://specs.openoffice.org/calc/compatibility/cac/parameter_classification.txt Available since SRC680_m67.|
|OOO_DISABLE_RECOVERY||all||ooo-build||If set this stops the recovery dialog prompting you as OO.o starts up - instead the recovery files are just silently accumulated.|
|OOO_ENABLE_LOCALE_DATA_CHECKS||all||ooo||Check locale data in product builds. For a full description see comment in i18npool/source/localedata/data/locale.dtd Available since SRC680_m109.|
|OOO_FORCE_SYSALLOC||all||ooo-build||If set this disables the internal OO.o allocators, in favour of the system allocators - this means it is possible to get useful valgrind data out of a production build.|
|PROT_REMOTE||all||ooo||Set the file name prefix for logging in bridges/remote modules|
|PROT_REMOTE_FAST||all||ooo||Keep the logging file always open for logging in bridges/remote modules|
|PROT_REMOTE_ACTIVATE||all||ooo||If existing in env activate logging in bridges/remote modules|
|U_RBBIDEBUG||all||ooo||For testing the "rule based break iterator" for ICU|
|SAL_DISABLE_BITMAPS_OPTS||all||ooo||Disables a relatively new templatized fast-path for outputting bitmaps (setting the variable reverts to the old, slow method)|
|STAROFFICE_USERTYPE||all||ooo||Used in crash report handling. Valid values are "qa", "developer" and "internal". Will be included in crash report if set and marks the report as belonging to a certain usertype group. The only usage of that setting is that the crash report database can be asked afterwards how many reports there where of those groups as opposed to normal users.|
Environment variables not classified yet
Remaining to be done
|CLASSPATH||all||java||Path with Diretories and jar files to search for .class files.|
|COMSPEC||win||system||Path to the batch file command interpreter eg. command.com or 4nt.exe.|
|JAVA_HOME||all||java||Path to java installation.|
|PATH||all||system||Directories searched for finding programs and depending on OS also shared libraries.|
|SAL_DISABLE_CUPS||unx||ooo||Disable CUPS printing support|
|SHELL||unix||system||Command shell to use|
|TEMP||win||system||A pathname of a directory made available for programs that need a place to create temporary files.|
|TERM||unix||system||The kind of terminal for which output is to be prepared.|
|TMP||unx||system||A pathname of a directory made available for programs that need a place to create temporary files.|
|TMPDIR||unx||system||A pathname of a directory made available for programs that need a place to create temporary files|
Deprecated environment variables
Were used, but should not be used anymore.
Feedback and Explanation
This list is under construction. If you have information about the role of some environment variable(s), please modify this page (using "Edit" tab at the very top of this page).
To add information about some environment variable that is listed here, please move it from the "not classified yet" table to the "user" or "developer" table (use cut and paste). Try respecting the alphabetical order. Do not hesitate to add missing environment variables nor to remove any "variable" that appears here by mistake.
Reminder: these are runtime environment variables. Not build system ones.
Categories tables are:
- #Environment variables for users = users could use them or should know about them
- #Environment variables for OOo developpers = for developpers only (testing, debugging, getting system information, ...)
- #Environment variables not classified yet = remaining to be done
- #Deprecated environment variables = were used, but should not be used anymore
Operating System ("OS") field is:
- (empty) = not known yet
- linux = GNU/Linux
- mac = Mac OS X
- solaris = Solaris
- other = other UNIX-like system
- win = Microsoft Windows
- unx = linux + mac + solaris + other
- all = unx + win
"Belongs to" field is:
- (empty) = not known yet
- ooo = introduced by OOo
- system = belongs to the underlying operating system(s)
The original list of the environment variables was extracted from the OOo sources.