/* * Copyright (c) 2014-2016, Siemens AG. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ #ifndef EMBB_MTAPI_NODE_ATTRIBUTES_H_ #define EMBB_MTAPI_NODE_ATTRIBUTES_H_ #include #include #include namespace embb { namespace mtapi { /** * Contains attributes of a Node. * * \ingroup CPP_MTAPI */ class NodeAttributes { public: /** * Constructs a NodeAttributes object. * * \waitfree */ NodeAttributes() { mtapi_status_t status; mtapi_nodeattr_init(&attributes_, &status); internal::CheckStatus(status); } /** * Copies a NodeAttributes object. * * \waitfree */ NodeAttributes( NodeAttributes const & other /**< The NodeAttributes to copy. */ ) : attributes_(other.attributes_) { // empty } /** * Copies a NodeAttributes object. * * \waitfree */ void operator=( NodeAttributes const & other /**< The NodeAttributes to copy. */ ) { attributes_ = other.attributes_; } /** * Sets the core affinity of the Node. This also determines the number of * worker threads. * * \returns Reference to this object. * \notthreadsafe */ NodeAttributes & SetCoreAffinity( embb::base::CoreSet const & cores /**< The cores to use. */ ) { mtapi_status_t status; mtapi_nodeattr_set(&attributes_, MTAPI_NODE_CORE_AFFINITY, &cores.GetInternal(), sizeof(embb_core_set_t), &status); internal::CheckStatus(status); return *this; } /** * Sets the priority of the specified worker threads. * * \returns Reference to this object. * \notthreadsafe */ NodeAttributes & SetWorkerPriority( mtapi_worker_priority_entry_t * worker_priorities /**< Array of priorities */ ) { mtapi_status_t status; mtapi_nodeattr_set(&attributes_, MTAPI_NODE_WORKER_PRIORITIES, worker_priorities, MTAPI_NODE_WORKER_PRIORITIES_SIZE, &status); internal::CheckStatus(status); return *this; } /** * Sets the maximum number of concurrently active tasks. * * \returns Reference to this object. * \notthreadsafe */ NodeAttributes & SetMaxTasks( mtapi_uint_t value /**< The value to set. */ ) { mtapi_status_t status; mtapi_nodeattr_set(&attributes_, MTAPI_NODE_MAX_TASKS, &value, sizeof(value), &status); internal::CheckStatus(status); return *this; } /** * Sets the maximum number of actions. * * \returns Reference to this object. * \notthreadsafe */ NodeAttributes & SetMaxActions( mtapi_uint_t value /**< The value to set. */ ) { mtapi_status_t status; mtapi_nodeattr_set(&attributes_, MTAPI_NODE_MAX_ACTIONS, &value, sizeof(value), &status); internal::CheckStatus(status); return *this; } /** * Sets the maximum number of groups. * * \returns Reference to this object. * \notthreadsafe */ NodeAttributes & SetMaxGroups( mtapi_uint_t value /**< The value to set. */ ) { mtapi_status_t status; mtapi_nodeattr_set(&attributes_, MTAPI_NODE_MAX_GROUPS, &value, sizeof(value), &status); internal::CheckStatus(status); return *this; } /** * Sets the maximum number of queues. * * \returns Reference to this object. * \notthreadsafe */ NodeAttributes & SetMaxQueues( mtapi_uint_t value /**< The value to set. */ ) { mtapi_status_t status; mtapi_nodeattr_set(&attributes_, MTAPI_NODE_MAX_QUEUES, &value, sizeof(value), &status); internal::CheckStatus(status); return *this; } /** * Sets the default limit (capacity) of all queues. * * \returns Reference to this object. * \notthreadsafe */ NodeAttributes & SetQueueLimit( mtapi_uint_t value /**< The value to set. */ ) { mtapi_status_t status; mtapi_nodeattr_set(&attributes_, MTAPI_NODE_QUEUE_LIMIT, &value, sizeof(value), &status); internal::CheckStatus(status); return *this; } /** * Sets the maximum number of available jobs. * * \returns Reference to this object. * \notthreadsafe */ NodeAttributes & SetMaxJobs( mtapi_uint_t value /**< The value to set. */ ) { mtapi_status_t status; mtapi_nodeattr_set(&attributes_, MTAPI_NODE_MAX_JOBS, &value, sizeof(value), &status); internal::CheckStatus(status); return *this; } /** * Sets the maximum number of actions per job. * * \returns Reference to this object. * \notthreadsafe */ NodeAttributes & SetMaxActionsPerJob( mtapi_uint_t value /**< The value to set. */ ) { mtapi_status_t status; mtapi_nodeattr_set(&attributes_, MTAPI_NODE_MAX_ACTIONS_PER_JOB, &value, sizeof(value), &status); internal::CheckStatus(status); return *this; } /** * Sets the maximum number of available priorities. The priority values * will range from 0 to \c value - 1 with 0 being the highest priority. * * \returns Reference to this object. * \notthreadsafe */ NodeAttributes & SetMaxPriorities( mtapi_uint_t value /**< The value to set. */ ) { mtapi_status_t status; mtapi_nodeattr_set(&attributes_, MTAPI_NODE_MAX_PRIORITIES, &value, sizeof(value), &status); internal::CheckStatus(status); return *this; } #ifdef EMBB_HARD_REALTIME /** * Sets the scheduling mode which is applied to schedule tasks on this node. * * \returns Reference to this object. * \notthreadsafe */ NodeAttributes & SetSchedulerMode( embb_mtapi_scheduler_mode_t value /**< The value to set. */ ) { mtapi_status_t status; mtapi_nodeattr_set(&attributes_, MTAPI_NODE_SCHEDULER_MODE, &value, sizeof(value), &status); internal::CheckStatus(status); return *this; } #endif /*EMBB_HARD_REALTIME*/ /** * Enables or disables the reuse of the main thread as a worker. * * \returns Reference to this object. * \notthreadsafe */ NodeAttributes & SetReuseMainThread( mtapi_boolean_t reuse ) { mtapi_status_t status; mtapi_nodeattr_set(&attributes_, MTAPI_NODE_REUSE_MAIN_THREAD, &reuse, sizeof(reuse), &status); internal::CheckStatus(status); return *this; } /** * Returns the internal representation of this object. * Allows for interoperability with the C interface. * * \returns A reference to the internal mtapi_node_attributes_t structure. * \waitfree */ mtapi_node_attributes_t const & GetInternal() const { return attributes_; } private: mtapi_node_attributes_t attributes_; }; } // namespace mtapi } // namespace embb #endif // EMBB_MTAPI_NODE_ATTRIBUTES_H_