搜尋此網誌

2011年5月30日 星期一

EFI Shell commands -- CONNECT(連結一個或多個EFI驅動程式到一個裝置)

Connects one or more EFI drivers to a device.

CONNECT [[DeviceHandle] [DriverHandle] | [-c] | [-r]]


    DeviceHandle - Device handle in hexadecimal format
    DriverHandle - Driver handle in hexadecimal format
    -c           - Connect console devices
    -r           - Connect recursively

Note:
    1. If no 'DeviceHandle' parameter is specified, all device handles in the
       current system will be the default.
    2. If no 'DriverHandle' parameter is specified, all matched drivers will be
       bound to the specified device.
    3. If 'DriverHandle' parameter is provided, the specified driver will have
       highest priority on connecting the device(s).
    4. If the '-c' option is specified, only console devices described in the
       EFI Shell environment variables and related devices will be connected.
    5. If the '-r' option is specified, the command will 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.
    6. 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.
    7. 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.
    8. 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
    ConnectController(1) : Status = Success
    ConnectController(2) : Status = Success
    ConnectController(3) : Status = Success
    ...
    ConnectController(3D) : Status = Success

  * 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 they can
    manage:
    Shell> connect 19 17

  * To connect console devices described in the EFI Shell environment
    variables:
    Shell> connect -c

沒有留言:

張貼留言