grub-lakitu/include/grub/verify.h

#include <grub/file.h>
#include <grub/list.h>

enum grub_verify_flags
  {
    GRUB_VERIFY_FLAGS_SKIP_VERIFICATION = 1,
    GRUB_VERIFY_FLAGS_SINGLE_CHUNK = 2,
  };

enum grub_verify_string_type
  {
    GRUB_VERIFY_KERNEL_CMDLINE,
    GRUB_VERIFY_MODULE_CMDLINE,
  };

struct grub_file_verifier
{
  struct grub_file_verifier *next;
  struct grub_file_verifier **prev;

  const char *name;

  /* Check if file needs to be verified and set up context.  */
  /* init/read/fini is structured in the same way as hash interface.  */
  grub_err_t (*init) (grub_file_t io, enum grub_file_type type,
		      void **context, enum grub_verify_flags *verify_flags);
  /* Right now we pass the whole file in one call but it
     will change in the future. If you insist on single buffer we can
     you need to set GRUB_VERIFY_FLAGS_SINGLE_CHUNK in verify_flags.
  */
  grub_err_t (*write) (void *context, void *buf, grub_size_t sz);
  grub_err_t (*fini) (void *context);
  void (*close) (void *context);

  grub_err_t (*verify_string) (char *str, enum grub_verify_string_type type);
};

extern struct grub_file_verifier *grub_file_verifiers;

static inline void
grub_verifier_register (struct grub_file_verifier *ver)
{
  grub_list_push (GRUB_AS_LIST_P (&grub_file_verifiers), GRUB_AS_LIST (ver));
}

static inline void
grub_verifier_unregister (struct grub_file_verifier *ver)
{
  grub_list_remove (GRUB_AS_LIST (ver));
}

grub_err_t
grub_verify_string (char *str, enum grub_verify_string_type type);