Disable gtk-doc since the build fails

Change-Id: Iaa719212109460fd6fa8bbaf45c7b0e56c88de5c
Signed-off-by: Mikko Ylinen <mikko.ylinen@intel.com>

Add Tizen packaging files

Change-Id: I70ca7386b80521718c1bd7876524640bd3b1fafa
Signed-off-by: Mikko Ylinen <mikko.ylinen@intel.com>

Add .gbs.conf

Change-Id: I8e0b9cf67fe6095f1bbfdfaa115f8f03a23ef3ae
Signed-off-by: Mikko Ylinen <mikko.ylinen@intel.com>

Release 1.0.2

Fix sections in the NEWS file

Emit "luc-group-started" even if failing to read the LUC

If we don't do this, the callback provided by the application will
not always be called and thus, sd_notify() will only be called if
reading the LUC is attempted. That breaks starting the NSC service
through systemd.

Signed-off-by: Jannis Pohlmann <jannis.pohlmann@codethink.co.uk>
Reviewed-by: Jonathan Maw <jonathan.maw@codethink.co.uk>

Adjust NSM Consumer D-Bus interface to match the real NSM

Release 1.0.1

Make systemd respond to "READY" notifications from the NSC (GT-2212)

The type of the systemd service is now "notify", because systemd ignores
the "READY=1" notification for all other service types.

Release 1.0.0

Expand description for ShutdownClient

Adds some information about the data it contains.

Fix minor inconsistencies in expected test output.

In test-legacy-app-handling.xml, the timeout was wrong.

In test-target-startup-monitoring, the phrase "Applied the node state N"
had been changed to "Node state N applied" in everywhere but one place.

Rename all com.contiautomotive to org.genivi

Expand description of the NodeStartupControllerService

Expands the description to explain what it does when it receives the
"handle-begin-lucregistration", "handle-register-with-luc" and
"handle-finish-lucregistration" signals.

Expand description of the LAHandlerService

Includes a step-by-step description of what happens when it receives a
method call.

Expand description for TargetStartupMonitor

Expand description of the LUCStarter

Includes a step-by-step description of how to start the Last User
Context.

Expand documentation for JobManager

Remove the list of units and create D-Bus proxy only for wanted targets

Remove the list of units which is not longer used.
When the TargetStarterMonitor receives a "job-removed" signal it
creates a D-Bus proxy to monitor the unit and check if the state
changes to "active". If it does the TargetStartupMonitor sets the node
state.

The TargetStarterMonitor is only interested in monitoring
"focussed.target", "unfocussed.target" and "lazy.target" units. To
avoid creating the D-Bus proxy for unneeded units, it should check in
target_startup_monitor_job_removed if the unit is a unit which has to be
monitored.

Add callbacks that log when bus names are acquired or lost

Callbacks added to both the Node Startup Controller and the NSM Dummy

Update log messages in the TargetStartupMonitor test case docs

Replace the old DLT messages in the TargetStartupMonitor test case
documetnation with the ones we currently use.

Edit docs for NodeStartupControllerApplication to be more elaborate

Rewrites the description of the NodeStartupControllerApplication to
be more explicit in what it contains and what it does.

Fix minor bugs in NodeStartupControllerApplication's SIGINT handler

The SIGINT handler did not cancel the LUCStarter, it does now.

The SIGINT handler made the application quit, but the asynchronous
call to deregister its shutdown consumer from the Node State Manager
does that when it is finished.

Fix segmentation faults and remove an unused variable

Fix a segmentation fault in target_startup_monitor_finalize caused by
freeing the data of a list item instead of the actual unit list we want
to free.

Fix another possible segmentation fault in
la_handler_service_handle_consumer_lifecycle_request_finish caused by
logging a message using the wrong GError.

Remove an unused variable in la_handler_service_handle_register.

Add documentation for the GLib extension functions

Document the NodeStartupControllerService class

In README, point to building.xml for build deps and instructions

Remove empty lines in node-startup-controller-application.c

Document arguments and remove old function prototype of LAHandlerService

Previous documentation of the LAHandlerService omitted explaining
the @service arguments.

A function prototype existed in the header for the LAHandlerService and
was included in the documentation, but was never used or defined.

Document the LUCStarter class

Add documentation to the ShutdownClient class

Add documentation for the NodeStartupControllerApplication class

License the reference manual under Creative Commons CC0 1.0 Universal

Add a dedicated COPYING.docs file for this. The license is also
mentioned again in the reference manual itself.

Improve WatchdogClient documentation a bit

