This is another step in a general cleanup of the state machine.  To
help me knowning what is audited and what is not, I rename the "common
functions" to fsm-lib. This is the management of announce.

- master and slave functions were the same, so they are unified now

- hooks->handle_annunce returns int (it may fail)
Signed-off-by: Alessandro Rubini <rubini@gnudd.com>

This removes a number of explicit checks in the states themselves.
Signed-off-by: Alessandro Rubini <rubini@gnudd.com>

This changes all "Name Surname for CERN" to "Copyright CERN, author
Name Surname".  This is trivial and makes no change, with a few
expections:

- all trivial Makefiles that had "for CERN" lines have now no
attributions, as they are trivial anyways.

- a few unrepresented files have not the copyright notice (especially
ptpdump, that I wrote in 2012).

- a few "for CERN" remain in subprojects, where I didn't touch anyrhing
Signed-off-by: Alessandro Rubini <rubini@gnudd.com>

The function is called by several states, but only state-slave
is checking the delay request timeout. Thus, this commit removes
the associated lines from the common function and moves them back
to state-slave, the only state that issues delay_request frames.
Signed-off-by: Alessandro Rubini <rubini@gnudd.com>

This changes some things to make code more readable (I really didn't
know what the tmp_header was: now it is the "received_ptp_header".
The commit simplifies allocation, because the tx and rx buffers are
now part of ppi itself.

We now have tx_ptp and tx_frame, both pointing within tx_buffer (and
the same for rx). The pointers are the protocol side (aligned) and the
argument passed to send/recv (which may be not be 4-aligned).

At this point nothing changes, i.e. both gnu-linux flavours work and
bare-i386 is not able to received.

This is a major patch, because header files are renamed, and
the header directory with them. Still, no functional change is there.

This patch is due to the fact that the code did not correctly handle
the situation of "no incoming message". Since messageType 0 is a SYNC
message type, in those cases an empty message was tried to be handled as a SYNC
message, and led to FAULTY state. This patch seemed to me the least
invasive with respect to the current code.

msg_issue_xxx functions declared, implemented and used
See that pp_get_tstamp now returns a TimeInternal struct.
Actually timestamp struct might be defined outside of ieee_1588_types.h
file, since it is not defined in the spec. For the moment, I leave
it there, but in the future it must be redefined for our purposes (and
in standard_c_notation)

a general notice is also put in AUTHORS file

the "ppi" object instance should consistently be the first argument of
functions that receive it. Besides being more consistent, it's smaller
and faster too (on processors with more than 4 registers, I mean).
Signed-off-by: Alessandro Rubini <rubini@gnudd.com>

All other state-* files refer to one state of the fsm, so rename common
functions accordingly
Signed-off-by: Alessandro Rubini <rubini@gnudd.com>

While the code layout comes from ptp-proposal, this is a different
package, now called pptp for "Portable PTP".
Signed-off-by: Alessandro Rubini <rubini@gnudd.com>
Acked-by: Aurelio Colosimo <aurelio@aureliocolosimo.it>

minor fixes and comments updated elsewhere

code was pruned from specific "ptp-proposal" protocol and the
skeleton of IEEE-1588 states was made. Next step is to insert,
step by step, the structs defined in ptpd. Still something needs
to be removed or renamed, but this should be a fair starting point.