X-Git-Url: http://git.ozlabs.org/?p=petitboot;a=blobdiff_plain;f=ui%2Fcommon%2Fdiscover-client.h;h=542a275bbc6230095cd93c1122125f2ae7dca085;hp=d2a8fc4c15001002ab38d6c1851bb4c1ca72a6cf;hb=254c2c4233377ba71d0f1c96a77d885c91f9ad4a;hpb=47a9f94bb346817b6767d5dac578a43beee47c1f diff --git a/ui/common/discover-client.h b/ui/common/discover-client.h index d2a8fc4..542a275 100644 --- a/ui/common/discover-client.h +++ b/ui/common/discover-client.h @@ -1,39 +1,50 @@ #ifndef _DISCOVER_CLIENT_H #define _DISCOVER_CLIENT_H -#include +#include +#include struct discover_client; +struct pb_boot_data { + char *image; + char *initrd; + char *dtb; + char *args; +}; + /** * struct discover_client_ops - Application supplied client info. * @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 { - int (*device_add)(const struct device *device, void *arg); - void (*device_remove)(const struct device *device, void *arg); + int (*device_add)(struct device *device, void *arg); + int (*boot_option_add)(struct device *dev, struct boot_option *option, + void *arg); + 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; }; -struct discover_client *discover_client_init( +struct discover_client *discover_client_init(struct waitset *waitset, const struct discover_client_ops *ops, void *cb_arg); -int discover_client_get_fd(const struct discover_client *client); - void discover_client_destroy(struct discover_client *client); -/** - * Process data from the server. - * - * Will read from the client socket, and call device_add on any discovered - * devices. - * - */ -int discover_client_process(struct discover_client *client); - /** * Get the number of devices that the discover client has stored. This * is the set of devices that have been added and not removed @@ -51,4 +62,33 @@ int discover_client_device_count(struct discover_client *client); */ struct device *discover_client_get_device(struct discover_client *client, int index); + +/* Tell the discover server to boot an image + * @param client A pointer to the discover client + * @param boot_command The command to boot + */ +int discover_client_boot(struct discover_client *client, + const struct device *device, + const struct boot_option *boot_option, + const struct pb_boot_data *data); + +/* 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); + +/* Re-enumerate the collected devices & boot options, calling ops->device_add + * and ops->boot_option_add on each. + */ +void discover_client_enumerate(struct discover_client *client); + +/* Send url to config to the discover server */ +int discover_client_send_url(struct discover_client *client, char *url); + #endif