Add documentation for the WatchdogClient class

Improve class documentation a bit

Add documentation to the TargetStartupMonitor class

Fix name of the LAHandlerService class in the docs and in NEWS

Add docuumentation to the la-handler-service class

Add an explanation of the JobManagerCallback

Update NEWS regarding the JobManager documentation

Add documentation for JobManager's constructor

Document purpose and start/stop methods of job manager

Fix minor alignment issue in glib-extensions.c

g_variant_string_array_has_string was partly aligned using tabs, which
only looks good when tab width is set to two spaces. Tabs have now been
replaced with spaces.

Simplify g_variant_lookup_value_with_int_key

An implementation custom-tailored towards "{ias}" dictionaries is
sufficient for us.

Update the NEWS file

Rewrite documentation for legacy app handler test

Removed the requirement to restart the system for each test, instead
just restart the node startup controller for each test. The downside of
this is that the dlt.log file is not reset so may become very large.

Reduced the number of DLT log messages to compare against the output.
Instead, only the most relevant lines are included for each test.

Added separate test that the Node Startup Controller registers itself.

Rewrote the descriptions for each test case to be more readable.

Numbered each test case.

Spelling and grammar fixes.

Remove the bus_name_id member from LAHandlerService

The bus_name_id member is not longer used in this class.

Update NEWS

Use a proper error code when unable to handle an unregister request

Send NSM_ERROR_STATUS_ERROR rather than -1 back to the caller when an
unregister request could not be handled successfully.

Release 0.9.1 - the first release candidate for 1.0.0

Update NEWS for the 0.9.1 release

Apply minor fixes for building the reference manual

Make sure to set GTKDOC_CFLAGS/GTKDOC_LIBS properly

Unregister all shutdown consumers when receiving SIGTERM

systemd uses SIGTERM to stop its units. We want to cleanly shut down
the NSC when receiving this signal. Part of that is to unregister all
shutdown consumers. If we don't do this, the NSM will later during its
shutdown phase call all shutdown consumers registered by the NSC. And
if the NSC was no longer running, this would cause the NSM to wait for a
timeout for every single one of these shutdown consumers. Obviously,
that is not desirable.

Add a type check to avoid a proxy to skeleton cast to fail

We use the "consumer" property of the ShutdownClient class to store a
proxy in the NSC code and a skeleton in the NSM dummy code. When
releasing the consumer in shutdown_client_finalize(), we may therefor
not cast to a ShutdownConsumerSkeleton unconditionally; otherwise
the NSM dummy will segfault when releasing ShutdownClient objects.

Fix Test legacy app handling purpose, error in logs and commands

Fix in Test legacy app handling documentation the purpose, some
error logs and some commands.
Fix duplicate will in about.xml

Fix a markup error in building.xml

Document the --enable-gtk-doc configure option in the manual

Use passive language in test-test-environment-setup.xml

Changes the single instance of "we" in this file.

Minor grammatical fixes.

Grammatical fix to test-nsm-dummy.xml

It now uses passive language throughout.

Other minor grammatical fixes

Make the description of the NSM dummy more clear to unfamiliar readers

Fix the link to test-luc-finish-only

Revert "Depend on systemd 37 to be able to build on Fedora 16"

This reverts commit 5dfb47b1b80d3aa91b8493491050b9d70c31c57b.

Finish documentation of build commands

Fix conflicting part/refentry IDs to make the building page show up

Add required command line utilities to build dependency docs

Add library dependencies for building to the docs

Depend on systemd 37 to be able to build on Fedora 16

Add parentheses in the shutdown mode rejection conditionals

Make shutdown mode registration similar in NSC and helper binary

The shutdown mode checker in the Node Startup Controller now uses the
same logging message as the legacy app handler helper binary.

The shutdown mode checker in the helper binary now uses the condition
statement from the Node Startup Controller

Make legacy app handler refuse invalid shutdown modes

Added code to the register signal handler to refuse any register signal
which is not a combination of NSM_SHUTDOWN_TYPE_NORMAL and
NSM_SHUTDOWN_TYPE_FAST and log an error.

Fix the title of the Test legacy application handler.

Replace the previous title by "Tests for legazy application handling".
Fix some paragraphs.

Better test case titles and always set the node state in TSM tests

Test titles are made more descriptive by including the name of the node
state which is being set.

A link is included to the enum which defines the NSMNodeState.

Tests are changed to always set the node state. This is done by
starting the unit twice in most cases. In addition, the less-important
lines in the DLT log output are no longer specified.

Capitalization in titles has been cleaned up somewhat.

