Commit 093a89d4 authored by Alan Tull's avatar Alan Tull Committed by Greg Kroah-Hartman

fpga: fpga-region: comment on fpga_region_program_fpga locking

Add a comment to the header of fpga_region_program_fpga()
regarding locking of the bridges.
Signed-off-by: default avatarAlan Tull <atull@kernel.org>
Signed-off-by: default avatarMoritz Fischer <mdf@kernel.org>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 88fb3a00
...@@ -95,6 +95,11 @@ static void fpga_region_put(struct fpga_region *region) ...@@ -95,6 +95,11 @@ static void fpga_region_put(struct fpga_region *region)
* fpga_region_program_fpga - program FPGA * fpga_region_program_fpga - program FPGA
* @region: FPGA region * @region: FPGA region
* Program an FPGA using fpga image info (region->info). * Program an FPGA using fpga image info (region->info).
* If the region has a get_bridges function, the exclusive reference for the
* bridges will be held if programming succeeds. This is intended to prevent
* reprogramming the region until the caller considers it safe to do so.
* The caller will need to call fpga_bridges_put() before attempting to
* reprogram the region.
* Return 0 for success or negative error code. * Return 0 for success or negative error code.
*/ */
int fpga_region_program_fpga(struct fpga_region *region) int fpga_region_program_fpga(struct fpga_region *region)
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment