discover/status: Use full URL in parse status message
[petitboot] / discover / paths.h
index 26d4ce41eb2a946c8bc9f13b5e5ba7b60637f4a6..191b8dc84c6a5debcfeb3333362898f1b0d31f5a 100644 (file)
@@ -1,53 +1,53 @@
 #ifndef PATHS_H
 #define PATHS_H
 
+#include <url/url.h>
+
 /**
- * Given a string (eg /dev/sda1, sda1 or UUID=B8E53381CA9EA0E3), parse the
- * device path (eg /dev/sda1). Any device descriptions read from config files
- * should be parsed into the path first.
- *
- * The cur_dev is provided for some remapping situations. If NULL is provided,
- * no remapping will be done.
+ * Utility function for joining two paths. Adds a / between a and b if
+ * required.
  *
  * Returns a newly-allocated string.
  */
-char *parse_device_path(const char *dev_str, const char *current_device);
+char *join_paths(void *alloc_ctx, const char *a, const char *b);
 
 /**
- * Get the mountpoint for a device.
+ * Returns the base path for mount points
  */
-const char *mountpoint_for_device(const char *dev);
+const char *mount_base(void);
 
-/**
- * Resolve a path given in a config file, to a path in the local filesystem.
- * Paths may be of the form:
- *  device:path (eg /dev/sda:/boot/vmlinux)
- *
- * or just a path:
- *  /boot/vmlinux
- * - in this case, the current mountpoint is used.
- *
- * Returns a newly-allocated string containing a full path to the file in path
- */
-char *resolve_path(const char *path, const char *current_device);
+struct load_task;
 
+struct load_url_result {
+       enum {
+               LOAD_OK,    /* load complete. other members should only be
+                              accessed if status == LOAD_OK */
 
-/**
- * Set the base directory for newly-created mountpoints
- */
-void set_mount_base(const char *path);
+               LOAD_ERROR, /* only signalled to async loaders
+                            * (sync will see a NULL result) */
 
-/**
- * Utility function for joining two paths. Adds a / between a and b if
- * required.
- *
- * Returns a newly-allocated string.
- */
-char *join_paths(const char *a, const char *b);
+               LOAD_ASYNC, /* async load still in progress */
 
-/**
- * encode a disk label (or uuid) for use in a symlink.
+               LOAD_CANCELLED,
+       } status;
+       struct pb_url           *url;
+       const char              *local;
+       bool                    cleanup_local;
+       struct load_task        *task;
+};
+
+/* callback type for asynchronous loads. The callback implementation is
+ * responsible for freeing result.
  */
-char *encode_label(const char *label);
+typedef void (*load_url_complete)(struct load_url_result *result, void *data);
+
+/* Load a (potentially remote) file, and return a guaranteed-local name */
+struct load_url_result *load_url_async(void *ctx, struct pb_url *url,
+               load_url_complete complete, void *data);
+
+/* Cancel a pending load */
+void load_url_async_cancel(struct load_url_result *res);
+
+struct load_url_result *load_url(void *ctx, struct pb_url *url);
 
 #endif /* PATHS_H */