zeroc-ice 3.7.9.1 → 3.8.0

data/ext/ice/cpp/include/Ice/Service.h

@@ -1,379 +0,0 @@
-//
-// Copyright (c) ZeroC, Inc. All rights reserved.
-//
-
-#ifndef ICE_SERVICE_H
-#define ICE_SERVICE_H
-
-#include <Ice/Initialize.h>
-#include <Ice/LoggerUtil.h>
-
-#ifdef _WIN32
-#   include <winsvc.h>
-#endif
-
-namespace Ice
-{
-
-/**
- * A singleton class comparable to Ice::Application but also provides the low-level, platform-specific
- * initialization and shutdown procedures common to system services.
- * \headerfile Ice/Ice.h
- */
-class ICE_API Service
-{
-public:
-
-    Service();
-    virtual ~Service();
-
-    /**
-     * Shutdown the service. The default implementation invokes shutdown()
-     * on the communicator.
-     */
-    virtual bool shutdown();
-
-    /**
-     * Notify the service about a signal interrupt. The default
-     * implementation invokes shutdown().
-     */
-    virtual void interrupt();
-
-    /**
-     * The primary entry point for services. This function examines
-     * the given argument vector for reserved options and takes the
-     * appropriate action. The reserved options are shown below.
-     *
-     * Win32:
-     *
-     * --service NAME
-     *
-     * Unix:
-     *
-     * --daemon [--nochdir] [--noclose]
-     *
-     * If --service or --daemon are specified, the program runs as
-     * a service, otherwise the program runs as a regular foreground
-     * process. Any service-specific (and Ice-specific) options
-     * are stripped from argv (just as for Ice::initialize()).
-     *
-     * @param argc Specifies the number of arguments in argv.
-     * @param argv The command-line arguments.
-     * @param initData Configuration data for the new Communicator.
-     * @param version Indicates the Ice version with which the application is compatible. If not
-     * specified, the version of the Ice installation is used.
-     * @return The application's exit status: EXIT_FAILURE or EXIT_SUCCESS.
-     */
-    int main(int argc, const char* const argv[], const InitializationData& initData = InitializationData(),
-             int version = ICE_INT_VERSION);
-
-#ifdef _WIN32
-    /**
-     * The primary entry point for services. This function examines
-     * the given argument vector for reserved options and takes the
-     * appropriate action. The reserved options are shown below.
-     *
-     * Win32:
-     *
-     * --service NAME
-     *
-     * Unix:
-     *
-     * --daemon [--nochdir] [--noclose]
-     *
-     * If --service or --daemon are specified, the program runs as
-     * a service, otherwise the program runs as a regular foreground
-     * process. Any service-specific (and Ice-specific) options
-     * are stripped from argv (just as for Ice::initialize()).
-     *
-     * @param argc Specifies the number of arguments in argv.
-     * @param argv The command-line arguments.
-     * @param initData Configuration data for the new Communicator.
-     * @param version Indicates the Ice version with which the application is compatible. If not
-     * specified, the version of the Ice installation is used.
-     * @return The application's exit status: EXIT_FAILURE or EXIT_SUCCESS.
-     */
-    int main(int argc, const wchar_t* const argv[], const InitializationData& initData = InitializationData(),
-             int version = ICE_INT_VERSION);
-#endif
-
-    /**
-     * The primary entry point for services. This function examines
-     * the given argument vector for reserved options and takes the
-     * appropriate action. The reserved options are shown below.
-     *
-     * Win32:
-     *
-     * --service NAME
-     *
-     * Unix:
-     *
-     * --daemon [--nochdir] [--noclose]
-     *
-     * If --service or --daemon are specified, the program runs as
-     * a service, otherwise the program runs as a regular foreground
-     * process. Any service-specific (and Ice-specific) options
-     * are stripped from argv (just as for Ice::initialize()).
-     *
-     * @param args The command-line arguments.
-     * @param initData Configuration data for the new Communicator.
-     * @param version Indicates the Ice version with which the application is compatible. If not
-     * specified, the version of the Ice installation is used.
-     * @return The application's exit status: EXIT_FAILURE or EXIT_SUCCESS.
-     */
-    int main(const StringSeq& args, const InitializationData& initData = InitializationData(),
-             int version = ICE_INT_VERSION);
-
-    /**
-     * Obtains the communicator created by the service.
-     * @return The service's communicator.
-     */
-    Ice::CommunicatorPtr communicator() const;
-
-    /**
-     * Obtains the Service singleton.
-     * @return A pointer to this service.
-     */
-    static Service* instance();
-
-    /**
-     * Indicates whether the program is running as a Win32 service or Unix daemon.
-     * @return True if the program is running as a service, false otherwise.
-     */
-    bool service() const;
-
-    /**
-     * Obtains the program name. If the program is running as a Win32
-     * service, the return value is the service name. Otherwise the
-     * return value is the executable name (i.e., argv[0]).
-     * @return The service name.
-     */
-    std::string name() const;
-
-    /**
-     * Determines whether the operating system supports running the
-     * program as a Win32 service or Unix daemon.
-     * @return True if the system supports services, false otherwise.
-     */
-    bool checkSystem() const;
-
-#ifdef _WIN32
-    /**
-     * Alternative entry point for services that use their own
-     * command-line options. Instead of invoking main(), the
-     * program processes its command-line options and invokes
-     * run(). To run as a Win32 service or Unix daemon, the
-     * program must first invoke configureService() or
-     * configureDaemon(), respectively.
-     *
-     * @param argc Specifies the number of arguments in argv.
-     * @param argv The command-line arguments.
-     * @param initData Configuration data for the new Communicator.
-     * @param version Indicates the Ice version with which the application is compatible. If not
-     * specified, the version of the Ice installation is used.
-     * @return The application's exit status: EXIT_FAILURE or EXIT_SUCCESS.
-     */
-    int run(int argc, const wchar_t* const argv[], const InitializationData& initData = InitializationData(),
-            int version = ICE_INT_VERSION);
-#endif
-
-    /**
-     * Alternative entry point for services that use their own
-     * command-line options. Instead of invoking main(), the
-     * program processes its command-line options and invokes
-     * run(). To run as a Win32 service or Unix daemon, the
-     * program must first invoke configureService() or
-     * configureDaemon(), respectively.
-     *
-     * @param argc Specifies the number of arguments in argv.
-     * @param argv The command-line arguments.
-     * @param initData Configuration data for the new Communicator.
-     * @param version Indicates the Ice version with which the application is compatible. If not
-     * specified, the version of the Ice installation is used.
-     * @return The application's exit status: EXIT_FAILURE or EXIT_SUCCESS.
-     */
-    int run(int argc, const char* const argv[], const InitializationData& initData = InitializationData(),
-            int version = ICE_INT_VERSION);
-
-#ifdef _WIN32
-
-    /**
-     * Configures the program to run as a Win32 service with the given name.
-     * @param name The service name.
-     */
-    void configureService(const std::string& name);
-
-    /// \cond INTERNAL
-    static void setModuleHandle(HMODULE);
-    /// \endcond
-
-#else
-
-    /**
-     * Configures the program to run as a Unix daemon. The first
-     * argument indicates whether the daemon should change its
-     * working directory to the root directory. The second
-     * argument indicates whether extraneous file descriptors are
-     * closed. If the value of the last argument is not an empty
-     * string, the daemon writes its process ID to the given
-     * filename.
-     *
-     * @param changeDirectory True if the daemon should change its working directory to the root directory,
-     * false otherwise.
-     * @param closeFiles True if the daemon should close unnecessary file descriptors (i.e., stdin, stdout, etc.),
-     * false otherwise.
-     * @param pidFile If a non-empty string is provided, the daemon writes its process ID to the given file.
-     */
-    void configureDaemon(bool changeDirectory, bool closeFiles, const std::string& pidFile);
-
-#endif
-
-    /**
-     * Invoked by the signal handler when it catches a signal.
-     * @param sig The signal that was caught.
-     */
-    virtual void handleInterrupt(int sig);
-
-protected:
-
-    /**
-     * Prepares a service for execution, including the creation and
-     * activation of object adapters and servants.
-     * @param argc Specifies the number of arguments in argv.
-     * @param argv The command-line arguments.
-     * @param status The exit status, which is returned by main
-     * @return True if startup was successful, false otherwise.
-     */
-    virtual bool start(int argc, char* argv[], int& status) = 0;
-
-    /**
-     * Blocks until the service shuts down. The default implementation
-     * invokes waitForShutdown() on the communicator.
-     */
-    virtual void waitForShutdown();
-
-    /**
-     * Cleans up resources after shutting down.
-     */
-    virtual bool stop();
-
-    /**
-     * Initializes a communicator.
-     * @param argc Specifies the number of arguments in argv.
-     * @param argv The command-line arguments.
-     * @param initData Configuration data for the new Communicator.
-     * @param version Indicates the Ice version with which the application is compatible. If not
-     * specified, the version of the Ice installation is used.
-     * @return The new communicator instance.
-     */
-    virtual Ice::CommunicatorPtr initializeCommunicator(int& argc, char* argv[], const InitializationData& initData,
-                                                        int version);
-
-    /**
-     * Logs a system error, which includes a description of the
-     * current system error code.
-     * @param msg The log message.
-     */
-    virtual void syserror(const std::string& msg);
-
-    /**
-     * Logs an error.
-     * @param msg The log message.
-     */
-    virtual void error(const std::string& msg);
-
-    /**
-     * Logs a warning.
-     * @param msg The log message.
-     */
-    virtual void warning(const std::string& msg);
-
-    /**
-     * Logs trace information.
-     * @param msg The log message.
-     */
-    virtual void trace(const std::string& msg);
-
-    /**
-     * Logs a literal message.
-     * @param msg The log message.
-     */
-    virtual void print(const std::string& msg);
-
-    /**
-     * Enables the signal handler to invoke interrupt() when a signal occurs.
-     */
-    void enableInterrupt();
-
-    /**
-     * Ignore signals.
-     */
-    void disableInterrupt();
-
-    /**
-     * Logger utility class for a system error.
-     */
-    typedef LoggerOutput<Service, Service*, &Service::syserror> ServiceSysError;
-
-    /**
-     * Logger utility class for an error.
-     */
-    typedef LoggerOutput<Service, Service*, &Service::error> ServiceError;
-
-    /**
-     * Logger utility class for a warning.
-     */
-    typedef LoggerOutput<Service, Service*, &Service::warning> ServiceWarning;
-
-    /**
-     * Logger utility class for a trace message.
-     */
-    typedef LoggerOutput<Service, Service*, &Service::trace> ServiceTrace;
-
-    /**
-     * Logger utility class for a literal message.
-     */
-    typedef LoggerOutput<Service, Service*, &Service::print> ServicePrint;
-
-private:
-
-    Ice::LoggerPtr _logger;
-    Ice::CommunicatorPtr _communicator;
-    bool _nohup;
-    bool _service;
-    std::string _name;
-
-    static Service* _instance;
-
-#ifdef _WIN32
-
-    int runService(int, const char* const[], const InitializationData&);
-    void terminateService(DWORD);
-    bool waitForServiceState(SC_HANDLE, DWORD, SERVICE_STATUS&);
-    void showServiceStatus(const std::string&, SERVICE_STATUS&);
-
-    SERVICE_STATUS_HANDLE _statusHandle;
-    std::vector<std::string> _serviceArgs;
-    InitializationData _initData;
-
-public:
-
-    /// \cond INTERNAL
-    void serviceMain(int, const wchar_t* const[]);
-    void control(int);
-    /// \endcond
-
-#else
-
-    int runDaemon(int, char*[], const InitializationData&, int);
-
-    bool _changeDirectory;
-    bool _closeFiles;
-    std::string _pidFile;
-
-#endif
-};
-
-} // End of namespace Ice
-
-#endif

