u-boot.git/include/os.h, branch v2021.07

sandbox: document parameters of os_realloc()

2021-04-06T04:33:19+00:00

Avoid 'make htmldocs' build warnings:

    ./include/os.h:139: warning:
    Function parameter or member 'ptr' not described in 'os_realloc'
    ./include/os.h:139: warning:
    Function parameter or member 'length' not described in 'os_realloc'

Fixes: 14e46dfb176b ("sandbox: Add os_realloc()")
Signed-off-by: Heinrich Schuchardt 
Reviewed-by: Simon Glass

sandbox: Update os_find_u_boot() to find the .img file

2021-03-12T14:57:31+00:00

At present this function can only locate the u-boot ELF file. For SPL it
is handy to be able to locate u-boot.img since this is what would normally
be loaded by SPL.

Add another argument to allow this to be selected.

While we are here, update the function to load SPL when running in TPL,
since that is the next stage.

Signed-off-by: Simon Glass

sandbox: Avoid using malloc() for system state

2021-03-02T20:53:37+00:00

This state is not accessible to the running U-Boot but at present it is
allocated in the emulated SDRAM. This doesn't seem very useful. Adjust
it to allocate from the OS instead.

The RAM buffer is currently not freed, but should be, so add that into
state_uninit(). Update the comment for os_free() to indicate that NULL is
a valid parameter value.

Note that the strdup() in spl_board_load_image() is changed as well, since
strdup() allocates memory in the RAM buffer.

Signed-off-by: Simon Glass

sandbox: Add os_realloc()

2021-03-02T20:53:37+00:00

We provide os_malloc() and os_free() but not os_realloc(). Add this,
following the usual semantics. Also update os_malloc() to behave correctly
when passed a zero size.

Signed-off-by: Simon Glass 
Reviewed-by: Heinrich Schuchardt

sandbox: mark os_abort() as noreturn

2021-02-03T10:38:41+00:00

gcc -fanalyzer needs the information that a function does not return to
provide accurate information.

os_abort() does not return. Mark it accordingly.

Signed-off-by: Heinrich Schuchardt 
Reviewed-by: Simon Glass

sandbox: keep time offset when resetting

2021-01-30T21:25:42+00:00

The UEFI Self Certification Test (SCT) checks the SetTime() service with
the following steps:

* set date
* reset
* check date matches

To be compliant the sandbox should keep the offset to the host RTC during
resets. The implementation uses the environment variable
UBOOT_SB_TIME_OFFSET to persist the offset.

Signed-off-by: Heinrich Schuchardt 
Reviewed-by: Simon Glass

sandbox: add handler for exceptions

2020-12-13T14:58:17+00:00

Add a handler for SIGILL, SIGBUS, SIGSEGV.

When an exception occurs print the program counter and the loaded
UEFI binaries and reset the system if CONFIG_SANDBOX_CRASH_RESET=y
or exit to the OS otherwise.

Signed-off-by: Heinrich Schuchardt 
Reviewed-by: Simon Glass

sandbox: update function descriptions in os.h

2020-11-05T16:11:31+00:00

Use Sphinx style function descriptions.

Signed-off-by: Heinrich Schuchardt 
Reviewed-by: Simon Glass

sandbox: implement reset

2020-11-05T16:11:30+00:00

Up to now the sandbox would shutdown upon a cold reset request. Instead it
should be reset.

In our coding we use static variables like LIST_HEAD(efi_obj_list). A reset
can occur at any time, e.g. via an UEFI binary calling the reset service.
The only safe way to return to an initial state is to relaunch the U-Boot
binary.

The reset implementation uses execv() to relaunch U-Boot.

Signed-off-by: Heinrich Schuchardt 
Reviewed-by: Simon Glass

sandbox: Drop os_realloc()

2020-02-06T02:33:46+00:00

Due to recent changes this function is no-longer used. Drop it.

Signed-off-by: Simon Glass