WakeupHandle Class Reference

A convenience handle for event loops so that one can interrupt a Poll before it times out. More...

#include <WakeupHandle.h>

Inheritance diagram for WakeupHandle:

Collaboration diagram for WakeupHandle:

Public Types
typedef AutoLock< PthreadMutex >	ALock

Public Member Functions
	WakeupHandle ()
virtual	~WakeupHandle ()
void	SendWakeup ()
	Causes this handler to become readable any Poll on this FileHandler will then return. More...
void	Read ()
	Read until not readable anymore. More...
int	Poll (double timeout)
bool	Readable (bool r)
	Set that the file is currently readable or not. More...
bool	Readable () const
	Gives the current readability status of the file. More...
bool	Writeable (bool w)
	Set that this file is currently writeable or not. More...
bool	Writeable () const
	Gives the current writability status of the file. More...
int	FD () const
int	FD (int filed)
	Set the current file descriptor. More...
bool	Eof () const
bool	Eof (bool e)
	Set/reset the end of file condition. More...
bool	Good () const
	Convenience method for testing if the file this FileHandle has is open and not at end of file. More...
bool	Closed () const
void	SetBlocking (bool blocking)
	Manipulate how the current file handles blocking. More...
bool	IsBlocking () const
	Test if the current file is in blocking or non blocking mode. More...
void	Reset ()
	Clear all internal state including the file descriptor! WARNING does not close the file! More...
void	Close ()
	Close the file and reset the internal state. More...
unsigned	Read (void *ptr, unsigned len)
	Read data from the file descriptor. More...
unsigned	Readv (const iovec *iov, int iovcnt)
	scatter gather io version of Read More...
unsigned	Write (const void *ptr, unsigned len)
	Write data to the file descriptor. More...
unsigned	Writev (const iovec *iov, int iovcnt)
	scatter gather io version of Write More...
void	Flush ()
	Tell the OS to flush any buffers it has. May not be supported for all file types. More...

Static Public Member Functions
static int	Poll (IteratorRef< FileHandle * > begin, IteratorRef< FileHandle * > end, double timeout)
	poll a list of FileHandles for any activity and call the appropriate On method. More...
static void	SetBlocking (int fd, bool blocking)
	a convenience method that allows one to set the same blocking parameters for a file descriptor without setting it inside a FileHandle. More...
static bool	IsBlocking (int fd)
	Test the given file descriptor if it is in blocking mode. More...

Protected Member Functions
virtual void	OnWriteable ()
	Called by Poll when it detects that the file is writeable. More...

Protected Attributes
PthreadMutex	file_lock
int	fd
bool	readable
bool	writeable
bool	eof

Private Member Functions
void	OnReadable ()
	Called by Poll when it detects that the file is readable. More...

Private Attributes
int	wfd

Detailed Description

A convenience handle for event loops so that one can interrupt a Poll before it times out.

SendWakeup my be called from any thread.

Definition at line 35 of file WakeupHandle.h.

Member Typedef Documentation

typedef AutoLock<PthreadMutex> FileHandle::ALock

inherited

Definition at line 43 of file FileHandle.h.

Constructor & Destructor Documentation

WakeupHandle::WakeupHandle

(

)

Definition at line 30 of file WakeupHandle.cc.

References FileHandle::FD(), FileHandle::Readable(), FileHandle::SetBlocking(), wfd, and FileHandle::Writeable().

    : wfd(-1)
{
    int filedes[2];
    if (pipe(filedes) != 0) {
        throw ErrnoException();
    }
    FD(filedes[0]);
    wfd = filedes[1];
    Readable(false);
    Writeable(false);
    SetBlocking(false);
    SetBlocking(wfd, false);
}

Here is the call graph for this function:

WakeupHandle::~WakeupHandle ( )

virtual

Definition at line 45 of file WakeupHandle.cc.

References wfd.

                            {
    close(wfd);
    wfd = -1;
}

Member Function Documentation

void FileHandle::Close ( )

inherited

Close the file and reset the internal state.

Definition at line 146 of file FileHandle.cc.

References FileHandle::eof, FileHandle::fd, FileHandle::file_lock, FileHandle::readable, and FileHandle::writeable.

