[710] | 1 | RoarAudio |
---|
| 2 | As loud as a Lion |
---|
| 3 | --------------------- |
---|
| 4 | |
---|
| 5 | --- 0. INDEX |
---|
| 6 | 0. Index |
---|
| 7 | 1. Infos for maintainers |
---|
| 8 | 2. Infos for developer |
---|
| 9 | |
---|
| 10 | --- 1. Infos for maintainers: |
---|
| 11 | |
---|
[1677] | 12 | If you want to maintain a packet for your favorite OS please let me know! |
---|
[712] | 13 | I would love to be in contact with the maintainers to send them infos about |
---|
[1677] | 14 | updates and maybe get feedback or things like init scripts or the like |
---|
[712] | 15 | (see 2. Infos for developer). |
---|
| 16 | |
---|
| 17 | If it would make your work simpler I can put things in trunk |
---|
| 18 | (info files for pkg build tools or the like). Just ask. |
---|
| 19 | |
---|
| 20 | Also if you need any help you may contact me. |
---|
| 21 | |
---|
| 22 | Here is my recommendation on how to split the RoarAudio in pkgs: |
---|
| 23 | |
---|
[2406] | 24 | libroar includes libroar, libroardsp, libroarmidi, |
---|
| 25 | libroarlight and libroareio |
---|
[712] | 26 | roaraudio-common include roard and roarclients |
---|
[1677] | 27 | (at least the ones with no special deps) |
---|
[712] | 28 | roaraudio-tools includes all other tools not in roaraudio-common |
---|
[1677] | 29 | because of special deps (if any) |
---|
[712] | 30 | roaraudio-compat includes libroaresd, libroararts, libroarpulse |
---|
| 31 | and libroaryiff. It would be nice to ask the user |
---|
| 32 | if he wants symlinks from libesd, libarts*, libpulse*. |
---|
| 33 | roaraudio-dev includes include/ |
---|
| 34 | someplayer-roar pkgs from plugins/ |
---|
| 35 | |
---|
| 36 | manpages should be included in the corresponding packet. |
---|
| 37 | |
---|
[893] | 38 | If your system includes a libdnet (Linux DECnet support) please build |
---|
| 39 | it with DECnet support compiled in. There will be no strange warning messages |
---|
| 40 | anymore with DECnet enabled on a non-DECnet system. libdnet does not |
---|
| 41 | require any Kernel modules or has any non standard deps itself. |
---|
| 42 | |
---|
[2406] | 43 | If you system includes libslp (normaly one of the deps of cups) please |
---|
| 44 | consider to build with libslp support. |
---|
| 45 | |
---|
[895] | 46 | In addition you should configure with --runtime-detect: this will |
---|
[1677] | 47 | let roard/libroar detect the presents of some tools at runtime and |
---|
| 48 | will reduce deps. |
---|
[895] | 49 | |
---|
[2406] | 50 | Please ensure that configure finds the correct audio users group. |
---|
| 51 | In case it does not detect the correct one please set it via |
---|
| 52 | --audio-group. |
---|
| 53 | |
---|
| 54 | Running roard: |
---|
| 55 | Global (system wide) roards normaly are started as root. |
---|
| 56 | Ensure it drops it's privilegs by setting --setuid/--setgid |
---|
| 57 | and maybe -U and -G. |
---|
| 58 | |
---|
| 59 | It is allways nice to use --pidfile. If you use a pidfile |
---|
| 60 | you can start and stop roard by using --start and --stop easily. |
---|
| 61 | |
---|
| 62 | You can use --chroot to chroot into an empty directory to improve security. |
---|
| 63 | roard does the chrooting after loading everything so it is perfectly safe |
---|
| 64 | to chroot into an empty directory. In case your system includes a /var/empty |
---|
| 65 | or simular directory please do the chroot. |
---|
| 66 | |
---|
| 67 | To ensure no drops consider to add one or two --realtime |
---|
| 68 | |
---|
| 69 | In case of a public (for LAN) server have some way for the user to set --location |
---|
| 70 | and use --slp for Zero Conf. |
---|
| 71 | |
---|
| 72 | For more information see roard --help. |
---|
| 73 | |
---|
[710] | 74 | --- 2. Infos for developer |
---|
| 75 | |
---|
[711] | 76 | At the moment all the libs are under GPLv3. |
---|
| 77 | As libesd, libarts*, libpulse* and maybe other are under |
---|
| 78 | LGPL the corresponding roar replacements should be under LGPL as well. |
---|
| 79 | Because they link libroar independent of what licenses they are under |
---|
| 80 | they are downgraded to GPL. This may change in future. |
---|
| 81 | |
---|
| 82 | Because of that I *require* that *everything* that is contributed by |
---|
| 83 | someone I get under LGPL so I can upgrade code to LGPL if needed |
---|
[1677] | 84 | in future without asking. Code I get under a different license |
---|
[711] | 85 | will *NOT* get into trunk nor will be hosted by me. |
---|
| 86 | |
---|
| 87 | Also add full contact infos when sending code to me, this includes: |
---|
| 88 | 1) Full name |
---|
| 89 | 2) nickname |
---|
| 90 | 3) E-Mail |
---|
| 91 | 4) OpenPGP key |
---|
| 92 | |
---|
[893] | 93 | When sending code please sign it with OpenPGP. |
---|
[711] | 94 | |
---|
[710] | 95 | |
---|
| 96 | #ll |
---|