Command-Line Parsing and Initialization

When you initialize the Ice run time by calling Ice::initialize (C++/Ruby), Ice.Util.initialize (Java/C#) or Ice.initialize (Python), you can pass an argument vector to the initialization call.¹

namespace Ice {
CommunicatorPtr initialize(int& argc, char* argv[]);
}

Ice::initialize parses the argument vector and initializes its property settings accordingly. In addition, it removes any arguments from argv that are property settings. For example, assume we invoke a server as:

$ ./server ‑‑myoption ‑‑Ice.Config=config ‑x a \
‑‑Ice.Trace.Network=3 ‑y opt file

Initially, argc has the value 9, and argv has ten elements: the first nine elements contain the program name and the arguments, and the final element, argv[argc], contains a null pointer (as required by the ISO C++ standard). When Ice::initialize returns, argc has the value 7 and argv contains the following elements:

This means that you should initialize the Ice run time before you parse the command line for your application-specific arguments. That way, the Ice-related options are stripped from the argument vector for you so you do not need to explicitly skip them. If you use the Ice::Application helper class (see Section 8.3.1), the run member function is passed the cleaned-up argument vector as well.

package Ice;
public final class Util {

    public static Communicator
    initialize();

    public static Communicator
    initialize(String[] args);

    public static Communicator
    initialize(StringSeqHolder args);

    public static Communicator
    initialize(InitializationData id);

    public static Communicator
    initialize(String[] args, InitializationData id);

    public static Communicator
    initialize(StringSeqHolder args, InitializationData id);


    // ...
}

The versions that accept an argument vector of type String[] do not strip Ice-related options for you, so, if you use one of these methods, your code must ignore options that start with one of the reserved prefixes (‑‑Ice, ‑‑IceBox, ‑‑IceGrid, ‑‑IcePatch2, ‑‑IceSSL, ‑‑IceStorm, ‑‑Freeze, and ‑‑Glacier2). The versions that accept a StringSeqHolder behave like the C++ version and strip the Ice-related options from the passed argument vector.

In C#, the argument vector is passed by reference to the initialize method, allowing it to strip the Ice-related options:

namespace Ice {

    public sealed class Util {

        public static Communicator
        initialize();

        public static Communicator
        initialize(ref string[] args);

        public static Communicator
        initialize(InitializationData id);

        public static Communicator
        initialize(ref string[] args, InitializationData id);

        // ...

    }
}

The Python and Ruby implementations of initialize have the same semantics as C++ and .NET; they expect the argument vector to be passed as a list from which all Ice-related options are removed.

If you use the Ice.Application helper class, the run method is passed the cleaned‑up argument vector. The Ice.Application class is described in the server-side language mapping chapters.

26.6 Command-Line Parsing and Initialization