Referenced by CPN::ConnectionServer::Close(), CPN::RemoteContext::EntryPoint(), CPN::RemoteQueue::HandleError(), CPN::RemoteQueue::InternalCheckStatus(), and CPN::RemoteContextDaemon::Terminate().

                       {
    ALock al(file_lock);
    if (fd != -1) {
        if (close(fd) != 0) {
            throw ErrnoException();
        }
        fd = -1;
    }
    readable = false;
    writeable = false;
    eof = false;
}

Here is the caller graph for this function:

bool FileHandle::Closed ( ) const

inlineinherited

Returns

false if this FileHandle has an open file

Definition at line 128 of file FileHandle.h.

References FileHandle::fd, and FileHandle::file_lock.

Referenced by SocketHandle::Connect(), CPN::ConnectionServer::ConnectReader(), CPN::ConnectionServer::ConnectWriter(), CPN::RemoteQueue::FileThreadEntryPoint(), CPN::RemoteQueue::InternalCheckStatus(), CPN::RemoteQueue::LogState(), CPN::ConnectionServer::LogState(), CPN::RemoteContextDaemon::Run(), CPN::RemoteContextDaemon::Client::Send(), and CPN::RemoteContext::SendMessage().

{ ALock al(file_lock); return fd == -1; }

Here is the caller graph for this function:

bool FileHandle::Eof ( ) const

inlineinherited

Returns

the current end of file condition

Definition at line 115 of file FileHandle.h.

References FileHandle::eof, and FileHandle::file_lock.

Referenced by CPN::RemoteQueue::EnqueuePacket(), CPN::RemoteContext::EntryPoint(), CPN::RemoteQueue::InternalCheckStatus(), CPN::RemoteContextDaemon::Client::Read(), and CPN::RemoteQueue::Read().

{ ALock al(file_lock); return eof; }

Here is the caller graph for this function:

bool FileHandle::Eof ( bool  e )

inlineinherited

Set/reset the end of file condition.

Parameters

e	the new end of file condition

Returns

the new end of file condition

Definition at line 120 of file FileHandle.h.

References FileHandle::eof, and FileHandle::file_lock.

{ ALock al(file_lock); return eof = e; }

int FileHandle::FD ( ) const

inlineinherited

Returns

the current set file descriptor

Definition at line 106 of file FileHandle.h.

References FileHandle::fd, and FileHandle::file_lock.

Referenced by ServerSocketHandle::Accept(), CPN::RemoteContextDaemon::Client::Client(), SocketHandle::Connect(), CPN::ConnectionServer::ConnectWriter(), SocketHandle::CreatePair(), CPN::RemoteQueue::FileThreadEntryPoint(), FileHandle::Flush(), CPN::ConnectionServer::GetAddress(), SocketHandle::GetKeepAlive(), SocketHandle::GetLingerTimeout(), SocketHandle::GetNoDelay(), SocketHandle::GetPendingError(), SocketHandle::GetReceiveBufferSize(), SocketHandle::GetReceiveTimeout(), SocketHandle::GetSendBufferSize(), SocketHandle::GetSendTimeout(), FileHandle::IsBlocking(), ServerSocketHandle::Listen(), FileHandle::Poll(), CPN::RemoteContextDaemon::Run(), FileHandle::SetBlocking(), SocketHandle::SetKeepAlive(), SocketHandle::SetLingerTimeout(), SocketHandle::SetNoDelay(), SocketHandle::SetReceiveBufferSize(), SocketHandle::SetReceiveTimeout(), SocketHandle::SetSendBufferSize(), SocketHandle::SetSendTimeout(), SocketHandle::ShutdownRead(), SocketHandle::ShutdownWrite(), and WakeupHandle().

{ ALock al(file_lock); return fd; }

Here is the caller graph for this function:

int FileHandle::FD ( int  filed )

inlineinherited

Set the current file descriptor.

Parameters

filed

the new file descriptor

Returns

the new file descriptor

Definition at line 111 of file FileHandle.h.

References FileHandle::fd, and FileHandle::file_lock.

{ ALock al(file_lock); return fd = filed; }

void FileHandle::Flush ( )

inherited

Tell the OS to flush any buffers it has. May not be supported for all file types.

Definition at line 293 of file FileHandle.cc.

References FileHandle::FD().

                       {
    if (fsync(FD()) != 0) {
        throw ErrnoException();
    }
}

