protocol: expose discovery reinit over client/server protocol

[petitboot] / ui / common / discover-client.h

diff --git a/ui/common/discover-client.h b/ui/common/discover-client.h
index feca63b9eac324c2fd77a6005eda2979c25cf3fc..405bd243c5ee4dc1dfadd3fbf4fee6ef1cca6859 100644 (file)
--- a/ui/common/discover-client.h
+++ b/ui/common/discover-client.h
@@ -18,6 +18,15 @@ struct pb_boot_data {
  * @device_add: PB_PROTOCOL_ACTION_ADD event callback.
  * @device_remove: PB_PROTOCOL_ACTION_REMOVE event callback.
  * @cb_arg: Client managed convenience variable passed to callbacks.
+ *
+ * The discover client holds talloc references to the devices (and the
+ * devices' boot options), so callbacks may store boot options and devices
+ * as long as the client remains allocated.
+ *
+ * The boot_status and system_info structs are allocated by the client,
+ * and will be free()ed after the callback is invoked. If the callback
+ * stores these structures for usage beyond the duration of the callback,
+ * it must talloc_steal() them.
  */
 
 struct discover_client_ops {
@@ -27,6 +36,7 @@ struct discover_client_ops {
        void (*device_remove)(struct device *device, void *arg);
        void (*update_status)(struct boot_status *status, void *arg);
        void (*update_sysinfo)(struct system_info *sysinfo, void *arg);
+       void (*update_config)(struct config *sysinfo, void *arg);
        void *cb_arg;
 };
 
@@ -65,4 +75,11 @@ int discover_client_boot(struct discover_client *client,
 /* Tell the discover server to cancel the default boot option, if any
  */
 int discover_client_cancel_default(struct discover_client *client);
+
+/* Tell the discover server to reinitialise */
+int discover_client_send_reinit(struct discover_client *client);
+
+/* Send new configuration data to the discover server */
+int discover_client_send_config(struct discover_client *client,
+               struct config *config);
 #endif