mirror of https://github.com/ossrs/srs.git
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
f71b833520
|
5 years ago | |
|---|---|---|
| .. | ||
| docs | 5 years ago | |
| examples | 5 years ago | |
| extensions | 5 years ago | |
| .gitignore | 5 years ago | |
| Makefile | 5 years ago | |
| README | 5 years ago | |
| README.md | 5 years ago | |
| common.h | 5 years ago | |
| event.c | 5 years ago | |
| io.c | 5 years ago | |
| key.c | 5 years ago | |
| libst.def | 5 years ago | |
| md.S | 5 years ago | |
| md.h | 5 years ago | |
| md_darwin.S | 5 years ago | |
| osguess.sh | 5 years ago | |
| public.h | 5 years ago | |
| sched.c | 5 years ago | |
| st.pc.in | 5 years ago | |
| st.spec | 5 years ago | |
| stk.c | 5 years ago | |
| sync.c | 5 years ago | |
README.md
state-threads
Fork from http://sourceforge.net/projects/state-threads, patched for SRS.
For original ST without any changes, checkout the ST master branch.
Branch SRS
The branch srs will be patched the following patches:
- Patch st.arm.patch, for ARM.
- Patch st.osx.kqueue.patch, for osx.
- Patch st.disable.examples.patch, for ubuntu.
- Refine TAB of code.
- Merge from michaeltalyansky and xzh3836598, support ARM.
- Merge from toffaletti, support valgrind for ST.
- Patch st.osx10.14.build.patch, for osx 10.14 build.
- Support macro
MD_ST_NO_ASMto disable ASM, #8. - Merge patch srs#1282 to support aarch64, #9.
- Support OSX for Apple Darwin, macOS, #11.
- Support sendmmsg for UDP, #12.
Docs
- Introduction: http://ossrs.github.io/state-threads/docs/st.html
- API reference: http://ossrs.github.io/state-threads/docs/reference.html
- Programming notes: http://ossrs.github.io/state-threads/docs/notes.html
Analysis
- About setjmp and longjmp, read setjmp.
- About the stack structure, read stack
- About asm code comments, read #91d530e.
- About the scheduler, read #13-scheduler.
- About the IO event system, read #13-IO.
Usage
Get code:
git clone https://github.com/ossrs/state-threads.git st-1.9 &&
git checkout -b srs origin/srs
For Linux:
make linux-debug EXTRA_CFLAGS="-DMD_HAVE_EPOLL"
For OSX:
make darwin-debug EXTRA_CFLAGS="-DMD_HAVE_KQUEUE"
Linux with valgrind:
make linux-debug EXTRA_CFLAGS="-DMD_VALGRIND"
Remark: User must install valgrind, for instance, in centos6
sudo yum install -y valgrind valgrind-devel.
Linux with valgrind and epoll:
make linux-debug EXTRA_CFLAGS="-DMD_HAVE_EPOLL -DMD_VALGRIND"
For OSX, user must specifies the valgrind header files:
make darwin-debug EXTRA_CFLAGS="-DMD_HAVE_KQUEUE -DMD_VALGRIND -I/usr/local/include"
Remark: Latest OSX does not support ST, please use docker to run ST.
Valgrind
How to debug with gdb under valgrind, read valgrind manual.
About startup parameters, read valgrind cli.
Important cli options:
--undef-value-errors=<yes|no> [default: yes], Controls whether Memcheck reports uses of undefined value errors. Set this to no if you don't want to see undefined value errors. It also has the side effect of speeding up Memcheck somewhat.--leak-check=<no|summary|yes|full> [default: summary], When enabled, search for memory leaks when the client program finishes. If set to summary, it says how many leaks occurred. If set to full or yes, each individual leak will be shown in detail and/or counted as an error, as specified by the options--show-leak-kindsand--errors-for-leak-kinds.--track-origins=<yes|no> [default: no], Controls whether Memcheck tracks the origin of uninitialised values. By default, it does not, which means that although it can tell you that an uninitialised value is being used in a dangerous way, it cannot tell you where the uninitialised value came from. This often makes it difficult to track down the root problem.--show-reachable=<yes|no> , --show-possibly-lost=<yes|no>, to show the using memory.
Winlin 2016