Here is the call graph for this function:

bool FileHandle::Good ( ) const

inlineinherited

Convenience method for testing if the file this FileHandle has is open and not at end of file.

Returns

true if open and not at end of file otherwise false

Definition at line 125 of file FileHandle.h.

References FileHandle::eof, FileHandle::fd, and FileHandle::file_lock.

Referenced by CPN::RemoteContext::EntryPoint(), and CPN::RemoteContextDaemon::Client::Read().

{ ALock al(file_lock); return !(eof || fd == -1); }

Here is the caller graph for this function:

bool FileHandle::IsBlocking ( ) const

inherited

Test if the current file is in blocking or non blocking mode.

Returns

true if blocking or false if non blocking

Definition at line 128 of file FileHandle.cc.

References FileHandle::FD().

                                  {
    return IsBlocking(FD());
}

Here is the call graph for this function:

bool FileHandle::IsBlocking ( int  fd )

staticinherited

Test the given file descriptor if it is in blocking mode.

Parameters

fd	the file descriptor to test

Returns

true if blocking or false if non blocking

Definition at line 132 of file FileHandle.cc.

                                  {
    int flags = fcntl(fd, F_GETFL, 0);
    if (-1 == flags) { throw ErrnoException(); }
    return !(flags & O_NONBLOCK);
}

void WakeupHandle::OnReadable ( )

inlineprivatevirtual

Called by Poll when it detects that the file is readable.

Reimplemented from FileHandle.

Definition at line 50 of file WakeupHandle.h.

{}

virtual void FileHandle::OnWriteable ( )

inlineprotectedvirtualinherited

Called by Poll when it detects that the file is writeable.

Definition at line 212 of file FileHandle.h.

References FileHandle::Writeable().

Referenced by FileHandle::Poll().

{ Writeable(true); }

Here is the call graph for this function:

Here is the caller graph for this function:

int FileHandle::Poll ( IteratorRef< FileHandle * >  begin, IteratorRef< FileHandle * >  end, double  timeout  )

staticinherited

poll a list of FileHandles for any activity and call the appropriate On method.

Definition at line 34 of file FileHandle.cc.

References FileHandle::FD(), FileHandle::fd, FileHandle::OnReadable(), FileHandle::OnWriteable(), FileHandle::Readable(), and FileHandle::Writeable().

Referenced by CPN::RemoteContext::EntryPoint(), CPN::RemoteQueue::FileThreadEntryPoint(), CPN::ConnectionServer::Poll(), FileHandle::Poll(), and CPN::RemoteContextDaemon::Run().

                                                                                                 {
    fd_set rfd;
    fd_set wfd;
    FD_ZERO(&rfd);
    FD_ZERO(&wfd);
    int maxfd = 0;
    IteratorRef<FileHandle*> itr = begin;
    while (itr != end) {
        FileHandle *han = *itr;
        int fd = han->FD();
        if (fd < 0) {
            return -1;
        } else {
            bool set = false;
            if (!han->Readable()) {
                FD_SET(fd, &rfd);
                set = true;
            }
            if (!han->Writeable()) {
                FD_SET(fd, &wfd);
                set = true;
            }
            if (set) { maxfd = std::max(maxfd, fd); }
        }
        ++itr;
    }
    timeval tv;
    timeval *ptv = 0;
    if (timeout >= 0) {
        tv.tv_sec = (int)timeout;
        tv.tv_usec = (int)((timeout - tv.tv_sec) * 1e6);
        ptv = &tv;
    }
    int ret = select(maxfd + 1, &rfd, &wfd, 0, ptv);
    if (ret < 0) {
        if (errno == EINTR) {
            return 0;
        }
        throw ErrnoException();
    }
    itr = begin;
    while (itr != end) {
        FileHandle *han = *itr;
        int fd = han->FD();
        if (fd >= 0) {
            if (FD_ISSET(fd, &rfd)) {
                han->OnReadable();
            }
            if (FD_ISSET(fd, &wfd)) {
                han->OnWriteable();
            }
        }
        ++itr;
    }
    return ret;
}

Here is the call graph for this function:

Here is the caller graph for this function:

int FileHandle::Poll ( double  timeout )

inherited

