Paraslash network audio streaming tools

About
News
Download
Documentation
Development

Development

The table below shows the topics currently under development. Each topic is included in the integration branch shown as Branch . Topics in next are expected to be of higher quality than those in pu .

Name	Branch	Commits	Description
ONESHELL	next	1	Activate the .ONESHELL feature
afh	next	6	cleanups of the audio format handlers
afh-preserve	next	1	New option for para_afh to preserve timestamps
compress	next	5	improvements to the compress filter
duration-keyword	pu	1	make "duration" a new keyword for the mood grammar
ff		0
for-maint	pu	0	urgent fixes for old bugs
misc	pu	0	smallish miscellaneous changes for master
mixer	next	1	improvements to para_mixer
ogg_afh	next	3	Improvements to the ogg audio format handlers
openssl-header-check	next	2	Check also headers for RSA_set0_key
para_play	next	1	Improvements to para_play
sf_float	pu	1	support 32 bit float sample format.
ssh	next	10	support for RFC4716 keys
ubsan	pu	1	New option for configure to activate ubsan

Topic branch details

The SHA1 number shown as tip can be used to checkout a commit which only contains the changes introduced in this topic.

ONESHELL

desc: Activate the .ONESHELL feature
state: started on 2018-10-08, cooking since 2018-12-23
branch: next
base: master
aim: master
number commits: 1
tip: ece3b9ff875a28473a4f840bb016f8debb2531fc
merge commit: 55e71cb79d41de087e43b977b4e9a2cc9eb3dc88
merge date: Thu, 6 Jun 2019 08:36:16 +0200
rebase count: 25

A single patch which instructs the build system to run multi-line statements in Makefiles in a single shell instance.

We now build the tree using the .ONESHELL feature of GNU make, which results in a significant speedup.

   Makefile.real   | 67 ++++++++++++++++++++++++++++++---------------------------
   m4/lls/makefile | 24 ++++++++++-----------
   t/makefile.test |  5 +++--
   3 files changed, 50 insertions(+), 46 deletions(-)

afh

desc: cleanups of the audio format handlers
state: started on 2018-09-19, cooking since 2018-12-21
branch: next
base: master
aim: master
number commits: 6
tip: a1610c2bd6e3097c6473c5403bfd59425b2058ba
merge commit: 0cdf1f8aa0ddd0a579a3a291307781a410c155bd
merge date: Thu, 6 Jun 2019 08:36:16 +0200
rebase count: 27

A couple of patches which remove ->init of struct audio_format_handler and struct receiver.

Cleanup of the audio format handler code.

   aac_afh.c     |  22 ++++----
   afh.c         |   1 -
   afh.h         |   9 ----
   afh_common.c  | 166 ++++++++++++++++++++--------------------------------------
   afh_recv.c    |   2 -
   audiod.c      |   1 -
   dccp_recv.c   |   1 -
   flac_afh.c    |  15 +++---
   http_recv.c   |   1 -
   mp3_afh.c     |  15 +++---
   ogg_afh.c     |  19 +++----
   opus_afh.c    |  19 +++----
   play.c        |   4 --
   recv.c        |   1 -
   recv.h        |   7 ---
   recv_common.c |  21 --------
   server.c      |   3 --
   spx_afh.c     |  17 +++---
   udp_recv.c    |   1 -
   wma_afh.c     |  16 +++---
   20 files changed, 118 insertions(+), 223 deletions(-)

afh-preserve

desc: New option for para_afh to preserve timestamps
state: started on 2018-07-31, cooking since 2018-09-04
branch: next
base: master
aim: master
number commits: 1
tip: 0e34285da6ad1111b270d3463d5216493ffcde6f
merge commit: 189d595bb71bf16d17beacef6132bbd30ed6e2f2
merge date: Thu, 6 Jun 2019 08:36:15 +0200
rebase count: 42

A single patch which adds –preserve to para_afh.

para_afh: New option: –preserve to reset the modification time to the value of the original file after meta data modification.

     afh.c               | 18 ++++++++++++++++++
     m4/lls/afh.suite.m4 |  6 ++++++
     2 files changed, 24 insertions(+)

ogg_afh

desc: Improvements to the ogg audio format handlers
state: started on 2018-12-22, cooking since 2019-02-24
branch: next
base: master
aim: master
number commits: 3
tip: 730bae4a2d2579b862a34c6436d1652823899b90
merge commit: 0f5aaf9dd7896f9d37a1fc2dde08464c64d18591
merge date: Thu, 4 Jul 2019 09:18:22 +0200
rebase count: 10

