blob: 74625b5ca2d12261879e585d7edeac83d937d540 (
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
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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
<html>
<head>
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="Content-Language" content="en" />
<title>bcnm - a better client network manager </title>
<meta name="Description" content="bcnm - a better client network manager" />
<meta name="Keywords" content="bcnm client network manager ethernet wifi laurent bercot ska skarnet networkmanager wicd connman wpa_supplicant" />
<!-- <link rel="stylesheet" type="text/css" href="//skarnet.org/default.css" /> -->
</head>
<body>
<p>
<a href="//skarnet.org/software/">Software</a><br />
<a href="//skarnet.org/">skarnet.org</a>
</p>
<h1> bcnm </h1>
<h2> What is it ? </h2>
<p>
In its final form, bcnm is a client network manager: it automatically
handles network connections for a client machine. It supports Ethernet
and Wi-Fi. IP addresses can be attributed statically or via DHCP.
</p>
<p>
However, given the existence, and work being done, on
<a href="https://github.com/ifupdown-ng/ifupdown-ng">ifupdown-ng</a>,
it is likely that not much effort will be put into the "network
manager" part of bcnm. The package as it exists today is still maintained,
because some tools rely on the programs and libraries it already
provides: a tool to wait for network interfaces to reach a
certain state, and a comfortable C API to control
<a href="https://w1.fi/wpa_supplicant/">wpa_supplicant</a>.
</p>
<hr />
<h2> Installation </h2>
<h3> Requirements </h3>
<ul>
<li> A Linux-based system with a standard C development environment </li>
<li> GNU make, version 3.81 or later </li>
<li> <a href="//skarnet.org/software/skalibs/">skalibs</a> version
2.11.0.0 or later. It's a build-time requirement. It's also a run-time
requirement if you link against the shared version of the skalibs library. </li>
</ul>
<h3> Licensing </h3>
<p>
bcnm is free software. It is available under the
<a href="https://opensource.org/licenses/ISC">ISC license</a>.
</p>
<h3> Download </h3>
<ul>
<li> The current released version of bcnm is
<a href="bcnm-0.0.1.4.tar.gz">0.0.1.4</a>. </li>
<li> Alternatively, you can checkout a copy of the
<a href="//git.skarnet.org/cgi-bin/cgit.cgi/bcnm/">bcnm
git repository</a>:
<pre> git clone git://git.skarnet.org/bcnm </pre> </li>
<li> There's also a
<a href="https://github.com/skarnet/bcnm">GitHub mirror</a>
of the bcnm git repository. </li>
</ul>
<h3> Compilation </h3>
<ul>
<li> See the enclosed INSTALL file for installation details. </li>
</ul>
<h3> Upgrade notes </h3>
<ul>
<li> <a href="upgrade.html">This page</a> lists the differences to be aware of between
the previous versions of bcnm and the current one. </li>
</ul>
<hr />
<h2> Reference </h2>
<h3> Commands </h3>
<p>
All these commands exit 111 if they encounter a temporary error, and
100 if they encounter a permanent error - such as a misuse.
</p>
<ul>
<li> <a href="bcnm-waitif.html">The <tt>bcnm-waitif</tt> program</a> </li>
</ul>
<h3> Libraries </h3>
<ul>
<li> <a href="libwpactrl/">The <tt>wpactrl</tt> library interface</a> </li>
</ul>
<h2> Related resources </h2>
<ul>
<li> <tt>bcnm</tt> is discussed on the
<a href="//skarnet.org/lists/#skaware">skaware</a> mailing-list. </li>
</ul>
</body>
</html>
|