Poll the current file descriptor for activity specified by the current readable or writeable status, if false poll that value, and call one of OnWriteable or OnReadable whos default action is to set Readable or Writeable to true.

Parameters

timeout

-1 to wait forever for activity 0 to poll and return immediately or a time to wait in seconds.

Returns

zero if timed out, positive if an event occurred or negative if an error occurred.

Definition at line 106 of file FileHandle.cc.

References FileHandle::Poll().

                                   {
    FileHandle *fh = this;
    return Poll(&fh, &fh + 1, timeout);
}

Here is the call graph for this function:

void WakeupHandle::Read

(

)

Read until not readable anymore.

Definition at line 70 of file WakeupHandle.cc.

References FileHandle::Read().

Referenced by CPN::ConnectionServer::Poll().

                        {
    char c[256];
    unsigned ret = 0;
    // If we didn't read all the buffer there isn't more to read
    do {
        ret = FileHandle::Read(c, sizeof(c));
    } while (ret == sizeof(c));
}

Here is the call graph for this function:

Here is the caller graph for this function:

unsigned FileHandle::Read ( void *  ptr, unsigned  len  )

inherited

Read data from the file descriptor.

Will set the end of file condition if read detects end of file.

Note

All the read functions will set readable to false if they read less than the requested amount or we are non blocking and a would block condition happened.

Parameters

ptr	pointer to write data to
len	the maximum number of bytes to write to ptr

Returns

0 if no bytes read (check Eof) or the number of bytes read

Definition at line 159 of file FileHandle.cc.

References FileHandle::eof, FileHandle::fd, FileHandle::file_lock, FileHandle::Readable(), and FileHandle::readable.

Referenced by CPN::RemoteQueue::D4RTagPacket(), and Read().

                                                 {
    int filed;
    {
        ALock al(file_lock);
        if (eof || fd == -1) { return 0; }
        filed = fd;
    }
    unsigned bytesread = 0;
    int num = read(filed, ptr, len);
    if (num < 0) {
        int error = errno;
        switch (error) {
        case EAGAIN:
            Readable(false);
        case EINTR:
        case ENOMEM:
            break;
        default:
            throw ErrnoException(error);
        }
    } else if (num == 0 && len != 0) {
        ALock al(file_lock);
        eof = true;
        readable = false;
    } else {
        if (unsigned(num) < len) { Readable(false); }
        bytesread = num;
    }
    return bytesread;
}

Here is the call graph for this function:

Here is the caller graph for this function:

bool FileHandle::Readable ( bool  r )

inlineinherited

Set that the file is currently readable or not.

Parameters

r	true or false

Returns

the new readable status

Definition at line 86 of file FileHandle.h.

References FileHandle::file_lock, and FileHandle::readable.

Referenced by CPN::RemoteContext::EntryPoint(), FileHandle::Poll(), CPN::ConnectionServer::Poll(), and CPN::RemoteQueue::Read().

{ ALock al(file_lock); return readable = r; }

Here is the caller graph for this function:

bool FileHandle::Readable ( ) const

inlineinherited

Gives the current readability status of the file.

Returns

true if it is known that a read will not block

Definition at line 91 of file FileHandle.h.

References FileHandle::file_lock, and FileHandle::readable.

Referenced by ServerSocketHandle::Accept(), CPN::RemoteContextDaemon::Client::Client(), FileHandle::OnReadable(), CPN::RemoteContextDaemon::Read(), FileHandle::Read(), FileHandle::Readv(), SocketHandle::Recv(), CPN::RemoteContextDaemon::Run(), and WakeupHandle().

{ ALock al(file_lock); return readable; }

Here is the caller graph for this function:

unsigned FileHandle::Readv ( const iovec *  iov, int  iovcnt  )

inherited

scatter gather io version of Read

Returns

see Read

Definition at line 190 of file FileHandle.cc.

References FileHandle::eof, FileHandle::fd, FileHandle::file_lock, FileHandle::Readable(), and FileHandle::readable.

