summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/Makefile2
-rw-r--r--docs/netctl-auto.1.txt90
-rw-r--r--docs/netctl.1.txt2
-rw-r--r--docs/netctl.special.7.txt6
4 files changed, 96 insertions, 4 deletions
diff --git a/docs/Makefile b/docs/Makefile
index 2fd858b..c90ead5 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -1,6 +1,6 @@
# Makefile for netctl documentation
-MANPAGES = netctl.1 netctl.profile.5 netctl.special.7
+MANPAGES = netctl.1 netctl-auto.1 netctl.profile.5 netctl.special.7
.PHONY: manpages install $(MANPAGES:=-install) clean
manpages: $(MANPAGES)
diff --git a/docs/netctl-auto.1.txt b/docs/netctl-auto.1.txt
new file mode 100644
index 0000000..1fa17d8
--- /dev/null
+++ b/docs/netctl-auto.1.txt
@@ -0,0 +1,90 @@
+NETCTL-AUTO(1)
+==============
+
+NAME
+----
+netctl-auto - Control automatic selection of wireless netctl profiles
+
+
+SYNOPSIS
+--------
+*netctl-auto* {*COMMAND*} ...
+
+*netctl-auto* [--help | --version]
+
+
+DESCRIPTION
+-----------
+*netctl-auto* may be used to control the automatic network profile selection
+offered by the 'netctl-auto@.service' file. See *netctl.special*(7) for
+details about the service file.
+
+
+OPTIONS
+-------
+The following commands are understood:
+
+*list*::
+ List all profiles which are currently available for automatic selection.
+ Active profiles will be marked with a '*', disabled profiles will be
+ marked with a '!'.
+
+*current*::
+ Report currently active profiles.
+
+*switch-to [+PROFILE+]*::
+ Switch to the network profile specified on the command line. The
+ specified profile will be enabled if necessary, the state of all other
+ profiles is not changed. This command does not force *netctl-auto* to use
+ the specified profile. If a disconnect occurs, *netctl-auto* may select
+ an alternative profile.
+
+*enable [+PROFILE+]*::
+ Enable a previously disabled network profile for automatic selection.
+ Every time the *netctl-auto* service is started, all available profiles
+ are enabled by default.
+
+*disable [+PROFILE+]*::
+ Disable the specified profile for automatic selection. This will only
+ take effect until the *netctl-auto* service is stopped.
+ To permanently exclude a profile from automatic selection, use the
+ 'ExcludeAuto=yes' option in the profile.
+
+*enable-all*::
+ Enable all profiles for automatic selection.
+
+*disable-all*::
+ Disable all profiles for automatic selection.
+
+*start [+INTERFACE+]*::
+ Start automatic profile selection on the specified interface. +
+ This command should not be invoked directly, use the following command
+ instead:
+---------------------------------------------
+ systemctl start netctl-auto@<interface>
+---------------------------------------------
+
+*stop [+INTERFACE+]*::
+ Stop automatic profile selection on the specified interface. This will
+ disconnect the currently active profile on the interface. +
+ This command should not be invoked directly, use the following command
+ instead:
+--------------------------------------------
+ systemctl stop netctl-auto@<interface>
+--------------------------------------------
+
+
+EXIT STATUS
+-----------
+On success 0 is returned, a non-zero failure code otherwise.
+
+
+ENVIRONMENT
+-----------
+'$NETCTL_DEBUG'::
+ If set to +"yes"+, debugging output is generated.
+
+
+SEE ALSO
+--------
+*netctl*(1), *netctl.profile*(5), *netctl.special*(7)
diff --git a/docs/netctl.1.txt b/docs/netctl.1.txt
index 954d62a..6440b00 100644
--- a/docs/netctl.1.txt
+++ b/docs/netctl.1.txt
@@ -89,4 +89,4 @@ ENVIRONMENT
SEE ALSO
--------
-*netctl.profile*(5), *netctl.special*(7), *systemctl*(1)
+*netctl-auto*(1), *netctl.profile*(5), *netctl.special*(7), *systemctl*(1)
diff --git a/docs/netctl.special.7.txt b/docs/netctl.special.7.txt
index 668f7b1..c61290c 100644
--- a/docs/netctl.special.7.txt
+++ b/docs/netctl.special.7.txt
@@ -48,7 +48,9 @@ netctl-auto@<interface>.service::
start a profile for a network it finds. It is targeted at wireless
interfaces. Profile specific values for WPADriver are ignored, but
it is possible to specify WPADriver in an interface hook
- ('/etc/netctl/interfaces/<interface>').
+ ('/etc/netctl/interfaces/<interface>'). +
+ Use *netctl-auto*(1) instead of *netctl(1)* to control the automatic
+ profile selection when using this unit.
netctl-ifplugd@<interface>.service::
This unit starts ifplugd on the interface it is used for. It will
@@ -59,4 +61,4 @@ netctl-ifplugd@<interface>.service::
SEE ALSO
--------
-*netctl*(1), *netctl.profile*(5)
+*netctl*(1), *netctl-auto*(1), *netctl.profile*(5)