+#ifndef _PARSER_H
+#define _PARSER_H
-#ifndef _PARSERS_H
-#define _PARSERS_H
+#include <stdbool.h>
+#include <sys/types.h>
+#include <sys/stat.h>
+#include <unistd.h>
+#include <dirent.h>
-#include <stdarg.h>
-#include "message.h"
+#include "device-handler.h"
+struct discover_context;
+struct device_handler;
+struct resource;
+
+/**
+ * Our config parser.
+ *
+ * Each parser is responsible for creating discover_boot_options from config
+ * files found on new devices. The boot items discovered during parse will have
+ * 'resources' attached (see @discover_boot_option), which may already be
+ * resolved (in the case of a device-local filename, or a URL), or unresolved
+ * (in the case of a filename on another device).
+ *
+ * If the boot option contains references to unresolved resources, the
+ * device handler will not inform clients about the boot options, as
+ * they're not properly "available" at this stage. The handler will attempt to
+ * resolve them whenever new devices are discovered, by calling the parser's
+ * resolve_resource function. Once a boot option's resources are full resolved,
+ * the option can be sent to clients.
+ */
struct parser {
- char *name;
- int priority;
- int (*parse)(const char *device);
- struct parser *next;
+ char *name;
+ int (*parse)(struct discover_context *ctx);
+ bool (*resolve_resource)(
+ struct device_handler *handler,
+ struct resource *res);
};
enum generic_icon_type {
ICON_TYPE_UNKNOWN
};
-#define streq(a,b) (!strcasecmp((a),(b)))
-
-/* general functions provided by parsers.c */
-void iterate_parsers(const char *devpath, const char *mountpoint);
-
-void free_device(struct device *dev);
-void free_boot_option(struct boot_option *opt);
-
-const char *generic_icon_file(enum generic_icon_type type);
+struct parser_found_file {
+ const char *filename;
+ unsigned ino;
+ struct list_item list;
+};
-/* functions provided by udev-helper or the test wrapper */
-void pb_log(const char *fmt, ...);
+#define streq(a,b) (!strcasecmp((a),(b)))
-int mount_device(const char *dev_path);
+void parser_init(void);
-char *resolve_path(const char *path, const char *current_dev);
-const char *mountpoint_for_device(const char *dev_path);
+void iterate_parsers(struct discover_context *ctx);
+int parse_user_event(struct discover_context *ctx, struct event *event);
-enum generic_icon_type guess_device_type(void);
+/* File IO functions for parsers; these should be the only interface that
+ * parsers use to access a device's filesystem.
+ *
+ * These are intended for small amounts of data, typically text
+ * configuration and state files. Note that parser_request_file,
+ * and parser_replace_file work only on non-directories.
+ */
+int parser_request_file(struct discover_context *ctx,
+ struct discover_device *dev, const char *filename,
+ char **buf, int *len);
+int parser_replace_file(struct discover_context *ctx,
+ struct discover_device *dev, const char *filename,
+ char *buf, int len);
+int parser_request_url(struct discover_context *ctx, struct pb_url *url,
+ char **buf, int *len);
+/* parser_stat_path returns 0 if path can be stated on dev by the
+ * running user. Note that this function follows symlinks, like the
+ * stat system call. When the function returns 0, also fills in
+ * statbuf for the path. Returns non-zero on error. This function
+ * does not have the limitations on file size that the functions above
+ * do. Unlike some of the functions above, this function also works
+ * on directories. */
+int parser_stat_path(struct discover_context *ctx,
+ struct discover_device *dev, const char *path,
+ struct stat *statbuf);
+/* Function used to list the files on a directory. The dirname should
+ * be relative to the discover context device mount path. It returns
+ * the number of files returned in files or a negative value on error.
+ */
+int parser_scandir(struct discover_context *ctx, const char *dirname,
+ struct dirent ***files, int (*filter)(const struct dirent *),
+ int (*comp)(const struct dirent **, const struct dirent **));
-int add_device(const struct device *dev);
-int add_boot_option(const struct boot_option *opt);
+/* parser_is_unique - Test a file against a list of known files.
+ * If the file @filename exists and the file is not in @found_list add the
+ * file to @found_list and return true. Use when searching case-insensitive
+ * filesystems.
+ */
+bool parser_is_unique(struct discover_context *ctx, struct discover_device *dev, const char *filename,
+ struct list *found_list);
-#endif /* _PARSERS_H */
+#endif /* _PARSER_H */
projects / petitboot / blobdiff