connect

Syntax

connect[[devicehandle][driverhandle]|[-c]|[-r]]

Description

Binds a driver to a specific device and starts the driver.

Options

devicehandle

Specifies a device handle in hexadecimal format.

driverhandle

Specifies a driver handle in hexadecimal format.

-c

Connects only the console devices described in UEFI Shell environment variables and related devices.

-r

Connects console devices recursively.

Usage

If a devicehandle is not specified, all device handles in the current system are the default.

If driverhandle is not specified, all matched drivers are bound to the specified device. If driverhandle is specified, it is given highest priority on connecting the specified devices. If the –r option is specified, all handles are recursively scanned to see if any loaded or embedded driver matches the specified device. Additionally, if more device handles are created during the binding, these handles are also checked to see if a matching driver can bind to the specified devices. This process is repeated until no more drivers are able to connect to any devices.

If the –r option is not specified, newly-created device handles are not bound further to any drivers. If only a single handle is specified and the handle has an EFI_DRIVER_BINDING_PROTOCOL, the handle is assumed to be a driver handle. Otherwise, it is assumed to be a device handle. If no parameters are specified, the command attempts to bind all proper drivers to all devices without recursion and each connection status is displayed. Output redirection is not supported for connect –r usage.

Examples

To connect all drivers to all devices recursively:

Shell> connect -r

To display all connections:

Shell> connect

To connect drivers with 0x17 as highest priority to all the devices they can manage:

Shell> connect 17

To connect all possible drivers to device 0x19:

Shell> connect 19

To connect drivers with 0x17 as highest priority to device 0x19:

Shell> connect 19 17

To connect console devices described in the UEFI Shell environment variables:

Shell> connect -c