Referenced by CPN::RemoteQueue::EnqueuePacket().

                                                       {
    int filed;
    {
        ALock al(file_lock);
        if (eof || fd == -1) { return 0; }
        filed = fd;
    }
    unsigned len = 0;
    for (int i = 0; i < iovcnt; ++i) {
        len += iov[i].iov_len;
    }
    unsigned bytesread = 0;
    int num = readv(filed, iov, iovcnt);
    if (num < 0) {
        int error = errno;
        switch (error) {
        case EAGAIN:
            Readable(false);
        case EINTR:
        case ENOMEM:
            break;
        default:
            throw ErrnoException(error);
        }
    } else if (num == 0 && len != 0) {
        ALock al(file_lock);
        eof = true;
        readable = false;
    } else {
        if (unsigned(num) < len) { Readable(false); }
        bytesread = num;
    }
    return bytesread;
}

Here is the call graph for this function:

Here is the caller graph for this function:

void FileHandle::Reset ( )

inherited

Clear all internal state including the file descriptor! WARNING does not close the file!

Definition at line 138 of file FileHandle.cc.

References FileHandle::eof, FileHandle::fd, FileHandle::file_lock, FileHandle::readable, and FileHandle::writeable.

Referenced by CPN::ConnectionServer::ConnectWriter(), CPN::RemoteQueue::FileThreadEntryPoint(), and FileHandle::~FileHandle().

                       {
    ALock al(file_lock);
    readable = false;
    writeable = false;
    eof = false;
    fd = -1;
}

Here is the caller graph for this function:

void WakeupHandle::SendWakeup

(

)

Causes this handler to become readable any Poll on this FileHandler will then return.

Definition at line 50 of file WakeupHandle.cc.

References FileHandle::file_lock, and wfd.

Referenced by CPN::RemoteQueueHolder::Shutdown().

                              {
    int wfiled;
    {
        FileHandle::ALock al(file_lock);
        wfiled = wfd;
    }
    char c = 0;
    int ret = 0;
    do {
        ret = write(wfiled, &c, sizeof(c));
        if (ret < 0) {
            if (errno == EAGAIN) {
                // The buffer is full.
                break;
            }
            throw ErrnoException();
        }
    } while (ret != sizeof(c));
}

Here is the caller graph for this function:

void FileHandle::SetBlocking ( bool  blocking )

inherited

Manipulate how the current file handles blocking.

Parameters

blocking

true to set to blocking mode (default) false to set to non blocking mode.

In non blocking mode all reads and writes will not block. Use Poll to block.

Definition at line 111 of file FileHandle.cc.

References FileHandle::FD().