Add the documentation for legacy app handling tests

Add the documentation for legacy app handling tests.
The following tests are provided:
 1. Register a normal and a fast shutdown consumer.
   - Check that node-startup-controller.service registers itself
     as a shutdown consumer.
   - Check that the registration for the shutdown consumer are ok.
   - Check that in the process of shutting down the fast consumers
     shutting down first and the normal consumers second.
   - Check that the shutdown consumers are unregister as a shutdown
     consumers when they have been shutting down.
   - Check that node-startup-controller.service unregisters itself
     as a shutdown consumer when it has been shutting down.

 2. Register two normal shutdown consumers
   - Check that in the process of shutting down the consumers are
     shutting down in reverse order of registration.

 3. Register a shutdown consumer twice within different modes and timeouts
   - Check that the re-registration modify the final mode to a combination
     of both modes (normal and fast) and the timeout has been set to the
     last registration value of timeout.
   - Check that in the process of shutting down the consumer is shutting down
     for the both modes.

 4. Register a shutdown consumer with invalid arguments
  - Check that register a consumer without unit name fails.
  - Check that register a consumer within mode 0 fails
  - Check that register a consumer with a negative timeout fails.

Document that timeout is non-mandatory parameter and its default value

Modify in the documentation for legacy app handler that timeout is a
non-mandatory legacy app handler argument and its default value is
1000 milliseconds.

Add NSM dummy documentation page

Restructure and number the Target Startup Monitoring tests

Tests are restructured in the same way as the previous commit

Number and restructure luc management test cases

Test cases are restructured into:
* Description
* Test Commands
* Desired behaviour and Output

Add missing XML files to the reference manual Makefile.am

Work on documentation of functional scope and interfaces

Also fix a mistyped systemd command.

Rework reference manual a bit, start reworking test case layout

Split test scenarios into separate pages, add legacy app skeleton

Each test scenario (i.e. luc, legacy app, tsm) has been split into a
separate file.

Setup steps which have to be performed for every scenario are moved into
test-general-setup.xml

Cross-references are used so that the test overview links to each test
case, and the "Testing" page links to the general setup and also each
test.

test-example has been removed because it is no longer necessary.

Add test scenarios for the Last User Context handling

The following test scenarios are added to the documentation:
* Registration of a simple dictionary
* Registration does not happen on an isolated RegisterWithLUC() call
* An isolated FinishLUCRegistration() call will not change the LUC
* Registration of a complex dictionary
* Registration can happen with a series of RegisterWithLUC() calls
* Repeated registration of an app changes the order in the LUC

Specify difference between NSM and NSM dummy in docmentation

Explicitly states the difference between the Node State Manager Dummy
and the real Node State Manager, i.e.
* The NSM dummy toggles between successfully setting the node state
  and failing to set the node state.
* The NSM dummy toggles between the LUC being required, and the LUC
  not being required.
* The NSM dummy will shut down its fast shutdown clients, then its
  normal shutdown clients, on receiving the SIGHUP signal

Add TSM test and improve layout of test document

The improvements to the layout of the test document are that the
individual tests will now show up on the table of contents.

The Target Startup Monitor (TSM) tests check that the following cases
attempt to change the node state:
* The Node Startup Controller starting
* focussed.target starting
* unfocussed.target starting
* lazy.target starting

The following case should not attempt to change the node state:
* focussed.target stopping

Add testing skeleton

Lays out the structure of the test document XML

Change required version of systemd from 37 to 183

Fix build instructions to include creating the m4 directory

Unregister exported D-Bus objects on finalization

Adds unregistration to the following services:
* legacy app handler
* shutdown client
* node startup controller
* nsm dummy lifecycle control
* nsm dummy consumer

Rework log messages a bit to make them more readable

Use DLT_LOG_INFO rather than DLT_LOG_DEBUG for everything

We can't get DLT to log our debug messages, setting LoggingLevel to 7
(LOG_DEBUG) in /etc/dlt.conf does not work as expected. So for now we'll
have to resort to logging all debug messages as info messages.

Adjust DLT log levels (info -> debug, some warnings, some errors)

Exclusively use DLT facilities to build log strings

We used to build the log strings using g_strdup_printf() but this
results in a certain amount of overhead and extra code.

Fix the name used for the LUCStarter::node-startup-controller property

Replace g_debug/g_warning calls with DLT logging

Unregister the NSM dummy DLT connection at exit

Fix small issues in Makefiles to make "make distcheck" happy

Rename all remaining bits and pieces

Rename service files and boot-manager binary