paludis  Version 2.6.0
Public Member Functions | List of all members
paludis::IPCOutputManager Class Reference
+ Inheritance diagram for paludis::IPCOutputManager:

Public Member Functions

 IPCOutputManager (const int pipe_read_fd, const int pipe_write_fd, const CreateOutputManagerInfo &)
 
virtual std::ostream & stdout_stream () PALUDIS_ATTRIBUTE((warn_unused_result))
 
virtual std::ostream & stderr_stream () PALUDIS_ATTRIBUTE((warn_unused_result))
 
virtual void succeeded ()
 
virtual void ignore_succeeded ()
 
virtual void flush ()
 
virtual bool want_to_flush () const
 
virtual void nothing_more_to_come ()
 
virtual void message (const MessageType, const std::string &)
 
- Public Member Functions inherited from paludis::OutputManager
 OutputManager (const OutputManager &)=delete
 
OutputManageroperator= (const OutputManager &)=delete
 

Member Function Documentation

virtual void paludis::IPCOutputManager::flush ( )
virtual

Clients may call this method every few seconds when running multiple processes.

This is used to display ongoing buffered messages without mixing output from multiple processes.

Implements paludis::OutputManager.

virtual void paludis::IPCOutputManager::ignore_succeeded ( )
virtual

Instructs the output manager to ignore future calls to succeeded().

Typically this is used to force log files to be kept even if an error has occurred, if the error does not trigger the usual failure mechanisms.

Since
0.59

Implements paludis::OutputManager.

virtual void paludis::IPCOutputManager::message ( const MessageType  ,
const std::string &   
)
virtual

An out of band message that might want to be logged or handled in a special way.

The caller must still also display the message to stdout_stream() as appropriate.

Implements paludis::OutputManager.

virtual void paludis::IPCOutputManager::nothing_more_to_come ( )
virtual

May be called to indicate that no further output or messages will occur, allowing for files to be closed off etc.

Summary messages are shown when the output manager is destructed, not when this method is called.

If this method and succeeded are both to be called, succeeded must be called first.

Implements paludis::OutputManager.

virtual void paludis::IPCOutputManager::succeeded ( )
virtual

Called if an action succeeds. This can be used to, for example, unlink the files behind a to-disk logged output manager.

If an OutputManager is destroyed without having had this method called, it should assume failure. This might mean keeping rather than removing log files, for example.

Further messages and output may occur even after a call to this method.

Calls to this method are done by the caller, not by whatever carries out the action in question.

If ignore_succeeded() has previously been called, does nothing.

Implements paludis::OutputManager.

virtual bool paludis::IPCOutputManager::want_to_flush ( ) const
virtual

Do we want to flush?

Provides a way for clients to avoid having to call flush() with a prefixed header when there's no output waiting.

Implements paludis::OutputManager.


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