Table of Contents Previous Next
Logo
Appendix C
Copyright © 2003-2009 ZeroC, Inc.

Appendix C 

Properties

This chapter provides a reference for all properties used by the Ice run time and its services.
Unless stated otherwise in the description of an individual property, its default value is the empty string. If a property takes a numeric value, the empty string is interpreted as zero.
Note that Ice reads properties that control the run time and its services only once on start-up, when you create a communicator. This means that you must set Ice-related properties to their correct values before you create a communicator. If you change the value of an Ice-related property after that point, it is likely that the new setting will simply be ignored.

C.1 Ice Configuration Property

Ice.Config

Synopsis

‑Ice.Config
‑‑Ice.Config=1
‑‑Ice.Config=config_file[,config_file,...]

Description

This property must be set from the command line with the Ice.Config, Ice.Config=1, or Ice.Config=config_file option.
If the Ice.Config property is empty or set to 1, the Ice run time examines the contents of the ICE_CONFIG environment variable to retrieve the path names of one or more configuration files. Otherwise, Ice.Config must be set to the path names of one or more configuration files, separated by commas. (Path names can be relative or absolute.) Further property values are read from the configuration files thus specified.

Configuration File Syntax

A configuration file contains a number of property settings, one setting per line. Property settings have one of the forms
property_name= # Set property to the empty string or zero
property_name=value # Assign value to property
The # character indicates a comment: the # character and anything following the # character on the same line are ignored. A line that has the # character as its first non-white space character is ignored in its entirety.
A configuration file is free-form: blank, tab, and newline characters serve as token delimiters and are otherwise ignored.
Any setting of the Ice.Config property inside the configuration file itself is ignored.
Table of Contents Previous Next
Logo