在运行更新时获取信息
=====================================

通常需要告知操作员运行更新的状态，而不仅仅是返回更新是否成功。
例如，如果目标具有显示或远程接口，则可以转发当前更新的目标及百分比，
以便估计还有多少更新需要完成。

SWUpdate为此提供了一个接口(“progress API”)。
外部进程可以在SWUpdate中注册自己，
当更新中的某些内容发生更改时，它将接收通知。
这与IPC API不同，因为后者主要用于传输SWU镜像，
只有轮询接口才能知道更新是否仍在运行。


API 描述
---------------

外部进程将自己注册到SWUpdate，并向SWUpdate默认配置的域套接字
"/tmp/swupdateprog" 发出connect()请求。
当没有要发送的信息时，SWUpdate只是将新连接插入要通知的进程列表中。
SWUpdate在更新过程中发生任何更改后，将使用以下数据
(请参见include/progress_ipc.h)发回一帧数据:

::

        struct progress_msg {
        	unsigned int	magic;		/* Magic Number */
        	unsigned int	status;		/* Update Status (Running, Failure) */
        	unsigned int	dwl_percent;	/* % downloaded data */
        	unsigned int	nsteps;		/* No. total of steps */
        	unsigned int	cur_step;	/* Current step index */
        	unsigned int	cur_percent;	/* % in current step */
        	char		cur_image[256];	/* Name of image to be installed */
        	char		hnd_name[64];	/* Name of running handler */
        	sourcetype	source;		/* Interface that triggered the update */
        	unsigned int 	infolen;    	/* Len of data valid in info */
        	char		info[2048];   	/* additional information about install */
        };

单个字段的含义如下:

        - *magic* 尚未使用，它可以被添加为帧的简单验证。
        - *status* 是swupdate_status.h中的值之一(START, RUN, SUCCESS, FAILURE, DOWNLOAD, DONE)。
        - *dwl_percent* 是status = Download 时下载数据的百分比。
        - *nsteps* 是要运行的安装程序(处理程序)的总数。
        - *cur_step* 是正在运行的处理程序的索引。cur_step在1..nsteps范围内
        - *cur_percent* 是在当前处理程序中完成的工作的百分比。这在通过慢速接口，如低速flash,
          进行更新时非常有用。信号是镜像已经复制到目标的百分比。
        - *cur_image* 是当前正在安装的镜像在sw-description中的名称。
        - *hnd_name* 报告正在运行的处理程序的名称。
        - *source* 是触发更新的接口。
        - *infolen* 后续info字段的数据长度。
        - *info* 关于安装的附加信息。

进度客户端的一个例子是 ``tools/progress`` 。
在控制台打印状态，并驱动 "psplash" 在屏幕上绘制进度条。