1 /* fs.h - filesystem manager */
3 * GRUB -- GRand Unified Bootloader
4 * Copyright (C) 2002,2003,2004,2007,2008,2009 Free Software Foundation, Inc.
6 * GRUB is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
11 * GRUB is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with GRUB. If not, see <http://www.gnu.org/licenses/>.
20 #ifndef GRUB_FS_HEADER
21 #define GRUB_FS_HEADER 1
23 #include <grub/device.h>
24 #include <grub/symbol.h>
25 #include <grub/types.h>
27 #include <grub/list.h>
28 /* For embedding types. */
30 #include <grub/partition.h>
33 /* Forward declaration is required, because of mutual reference. */
36 struct grub_dirhook_info
40 unsigned case_insensitive
:1;
46 typedef int (*grub_fs_dir_hook_t
) (const char *filename
,
47 const struct grub_dirhook_info
*info
,
50 /* Filesystem descriptor. */
53 /* The next filesystem. */
55 struct grub_fs
**prev
;
60 /* Call HOOK with each file under DIR. */
61 grub_err_t (*dir
) (grub_device_t device
, const char *path
,
62 grub_fs_dir_hook_t hook
, void *hook_data
);
64 /* Open a file named NAME and initialize FILE. */
65 grub_err_t (*open
) (struct grub_file
*file
, const char *name
);
67 /* Read LEN bytes data from FILE into BUF. */
68 grub_ssize_t (*read
) (struct grub_file
*file
, char *buf
, grub_size_t len
);
70 /* Close the file FILE. */
71 grub_err_t (*close
) (struct grub_file
*file
);
73 /* Return the label of the device DEVICE in LABEL. The label is
74 returned in a grub_malloc'ed buffer and should be freed by the
76 grub_err_t (*label
) (grub_device_t device
, char **label
);
78 /* Return the uuid of the device DEVICE in UUID. The uuid is
79 returned in a grub_malloc'ed buffer and should be freed by the
81 grub_err_t (*uuid
) (grub_device_t device
, char **uuid
);
83 /* Get writing time of filesystem. */
84 grub_err_t (*mtime
) (grub_device_t device
, grub_int32_t
*timebuf
);
87 /* Determine sectors available for embedding. */
88 grub_err_t (*embed
) (grub_device_t device
, unsigned int *nsectors
,
89 unsigned int max_nsectors
,
90 grub_embed_type_t embed_type
,
91 grub_disk_addr_t
**sectors
);
93 /* Whether this filesystem reserves first sector for DOS-style boot. */
94 int reserved_first_sector
;
96 /* Whether blocklist installs have a chance to work. */
97 int blocklist_install
;
100 typedef struct grub_fs
*grub_fs_t
;
102 /* This is special, because block lists are not files in usual sense. */
103 extern struct grub_fs grub_fs_blocklist
;
105 /* This hook is used to automatically load filesystem modules.
106 If this hook loads a module, return non-zero. Otherwise return zero.
107 The newly loaded filesystem is assumed to be inserted into the head of
108 the linked list GRUB_FS_LIST through the function grub_fs_register. */
109 typedef int (*grub_fs_autoload_hook_t
) (void);
110 extern grub_fs_autoload_hook_t
EXPORT_VAR(grub_fs_autoload_hook
);
111 extern grub_fs_t
EXPORT_VAR (grub_fs_list
);
113 #ifndef GRUB_LST_GENERATOR
115 grub_fs_register (grub_fs_t fs
)
117 grub_list_push (GRUB_AS_LIST_P (&grub_fs_list
), GRUB_AS_LIST (fs
));
122 grub_fs_unregister (grub_fs_t fs
)
124 grub_list_remove (GRUB_AS_LIST (fs
));
127 #define FOR_FILESYSTEMS(var) FOR_LIST_ELEMENTS((var), (grub_fs_list))
129 grub_fs_t
EXPORT_FUNC(grub_fs_probe
) (grub_device_t device
);
131 #endif /* ! GRUB_FS_HEADER */