Penguin
Recent Changes
Annotated edit history of upsct2(8) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 UPSCT2
2 !!!UPSCT2
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 UNATTENDED MODE
8 DIAGNOSTICS
9 BUGS
10 SEE ALSO
11 ----
12 !!NAME
13
14
15 upsct2 - UPS variable administration tool
16 !!SYNOPSIS
17
18
19 __upsct2__ ''ups''
20
21
22 __upsct2 -h__
23
24
25 __upsct2 -s__ ''variable'' __[[-u__
26 ''username''__] [[-p__ ''password''__]__
27 ''ups''
28 !!DESCRIPTION
29
30
31 __upsct2__ allows you to view and change the read/write
32 variables inside your UPS. It sends commands via the server
33 upsd(8) to your driver, which configures the hardware
34 for you.
35
36
37 The list of variables that allow you to change their values
38 is based on the capabilities of your UPS equipment. Not all
39 models support this feature. Typically, cheaper hardware
40 does not support any of them. Run upsct2 with a UPS
41 identifier to see what will work for you.
42 !!OPTIONS
43
44
45 -h
46
47
48 Display the help message.
49
50
51 -s ''variable''
52
53
54 Specify the variable to be changed inside the UPS. For
55 unattended mode such as in shell scripts, use the format
56 VAR=VALUE to specify both the variable and the value, for
57 example:
58
59
60 -s HIGHXFER=129
61
62
63 Without this argument, upsct2 will just display the list of
64 the variables and their possible values.
65
66
67 Some variables are strings, and can be set to any value
68 within the length limit. Others are enumerated types and can
69 only be set to one of those values. Refer to the list to
70 know what's available in your hardware.
71
72
73 -u ''username''
74
75
76 Set the username for the connection to the server. This is
77 optional, and you will be prompted for this when using the
78 -s option if you don't specify -u on the command
79 line.
80
81
82 -p ''password''
83
84
85 Set the password to authenticate to the server. This is also
86 optional like -u, and you will be prompted for it if
87 necessary.
88
89
90 ''ups''
91
92
93 View or change the settings on this UPS. The format for this
94 option is [[upsname@]hostname[[:port].
95 !!UNATTENDED MODE
96
97
98 If you run this program inside a shell script or similar to
99 set variables, you will need to specify all of the
100 information on the command line. This means using -s
101 VAR=VALUE, -u and -p. Otherwise it will put up a prompt and
102 your program will hang.
103
104
105 This is not necessary when displaying the list, as the
106 username and password are not required for read-only
107 mode.
108 !!DIAGNOSTICS
109
110
111 upsct2 can't set variables on your UPS unless you provide a
112 valid username and password. If you get
113 upsd.users__(5) has an entry for you, and that the
114 username you are using has permissions to SET
115 variables.
116 !!BUGS
117
118
119 The name of this program is misleading, as it does much more
120 than upsct(8).
121 !!SEE ALSO
122
123
124 upsd(8), upscmd(8)
125
126
127 __Internet resources:__
128
129
130 The NUT (Network UPS Tools) home page:
131 http://www.exploits.org/nut/
132
133
134 NUT mailing list archives and information:
135 http://lists.exploits.org/
136 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.