--- client/iwctl.rst | 50 ++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 48 insertions(+), 2 deletions(-) diff --git a/client/iwctl.rst b/client/iwctl.rst index 51873965..54af4b7d 100644 --- a/client/iwctl.rst +++ b/client/iwctl.rst @@ -16,12 +16,58 @@ Internet wireless control utility SYNOPSIS ======== -**iwctl** [*options* ...] +**iwctl** [*options* ...] [*commands* ...] DESCRIPTION =========== -Tool for configuring **iwd** daemon via D-Bus interface. +Tool for configuring **iwd** daemon via D-Bus interface. It supports both an +interactive mode and command line mode. + +OPTIONS +======= + +--username, -u Provide username. +--password, -p Provide password. +--passphrase, -P Provide passphrase. +--dont-ask, -v Don’t ask for missing credentials. +--help, -h Show help message and exit. + +EXAMPLES +======== + +Interactive mode +---------------- + +To start an interactive mode and list all available commands do: +.. code-block:: + + $ iwctl + [iwd]# help + +To connect to a network: +.. code-block:: + + [iwd]# device list + [iwd]# station DEVICE scan + [iwd]# station DEVICE get-networks + [iwd]# station DEVICE connect SSID + +Command line mode +---------------------- + +To list all available commands in command line mode and exit do: +.. code-block:: + + $ iwctl --help + +To connect to a network: +.. code-block:: + + $ iwctl device list + $ iwctl station DEVICE scan + $ iwctl station DEVICE get-networks + $ iwctl --passphrase=PASSPHRASE station DEVICE connect SSID SEE ALSO ======== -- 2.13.6