u-boot.git/include/blk.h, branch master

block: Remove blk_find_first/next

2025-07-23T23:37:14+00:00

In [0], Andrew noted a code quality issue in the implementation of
blk_find_first and blk_find_next. This led to the observation that the
logic of these functions was also likely incorrect, and based on a quick
check it seemed the functions were unused outside of test code, which
did not exercise the potential failure case, so we felt they should be
removed. In [1], a test patch which illustrates the failure in sandbox
is provided for reference.

Because a more thorough check agrees that these functions are unused,
they are currently incorrect, and fixed/removable flags on block devices
prior to probe are unreliable, just remove these functions instead of
fixing them. All potential users should have used blk_first_device_err
instead anyway.

CI results at [2].

[0] https://patchwork.ozlabs.org/project/uboot/patch/20250714-blk-uclass-v1-1-d21428c5f762@linaro.org/
[1] https://gist.github.com/gmalysa/b05e73a5c14bc18c5741a0e0e06a2992
[2] https://gitlab.com/gmalysa/lnxdsp-u-boot/-/pipelines/1931210857

Signed-off-by: Greg Malysa 
Reviewed-by: Andrew Goodbody

block: make blk_create_device() static

2024-10-24T17:20:58+00:00

There are no users of the blk_create_device() function outside the uclass.
Let's make it static. This will ensure that new block drivers will use
blk_create_devicef().

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

blk: Make functions available unconditionally

2024-10-18T20:10:21+00:00

Some boards still don't enable BLK but we want to be able to at least
compile the code which relies on this. For example, bootstd includes
calls to blk_...() functions, albeit with a check for BLK so that the
code is eliminated by the compiler.

Reduce the scope of the BLK #ifdef to help with this.

Signed-off-by: Simon Glass

blk: Correct comment for blk_get_devnum_by_uclass_idname()

2024-08-23T21:58:42+00:00

Update the comment to match the function. Fix the indentation while we
are here.

Signed-off-by: Simon Glass 
Reviewed-by: Sean Anderson 
Reviewed-by: Quentin Schulz

rockchip: block: blk-uclass: add bounce buffer flag to blk_desc

2023-10-24T07:55:17+00:00

Currently bounce buffer support is enabled for all block devices
when available. Add a flag to blk_desc to enable only on demand.

Signed-off-by: Johan Jonker 
Reviewed-by: Simon Glass 
Reviewed-by: Kever Yang

dm: blk: Drop blk_{read,write}_devnum()

2023-10-10T20:25:48+00:00

blk_{read,write}_devnum() are no longer used by anywhere in the
source tree. Drop them.

Signed-off-by: Bin Meng 
Reviewed-by: Simon Glass

dm: blk: Rename get_desc() and make it externally visible

2023-10-10T20:25:48+00:00

get_desc() can be useful outside blk-uclass.c. Let's change it to
an API and make it externally visible.

Signed-off-by: Bin Meng 
Reviewed-by: Simon Glass

blk: Use a macro for the typical block size

2023-10-10T20:19:29+00:00

Avoid using the magic number 512 directly.

Signed-off-by: Bin Meng 
Reviewed-by: Simon Glass

blkcache: Remove unused NEEDS_MANUAL_RELOC code bits

2023-09-14T14:42:24+00:00

The last user of the NEEDS_MANUAL_RELOC has been removed in commit
26af162ac8f8 ("arch: m68k: Implement relocation")
Remove now unused NEEDS_MANUAL_RELOC code.

Signed-off-by: Marek Vasut

blk: Add bounce buffer support to read/write operations

2023-08-22T19:17:53+00:00

Some devices have limited DMA capabilities and require that the
buffers passed to them fit specific properties. Add new optional
callback which can be used at driver level to indicate whether a
buffer alignment is suitable for the device DMA or not, and
trigger use of generic bounce buffer implementation to help use
of unsuitable buffers at the expense of performance degradation.

Signed-off-by: Marek Vasut