A single patch which teaches the ogg/* audio format handlers to report the correct length for files with holes.

The ogg audio format handlers learned to detect holes and now report the correct duration of even if ogg pages are missing. This affects ogg/vorbis ogg/speex and ogg/opus.

     ogg_afh_common.c | 20 +++++++++++++++-----
     1 file changed, 15 insertions(+), 5 deletions(-)

afh-preserve

desc: New option for para_afh to preserve timestamps
state: started on 2018-07-31, cooking since 2018-09-04
branch: next
base: master
aim: master
number commits: 1
tip: 0e34285da6ad1111b270d3463d5216493ffcde6f
merge commit: 189d595bb71bf16d17beacef6132bbd30ed6e2f2
merge date: Thu, 6 Jun 2019 08:36:15 +0200
rebase count: 42

A single patch which adds –preserve to para_afh.

para_afh: New option: –preserve to reset the modification time to the value of the original file after meta data modification.

     afh.c               | 18 ++++++++++++++++++
     m4/lls/afh.suite.m4 |  6 ++++++
     2 files changed, 24 insertions(+)

compress

desc: improvements to the compress filter
state: started on 2018-05-19, cooking since 2018-09-05
branch: next
base: master
aim: master
number commits: 5
tip: 99f21f0b6ecf29f949cdbce285e241a2e3ef3093
merge commit: fcb5f26a54214cf2e1ec4240885df6bf3cbbbd20
merge date: Thu, 6 Jun 2019 08:36:14 +0200
rebase count: 42

A short series which overhauls the algorithm behind the compress filter and its documentation.

An overhaul of the compress filter code. The refined algorithm should reduce clipping. The meaning of –aggressiveness has changed, see the updated and extended documentation of the compress filter for details.
```
   compress_filter.c          | 43 +++++++++++++++++++++++++++++++++++++++----
   m4/lls/filter_cmd.suite.m4 | 32 ++++++++++++++++++++++++++------
   2 files changed, 65 insertions(+), 10 deletions(-)
```

duration-keyword

desc: make “duration” a new keyword for the mood grammar
state: started on 2018-08-30
branch: pu
base: master
aim: master
number commits: 1
tip: c87f5c4cc4b6a6b4eaeae9451f94c9099e91825f
merge commit: e09ef88fb7ea3ccc64b34ad81b0eddf104c3b46a
merge date: Sun, 14 Jul 2019 13:01:50 +0200

rebase count: 23

   mp.c          | 21 +++++++++++++++++++++
   mp.h          |  1 +
   web/manual.md |  1 +
   yy/mp.lex     |  1 +
   yy/mp.y       |  5 +++++
   5 files changed, 29 insertions(+)

for-maint

desc: urgent fixes for old bugs
state: cooking for a while, to be merged soon
branch: pu
base: maint
aim: maint
number commits: 0
tip: 884f36e554f9c58815bc24cc3f1f033ab30cb7c7
merge commit: 884f36e554f9c58815bc24cc3f1f033ab30cb7c7
merge date: Mon, 30 Apr 2018 21:26:12 +0200
rebase count: 0

misc

desc: smallish miscellaneous changes for master
state: testing
branch: pu
base: master
aim: master
number commits: 0
tip: 522112ac291393b5a9cbeea550dfd5e7de3863bb
merge commit: 522112ac291393b5a9cbeea550dfd5e7de3863bb
merge date: Sun, 7 Apr 2019 16:57:12 +0200
rebase count: 5

Stuff in here is too small to get its own topic branch, and safe enough to be applied to master without cooking in next.

mixer

desc: improvements to para_mixer
state: started on 2019-03-23, cooking since 2019-06-01
branch: next
base: master
aim: master
number commits: 1
tip: ac289a22fd438a97d5eda86793a47377d0d570ce
merge commit: e96b8d2eb60a588abc26bfe589ac1369e0be0dea
merge date: Thu, 6 Jun 2019 08:36:12 +0200
rebase count: 5

A single patch for para_mixer which makes the subcommands which sleep a bit more robust.

Robustness improvements for para_mixer

   mixer.c | 117 ++++++++++++++++++++++++++++++++++++++++++----------------------
   1 file changed, 78 insertions(+), 39 deletions(-)

ogg_afh

desc: Improvements to the ogg audio format handlers
state: started on 2018-12-22, cooking since 2019-02-24
branch: next
base: master
aim: master
number commits: 3
tip: 730bae4a2d2579b862a34c6436d1652823899b90
merge commit: 0f5aaf9dd7896f9d37a1fc2dde08464c64d18591
merge date: Thu, 4 Jul 2019 09:18:22 +0200
rebase count: 10

A single patch which teaches the ogg/* audio format handlers to report the correct length for files with holes.

The ogg audio format handlers learned to detect holes and now report the correct duration of even if ogg pages are missing. This affects ogg/vorbis ogg/speex and ogg/opus.

     ogg_afh_common.c | 20 +++++++++++++++-----
     1 file changed, 15 insertions(+), 5 deletions(-)

openssl-header-check

desc: Check also headers for RSA_set0_key
state: started on 2018-12-21, cooking since 2019-02-16
branch: next
base: master
aim: master
number commits: 2
tip: a03519e08af6bb3d4a6ba9477eb6a02d6f4c48df
merge commit: c278dd0c25b3841be7c8a08e851b70a6aa06f45b
merge date: Thu, 6 Jun 2019 08:36:11 +0200

rebase count: 10

   configure.ac | 20 ++++++++++++++++++--
   openssl.c    |  2 ++
   2 files changed, 20 insertions(+), 2 deletions(-)

para_play

desc: Improvements to para_play
state: started on 2018-08-01, cooking since 2019-05-26
branch: next
base: master
aim: master
number commits: 1
tip: be3b6f16706c6a93bd46c6dc48caa8109e7860c6
merge commit: 50f7537192afdbb6dd8f651d304ec59ef55fe172
merge date: Thu, 6 Jun 2019 08:36:09 +0200
rebase count: 5

A single patch which adds –end-of-playlist to control the behaviour of para_play when the end of the playlist is reached.

New para_play option: –end-of-playlist

   error.h              |  1 +
   m4/lls/play.suite.m4 | 10 ++++++++++
   play.c               | 11 +++++++++--
   3 files changed, 20 insertions(+), 2 deletions(-)

sf_float

desc: support 32 bit float sample format.
state: started on 2018-04-29
branch: pu
base: master
aim: master
number commits: 1
tip: 4ac446f2b43f15df969effee9c81793d202d8ab2
merge commit: 1fe385797ee30f7448fbcfb040ef3358464ed58d
merge date: Sun, 14 Jul 2019 13:01:50 +0200
rebase count: 13

The first few patches of this series are small cleanups related to writers. The last patch adds two new sample formats for 32 bit IEEE float waveform data.

The alsa writer also supports 32 bit float sample formats.

   alsa_write.c                    |  2 ++
   ao_write.c                      |  2 ++
   check_wav.c                     | 20 +++++++++++++++++---
   m4/lls/include/sample-format.m4 |  4 +++-
   para.h                          |  2 ++
   5 files changed, 26 insertions(+), 4 deletions(-)

ssh

desc: support for RFC4716 keys
state: started on 2018-08-27, cooking since 2018-12-25
branch: next
base: master
aim: master
number commits: 10
tip: 9e2b093bed5d47a5941ebcf4735f4498ac1f427b
merge commit: 6fc3175dec1531058b96203b36ecaef847e467f6
merge date: Thu, 6 Jun 2019 08:36:05 +0200
rebase count: 23

A medium sized series which teaches both crypto backends about the RFC4716 key format, which has become the default for ssh-keygen as of openssh-7.8.

para_client now supports RFC4716 private keys as generated with ssh-keygen -m RFC4716. In fact, this key format has been made the default, and the former PEM keys will be depreciated soon.

   crypt_backend.h |   9 +-
   crypt_common.c  | 160 +++++++++++++++++++++++++++++-
   error.h         |   1 +
   gcrypt.c        | 300 +++++++++++++++++++++++++++++---------------------------
   openssl.c       | 168 +++++++++++++++++++++++++++----
   web/manual.md   |   2 +-
   6 files changed, 473 insertions(+), 167 deletions(-)

ubsan

desc: New option for configure to activate ubsan
state: started on 2017-07-15
branch: pu
base: master
aim: master
number commits: 1
tip: 0b3b2516a952836a256ce211cb73e4f7d87a8ef3
merge commit: 49d726f7062ed6ca070767ccb2e2eb510cd0ad1e
merge date: Sun, 14 Jul 2019 13:01:50 +0200

rebase count: 5

   Makefile.in   | 2 ++
   Makefile.real | 5 +++++
   configure.ac  | 5 +++++
   3 files changed, 12 insertions(+)