Ice 3.7 C++11 API Reference
Public Member Functions | Static Public Member Functions | List of all members
Ice::ProcessPrx Class Reference

An administrative interface for process management. More...

#include <Ice/Ice.h>

Inheritance diagram for Ice::ProcessPrx:
Inheritance graph
[legend]
Collaboration diagram for Ice::ProcessPrx:
Collaboration graph
[legend]

Public Member Functions

void shutdown (const Context &context=noExplicitContext)
 Initiate a graceful shut-down. More...
 
::std::function< void()> shutdownAsync (::std::function< void()> response, ::std::function< void(::std::exception_ptr)> ex=nullptr, ::std::function< void(bool)> sent=nullptr, const Context &context=noExplicitContext)
 Initiate a graceful shut-down. More...
 
template<template< typename > class P = ::std::promise>
auto shutdownAsync (const Context &context=noExplicitContext) -> decltype(::std::declval< P< void >>().get_future())
 Initiate a graceful shut-down. More...
 
void writeMessage (const ::std::string &message, int fd, const Context &context=noExplicitContext)
 Write a message on the process' stdout or stderr. More...
 
::std::function< void()> writeMessageAsync (const ::std::string &message, int fd, ::std::function< void()> response, ::std::function< void(::std::exception_ptr)> ex=nullptr, ::std::function< void(bool)> sent=nullptr, const Context &context=noExplicitContext)
 Write a message on the process' stdout or stderr. More...
 
template<template< typename > class P = ::std::promise>
auto writeMessageAsync (const ::std::string &message, int fd, const Context &context=noExplicitContext) -> decltype(::std::declval< P< void >>().get_future())
 Write a message on the process' stdout or stderr. More...
 
- Public Member Functions inherited from Ice::Proxy< ProcessPrx, ObjectPrx >
::std::shared_ptr< ProcessPrxice_adapterId (const ::std::string &id) const
 Obtains a proxy that is identical to this proxy, except for the adapter ID. More...
 
::std::shared_ptr< ProcessPrxice_batchDatagram () const
 Obtains a proxy that is identical to this proxy, but uses batch datagram invocations. More...
 
::std::shared_ptr< ProcessPrxice_batchOneway () const
 Obtains a proxy that is identical to this proxy, but uses batch oneway invocations. More...
 
::std::shared_ptr< ProcessPrxice_collocationOptimized (bool b) const
 Obtains a proxy that is identical to this proxy, except for collocation optimization. More...
 
::std::shared_ptr< ProcessPrxice_compress (bool b) const
 Obtains a proxy that is identical to this proxy, except for its compression setting which overrides the compression setting from the proxy endpoints. More...
 
::std::shared_ptr< ProcessPrxice_connectionCached (bool b) const
 Obtains a proxy that is identical to this proxy, except for connection caching. More...
 
::std::shared_ptr< ProcessPrxice_connectionId (const ::std::string &id) const
 Obtains a proxy that is identical to this proxy, except for its connection ID. More...
 
::std::shared_ptr< ProcessPrxice_context (const ::Ice::Context &context) const
 Obtains a proxy that is identical to this proxy, except for the per-proxy context. More...
 
::std::shared_ptr< ProcessPrxice_datagram () const
 Obtains a proxy that is identical to this proxy, but uses datagram invocations. More...
 
::std::shared_ptr< ProcessPrxice_encodingVersion (const ::Ice::EncodingVersion &version) const
 Obtains a proxy that is identical to this proxy, except for the encoding used to marshal parameters. More...
 
::std::shared_ptr< ProcessPrxice_endpoints (const ::Ice::EndpointSeq &endpoints) const
 Obtains a proxy that is identical to this proxy, except for the endpoints. More...
 
::std::shared_ptr< ProcessPrxice_endpointSelection (::Ice::EndpointSelectionType type) const
 Obtains a proxy that is identical to this proxy, except for the endpoint selection policy. More...
 
::std::shared_ptr< ProcessPrxice_fixed (const ::std::shared_ptr<::Ice::Connection > &connection) const
 Obtains a proxy that is identical to this proxy, except it's a fixed proxy bound the given connection. More...
 
::std::shared_ptr< ProcessPrxice_invocationTimeout (int timeout) const
 Obtains a proxy that is identical to this proxy, except for the invocation timeout. More...
 
::std::shared_ptr< ProcessPrxice_locator (const ::std::shared_ptr<::Ice::LocatorPrx > &locator) const
 Obtains a proxy that is identical to this proxy, except for the locator. More...
 
