Add release notes for version 1.2.8

1.2.8 -- with a man file and installer

Merge pull request #48 from bootc/feature/manpage

Add man page.

Add man page

This was written for the Debian project, which has a long tradition of
writing man pages for all installed binaries.

Fixes #47

Merge branch 'main' of github.com:mikebrady/nqptp

Online changes merged back.

Add release notes for version 1.2.7

Added release notes for version 1.2.7, including updates on pkg-config usage and configuration options.

Update AM version number.

Merge pull request #46 from bootc/systemdsystemunitdir

Use pkg-config to determine systemdsystemunitdir

use pkg-config to determine systemdsystemunitdir

The systemd unit file is currently installed under
$(libdir)/systemd/system, which is incorrect on multiarch systems (e.g.
Debian and Ubuntu, where libdir should be /usr/lib/aarch64-linux-gnu/
on arm64).

Add PKG_PROG_PKG_CONFIG and a --with-systemdsystemunitdir configure
option. When not explicitly set it queries the 'systemd' pkg-config
module for the correct path, falling back to
$(prefix)/lib/systemd/system if that didn't work.

This allows downstream packagers to override the path cleanly:

./configure --with-systemd-startup \
            --with-systemdsystemunitdir=/usr/lib/systemd/system

Fixes #45

Update RELEASE_NOTES.md for version 1.2.6

Updated release notes for version 1.2.6, including improvements to synchronization and instructions for updating existing installations.

1.2.5-dev-29-ga93ba70 -> 1.2.6.

Update README.md

Make debug_print_buffer check the debug level before doing any work. Set suggested compiler optimisation level to -O3.

Release Note Update

Use check-gitversion for improved use of 'git describe' information for versioning.

Update RELEASE_NOTES.md

Set a FIFO scheduling policy and a priority of -6 so tat the timinig accuracy stays high under load.

Update README.md

Update RELEASE_NOTES.md

Use the systemd DynamicUser facility, and don't define the nqptp user and group anymore.

No longer define the user "nqptp" because it's not strictly needed with the DynamicUser option.

Use DynamicUser=yes in systemd-based Linux, but continue to specify the name of the user to be "nqptp"

Update RELEASE_NOTES.md

Merge pull request #34 from heitbaum/patch-1

change setcap to AmbientCapabilities in README.md

change setcap to AmbientCapabilities in README.md

Update RELEASE_NOTES.md

Merge pull request #32 from qerub/patch-1

Add missing rm command to README.md

Merge pull request #31 from klemensn/openbsd

Support OpenBSD

Add missing rm command to README.md

Hoist control socket handling, restrict runtime on OpenBSD

Use pledge(2) to prevent fork/exec, filesystem access and other
unused subsets of system calls, effectively leaving only shared
memory and networking capabilities at runtime.

(Those might be further reduced, but that warrants further analysis
 and most likely more code shuffling.)

Hoist PTP socket handling, drop privileges on OpenBSD

bind(2)ing ports below 1024 is the only privileged operation NQPTP does.

Move its code up in main() before shared memory handling such that root
privileges can be dropped immediately after it;  no currently supported
system does that, thus this should be a NOOP.

Do so on OpenBSD where shm_open(3) does not allow access to shared memory
objects by multiple UIDs, i.e. to communicate, shairport-sync and NQPTP
must create them and run as the very same user.

OpenBSD's official audio/shairport-sync user provides an rc.d(8) daemon
script that runs as `_shairport` user.

Build on OpenBSD

Recognise the system to configure, build and start.
More work is required to actually work with shairport-sync.
Tested on OpenBSD/amd64 7.4-current.

Update RELEASE_NOTES.md

Change Linux installation to use AmbientCapabilities from systemd. Fix FreeBSD compilation errors.

Update RELEASE_NOTES.md

reorder the include files for FreeBSD

Update RELEASE_NOTES.md

Update RELEASE_NOTES.md

Improve some of the error messages. Remove the setcap command from Makefile.am, since we are now using an AmbientCapabilities setting in the systemd service file.

Update README.md

Update README.md

Merge pull request #26 from Hs-Yeah/development

Added AmbientCapabilities to nqptp.service.in

Added AmbientCapabilities to nqptp.service.in

Added AmbientCapabilities=CAP_NET_BIND_SERVICE
so that the systemd service can be used without the  capability set on the built nqptp binary.

Update README.md

Updated release notes

Update release notes, readme and configuration version number.

Update README.md

Update RELEASE_NOTES.md

Update RELEASE_NOTES.md

Update RELEASE_NOTES.md

Update RELEASE_NOTES.md

Move to smi version 10, read-only interface, no mutex, write and read each record twice to ensure it is not inconsistent when read.

Update README.md

Update README.md

Update README.md

Update README.md

1.2.4d0

Fix a bug whereby a maliciously-crafted packet received on the control port could crash the program.

Fix a crashing bug with an empty command string and check for missing or bad parameters a bit more carefully

Update README.md

Remove references to the `development` branch!

1.2.2d0

bump version number

Include lightweight tags and note if broken.

merge updates from 1.2 main

actually make it 1.2

version 1.2rc0

update Release Notes

slight change in format of output of the smi in the -V command.

slight change in format of output of the smi in the -V command.

Merge branch 'main' into development
Typo

Merge pull request #21 from tsbernar/patch-1

Update README.md

Documentation and version string updates.

Fix a FreeBSD compilation error.

Update README.md

small typo

Update RELEASE_NOTES.md

Merge branch 'development' of github.com:mikebrady/nqptp into development

Online updates merged.

Change open_sockets_at_port to be satisfied with just one port on IPv4 or IPv6. Fix misleading message.

Update RELEASE_NOTES.md

Update RELEASE_NOTES.md

Merge branch 'development' of github.com:mikebrady/nqptp into development

Merge other update.

Tune the weights of additions and reductions.

Fix a bug -- use the previous offset if a negative jitter for the first period. Fix a misleading comment.

Update README.md

Update README.md

Update RELEASE_NOTES.md

Add modifications suggested by https://github.com/mikebrady/nqptp/issues/14 to restrict UDP write access to 9000 to the localhost.

Merge pull request #17 from Weidav/main

typo: remove duplicate you

Update RELEASE_NOTES.md

Enhance an error message.

Update README.md

Tidy up a few comments.

Bump the SHM Interface number to note new commands.

Add version string to initial debug message
Work out when the clock can be relied upon not to go to sleep, i.e. is "active". This is when SPS is playing (B) or paused (P) and for brief periods after the clock is selected (T) and after play ends (E).
SPS signals Play/Pause/End/Timer Select/Timer Release with B/P/E/T messages -- B for "Begin". "T <ip>" means select the clock at that address. "T" means release the clock.
Reset clock smoothing when the clock goes "active" but not at any other time.
Clamp reductions in the offset calculated as a uint64_t remote-time-now_ns - local-time-now_ns -- and which it is assumed are due to delays in the network when the clock is "active" -- to 2.5 mS.
Turn off clock updates when the clock is not "active" -- i.e. when SPS is not paying or paused.
Remove some redundant features and code.

Add ability to receive status information from SPS B/E/P for Begin/End/Pause play. Assume clocks don't sleep between Begin and End and are valid for short times after T and after E. More cleaning up to do.

Allow clock to resent if the grandmaster is the same as the master and it stops for two or more samples. Always send a wakeup to the master at the start.

Small documentation update

Update README.md

typo: remove duplicate you

Merge from main.

Small changes to debug messages.