paraslash

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 next 3 overhaul the ff server command
for-maint pu 0 urgent fixes for old bugs
misc pu 1 smallish miscellaneous changes for master
mixer pu 1 improvements to para_mixer
ogg_afh next 1 Improvements to the ogg audio format handlers
openssl-header-check next 2 Check also headers for RSA_set0_key
para_play pu 2 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: 61c39bc8e630b40689fe10fd575ccc40e0950528
  • merge date: Sun, 23 Dec 2018 02:12:10 +0100
  • rebase count: 19

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: a9fa055bb5145f46876d56abf9a776a42225fc3b
  • merge date: Fri, 21 Dec 2018 14:45:39 +0100
  • rebase count: 21

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: effc3918d2c2caaf822316416f4495231aedf50b
  • merge date: Tue, 4 Sep 2018 12:38:03 +0200
  • rebase count: 36

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: 1
  • tip: 16f2ff3d3a6951588cd7a4ba1b33832a07b8652b
  • merge commit: b9f725a95e0df7c0de79e90efa2ad4d8d2cff540
  • merge date: Sun, 24 Feb 2019 14:28:22 +0100
  • rebase count: 4

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 | 19 ++++++++++++++-----
     1 file changed, 14 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: effc3918d2c2caaf822316416f4495231aedf50b
  • merge date: Tue, 4 Sep 2018 12:38:03 +0200
  • rebase count: 36

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: ed37c0e869ce011fc82aaf882af2d906d9f3caf5
  • merge date: Wed, 5 Sep 2018 17:23:51 +0200
  • rebase count: 36

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: 7bef68840ffe4467cee58ce7c4f80bd0513a0071
  • merge date: Sat, 23 Mar 2019 21:18:49 +0100

  • rebase count: 17

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

ff

  • desc: overhaul the ff server command
  • state: started on 2018-05-01, cooking since 2018-08-01
  • branch: next
  • base: master
  • aim: master
  • number commits: 3
  • tip: 9d232e636d79a2321e280fe3eee6839c8f45c36f
  • merge commit: d397fe5f73aefdecc5d38a1cad7ec3429bf89edf
  • merge date: Wed, 1 Aug 2018 15:53:46 +0200
  • rebase count: 44

A short series which overhauls the ff server command.

  • The ff command now accepts a negative argument to instruct the virtual streaming system to jump backwards in the current audio stream. The old syntax (e.g., “ff 30-”) is still supported but it is deprecated and no longer documented. The compatibility code is sheduled for removal after 0.7.0.

       command.c                  | 32 ++++++++++++++++++++++----------
   m4/lls/server_cmd.suite.m4 | 20 ++++++++++----------
   2 files changed, 32 insertions(+), 20 deletions(-)

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: 1
  • tip: 30a97f487fb69a73c53bba6c5d97bcc653678528
  • merge commit: c526b1d9c83deec21cf7fbb4150277f5f110c81a
  • merge date: Sat, 23 Mar 2019 21:18:49 +0100
  • rebase count: 4

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

     aft.c | 2 +-
     1 file changed, 1 insertion(+), 1 deletion(-)

mixer

  • desc: improvements to para_mixer
  • state: started on 2019-03-23
  • branch: pu
  • base: master
  • aim: master
  • number commits: 1
  • tip: 72aea87167a9ae0e01697a211f21a2fb39509be2
  • merge commit: 69caa0dcaf0b249a9c4dee7b024e47c70afe49dd
  • merge date: Sat, 23 Mar 2019 21:18:49 +0100

  • rebase count: 0

       mixer.c | 113 ++++++++++++++++++++++++++++++++++++++++++----------------------
   1 file changed, 75 insertions(+), 38 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: 1
  • tip: 16f2ff3d3a6951588cd7a4ba1b33832a07b8652b
  • merge commit: b9f725a95e0df7c0de79e90efa2ad4d8d2cff540
  • merge date: Sun, 24 Feb 2019 14:28:22 +0100
  • rebase count: 4

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 | 19 ++++++++++++++-----
     1 file changed, 14 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: 00a09b65970165bbf5601b5a10fe2be0e4c393b1
  • merge date: Sat, 16 Feb 2019 20:16:16 +0100

  • rebase count: 4

       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
  • branch: pu
  • base: master
  • aim: master
  • number commits: 2
  • tip: 3496893d939c7120d63373ad98bc2705b40af584
  • merge commit: 25416f23eeeea908150f30b55c44e6da8711af79
  • merge date: Sat, 23 Mar 2019 21:18:49 +0100

  • rebase count: 5

       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: 36525b6de03186a4fb3683e3422c6890e1765a95
  • merge date: Sat, 23 Mar 2019 21:18:49 +0100
  • rebase count: 7

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: d068b8e754d156497061a074c717a7c0cbede3b5
  • merge date: Tue, 25 Dec 2018 17:46:20 +0100
  • rebase count: 17

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: add68533202c6cb8e71ad22f35e7ad1697cde354
  • merge commit: e7a205e8b435985eed34c89c32eb071d10b95c80
  • merge date: Sat, 23 Mar 2019 21:18:49 +0100

  • rebase count: 3

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