1 // SPDX-License-Identifier: GPL-2.0+
37  * @count	number of child controllers
49 	ret = boottime->open_protocol_information(handle, protocol,  in count_child_controllers()
56 		if (entry_buffer[--entry_count].attributes &  in count_child_controllers()
60 	ret = boottime->free_pool(entry_buffer);  in count_child_controllers()
67  * Check if the driver supports the controller.
70  * @controller_handle		handle of the controller
71  * @remaining_device_path	path specifying the child controller
82 	ret = boottime->open_protocol(  in supported()
95 	ret = boottime->close_protocol(  in supported()
107  * @controller_handle		handle of the controller
108  * @remaining_device_path	path specifying the child controller
120 	/* Attach driver to controller */  in start()
121 	ret = boottime->open_protocol(  in start()
137 		/* Creating a new handle for the child controller */  in start()
139 		ret = boottime->install_protocol_interface(  in start()
146 		ret = boottime->open_protocol(  in start()
160  * Remove a single child controller from the parent controller.
162  * @controller_handle	parent controller
163  * @child_handle	child controller
171 	ret = boottime->close_protocol(  in disconnect_child()
178 	ret = boottime->uninstall_protocol_interface(  in disconnect_child()
188  * Remove child controllers and disconnect the controller.
191  * @controller_handle		handle of the controller
192  * @number_of_children		number of child controllers to remove
220 	ret = boottime->open_protocol_information(  in stop()
228 		if (entry_buffer[--count].attributes &  in stop()
237 	ret = boottime->free_pool(entry_buffer);  in stop()
241 	/* Detach driver from controller */  in stop()
242 	ret = boottime->close_protocol(  in stop()
273 	boottime = systable->boottime;  in setup()
275 	/* Create controller handle */  in setup()
276 	ret = boottime->install_protocol_interface(  in setup()
284 	ret = boottime->install_protocol_interface(  in setup()
298  * The number of child controllers is checked after each of the following
301  * Connect a controller to a driver.
302  * Disconnect and destroy a child controller.
305  * Connect a controller to a driver.
306  * Reinstall the driver protocol on the controller.
307  * Uninstall the driver protocol from the controller.
314 	/* Connect controller to driver */  in execute()
315 	ret = boottime->connect_controller(handle_controller, NULL, NULL, 1);  in execute()
317 		efi_st_error("Failed to connect controller\n");  in execute()
320 	/* Check number of child controllers */  in execute()
324 		efi_st_error("Number of children %u != %u\n",  in execute()
327 	/* Destroy second child controller */  in execute()
328 	ret = boottime->disconnect_controller(handle_controller,  in execute()
332 		efi_st_error("Failed to disconnect child controller\n");  in execute()
335 	/* Check number of child controllers */  in execute()
338 	if (ret != EFI_SUCCESS || count != NUMBER_OF_CHILD_CONTROLLERS - 1) {  in execute()
339 		efi_st_error("Destroying single child controller failed\n");  in execute()
342 	/* Destroy remaining child controllers and disconnect controller */  in execute()
343 	ret = boottime->disconnect_controller(handle_controller, NULL, NULL);  in execute()
345 		efi_st_error("Failed to disconnect controller\n");  in execute()
348 	/* Check number of child controllers */  in execute()
356 	/* Connect controller to driver */  in execute()
357 	ret = boottime->connect_controller(handle_controller, NULL, NULL, 1);  in execute()
359 		efi_st_error("Failed to connect controller\n");  in execute()
362 	/* Check number of child controllers */  in execute()
366 		efi_st_error("Number of children %u != %u\n",  in execute()
369 	/* Try to uninstall controller protocol using the wrong interface */  in execute()
370 	ret = boottime->uninstall_protocol_interface(handle_controller,  in execute()
378 	/* Reinstall controller protocol */  in execute()
379 	ret = boottime->reinstall_protocol_interface(handle_controller,  in execute()
387 	/* Check number of child controllers */  in execute()
391 		efi_st_error("Number of children %u != %u\n",  in execute()
394 	/* Uninstall controller protocol */  in execute()
395 	ret = boottime->uninstall_protocol_interface(handle_controller,  in execute()
402 	/* Check number of child controllers */  in execute()