File: driver-control.txt

package info (click to toggle)
nut 0.45.5-rel-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 1,984 kB
  • ctags: 2,146
  • sloc: ansic: 22,216; sh: 1,138; makefile: 405
file content (95 lines) | stat: -rw-r--r-- 2,685 bytes parent folder | download
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
Name: Automatic driver control
File: driver-control.txt
Date: 25 February 2002
Auth: Russell Kroll <rkroll@exploits.org>

Distributors, rejoice.  You no longer need to maintain configuration
information in two places.  By this I mean the existing scheme where
you have to list the driver(s) in startup scripts *and* in the
upsd.conf.  Some distributions have tackled this by ripping the data
out of upsd.conf.  You no longer need to do this.

upsdrvctl now offers a standard interface to all of the unified drivers. 
To start your drivers, you edit the ups.conf to reflect the system's 
configuration, then just run upsdrvctl:

	/path/to/upsdrvctl start

That's it.  upsdrvctl parses the .conf, and calls the individual drivers
with the new -a (autoconfig) option to get them running.

You can also do "stop" and "status" to check all of them, or tack on a
UPS name to perform the action on just one.  As of 0.45.4, "shutdown" is
also supported, so the manual calls to "<driver> -k <port>" can be
removed from your shutdown scripts.

upsd now also suports using ups.conf for configuration data, and the older
support for "UPS blah /var/state/foo" lines in upsd.conf will eventually
be removed.  At that point, you will have to use ups.conf for all UPS
definitions.

The rub
-------

Nothing is ever simple.  The problem here is that the majority of the
drivers are not yet using the unified structure where main.c has control
and the actual driver.c is just a bunch of support functions. 

The old drivers do not support -a, so they can't be used with this system
yet.  It is imperative that we start converting them to make this work for
everyone.

Note: no patches will be accepted to hack -a support into old drivers.
Convert them.

At the time of this writing, these drivers have been converted or created
with this design:

	- apcsmart
	- belkin
	- bestuferrups801-807
	- bestups
	- cyberpower
	- everups
	- fentonups
	- genericups
	- hidups
	- masterguard
	- mge-ellipse
	- newapc
	- newpowercom
	- newvictron
	- sec
	- tripplite

If you are using an old driver, you can still use ups.conf for the 
purposes of configuring upsd, but upsdrvctl will not work.

Drivers that are being converted 
--------------------------------

	- no known projects at this time

What needs to be converted
--------------------------

	- aeg
	- bestfort
	- bestuferrups
	- engetron
	- ipt-anzen
	- mgeups
	- multilink
	- mustekups
	- optiups
	- sms
	- toshiba1500
	- upseyeux
	- victronups

What needs to go away (obsolete drivers)
----------------------------------------

	- powercom (replaced by newpowercom)
	- ups-trust425+625 (replaced by newpowercom)
	- victronups (replaced by newvictron)