iface Command
=============

The `iface` command allows you to manage drivers in the system, including listing, adding, and removing drivers. It provides an interface for interacting with drivers, configuring their properties, and managing their relationships.

Usage
-----
The basic syntax for the `iface` command is as follows:

.. code-block::

    iface <operation> [options]

Arguments
----------

- `operation`: (Required) The specific operation to perform on drivers. This can be one of the following:
  - `list`: List all drivers in the system.
  - `add`: Add a new driver to the system.
  - `remove`: Remove a driver from the system.

Options
-------
The following options can be used with specific operations:

- `-n <name>`: Specify the driver name (only valid with `add`).
- `-p <parent>`: Specify the parent driver (only valid with `add`).
- `-t <type>`: Specify the driver type (only valid with `add`).
- `--<option>`: Additional configuration options for the driver (only valid with `add`).

Description
-----------
The `iface` command allows you to interact with drivers within the system. The available operations are:

1. **List Drivers**: Displays a list of all drivers currently in the system.
2. **Add Driver**: Adds a new driver to the system, specifying its name, parent, type, and optional configuration.
3. **Remove Driver**: Removes a specified driver from the system.

Each operation may require additional parameters such as the driver name, parent, and type.

Examples
--------

1. **List all drivers:**

   .. code-block::

       iface list

   This will display a list of all drivers in the system.

2. **Add a new driver:**

   .. code-block::

       iface add -n myDriver -p parentDriver -t sensor --config-option value

   This will add a new driver with the name `myDriver`, parent `parentDriver`, type `sensor`, and the specified configuration option.

3. **Remove a driver:**

   .. code-block::

       iface remove -n myDriver

   This will remove the driver named `myDriver` from the system.

Error Handling
--------------
If there is an error with the input or execution, the following error messages may be shown:

- **"Invalid parameters supplied"**: This error occurs if the parameters provided for adding a driver are incomplete or invalid.
- **"ERROR: <operation status>"**: This error occurs if the driver could not be added due to an issue during the driver creation process.
- **"Invalid operation requested"**: This error occurs if an unsupported operation is requested.

Notes
-----
- The `add` operation requires the `-n`, `-p`, and `-t` options to specify the driver’s name, parent, and type.
- The `--<option>` allows additional driver configuration. Each driver may have specific configuration options.
- When adding a driver, ensure that the parameters are properly set to avoid errors during driver creation.

See Also
--------
- `driver`: For driver-specific commands and operations.