summaryrefslogtreecommitdiff
path: root/TAO/tao/PortableServer/ImplRepo.pidl
diff options
context:
space:
mode:
Diffstat (limited to 'TAO/tao/PortableServer/ImplRepo.pidl')
-rw-r--r--TAO/tao/PortableServer/ImplRepo.pidl218
1 files changed, 0 insertions, 218 deletions
diff --git a/TAO/tao/PortableServer/ImplRepo.pidl b/TAO/tao/PortableServer/ImplRepo.pidl
deleted file mode 100644
index cbeb5fc3708..00000000000
--- a/TAO/tao/PortableServer/ImplRepo.pidl
+++ /dev/null
@@ -1,218 +0,0 @@
-// -*- IDL -*-
-
-//=============================================================================
-/**
- * @file ImplRepo.pidl
- *
- * $Id$
- *
- * This file was used to generate the code in ImplRepo{C,S,S_T}.{h,i,cpp}
- *
- * The command used to generate code from this file is:
- *
- * tao_idl.exe -o orig -ci C.i -si S.i -st S_T.i -Gp -Gd -Ge 1 -Sc -GT -Wb,export_macro=TAO_PortableServer_Export -Wb,export_include=portableserver_export.h -Wb,pre_include="ace/pre.h" -Wb,post_include="ace/post.h" ImplRepo.pidl
- *
- */
-//=============================================================================
-
-module ImplementationRepository
-{
- /**
- * @brief Server Side IR Object
- *
- * This object, which exists on the servers that use the
- * Implementation Repository (IR), is used to control or check the
- * status of the server by the IR.
- */
- interface ServerObject
- {
- /// Check the liveness of a server.
- void ping ();
-
- /// Try to shutdown the server gracefully.
- void shutdown ();
- };
-
- // = Exceptions
-
- /// Object already bound in the Implementation Repository
- exception AlreadyRegistered {};
-
- /// The server could not be restarted.
- exception CannotActivate
- {
- string reason;
- };
-
- /// Object not found in the Implementation Repository
- exception NotFound {};
-
- /// One environment variable/value pair.
- struct EnvironmentVariable
- {
- string name;
- string value;
- };
-
- /// This is used in places that require a partial IOR with
- /// just the ObjectKey missing.
- typedef string Address;
-
- /// Complete Environment.
- typedef sequence<EnvironmentVariable> EnvironmentList;
-
- /// The type of Activation
- enum ActivationMode {NORMAL, MANUAL, PER_CLIENT, AUTO_START};
-
- /// Options used to start up the server.
- struct StartupOptions
- {
- /// Startup command (program name and arguments).
- string command_line;
-
- /// Environment Variables.
- EnvironmentList environment;
-
- /// Working directory.
- string working_directory;
-
- /// Activation Mode
- ActivationMode activation;
-
- /// Name of the activator
- string activator;
- };
-
- /// All the information about one server.
- struct ServerInformation
- {
- /// The logical server this server is part of.
- string logical_server;
-
- /// Server name.
- string server;
-
- /// How to start up the server.
- StartupOptions startup;
-
- /// Where the server is located currently.
- Address location;
- };
-
- typedef sequence <ServerInformation> ServerInformationList;
-
- /// Forward declaration.
- interface ServerInformationIterator;
-
- /**
- * @brief The Implementation Repository Administration Interface
- *
- * This interface exports all the administration functionality of
- * the Implementation Repository.
- */
- interface Administration
- {
- /// Activate server that is named @a server.
- ///
- /// The <NotFound> exception is raised when <server> is not found
- /// in the Implementation Repository. The <CannotActivate> exception
- /// is raised when <server> is found in the Repository but could not be
- /// activated.
- void activate_server (in string server)
- raises (NotFound, CannotActivate);
-
- string activate_server_with_startup (in string server,
- in long check_startup)
- raises (NotFound, CannotActivate);
-
- /// Register the <options> to specify how the <server> should be
- /// restarted when a client asks for it.
- ///
- /// The <AlreadyRegistered> exception is raised when <server> has
- /// already been registered with the Implementation Repository.
- /// The <NotFound> exception is raised when the activator specified
- /// in the options is not registered.
- void register_server (in string server,
- in StartupOptions options)
- raises (AlreadyRegistered, NotFound);
-
- /// Update the <options> to specify how the <server> should be
- /// restarted when a client asks for it. Will register the server
- /// if not already registered.
- /// The <AlreadyRegistered> exception is raised when <server> has
- /// already been registered with a different activator.
- /// The <NotFound> exception is raised when the activator specified
- /// in the options is not registered.
- void reregister_server (in string server,
- in StartupOptions options)
- raises(AlreadyRegistered, NotFound);
-
- /// Remove <server> from the Implementation Repository.
- ///
- /// The <NotFound> exception is raised when <server> is not found
- /// in the Implementation Repository.
- void remove_server (in string server)
- raises (NotFound);
-
- /// Tries to shutdown the server, first gracefully, then ungracefully.
- ///
- /// The <NotFound> exception is raised when <server> is not found
- /// in the Implementation Repository.
- void shutdown_server (in string server)
- raises (NotFound);
-
- /// Used to notify the Implementation Repository that <server> is alive
- /// and well at <addr>.
- ///
- /// The <NotFound> exception is raised when <server> is not found
- /// in the Implementation Repository.
- void server_is_running (in string server,
- in Address addr,
- in ServerObject server_object)
- raises (NotFound);
-
- /// Used to tell the Implementation Repository that <server> is shutting
- /// down.
- ///
- /// The <NotFound> exception is raised when <server> is not found
- /// in the Implementation Repository.
- void server_is_shutting_down (in string server)
- raises (NotFound);
-
- /// Returns the startup information for a given <server>.
- ///
- /// The <NotFound> exception is raised when <server> is not found
- /// in the Implementation Repository.
- void find (in string server,
- out ServerInformation info)
- raises (NotFound);
-
- /// Returns at most <how_many> servers in <server_list>. If there
- /// are additional servers, they can be received through the
- /// <server_iterator>. If there are no more servers, then
- /// <server_iterator> is null.
- void list (in unsigned long how_many,
- out ServerInformationList server_list,
- out ServerInformationIterator server_iterator);
-
- /// Shuts down the repository
- void shutdown_repo() ;
-
- string find_ior (in string object_name)
- raises (NotFound);
-
- };
-
- /// Interface for iterating over servers returned with
- /// Administration::list ().
- interface ServerInformationIterator
- {
- /// This operation returns at most the requested number of
- /// servers.
- boolean next_n (in unsigned long how_many,
- out ServerInformationList server_list);
-
- /// This operation destroys the iterator.
- void destroy ();
- };
-};