EasyGate News

From Easyneufenglish

[edit] Easygate news

[edit] Functioning

Easygate news display (release notes) is done by a popup. This popup is controlled by 9release script, which is included in the « 9system » package of buildroot. The 9release script is the EasyPopup frontend.

[edit] 9release script

It supports the following arguments

• --display : release notes displayed by the 9release binary
• --update : positionning of a status file (/var/lib/state/9release) which shows that next reboot release notes will be displayed.
• --force : display release notes even if the status file is not there
• --remove : delete the status file whether it exists

Notice that this script is based on sudo to gain privileges.

[edit] Update notifications

After each successfull u^date done by 9update, a status file is created by the « /sbin/9release --update » call in the /var/lib/state directory . At this step, nothng is displayed.

[edit] Display for the user

At the next reboot, the display is done by the « 9release --display » script call via the .xinitrc user configuration file.

It's also possible to force this display by using 9panel. A link called « display recent updates » allows displaying all updates by using at the same time the « --force » and « --display » options.

[edit] File format

File format is simple: a simple text file displayed with these peculiarities :

• list display (bullet list), when a line begins by « - » and space.
• The file has to be encoded in unicode.

File example:

The following modifications have been added:
- Poker game added
- Minor bugs correction AAAAMMJJ

[edit] Content obtaining

This content is obtained from a text file, downloaded from internet. The urls has to be like this : « !http://BASE_RELEASE_URL/release-AAAAMMJJ.txt ».

Base url BASE_RELEASE_URL is hardcoded in the src/main.c EasyPopup source file. For possible modifications, you just have to search the string BASE_RELEASE_URL. The date AAAAMMJJ is dynamically made by EasyPopup with the help of the /etc/easygate_version file located in the easygate filesystem. This file is generated during the image compilation. It contains the compilation date and the image release number.

In case of failure, EasyPopup try to download a release-notes file from the « !http://BASE_RELEASE_URL/release.txt » url. This file (release.txt) could be for example a symbolic link to the most recent release file?

[edit] Contains update

See it with jean.

[edit] Known problems

• The 9release script need the root premission to create the « /var/lib/state/9release » file.