::std::shared_ptr< ProcessPrxice_locatorCacheTimeout (int timeout) const
 Obtains a proxy that is identical to this proxy, except for the locator cache timeout. More...
 
::std::shared_ptr< ProcessPrxice_oneway () const
 Obtains a proxy that is identical to this proxy, but uses oneway invocations. More...
 
::std::shared_ptr< ProcessPrxice_preferSecure (bool b) const
 Obtains a proxy that is identical to this proxy, except for its endpoint selection policy. More...
 
::std::shared_ptr< ProcessPrxice_router (const ::std::shared_ptr<::Ice::RouterPrx > &router) const
 Obtains a proxy that is identical to this proxy, except for the router. More...
 
::std::shared_ptr< ProcessPrxice_secure (bool b) const
 Obtains a proxy that is identical to this proxy, except for how it selects endpoints. More...
 
::std::shared_ptr< ProcessPrxice_timeout (int timeout) const
 Obtains a proxy that is identical to this proxy, except for its connection timeout setting which overrides the timeot setting from the proxy endpoints. More...
 
::std::shared_ptr< ProcessPrxice_twoway () const
 Obtains a proxy that is identical to this proxy, but uses twoway invocations. More...
 

Static Public Member Functions

static const ::std::string & ice_staticId ()
 Obtains the Slice type ID of this interface. More...
 

Detailed Description

An administrative interface for process management.

Managed servers must implement this interface.

A servant implementing this interface is a potential target for denial-of-service attacks, therefore proper security precautions should be taken. For example, the servant can use a UUID to make its identity harder to guess, and be registered in an object adapter with a secured endpoint.

Member Function Documentation

◆ ice_staticId()

static const ::std::string& Ice::ProcessPrx::ice_staticId ( )
static

Obtains the Slice type ID of this interface.

Returns
The fully-scoped type ID.

◆ shutdown()

void Ice::ProcessPrx::shutdown ( const Context context = noExplicitContext)
inline

Initiate a graceful shut-down.

Parameters
contextThe Context map to send with the invocation.
See also
Communicator::shutdown

◆ shutdownAsync() [1/2]

::std::function<void()> Ice::ProcessPrx::shutdownAsync ( ::std::function< void()>  response,
::std::function< void(::std::exception_ptr)>  ex = nullptr,
::std::function< void(bool)>  sent = nullptr,
const Context context = noExplicitContext 
)
inline

Initiate a graceful shut-down.

Parameters
responseThe response callback.
exThe exception callback.
sentThe sent callback.
contextThe Context map to send with the invocation.
Returns
A function that can be called to cancel the invocation locally.
See also
Communicator::shutdown

◆ shutdownAsync() [2/2]

template<template< typename > class P = ::std::promise>
auto Ice::ProcessPrx::shutdownAsync ( const Context context = noExplicitContext) -> decltype(::std::declval<P<void>>().get_future())
inline

Initiate a graceful shut-down.

Parameters
contextThe Context map to send with the invocation.
Returns
The future object for the invocation.
See also
Communicator::shutdown

◆ writeMessage()

void Ice::ProcessPrx::writeMessage ( const ::std::string &  message,
int  fd,
const Context context = noExplicitContext 
)
inline

Write a message on the process' stdout or stderr.

Parameters
messageThe message.
fd1 for stdout, 2 for stderr.
contextThe Context map to send with the invocation.

◆ writeMessageAsync() [1/2]

::std::function<void()> Ice::ProcessPrx::writeMessageAsync ( const ::std::string &  message,
int  fd,
::std::function< void()>  response,
::std::function< void(::std::exception_ptr)>  ex = nullptr,
::std::function< void(bool)>  sent = nullptr,
const Context context = noExplicitContext 
)
inline

Write a message on the process' stdout or stderr.

Parameters
messageThe message.
fd1 for stdout, 2 for stderr.
responseThe response callback.
exThe exception callback.
sentThe sent callback.
contextThe Context map to send with the invocation.
Returns
A function that can be called to cancel the invocation locally.

◆ writeMessageAsync() [2/2]

template<template< typename > class P = ::std::promise>
auto Ice::ProcessPrx::writeMessageAsync ( const ::std::string &  message,
int  fd,
const Context context = noExplicitContext 
) -> decltype(::std::declval<P<void>>().get_future())
inline

Write a message on the process' stdout or stderr.

Parameters
messageThe message.
fd1 for stdout, 2 for stderr.
contextThe Context map to send with the invocation.
Returns
The future object for the invocation.

The documentation for this class was generated from the following file: