shaka-packager/docs/source
Joey Parrish 9be7c2b1ac
feat: Portable, fully-static release executables on Linux (#1351)
This adds the option FULLY_STATIC to create fully-static executables.

To create portable, fully-static release executables on Linux, we need
to use musl instead of glibc. Static executables from glibc are not
portable.

The popular musl-gcc wrapper does not support C++, so instead we use a
full musl cross-compiler toolchain in the build workflow.

To build FULLY_STATIC, the user must point to the appropriate
cross-compiler, as we do in the workflow. On systems where musl is the
native libc (such as Alpine Linux), this is not necessary.

I have also read that musl's allocator is not very fast in
multi-threaded applications. So when FULLY_STATIC is enabled, we will
also enable mimalloc, a replacement allocator that is very fast.

I tested a very basic packaging command to compare speeds of dynamic
glibc, static musl, and static musl+mimalloc:

dynamic glibc:
runs: 2.527, 2.798, 2.703, 2.756, 2.959
avg = 2.749, std dev = 0.156s

static musl:
runs: 2.813, 2.920, 3.129, 3.003, 2.738
avg = 2.921s, std dev = 0.154s

static musl+mimalloc:
runs: 2.291, 2.034, 2.415, 2.303, 2.265
avg = 2.262s, std dev = 0.140s

The mimalloc build is 82% faster than musl default allocator, 77% faster
than glibc, and has more consistent runtime characteristics (lower
standard deviation).
2024-02-27 10:47:04 -08:00
..
_static Updated style for option list and field list 2017-09-19 14:52:25 -07:00
options feat: Allow LIVE UDP WebVTT input (#1349) 2024-02-23 16:02:19 -08:00
tutorials feat: Add input support for EBU Teletext in MPEG-TS (#1344) 2024-02-23 15:31:48 -08:00
build_instructions.md feat: Portable, fully-static release executables on Linux (#1351) 2024-02-27 10:47:04 -08:00
conf.py ci: Fix main workflows (#1122) 2022-10-28 15:46:33 -07:00
design.rst Added architecture diagram 2017-12-01 00:29:50 +00:00
docker_instructions.md Default multicast interface address to "0.0.0.0" if absent 2017-12-04 19:21:52 +00:00
documentation.rst chore: Update URLs after moving projects (#1042) 2022-03-07 11:56:34 -08:00
index.rst chore: Update URLs after moving projects (#1042) 2022-03-07 11:56:34 -08:00
library.rst chore: Update URLs after moving projects (#1042) 2022-03-07 11:56:34 -08:00
library_details.rst Update the tutorial and documentation for multi-DRM support. 2018-07-26 06:13:37 +00:00