Referenced by WakeupHandle().

                                          {
    SetBlocking(FD(), blocking);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void FileHandle::SetBlocking ( int  fd, bool  blocking  )

staticinherited

a convenience method that allows one to set the same blocking parameters for a file descriptor without setting it inside a FileHandle.

Parameters

fd	the file descriptor
blocking	true or false see SetBlock

Definition at line 115 of file FileHandle.cc.

                                                  {
    int flags = fcntl(fd, F_GETFL, 0);
    if (-1 == flags) { throw ErrnoException(); }
    if (blocking) {
        flags &= ~O_NONBLOCK;
    } else {
        flags |= O_NONBLOCK;
    }
    if (fcntl(fd, F_SETFL, flags) != 0) {
        throw ErrnoException();
    }
}

unsigned FileHandle::Write ( const void *  ptr, unsigned  len  )

inherited

Write data to the file descriptor.

Note

All write functions will set Writeable to false if they write less than the amount requested or if the file is in non blocking mode and the write returned would block.

Parameters

ptr	pointer to beginning of data to write
len	length of data to write

Returns

number of bytes written

Definition at line 225 of file FileHandle.cc.

References FileHandle::fd, FileHandle::file_lock, and FileHandle::Writeable().

Referenced by CPN::ConnectionServer::ConnectWriter(), CPN::RemoteContextDaemon::Client::Send(), CPN::RemoteContext::SendMessage(), and CPN::RemoteQueue::WriteBytes().

                                                        {
    int filed;
    {
        ALock al(file_lock);
        if (fd == -1) { return 0; }
        filed = fd;
    }
    unsigned written = 0;
    int num = write(filed, ptr, len);
    if (num < 0) {
        int error = errno;
        switch (error) {
        case EAGAIN: // Would block
        //case EWOULDBLOCK:
            Writeable(false);
        case EINTR: // Returned because of signal
        case ENOMEM:
        case ENOBUFS: // Buffers are full
            break;
        case EPIPE:
        case EBADF:
        case EFAULT:
        case EFBIG:
        case EINVAL:
        case EIO:
        case ENOSPC:
        default:
            throw ErrnoException(error);
        }
    } else {
        if (unsigned(num) < len) { Writeable(false); }
        written = num;
    }
    return written;
}

Here is the call graph for this function:

Here is the caller graph for this function:

bool FileHandle::Writeable ( bool  w )

inlineinherited

Set that this file is currently writeable or not.

Parameters

w	true or false

Returns

the new writeable status

Definition at line 97 of file FileHandle.h.

References FileHandle::file_lock, and FileHandle::writeable.

Referenced by FileHandle::Poll().

{ ALock al(file_lock); return writeable = w; }

Here is the caller graph for this function:

bool FileHandle::Writeable ( ) const

inlineinherited

Gives the current writability status of the file.

Returns

true if it is known that a write will not block

Definition at line 102 of file FileHandle.h.

References FileHandle::file_lock, and FileHandle::writeable.

Referenced by FileHandle::OnWriteable(), SocketHandle::Send(), WakeupHandle(), FileHandle::Write(), and FileHandle::Writev().

{ ALock al(file_lock); return writeable; }

Here is the caller graph for this function:

unsigned FileHandle::Writev ( const iovec *  iov, int  iovcnt  )

inherited

scatter gather io version of Write

Returns

see Write

Definition at line 261 of file FileHandle.cc.

References FileHandle::fd, FileHandle::file_lock, and FileHandle::Writeable().

Referenced by CPN::RemoteQueue::WriteBytes().

                                                        {
    int filed;
    {
        ALock al(file_lock);
        if (fd == -1) { return 0; }
        filed = fd;
    }
    unsigned written = 0;
    int num = writev(filed, iov, iovcnt);
    if (num < 0) {
        int error = errno;
        switch (error) {
        case EAGAIN:
            Writeable(false);
        case EINTR:
        case ENOMEM:
        case ENOBUFS:
            break;
        default:
            throw ErrnoException(error);
        }
    } else {
        unsigned len = 0;
        for (int i = 0; i < iovcnt; ++i) {
            len += iov[i].iov_len;
        }
        if (unsigned(num) < len) { Writeable(false); }
        written = num;
    }
    return written;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

bool FileHandle::eof

protectedinherited

Definition at line 217 of file FileHandle.h.

Referenced by FileHandle::Close(), FileHandle::Eof(), FileHandle::Good(), FileHandle::Read(), FileHandle::Readv(), SocketHandle::Recv(), and FileHandle::Reset().

int FileHandle::fd

protectedinherited

Definition at line 214 of file FileHandle.h.

Referenced by FileHandle::Close(), FileHandle::Closed(), FileHandle::FD(), FileHandle::Good(), FileHandle::Poll(), FileHandle::Read(), FileHandle::Readv(), SocketHandle::Recv(), FileHandle::Reset(), SocketHandle::Send(), FileHandle::Write(), FileHandle::Writev(), and FileHandle::~FileHandle().

PthreadMutex FileHandle::file_lock

mutableprotectedinherited

Definition at line 213 of file FileHandle.h.

Referenced by FileHandle::Close(), FileHandle::Closed(), FileHandle::Eof(), FileHandle::FD(), FileHandle::Good(), FileHandle::Read(), FileHandle::Readable(), FileHandle::Readv(), SocketHandle::Recv(), FileHandle::Reset(), SocketHandle::Send(), SendWakeup(), FileHandle::Write(), FileHandle::Writeable(), and FileHandle::Writev().

bool FileHandle::readable

protectedinherited

Definition at line 215 of file FileHandle.h.

Referenced by FileHandle::Close(), FileHandle::Read(), FileHandle::Readable(), FileHandle::Readv(), SocketHandle::Recv(), and FileHandle::Reset().

int WakeupHandle::wfd

private

Definition at line 51 of file WakeupHandle.h.

Referenced by SendWakeup(), WakeupHandle(), and ~WakeupHandle().

bool FileHandle::writeable

protectedinherited

Definition at line 216 of file FileHandle.h.

Referenced by FileHandle::Close(), FileHandle::Reset(), and FileHandle::Writeable().

---

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

• include/cpn/io/WakeupHandle.h
• lib/io/WakeupHandle.cc