data/ext/ice/cpp/include/Ice/SliceChecksums.h

@@ -1,33 +0,0 @@
-//
-// Copyright (c) ZeroC, Inc. All rights reserved.
-//
-
-#ifndef ICE_SLICE_CHECKSUM_H
-#define ICE_SLICE_CHECKSUM_H
-
-#include <Ice/SliceChecksumDict.h>
-
-namespace Ice
-{
-
-/**
- * Obtains the map containing the checksums for Slice definitions.
- * @return The checksum map.
- */
-ICE_API SliceChecksumDict sliceChecksums();
-
-}
-
-namespace IceInternal
-{
-
-class ICE_API SliceChecksumInit : private IceUtil::noncopyable
-{
-public:
-
-    SliceChecksumInit(const char*[]);
-};
-
-}
-
-#endif

data/ext/ice/cpp/include/Ice/SlicedData.h

@@ -1,172 +0,0 @@
-//
-// Copyright (c) ZeroC, Inc. All rights reserved.
-//
-
-#ifndef ICE_SLICED_DATA_H
-#define ICE_SLICED_DATA_H
-
-#include <Ice/SlicedDataF.h>
-#include <Ice/GCObject.h>
-#include <Ice/Value.h>
-
-namespace Ice
-{
-
-/**
- * Encapsulates the details of a slice for an unknown class or exception type.
- * \headerfile Ice/Ice.h
- */
-struct ICE_API SliceInfo
-#ifndef ICE_CPP11_MAPPING
-    : public ::IceUtil::Shared
-#endif
-{
-    /**
-     * The Slice type ID for this slice.
-     */
-    ::std::string typeId;
-
-    /**
-     * The Slice compact type ID for this slice.
-     */
-    int compactId;
-
-    /**
-     * The encoded bytes for this slice, including the leading size integer.
-     */
-    ::std::vector<Byte> bytes;
-
-    /**
-     * The class instances referenced by this slice.
-     */
-    ::std::vector<ValuePtr> instances;
-
-    /**
-     * Whether or not the slice contains optional members.
-     */
-    bool hasOptionalMembers;
-
-    /**
-     * Whether or not this is the last slice.
-     */
-    bool isLastSlice;
-};
-
-/**
- * Holds the slices of unknown types.
- * \headerfile Ice/Ice.h
- */
-class ICE_API SlicedData
-#ifndef ICE_CPP11_MAPPING
-    : public ::IceUtil::Shared
-#endif
-{
-public:
-
-#ifndef ICE_CPP11_MAPPING
-    virtual ~SlicedData();
-#endif
-
-    SlicedData(const SliceInfoSeq&);
-
-    /** The slices of unknown types. */
-    const SliceInfoSeq slices;
-
-    /**
-     * Clears the slices to break potential cyclic references.
-     */
-    void clear();
-
-#ifndef ICE_CPP11_MAPPING
-    /// \cond INTERNAL
-    void _iceGcVisitMembers(IceInternal::GCVisitor&);
-    /// \endcond
-#endif
-
-};
-
-/**
- * Represents an instance of an unknown type.
- * \headerfile Ice/Ice.h
- */
-class ICE_API UnknownSlicedValue :
-#ifdef ICE_CPP11_MAPPING
-    public Value
-#else
-    public IceInternal::GCObject
-#endif
-{
-public:
-
-    /**
-     * Constructs the placeholder instance.
-     * @param unknownTypeId The Slice type ID of the unknown value.
-     */
-    UnknownSlicedValue(const std::string& unknownTypeId);
-
-#ifdef ICE_CPP11_MAPPING
-    /**
-     * Obtains the sliced data associated with this instance.
-     * @return The sliced data if the value has a preserved-slice base class and has been sliced during
-     * unmarshaling of the value, or nil otherwise.
-     */
-    virtual SlicedDataPtr ice_getSlicedData() const override;
-
-    /**
-     * Determine the Slice type ID associated with this instance.
-     * @return The type ID supplied to the constructor.
-     */
-    virtual std::string ice_id() const override;
-
-    /**
-     * Clones this object.
-     * @return A new instance.
-     */
-    std::shared_ptr<UnknownSlicedValue> ice_clone() const;
-
-    /// \cond STREAM
-    virtual void _iceWrite(::Ice::OutputStream*) const override;
-    virtual void _iceRead(::Ice::InputStream*) override;
-    /// \endcond
-
-protected:
-
-    /// \cond INTERNAL
-    virtual std::shared_ptr<Value> _iceCloneImpl() const override;
-    /// \endcond
-
-#else
-
-    /**
-     * Obtains the sliced data associated with this instance.
-     * @return The sliced data if the value has a preserved-slice base class and has been sliced during
-     * unmarshaling of the value, or nil otherwise.
-     */
-    virtual SlicedDataPtr ice_getSlicedData() const;
-
-    /**
-     * Determine the Slice type ID associated with this instance.
-     * @param current The current object for this invocation.
-     * @return The type ID supplied to the constructor.
-     */
-    virtual const std::string& ice_id(const Current& current = Ice::emptyCurrent) const;
-
-    /// \cond INTERNAL
-    virtual void _iceGcVisitMembers(IceInternal::GCVisitor&);
-    /// \endcond
-
-    /// \cond STREAM
-    virtual void _iceWrite(::Ice::OutputStream*) const;
-    virtual void _iceRead(::Ice::InputStream*);
-    /// \endcond
-#endif
-
-private:
-
-    const std::string _unknownTypeId;
-    SlicedDataPtr _slicedData;
-};
-
-}
-
-#endif

