summaryrefslogtreecommitdiffstats
path: root/docs/netctl.special.7.txt
blob: c61290c59a375693e0c73f42257cd914ba060984 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
NETCTL.SPECIAL(7)
=================

NAME
----
netctl.special - Special netctl systemd units


SYNOPSIS
--------
netctl.service, netctl-auto.service, netctl-ifplugd.service


DESCRIPTION
-----------
Bundled with netctl come a few systemd units that are not controlled
through the netctl command. They can be used through the systemctl
utility of systemd.


SPECIAL UNITS
-------------
netctl.service::
    When started, this unit tries to start the profiles that were
    running when the unit was last stopped. In some cases, the interface
    a profile binds to might not be available yet, when netctl.service
    tries to bring a profile up. A simple, hackish, solution is to do:
--------------------------------------------------------------------
echo "[[ -t 0 ]] || sleep 3" > /etc/netctl/interfaces/<interface>
chmod 755 /etc/netctl/interfaces/<interface>
--------------------------------------------------------------------
    A more concise solution is to first enable a profile through netctl
    and then disable it again through systemctl:
--------------------------------------------------------------------
netctl enable <profile>
systemctl disable netctl@<profile>
--------------------------------------------------------------------
    This way the unit configuration file for the profile remains in
    existence, while the profile is not enabled.

netctl-sleep.service::
    When enabled, this unit stores and stops the active network profiles
    before the machine is put to sleep. After the system is resumed,
    previously stored profiles are restarted.

netctl-auto@<interface>.service::
    This unit issues a scan on the interface it is used for and tries to
    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>'). +
    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
    try to start a netctl profile whenever a cable is plugged into the
    interface and stop the profile when the cable is unplugged. Note
    that this unit does not provide network.target.


SEE ALSO
--------
*netctl*(1), *netctl-auto*(1), *netctl.profile*(5)