Specifications

Version 2.0
91
connect
Summary
Binds a driver to a specific device and starts the driver.
Usage
connect [[DeviceHandle] [DriverHandle] | [-c] | [-r]]
Options
-r
Recursively scan all handles and check to see if any loaded or embedded driver
can match the specified device. If so, the driver will be bound to the device.
Additionally, if more device handles are created during the binding, these
handles will also be checked to see if a matching driver can bind to these devices
as well. The process is repeated until no more drivers are able to connect to any
devices. However, without the option, the newly created device handles will not
be further bound to any drivers.
-c
Connect console devices found in the EFI global variables (see UEFI specification,
chapter 3)
DeviceHandle
Device handle (a hexadecimal number). If not specified, then all device handles
will be connected.
DriverHandle
Driver handle (a hexadecimal number). If not specified, then all matching drivers
will be bound to the specified device. If specified, then this driver will have the
highest priority.
Description
This command binds a driver to a specific device and starts the driver. If the -r flag is
used, then the connection is done recursively until no further connections between
devices and drivers are made. If the -c flag is used, then the connect command will
bind the proper drivers to the console devices that are described in the EFI
environment variables. The example below shows the typical output from the verbose
help for this command.
If only a single handle is specified and the handle has an
EFI_DRIVER_BINDING_PROTOCOL on it, then the handle is assumed to be a driver
handle. Otherwise, it is assumed to be a device handle.
If no parameters are specified, then the command will attempt to bind all proper
drivers to all devices without recursion. Each connection status will be displayed.