|
|
|
|
@ -31,49 +31,43 @@
|
|
|
|
|
#include <srs_service_st.hpp>
|
|
|
|
|
#include <srs_protocol_io.hpp>
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Each ST-coroutine must implements this interface,
|
|
|
|
|
* to do the cycle job and handle some events.
|
|
|
|
|
*
|
|
|
|
|
* Thread do a job then terminated normally, it's a SrsOneCycleThread:
|
|
|
|
|
* class SrsOneCycleThread : public ISrsCoroutineHandler {
|
|
|
|
|
* public: SrsCoroutine trd;
|
|
|
|
|
* public: virtual srs_error_t cycle() {
|
|
|
|
|
* // Do something, then return this cycle and thread terminated normally.
|
|
|
|
|
* }
|
|
|
|
|
* };
|
|
|
|
|
*
|
|
|
|
|
* Thread has its inside loop, such as the RTMP receive thread:
|
|
|
|
|
* class SrsReceiveThread : public ISrsCoroutineHandler {
|
|
|
|
|
* public: SrsCoroutine* trd;
|
|
|
|
|
* public: virtual srs_error_t cycle() {
|
|
|
|
|
* while (true) {
|
|
|
|
|
* // Check whether thread interrupted.
|
|
|
|
|
* if ((err = trd->pull()) != srs_success) {
|
|
|
|
|
* return err;
|
|
|
|
|
* }
|
|
|
|
|
* // Do something, such as st_read() packets, it'll be wakeup
|
|
|
|
|
* // when user stop or interrupt the thread.
|
|
|
|
|
* }
|
|
|
|
|
* }
|
|
|
|
|
* };
|
|
|
|
|
*/
|
|
|
|
|
// Each ST-coroutine must implements this interface,
|
|
|
|
|
// to do the cycle job and handle some events.
|
|
|
|
|
//
|
|
|
|
|
// Thread do a job then terminated normally, it's a SrsOneCycleThread:
|
|
|
|
|
// class SrsOneCycleThread : public ISrsCoroutineHandler {
|
|
|
|
|
// public: SrsCoroutine trd;
|
|
|
|
|
// public: virtual srs_error_t cycle() {
|
|
|
|
|
// // Do something, then return this cycle and thread terminated normally.
|
|
|
|
|
// }
|
|
|
|
|
// };
|
|
|
|
|
//
|
|
|
|
|
// Thread has its inside loop, such as the RTMP receive thread:
|
|
|
|
|
// class SrsReceiveThread : public ISrsCoroutineHandler {
|
|
|
|
|
// public: SrsCoroutine* trd;
|
|
|
|
|
// public: virtual srs_error_t cycle() {
|
|
|
|
|
// while (true) {
|
|
|
|
|
// // Check whether thread interrupted.
|
|
|
|
|
// if ((err = trd->pull()) != srs_success) {
|
|
|
|
|
// return err;
|
|
|
|
|
// }
|
|
|
|
|
// // Do something, such as st_read() packets, it'll be wakeup
|
|
|
|
|
// // when user stop or interrupt the thread.
|
|
|
|
|
// }
|
|
|
|
|
// }
|
|
|
|
|
// };
|
|
|
|
|
class ISrsCoroutineHandler
|
|
|
|
|
{
|
|
|
|
|
public:
|
|
|
|
|
ISrsCoroutineHandler();
|
|
|
|
|
virtual ~ISrsCoroutineHandler();
|
|
|
|
|
public:
|
|
|
|
|
/**
|
|
|
|
|
* Do the work. The ST-coroutine will terminated normally if it returned.
|
|
|
|
|
* @remark If the cycle has its own loop, it must check the thread pull.
|
|
|
|
|
*/
|
|
|
|
|
// Do the work. The ST-coroutine will terminated normally if it returned.
|
|
|
|
|
// @remark If the cycle has its own loop, it must check the thread pull.
|
|
|
|
|
virtual srs_error_t cycle() = 0;
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* The corotine object.
|
|
|
|
|
*/
|
|
|
|
|
// The corotine object.
|
|
|
|
|
class SrsCoroutine
|
|
|
|
|
{
|
|
|
|
|
public:
|
|
|
|
|
@ -89,10 +83,8 @@ public:
|
|
|
|
|
virtual int cid() = 0;
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* An empty coroutine, user can default to this object before create any real coroutine.
|
|
|
|
|
* @see https://github.com/ossrs/srs/pull/908
|
|
|
|
|
*/
|
|
|
|
|
// An empty coroutine, user can default to this object before create any real coroutine.
|
|
|
|
|
// @see https://github.com/ossrs/srs/pull/908
|
|
|
|
|
class SrsDummyCoroutine : public SrsCoroutine
|
|
|
|
|
{
|
|
|
|
|
public:
|
|
|
|
|
@ -110,20 +102,18 @@ public:
|
|
|
|
|
typedef void* (*_ST_THREAD_CREATE_PFN)(void *(*start)(void *arg), void *arg, int joinable, int stack_size);
|
|
|
|
|
extern _ST_THREAD_CREATE_PFN _pfn_st_thread_create;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* A ST-coroutine is a lightweight thread, just like the goroutine.
|
|
|
|
|
* But the goroutine maybe run on different thread, while ST-coroutine only
|
|
|
|
|
* run in single thread, because it use setjmp and longjmp, so it may cause
|
|
|
|
|
* problem in multiple threads. For SRS, we only use single thread module,
|
|
|
|
|
* like NGINX to get very high performance, with asynchronous and non-blocking
|
|
|
|
|
* sockets.
|
|
|
|
|
* @reamrk For multiple processes, please use go-oryx to fork many SRS processes.
|
|
|
|
|
* Please read https://github.com/ossrs/go-oryx
|
|
|
|
|
* @remark For debugging of ST-coroutine, read _st_iterate_threads_flag of ST/README
|
|
|
|
|
* https://github.com/ossrs/state-threads/blob/st-1.9/README#L115
|
|
|
|
|
* @remark We always create joinable thread, so we must join it or memory leak,
|
|
|
|
|
* Please read https://github.com/ossrs/srs/issues/78
|
|
|
|
|
*/
|
|
|
|
|
// A ST-coroutine is a lightweight thread, just like the goroutine.
|
|
|
|
|
// But the goroutine maybe run on different thread, while ST-coroutine only
|
|
|
|
|
// run in single thread, because it use setjmp and longjmp, so it may cause
|
|
|
|
|
// problem in multiple threads. For SRS, we only use single thread module,
|
|
|
|
|
// like NGINX to get very high performance, with asynchronous and non-blocking
|
|
|
|
|
// sockets.
|
|
|
|
|
// @reamrk For multiple processes, please use go-oryx to fork many SRS processes.
|
|
|
|
|
// Please read https://github.com/ossrs/go-oryx
|
|
|
|
|
// @remark For debugging of ST-coroutine, read _st_iterate_threads_flag of ST/README
|
|
|
|
|
// https://github.com/ossrs/state-threads/blob/st-1.9/README#L115
|
|
|
|
|
// @remark We always create joinable thread, so we must join it or memory leak,
|
|
|
|
|
// Please read https://github.com/ossrs/srs/issues/78
|
|
|
|
|
class SrsSTCoroutine : public SrsCoroutine
|
|
|
|
|
{
|
|
|
|
|
private:
|
|
|
|
|
@ -145,35 +135,25 @@ public:
|
|
|
|
|
SrsSTCoroutine(const std::string& n, ISrsCoroutineHandler* h, int cid = 0);
|
|
|
|
|
virtual ~SrsSTCoroutine();
|
|
|
|
|
public:
|
|
|
|
|
/**
|
|
|
|
|
* Start the thread.
|
|
|
|
|
* @remark Should never start it when stopped or terminated.
|
|
|
|
|
*/
|
|
|
|
|
// Start the thread.
|
|
|
|
|
// @remark Should never start it when stopped or terminated.
|
|
|
|
|
virtual srs_error_t start();
|
|
|
|
|
/**
|
|
|
|
|
* Interrupt the thread then wait to terminated.
|
|
|
|
|
* @remark If user want to notify thread to quit async, for example if there are
|
|
|
|
|
* many threads to stop like the encoder, use the interrupt to notify all threads
|
|
|
|
|
* to terminate then use stop to wait for each to terminate.
|
|
|
|
|
*/
|
|
|
|
|
// Interrupt the thread then wait to terminated.
|
|
|
|
|
// @remark If user want to notify thread to quit async, for example if there are
|
|
|
|
|
// many threads to stop like the encoder, use the interrupt to notify all threads
|
|
|
|
|
// to terminate then use stop to wait for each to terminate.
|
|
|
|
|
virtual void stop();
|
|
|
|
|
/**
|
|
|
|
|
* Interrupt the thread and notify it to terminate, it will be wakeup if it's blocked
|
|
|
|
|
* in some IO operations, such as st_read or st_write, then it will found should quit,
|
|
|
|
|
* finally the thread should terminated normally, user can use the stop to join it.
|
|
|
|
|
*/
|
|
|
|
|
// Interrupt the thread and notify it to terminate, it will be wakeup if it's blocked
|
|
|
|
|
// in some IO operations, such as st_read or st_write, then it will found should quit,
|
|
|
|
|
// finally the thread should terminated normally, user can use the stop to join it.
|
|
|
|
|
virtual void interrupt();
|
|
|
|
|
/**
|
|
|
|
|
* Check whether thread is terminated normally or error(stopped or termianted with error),
|
|
|
|
|
* and the thread should be running if it return ERROR_SUCCESS.
|
|
|
|
|
* @remark Return specified error when thread terminated normally with error.
|
|
|
|
|
* @remark Return ERROR_THREAD_TERMINATED when thread terminated normally without error.
|
|
|
|
|
* @remark Return ERROR_THREAD_INTERRUPED when thread is interrupted.
|
|
|
|
|
*/
|
|
|
|
|
// Check whether thread is terminated normally or error(stopped or termianted with error),
|
|
|
|
|
// and the thread should be running if it return ERROR_SUCCESS.
|
|
|
|
|
// @remark Return specified error when thread terminated normally with error.
|
|
|
|
|
// @remark Return ERROR_THREAD_TERMINATED when thread terminated normally without error.
|
|
|
|
|
// @remark Return ERROR_THREAD_INTERRUPED when thread is interrupted.
|
|
|
|
|
virtual srs_error_t pull();
|
|
|
|
|
/**
|
|
|
|
|
* Get the context id of thread.
|
|
|
|
|
*/
|
|
|
|
|
// Get the context id of thread.
|
|
|
|
|
virtual int cid();
|
|
|
|
|
private:
|
|
|
|
|
virtual srs_error_t cycle();
|
|
|
|
|
|
winlin
6 years ago