data/ext/ice/cpp/include/Ice/SlicedDataF.h

@@ -1,40 +0,0 @@
-//
-// Copyright (c) ZeroC, Inc. All rights reserved.
-//
-
-#ifndef ICE_SLICED_DATA_F_H
-#define ICE_SLICED_DATA_F_H
-
-#include <IceUtil/Shared.h>
-#include <Ice/Handle.h>
-
-namespace Ice
-{
-
-struct SliceInfo;
-class SlicedData;
-class UnknownSlicedValue;
-
-#ifdef ICE_CPP11_MAPPING
-/// \cond INTERNAL
-using SliceInfoPtr = ::std::shared_ptr<SliceInfo>;
-using SlicedDataPtr = ::std::shared_ptr<SlicedData>;
-using UnknownSlicedValuePtr = ::std::shared_ptr<UnknownSlicedValue>;
-/// \endcond
-#else
-ICE_API IceUtil::Shared* upCast(SliceInfo*);
-typedef IceInternal::Handle<SliceInfo> SliceInfoPtr;
-
-ICE_API IceUtil::Shared* upCast(SlicedData*);
-typedef IceInternal::Handle<SlicedData> SlicedDataPtr;
-
-ICE_API IceUtil::Shared* upCast(UnknownSlicedValue*);
-typedef IceInternal::Handle<UnknownSlicedValue> UnknownSlicedValuePtr;
-#endif
-
-/** The slices of unknown types. */
-typedef ::std::vector<SliceInfoPtr> SliceInfoSeq;
-
-}
-
-#endif