-
Notifications
You must be signed in to change notification settings - Fork 0
/
bond-dummy-enslave.8
90 lines (90 loc) · 2.51 KB
/
bond-dummy-enslave.8
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
.\" Copyright (c) 2018 StorPool
.\" All rights reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License, version 2,
.\" as published by the Free Software Foundation.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\"
.Dd November 1, 2018
.Dt BOND-DUMMY-ENSLAVE 8
.Os
.Sh NAME
.Nm bond-dummy-enslave
.Nd add a dummy interface to a bond one when the latter is ready
.Sh SYNOPSIS
.Nm
.Ar bond-ifname dummy-ifname
.Sh DESCRIPTION
The
.Nm
utility makes sure that a dummy network interface is added to
a bond interface at the correct time; namely, after the initial setup of
the bond interface has been completed.
The
.Nm
utility is not meant to be started directly; it should be invoked from
the dummy interface's
.Va pre-up
command as defined in the
.Xr interfaces 5
configuration file.
Thus, it will be automatically invoked by the
.Xr ifup 8
tool as part of the system startup sequence or, later, if the dummy
interface should be brought up (again) for any reason.
The system administrator must make sure that the
.Xr interfaces 5
file contains an invocation of the
.Nm
utility with the names of the bond interface and the dummy one as
its first and second argument respectively.
.Sh ENVIRONMENT
The operation of the
.Nm
utility is not directly influenced by any environment variables.
.Sh FILES
The
.Nm
utility waits for the bond interface to be configured by periodically
polling for the existence of the
.Pa /run/network/ifenslave.<ifname>
marker file.
.Sh EXAMPLES
A line similar to the following should be part of the configuration of
the dummy interface in the
.Xr interfaces 5
file:
.Pp
.Dl pre-up bond-dummy-enslave bond0 dummy0
.Pp
.Sh DIAGNOSTICS
.Ex -std
.Sh SEE ALSO
.Xr interfaces 5 ,
.Xr ifup 8
.Sh STANDARDS
No standards were harmed during the production of the
.Nm
utility.
.Sh HISTORY
The
.Nm
utility was written as part of the
.Tn StorPool
distributed storage software in 2018.
.Sh AUTHORS
.An StorPool support
.Sh BUGS
No, thank you :)
But if you should actually find any, please report them to
.Tn StorPool .