5d678dba9e
While importing trace sources as trace subjects into a TRACE session, the session quota might become depleted. The TRACE session already keeps track of the session quota via an allocator guard but the 'subjects' RPC function missed to handle the out-of-memory condition. This patch reflects the error condition as an 'Out_of_metadata' exception to the TRACE client. It also contains an extension of the trace test to exercise the corner case.
161 lines
4.6 KiB
C++
161 lines
4.6 KiB
C++
/*
|
|
* \brief TRACE session interface
|
|
* \author Norman Feske
|
|
* \date 2013-08-11
|
|
*/
|
|
|
|
/*
|
|
* Copyright (C) 2013 Genode Labs GmbH
|
|
*
|
|
* This file is part of the Genode OS framework, which is distributed
|
|
* under the terms of the GNU General Public License version 2.
|
|
*/
|
|
|
|
#ifndef _INCLUDE__TRACE_SESSION__TRACE_SESSION_H_
|
|
#define _INCLUDE__TRACE_SESSION__TRACE_SESSION_H_
|
|
|
|
#include <base/exception.h>
|
|
#include <base/trace/types.h>
|
|
#include <dataspace/capability.h>
|
|
#include <session/session.h>
|
|
|
|
namespace Genode { namespace Trace { struct Session; } }
|
|
|
|
|
|
struct Genode::Trace::Session : Genode::Session
|
|
{
|
|
static const char *service_name() { return "TRACE"; }
|
|
|
|
/**
|
|
* Allocate policy-module backing store
|
|
*
|
|
* \throw Out_of_metadata
|
|
*/
|
|
virtual Policy_id alloc_policy(size_t size) = 0;
|
|
|
|
/**
|
|
* Request policy-module backing store
|
|
*
|
|
* \throw Nonexistent_policy
|
|
*/
|
|
virtual Dataspace_capability policy(Policy_id) = 0;
|
|
|
|
/**
|
|
* Remove a policy module from the TRACE service
|
|
*/
|
|
virtual void unload_policy(Policy_id) = 0;
|
|
|
|
/**
|
|
* Start tracing of a subject
|
|
*
|
|
* \throw Out_of_metadata
|
|
* \throw Already_traced
|
|
* \throw Source_is_dead
|
|
* \throw Nonexistent_policy
|
|
* \throw Traced_by_other_session
|
|
*/
|
|
virtual void trace(Subject_id, Policy_id, size_t buffer_size) = 0;
|
|
|
|
/**
|
|
* Install a matching rule for automatically tracing new threads
|
|
*/
|
|
virtual void rule(Session_label const &, Thread_name const &,
|
|
Policy_id, size_t buffer_size) = 0;
|
|
|
|
/**
|
|
* Pause generation of tracing data
|
|
*
|
|
* \throw Nonexistent_subject
|
|
*/
|
|
virtual void pause(Subject_id) = 0;
|
|
|
|
/**
|
|
* Resume generation of tracing data
|
|
*
|
|
* \throw Nonexistent_subject
|
|
* \throw Source_is_dead
|
|
*/
|
|
virtual void resume(Subject_id) = 0;
|
|
|
|
/**
|
|
* Obtain details about tracing subject
|
|
*
|
|
* \throw Nonexistent_subject
|
|
*/
|
|
virtual Subject_info subject_info(Subject_id) = 0;
|
|
|
|
/**
|
|
* Obtain trace buffer of given subject
|
|
*
|
|
* \throw Nonexistent_subject
|
|
*/
|
|
virtual Dataspace_capability buffer(Subject_id) = 0;
|
|
|
|
/**
|
|
* Release subject and free buffers
|
|
*
|
|
* If the source still exists, the buffers are freed but the subject
|
|
* stays intact.
|
|
*
|
|
* \throw Nonexistent_subject
|
|
*/
|
|
virtual void free(Subject_id) = 0;
|
|
|
|
virtual ~Session() { }
|
|
|
|
|
|
/*********************
|
|
** RPC declaration **
|
|
*********************/
|
|
|
|
GENODE_RPC(Rpc_dataspace, Dataspace_capability, dataspace);
|
|
GENODE_RPC_THROW(Rpc_alloc_policy, Policy_id, alloc_policy,
|
|
GENODE_TYPE_LIST(Out_of_metadata),
|
|
size_t);
|
|
GENODE_RPC_THROW(Rpc_policy, Dataspace_capability, policy,
|
|
GENODE_TYPE_LIST(Nonexistent_policy),
|
|
Policy_id);
|
|
GENODE_RPC_THROW(Rpc_unload_policy, void, unload_policy,
|
|
GENODE_TYPE_LIST(Nonexistent_policy), Policy_id);
|
|
GENODE_RPC_THROW(Rpc_trace, void, trace,
|
|
GENODE_TYPE_LIST(Out_of_metadata, Already_traced,
|
|
Source_is_dead, Nonexistent_policy,
|
|
Traced_by_other_session),
|
|
Subject_id, Policy_id, size_t);
|
|
GENODE_RPC_THROW(Rpc_rule, void, rule,
|
|
GENODE_TYPE_LIST(Out_of_metadata),
|
|
Session_label const &, Thread_name const &,
|
|
Policy_id, size_t);
|
|
GENODE_RPC_THROW(Rpc_pause, void, pause,
|
|
GENODE_TYPE_LIST(Nonexistent_subject), Subject_id);
|
|
GENODE_RPC_THROW(Rpc_resume, void, resume,
|
|
GENODE_TYPE_LIST(Nonexistent_subject, Source_is_dead),
|
|
Subject_id);
|
|
GENODE_RPC_THROW(Rpc_subjects, size_t, subjects,
|
|
GENODE_TYPE_LIST(Out_of_metadata));
|
|
GENODE_RPC_THROW(Rpc_subject_info, Subject_info, subject_info,
|
|
GENODE_TYPE_LIST(Nonexistent_subject), Subject_id);
|
|
GENODE_RPC_THROW(Rpc_buffer, Dataspace_capability, buffer,
|
|
GENODE_TYPE_LIST(Nonexistent_subject, Subject_not_traced),
|
|
Subject_id);
|
|
GENODE_RPC_THROW(Rpc_free, void, free,
|
|
GENODE_TYPE_LIST(Nonexistent_subject), Subject_id);
|
|
|
|
typedef Meta::Type_tuple<Rpc_dataspace,
|
|
Meta::Type_tuple<Rpc_alloc_policy,
|
|
Meta::Type_tuple<Rpc_policy,
|
|
Meta::Type_tuple<Rpc_unload_policy,
|
|
Meta::Type_tuple<Rpc_trace,
|
|
Meta::Type_tuple<Rpc_rule,
|
|
Meta::Type_tuple<Rpc_pause,
|
|
Meta::Type_tuple<Rpc_resume,
|
|
Meta::Type_tuple<Rpc_subjects,
|
|
Meta::Type_tuple<Rpc_subject_info,
|
|
Meta::Type_tuple<Rpc_buffer,
|
|
Meta::Type_tuple<Rpc_free,
|
|
Meta::Empty>
|
|
> > > > > > > > > > > Rpc_functions;
|
|
};
|
|
|
|
#endif /* _INCLUDE__TRACE_SESSION__TRACE_SESSION_H_ */
|