File: README.adoc

package info (click to toggle)
nut 2.8.3-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 24,356 kB
  • sloc: ansic: 123,904; sh: 14,718; cpp: 12,558; makefile: 5,212; python: 1,114; perl: 855; xml: 47
file content (47 lines) | stat: -rw-r--r-- 1,224 bytes parent folder | download | duplicates (2)
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
Hotplug script for NUT USB drivers
==================================
Arnaud Quette <arnaud.quette@mgeups.com>
v1.0, 8 January 2007 (start date)

This document introduces Linux Hotplug script for NUT USB
drivers (`usbhid-ups`, `bcmxcp_usb` and `tripplite_usb`).

These are needed, on older Linux systems, to ensure the right
privileges are set on the USB device node files (i.e. allowing
`nut` user to read AND write to the UPS device).


Alternative
-----------

For newer 2.6 kernels with the `udev` mechanism, you should use
the scripts in `scripts/udev` instead of this one.


Installation
------------

For most users, these files will be automatically installed in
`/etc/hotplug` upon `make install`, if that directory exists.

You can specify an alternate directory by running:
----
:; ./configure --with-hotplug-dir=DIR
----


Manual installation
-------------------

These scripts can be used with Linux 2.4 to 2.6.13.

- possibly change `libhidups` to match NUT user
- copy `libhidups` and `libhid.usermap` to `/etc/hotplug/usb/`
- make `libhidups` executable with:
+
----
:; chmod a+x /etc/hotplug/usb/libhidups
----
- call `update-usb.usermap` or equivalent if needed

You can then plug your UPS, and start NUT.