2 * Copyright (c) 2011 The Chromium OS Authors. All rights reserved.
4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public License as
6 * published by the Free Software Foundation; either version 2 of
7 * the License, or (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
24 #include <linux/compiler.h>
35 CBFS_TYPE_STAGE = 0x10,
36 CBFS_TYPE_PAYLOAD = 0x20,
37 CBFS_TYPE_OPTIONROM = 0x30,
38 CBFS_TYPE_BOOTSPLASH = 0x40,
42 CBFS_TYPE_MICROCODE = 0x53,
43 CBFS_COMPONENT_CMOS_DEFAULT = 0xaa,
44 CBFS_COMPONENT_CMOS_LAYOUT = 0x01aa
57 struct cbfs_fileheader {
65 struct cbfs_cachenode {
66 struct cbfs_cachenode *next;
75 extern enum cbfs_result file_cbfs_result;
78 * Return a string describing the most recent error condition.
80 * @return A pointer to the constant string.
82 const char *file_cbfs_error(void);
85 * Initialize the CBFS driver and load metadata into RAM.
87 * @param end_of_rom Points to the end of the ROM the CBFS should be read
90 void file_cbfs_init(uintptr_t end_of_rom);
93 * Get the header structure for the current CBFS.
95 * @return A pointer to the constant structure, or NULL if there is none.
97 const struct cbfs_header *file_cbfs_get_header(void);
100 * Get a handle for the first file in CBFS.
102 * @return A handle for the first file in CBFS, NULL on error.
104 const struct cbfs_cachenode *file_cbfs_get_first(void);
107 * Get a handle to the file after this one in CBFS.
109 * @param file A pointer to the handle to advance.
111 void file_cbfs_get_next(const struct cbfs_cachenode **file);
114 * Find a file with a particular name in CBFS.
116 * @param name The name to search for.
118 * @return A handle to the file, or NULL on error.
120 const struct cbfs_cachenode *file_cbfs_find(const char *name);
123 /***************************************************************************/
124 /* All of the functions below can be used without first initializing CBFS. */
125 /***************************************************************************/
128 * Find a file with a particular name in CBFS without using the heap.
130 * @param end_of_rom Points to the end of the ROM the CBFS should be read
132 * @param name The name to search for.
134 * @return A handle to the file, or NULL on error.
136 const struct cbfs_cachenode *file_cbfs_find_uncached(uintptr_t end_of_rom,
140 * Get the name of a file in CBFS.
142 * @param file The handle to the file.
144 * @return The name of the file, NULL on error.
146 const char *file_cbfs_name(const struct cbfs_cachenode *file);
149 * Get the size of a file in CBFS.
151 * @param file The handle to the file.
153 * @return The size of the file, zero on error.
155 u32 file_cbfs_size(const struct cbfs_cachenode *file);
158 * Get the type of a file in CBFS.
160 * @param file The handle to the file.
162 * @return The type of the file, zero on error.
164 u32 file_cbfs_type(const struct cbfs_cachenode *file);
167 * Read a file from CBFS into RAM
169 * @param file A handle to the file to read.
170 * @param buffer Where to read it into memory.
172 * @return If positive or zero, the number of characters read. If negative, an
175 long file_cbfs_read(const struct cbfs_cachenode *file, void *buffer,
176 unsigned long maxsize);
178 #endif /* __CBFS_H */