0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-12-24 14:34:00 +01:00
construct/include/ircd/ctx/ole.h
2020-02-01 12:31:37 -08:00

56 lines
1.3 KiB
C++

// Matrix Construct
//
// Copyright (C) Matrix Construct Developers, Authors & Contributors
// Copyright (C) 2016-2018 Jason Volk <jason@zemos.net>
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice is present in all copies. The
// full license for this software is available in the LICENSE file.
#pragma once
#define HAVE_IRCD_CTX_OLE_H
/// Context OffLoad Engine (OLE).
///
/// This system allows moving a task off the main IRCd thread by passing a function to a
/// worker thread for execution. The context on the main IRCd thread yields until the offload
/// function has returned (or thrown).
///
namespace ircd::ctx::ole
{
struct init;
struct opts;
struct offload;
}
namespace ircd::ctx
{
using ole::offload;
}
struct ircd::ctx::ole::offload
{
using function = std::function<void ()>;
offload(const opts &, const function &);
offload(const function &);
};
struct ircd::ctx::ole::opts
{
/// Optionally give this offload task a name for any tasklist.
string_view name;
/// The function will be executed on each thread.
size_t concurrency {1};
/// Queuing priority; in the form of a nice value.
int8_t prio {0};
};
struct ircd::ctx::ole::init
{
init();
~init() noexcept;
};