2009-03-31 13:57:36 +02:00
|
|
|
/*
|
2009-04-14 02:08:34 +02:00
|
|
|
* cbfstool
|
2009-03-31 13:57:36 +02:00
|
|
|
*
|
|
|
|
* Copyright (C) 2008 Jordan Crouse <jordan@cosmicpenguin.net>
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
|
|
|
* the Free Software Foundation; version 2 of the License.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License
|
|
|
|
* along with this program; if not, write to the Free Software
|
|
|
|
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA, 02110-1301 USA
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include <string.h>
|
|
|
|
#include <unistd.h>
|
|
|
|
#include <fcntl.h>
|
|
|
|
#include <sys/stat.h>
|
|
|
|
#include <sys/mman.h>
|
2009-04-14 02:08:34 +02:00
|
|
|
#include "cbfstool.h"
|
2009-03-31 13:57:36 +02:00
|
|
|
|
2009-05-17 01:05:20 +02:00
|
|
|
int uninitialized_flash_value = 0xff;
|
|
|
|
|
|
|
|
void flashinit(void *ptr, size_t len)
|
|
|
|
{
|
|
|
|
memset(ptr, uninitialized_flash_value, len);
|
|
|
|
}
|
|
|
|
|
2009-03-31 13:57:36 +02:00
|
|
|
int get_size(const char *size)
|
|
|
|
{
|
|
|
|
char *next;
|
|
|
|
int val = strtoul(size, &next, 0);
|
|
|
|
|
|
|
|
/* Support modifiers for the size kK and mM for kbytes and
|
|
|
|
mbytes respectfully */
|
|
|
|
|
|
|
|
if (next != NULL) {
|
|
|
|
if (*next == 'k' || *next == 'K')
|
|
|
|
val *= 1024;
|
|
|
|
else if (*next == 'm' || *next == 'M')
|
|
|
|
val *= (1024 * 1024);
|
|
|
|
}
|
|
|
|
|
|
|
|
return val;
|
|
|
|
}
|
|
|
|
|
|
|
|
int copy_from_fd(int fd, void *ptr, int size)
|
|
|
|
{
|
|
|
|
unsigned char *p = ptr;
|
|
|
|
|
|
|
|
while (size > 0) {
|
|
|
|
int ret = read(fd, p, size);
|
|
|
|
|
|
|
|
if (ret == -1) {
|
|
|
|
ERROR("Error while reading: %m\n");
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (ret == 0) {
|
|
|
|
ERROR("Unexpected end of file\n");
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
p += ret;
|
|
|
|
size -= ret;
|
|
|
|
}
|
|
|
|
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
int size_and_open(const char *filename, unsigned int *size)
|
|
|
|
{
|
|
|
|
struct stat s;
|
|
|
|
|
|
|
|
int fd = open(filename, O_RDONLY);
|
|
|
|
|
|
|
|
if (fd == -1) {
|
|
|
|
ERROR("Unable to open %s: %m\n", filename);
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (fstat(fd, &s)) {
|
|
|
|
ERROR("Unable to stat %s: %m\n", filename);
|
|
|
|
close(fd);
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
*size = s.st_size;
|
|
|
|
return fd;
|
|
|
|
}
|
|
|
|
|
|
|
|
int map_rom(struct rom *rom, int size)
|
|
|
|
{
|
|
|
|
rom->ptr = mmap(NULL, size, PROT_READ | PROT_WRITE, MAP_SHARED,
|
|
|
|
rom->fd, 0);
|
|
|
|
|
|
|
|
if (rom->ptr == MAP_FAILED) {
|
|
|
|
ERROR("Could not map the rom: %m\n");
|
|
|
|
rom->ptr = NULL;
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
int open_rom(struct rom *rom, const char *filename)
|
|
|
|
{
|
|
|
|
struct stat s;
|
|
|
|
unsigned long offset;
|
|
|
|
|
|
|
|
if (stat(filename, &s)) {
|
|
|
|
ERROR("Could not stat %s: %m\n", filename);
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
rom->fd = open(filename, O_RDWR);
|
|
|
|
|
|
|
|
if (rom->fd == -1) {
|
|
|
|
ERROR("Could not open %s: %m\n", filename);
|
|
|
|
rom->fd = 0;
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (map_rom(rom, s.st_size))
|
|
|
|
goto err;
|
|
|
|
|
|
|
|
/* Find the master header */
|
|
|
|
|
|
|
|
offset = ROM_READL(rom, s.st_size - 4);
|
|
|
|
|
2009-04-14 02:08:34 +02:00
|
|
|
rom->header = (struct cbfs_header *)
|
2009-03-31 13:57:36 +02:00
|
|
|
ROM_PTR(rom, s.st_size - (0xFFFFFFFF - offset) - 1);
|
|
|
|
|
|
|
|
if (ntohl(rom->header->magic) != HEADER_MAGIC) {
|
|
|
|
ERROR("This does not appear to be a valid ROM\n");
|
|
|
|
goto err;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Check that the alignment is correct */
|
|
|
|
if (ntohl(rom->header->align) == 0) {
|
|
|
|
ERROR("The alignment in the ROM is 0 - probably malformed\n");
|
|
|
|
goto err;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Sanity check that the size matches the file size */
|
|
|
|
|
|
|
|
if (ntohl(rom->header->romsize) != s.st_size) {
|
|
|
|
ERROR("The ROM size in the header does not match the file\n");
|
|
|
|
ERROR("ROM size is %d bytes, file size is %d bytes\n",
|
|
|
|
ntohl(rom->header->romsize), (unsigned int)s.st_size);
|
|
|
|
goto err;
|
|
|
|
}
|
|
|
|
|
|
|
|
rom->size = ntohl(rom->header->romsize);
|
|
|
|
rom->fssize = rom->size - ntohl(rom->header->bootblocksize);
|
|
|
|
|
|
|
|
return 0;
|
|
|
|
|
|
|
|
err:
|
|
|
|
if (rom->ptr != NULL)
|
|
|
|
munmap(rom->ptr, s.st_size);
|
|
|
|
|
|
|
|
if (rom->fd > 0)
|
|
|
|
close(rom->fd);
|
|
|
|
|
|
|
|
rom->ptr = NULL;
|
|
|
|
rom->fd = 0;
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
int create_rom(struct rom *rom, const unsigned char *filename,
|
2009-05-01 00:45:41 +02:00
|
|
|
int romsize, const char *bootblockname,
|
2009-04-25 14:39:04 +02:00
|
|
|
int bootblocksize, int align)
|
2009-03-31 13:57:36 +02:00
|
|
|
{
|
|
|
|
unsigned char null = '\0';
|
|
|
|
|
|
|
|
if (rom->fd != 0) {
|
|
|
|
ERROR("%s already exists - cannot create\n", filename);
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Remember the size of the entire ROM */
|
|
|
|
rom->size = romsize;
|
|
|
|
|
2009-04-25 14:39:04 +02:00
|
|
|
/* The size of the archive section is everything but the bootblock and
|
|
|
|
* the cbfs master header. */
|
|
|
|
rom->fssize = romsize - bootblocksize - sizeof(struct cbfs_header);
|
2009-03-31 13:57:36 +02:00
|
|
|
|
|
|
|
/* Open the file descriptor */
|
|
|
|
|
|
|
|
rom->fd = open((char *)filename, O_RDWR | O_CREAT, S_IRUSR | S_IWUSR);
|
|
|
|
|
|
|
|
if (rom->fd == -1) {
|
|
|
|
ERROR("Could not create %s: %m\n", filename);
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Size the new file appropriately */
|
|
|
|
lseek(rom->fd, romsize - 1, SEEK_SET);
|
|
|
|
write(rom->fd, &null, 1);
|
|
|
|
|
|
|
|
if (map_rom(rom, romsize)) {
|
|
|
|
close(rom->fd);
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
2009-05-17 01:05:20 +02:00
|
|
|
/* mmap'ed pages are by default zero-filled. Fix that. */
|
|
|
|
flashinit(rom->ptr, romsize);
|
|
|
|
|
2009-03-31 13:57:36 +02:00
|
|
|
/* This is a pointer to the header for easy access */
|
2009-04-14 02:08:34 +02:00
|
|
|
rom->header = (struct cbfs_header *)
|
2009-04-25 14:39:04 +02:00
|
|
|
ROM_PTR(rom, rom->size - 16 - bootblocksize - sizeof(struct cbfs_header));
|
2009-03-31 13:57:36 +02:00
|
|
|
rom->header->magic = htonl(HEADER_MAGIC);
|
|
|
|
rom->header->romsize = htonl(romsize);
|
|
|
|
rom->header->bootblocksize = htonl(bootblocksize);
|
|
|
|
rom->header->align = htonl(align);
|
|
|
|
rom->header->offset = htonl(0);
|
|
|
|
|
2009-04-25 14:39:04 +02:00
|
|
|
add_bootblock(rom, bootblockname);
|
|
|
|
|
|
|
|
/* Write the cbfs master header address at the end of the ROM. */
|
|
|
|
|
|
|
|
ROM_WRITEL(rom, rom->size - 4,
|
|
|
|
0xFFFFFFF0 - bootblocksize - sizeof(struct cbfs_header));
|
I have made a very simple mod to cbfstool that is compatible with the
src/lib/ code in coreboot. I.e. the tool changes but the coreboot code
does not.
Currently, as cbfstool manages the ROM, there are files and empty
space. To allocate files, the code does, first, a walk of the headers
and, if that fails, does a brute-force search of the rest of the
space.
We all agree that the brute-force search has lots of problems from a
performance and correctness standpoint.
I've made a slight change. Instead of an "empty space" area with no
valid headers, I've made a header for the empty space.
So cbfs creation looks like this:
- set up the boot block
- create a file, of type CBFS_COMPONENT_NULL, that contains the empty
space. CBFS_COMPONENT_NULL was already defined in cbfs.h
Here's an example:
[rminnich@xcpu2 cbfstool]$ ./cbfstool testcbfs create 1048576 2048
(cbfstool) E: Unable to open (null): Bad address
[rminnich@xcpu2 cbfstool]$ ./cbfstool testcbfs print
testcbfs: 1024 kB, bootblocksize 2048, romsize 1048576, offset 0x0
Alignment: 16 bytes
Name Offset Type Size
0x0 0xffffffff 1046456
So how do we create a new file?
It's easy: walk the files and find a file of type CBFS_COMPONENT_NULL,
which is as large
or larger than the file you are trying to create. Then you use that file.
- if the file is the same size as the NULL file, then it's easy: take it
- if the file is smaller than the NULL file, you split the NULL file
into two parts.
note that this works in the base case: the base case is that the whole
storage is CBFS_COMPONENT_NULL.
Here's an example of adding a file.
[rminnich@xcpu2 cbfstool]$ ./cbfstool testcbfs add-stage testfixed t
[rminnich@xcpu2 cbfstool]$ ./cbfstool testcbfs print
testcbfs: 1024 kB, bootblocksize 2048, romsize 1048576, offset 0x0
Alignment: 16 bytes
Name Offset Type Size
t 0x0 stage 23176
0x5ab0 0xffffffff 1023240
Note that the NULL split and got smaller. But the entire ROM is still
contained by the two files. To walk this entire rom will require two
FLASH accesses.
Add another file:
[rminnich@xcpu2 cbfstool]$ ./cbfstool testcbfs add-stage testfixed tt
[rminnich@xcpu2 cbfstool]$ ./cbfstool testcbfs print
testcbfs: 1024 kB, bootblocksize 2048, romsize 1048576, offset 0x0
Alignment: 16 bytes
Name Offset Type Size
t 0x0 stage 23176
tt 0x5ab0 stage 23176
0xb560 0xffffffff 1000024
[rminnich@xcpu2 cbfstool]$
So, taking current ROMs as an example, I can reduce FLASH accesses for
cbfs from (potentially) thousands to (typically) less than 10.
Index: fs.c
Changes for readability and cleanliness. Move common blobs of code to functions.
New function: rom_alloc,which allocates files by finding NULL files and using/splitting.
Other changes as needed to support this usage.
Index: util.c
Creating a cbfs archive now requires creation of a NULL file covering the file system space.
Index: cbfs.h
Add a DELETED file type with value 0. Any file can be marked deleted by zero its type; this is a
FLASH-friendly definition for all known FLASH types.
Signed-off-by: Ronald G. Minnich <rminnich@gmail.com>
I think it is a step in the right direction. Could you add the
function prototype to cbfstool.h?
Acked-by: Myles Watson <mylesgw@gmail.com>
(I added the prototype)
git-svn-id: svn://svn.coreboot.org/coreboot/trunk@4261 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
2009-05-08 21:23:00 +02:00
|
|
|
|
|
|
|
/* write the empty header */
|
|
|
|
rom_set_header(rom, (struct cbfs_file *)rom->ptr, "", -1, CBFS_COMPONENT_NULL);
|
2009-03-31 13:57:36 +02:00
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
int add_bootblock(struct rom *rom, const char *filename)
|
|
|
|
{
|
|
|
|
unsigned int size;
|
|
|
|
int fd = size_and_open(filename, &size);
|
|
|
|
int ret;
|
|
|
|
|
|
|
|
if (fd == -1)
|
|
|
|
return -1;
|
|
|
|
|
|
|
|
if (size > ntohl(rom->header->bootblocksize)) {
|
|
|
|
ERROR("The bootblock size is not correct (%d vs %d)\n",
|
|
|
|
size, ntohl(rom->header->bootblocksize));
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Copy the bootblock into place at the end of the file */
|
|
|
|
ret = copy_from_fd(fd, ROM_PTR(rom, rom->size - ntohl(rom->header->bootblocksize)), size);
|
|
|
|
|
|
|
|
close(fd);
|
|
|
|
|
|
|
|
if (ret) {
|
|
|
|
ERROR("Unable to add %s to the bootblock\n", filename);
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
int rom_exists(struct rom *rom)
|
|
|
|
{
|
|
|
|
if (rom->fd <= 0)
|
|
|
|
return 0;
|
|
|
|
return 1;
|
|
|
|
}
|