Program Listing for File priority_pos.hpp
↰ Return to documentation for file (include/ecl/threads/priority_pos.hpp
)
/*****************************************************************************
** Ifdefs
*****************************************************************************/
#ifndef ECL_THREADS_PRIORITY_POS_HPP_
#define ECL_THREADS_PRIORITY_POS_HPP_
/*****************************************************************************
** Platform Check
*****************************************************************************/
#include <ecl/config/ecl.hpp>
#if defined(ECL_IS_POSIX)
/*****************************************************************************
** Includes
*****************************************************************************/
#include <unistd.h>
#include <string>
#include <sstream>
#include <errno.h>
#include <sys/resource.h>
#include <ecl/config/ecl.hpp>
#include <ecl/exceptions/macros.hpp>
#include <ecl/exceptions/standard_exception.hpp>
#include "priority_common.hpp"
/*****************************************************************************
** Namespaces
*****************************************************************************/
namespace ecl {
bool ECL_PUBLIC set_priority(Priority priority_level);
Priority ECL_PUBLIC get_priority();
std::string ECL_PUBLIC print_priority_diagnostics();
/*****************************************************************************
** Namespace
*****************************************************************************/
namespace threads {
bool ECL_LOCAL set_real_time_priority(int policy,int priority_level);
} // namespace threads
} // namespace ecl
/*****************************************************************************
** Interface [Exceptions]
*****************************************************************************/
#if defined(ECL_HAS_EXCEPTIONS)
namespace ecl {
namespace threads {
/*****************************************************************************
** Interface [Priority Exceptions]
*****************************************************************************/
inline StandardException ECL_LOCAL throwPriorityException(const char* loc ) {
int error_result = errno;
switch (error_result) {
case ( EINVAL ) : return StandardException(loc, ecl::InvalidInputError, "The specified param structure or priority group was invalid.");
case ( ESRCH ) : return StandardException(loc, ecl::InvalidInputError, "The process specified could not be found.");
case ( EPERM ) : return StandardException(loc, ecl::PermissionsError, "The caller does not have the appropriate privileges for realtime scheduling (http://snorriheim.dnsdojo.com/doku/doku.php/en:linux:admin:priorities).");
case ( EACCES ) : return StandardException(loc, ecl::PermissionsError, "The caller does not have the appropriate privileges for elevating the process priority by reducing the niceness value (http://snorriheim.dnsdojo.com/doku/doku.php/en:linux:admin:priorities).");
default :
{
std::ostringstream ostream;
ostream << "Unknown posix error " << error_result << ": " << strerror(error_result) << ".";
return StandardException(loc, UnknownError, ostream.str());
}
}
}
} // namespace threads
} // namespace ecl
#endif /* ECL_HAS_EXCEPTIONS */
#endif /* ECL_IS_POSIX */
#endif /* ECL_THREADS_PRIORITY_POS_HPP_ */
// void yield();
// void capabilities() throw(StandardException);
// * Yields this process (must be a real-time process) to lower priority processes.
// * In effect, this places the process at the back of the cpu queue, even if there
// * are lower priority processes ahead of it.
// */
//inline void Process::yield()
//{
// sched_yield();
//}
// * Print out the posix capabilities of your program.
// */
//inline void Process::capabilities() throw(StandardException)
//{
// cap_t cap = cap_get_proc();
//
// if (!cap) {
// throw StandardException(LOC,"Could not retrieve posix characteristics.","Was not possible to retrieve the processes' posix capability list.");
// }
// std::cout << "Posix capabilities " << cap_to_text(cap,NULL) << std::endl;
// cap_free(cap);
//}