1             Release Notes for ApcCtrl 0.8.x
2
30.8.21 - 10 de maio de 2019
4
5    * Apresentacao da potencia de saida em Watts e VA
6       - A potencia de saida passa a ser apresentada no apcaccess tanto em Watts e
7         VA (Volt * Ampere).
8       - OBSERVACOES IMPORTANTES: os nobreaks nao sao equipamentos de medicao.
9         Nos testes realizados, a potencia de saida em Watts apresentava valores
10         maiores que em VA. Essa condicao nao deveria nunca ocorrer por questoes tecnicas.
11         A potencia em VA (potencia aparente) eh a pura multiplicacao da tensao pela
12         corrente. Ja a potencia real (ativa), medida em Watts, leva em consideracao a
13         fase entre a corrente e a tensao, devendo ser SEMPRE igual ou menor que a
14         potencia aparente.
15
160.8.20 - 06 de dezembro de 2018
17
18    * Alteraçao do apctest: Após um desligamento por falta de energia com o uso do apcctrl
19      daemon pode ocorrer, com uma boa frequência, que uma programação de desligamento
20      automático feita durante o desligamento não seja automaticamente cancelada durante
21      a inicialização do apctest. Para corrigir isso, o apctest força o cancelamento nas
22      etapas iniciais.
23
240.8.19 - 09 de agosto de 2018
25
26	* Para modelos com cabo serial o nobreak realiza o controle de fluxo. Alterados
27	  os bits DTR e RTS para receber dados do nobreak.
28
290.8.15 - 08 de fevereiro de 2018
30
31    * Implementação da leitura da potência aparente do nobreak e da corrente de saída.
32      Sugestão de Levi Pereira (https://sourceforge.net/u/leviweb/profile/)
33
34
350.8.14 - 05 de fevereiro de 2018
36
37	* Correção do bug na detecção de conexão perdida. O problema ocorria quando o serviço
38	  já estava rodando e conectado ao nobreak corretamente quando então o cabo era
39	  removido e a conexão era perdida.
40
41
420.8.13 - 02 de fevereiro de 2018
43
44	* Correção de bug de perda de comunicação
45
460.8.12 - 02 de fevereiro de 2018
47
48	* Correção de bug no apctest para Windows. Em alguns casos o nobreak se desconecta da
49	  porta serial (USB-serial) e ao reconectar o apctest reconfigurava o nobreak. Agora
50	  isso só ocorre quando o driver é instanciado pela primeira vez.
51
52	* Revisão das rotinas do apctest para teste do estado da bateria. Agora o teste da
53	  condição das baterias mostra os dados de forma mais clara. Além do teste todo
54	  ter sido revisado.
55
56	* Revisão das constantes para cálculo da autonomia. Alguns testes de bancada indicaram
57	  que ps cálculos da autonomia pela forma de Peukert e quando operando apenas pelas
58	  baterias estavam super estimados.
59
60
610.8.8 - 09 de fevereiro de 2017
62
63	* Contribuições feitas por Alan Franco (alanfr8.85 no gmail).
64
65	* As declarações de constantes no arquivo brazilbattery.h foram alteradas para
66	  compatibilizar com gcc6 (std c++11) e os atuais padrões para linguagem de programação C++.
67
68    * O arquivo configure.in foi alterado para identificar a distribuição ArchLinux e instalar
69      os arquivos apropriados.
70
71	* Novos arquivos para a distribuição ArchLinux em plataforms
72
730.8.7 - 09 de janeiro de 2017
74
75    * Para Mac OS X!!!! Criada uma função para listar os devices na pasta /dev e identificar
76      qual deles tem um nome similar ao configurado. Obrigatoriamente o nome do device deve
77      iniciar por "cu." para evitar escrever algo em um device inadequado e, por exemplo,
78      escrever no disco.
79
80    * Adicionado um sleep de um segundo na função de abertura de porta para evitar que
81      o processo fique em loop quando o cabo do nobreak é removido.
82
830.8.5 - 16 de dezembro de 2016
84
85	* Saídas para debug na função BrazilDriver::open()
86
87	* Flag O_CLOEXEC na função BrazilDriver::open()
88
89	* Removida a aplicação smtp. Não está adequada a internet atual. Utilize o ssmtp ou heirloom-mailx
90
910.8.4 - 10 de dezembro de 2016
92
93	* Corrigido bug para Mac. A porta serial não era configurada adequadamente.
94
950.8.2 - 03 de outubro de 2016
96
97    * Atualizada versão base do apcupsd para versão 3.14.14
98
99    * Versão 3.14.14 pode ser compilada no macos "el capitan"
100
1010.8.1 - 29 de setembro de 2016
102
103    * Correção do instalador para Windows para iniciar o serviço durante a
104      instalação
105
106
1070.8.0 - 27 de setembro de 2016
108
109    * No Ubuntu 16.04.1 a porta serial padrão do nobreak é ttyACM0. Alterando
110      comentário no arquivo de configuração. Sugestão de Caio Moysés de Lima.
111
112    * O Ubuntu 16.04.1 não possui a aplicação insserv para atualizar o rc.d
113      e por isso o Makefile em plataforms/debian/Makefile faz o teste
114      pela existência dessa aplicação. Observado por Caio Moysés de Lima.
115
116    * Mudança da pasta padrão de config para /etc/apcctrl
117
118    * Mudança do arquivo padrão de config para apcctrl.conf
119
120    * Mudança no nome do daemon para apcctrl
121
122    * Mudança na classe brazilbattery
123
1240.7.0 - 28 de junho de 2016
125
126    * Suporte para os modelos com protocolo solis
127      Smart-UPS BR 1000VA
128      Smart-UPS BR 1500VA
129      Smart-UPS BR 2000VA
130      Smart-UPS BR 3000VA
131
1320.7.4 - 01 de julho de 2016
133
134    * Mudança no shutdownauto
135
136    * Adição do parâmetro BATTEXPANDER no arquivo de configuração
137      para indicar o tamanho do expansor de bateria.
138
1390.7.5 - 01 de julho de 2016
140
141    * Correção de BUG grave. Duplo desligamento! Por detecção de ausência de carga
142      e por shutdown puro sem timeout específico.
143
144
145----------------------------------------------------------------------------
146
147             Release Notes for ApcCtrl 0.6.x
148
1490.6.9 - 16 de Junho de 2016
150
151    * Criado o driver de aplicação Brazil
152
153      Criado um novo driver dentro da aplicação chamado "brazil"
154      1. Suporte para os modelos da linha APC Back-UPS.
155      2.Estimativas de timeleft dentro da aplicação. O nobreak não fornece
156        nenhuma informação de timeleft automaticamente.
157
158    * Aplicação para interpolação
159
160      Para estimar o timeleft do nobreak foi criada uma aplicação para
161      resolver equações lineares que permitem obter dados em uma curva
162      contínua onde só havia dados discretos
163
164    * Alterações no apctest
165
166      A aplicação apctest foi alterada para dar suporte a esse driver.
167
168    * Instalador para Microsoft Windows
169
170      O driver USB para Microsoft Windows foi alterado para o driver da APC
171      do Brasil.
172
173    * Autoconf
174
175      Mudanças nos arquivos de autoconf para gerar outro configure e Makefile
176
177
178----------------------------------------------------------------------------
179
180             Release Notes for apcupsd 3.14.x
181
182apcupsd 3.14.x is the latest STABLE release, containing many bug fixes and
183new features over the previous 3.12.x stable series. Users of all previous
184versions are encouraged to upgrade.
185
186IF YOU USE THE OLD STYLE MASTER/SLAVE NETWORKING MODE, BE SURE TO READ THE
1873.14.0 RELEASE NOTES BELOW.
188
189
1903.14.13 -- 02 February 2015
191
192NEW FEATURES
193
194  * MODBUS USB support
195
196    Previous releases supported MODBUS serial (RS232). This release adds
197    support for MODBUS over USB. This protocol is preferable to the normal
198    USB HID driver because it offers access to more UPS data readouts and
199    controls. The only configuration file change needed versus MODBUS serial
200    is to change UPSCABLE to usb and use an empty DEVICE setting. See the
201    MODBUS section of the apcupsd manual for more details.
202
203  * Support for Apple Notification Center on Mac OS X (replaces Growl)
204
205  * Apple install packages and binaries are signed with an Apple Developer
206    key for compatibility with Gate Keeper
207
208  * Windows USB driver has been updated with additional USB identifiers to
209    support future APC products.
210
211BUG FIXES
212
213  * Use launchd for startup on Mac OS X as the old Startup Items mechanism is
214    no longer supported in 10.10 and above
215
216  * Fix apcaccess on ARM systems where char is unsigned by default
217
218  * Fix several potential issues identified by Coverity static analysis
219
220  * Numerous other fixes and improvements all over the code, many of them
221    submitted by users...Thank you!
222
223MISC
224
225  * Windows port now builds with the same configure and make system as the
226    other targets, no need to maintain a special hardcoded Makefile.
227
228  * Many cleanups to the Windows port codebase
229
230  * Prebuilt binaries for Mac OS X no longer support PowerPC systems or
231    Mac OS X 10.4 and older
232
233
2343.14.12 -- 29 March 2014             (Maintenance Release)
235
236NEW FEATURES
237
238  * apcaccess and apcupsd status format updates to ease parsing by scripts
239
240  * UPS name is included in subject line of emails in default scripts
241
242  * Default event scripts pull SYSADMIN and APCCTRL_MAIL definitions from a
243    common config file so they can easily be configured in one place
244
245BUG FIXES
246
247  * Fix issue with certain Back-UPS USB models repeatedly cycling power on/off
248    after killpower is issued
249
250  * Fix display of battery level during MODBUS calibration
251
252  * Fix apctest EEPROM setting on various models
253
254  * Close and reopen serial port during extended COMMLOST in apcsmart driver
255    (helps recover connection when USB serial port dongles are reconnected)
256
257  * Avoid probing non-APC USB devices as it can cause lockups
258
259  * Fix issue with service failing to start on Windows during boot with USB UPS
260
261  * Fix bogus lock file error when config file error forces early termination
262
263  * Fix MODBUS NOMOUTV reading for voltages other than 120VAC
264
265  * Fix LOADPCT (CI_LOAD) on MODBUS driver
266
267  * Fix issue with net driver not reporting MODEL value
268
269
2703.14.11 -- 31 January 2014           (Maintenance Release)
271
272NEW FEATURES
273
274  * MODBUS protocol support
275
276    Over the summer, APC publicly released documentation[1] on a new UPS
277    control and monitoring protocol, loosely referred to as MODBUS (after the
278    historic industrial control protocol it is based on). The new protocol
279    operates over RS232 serial lines as well as USB connections and is intended
280    to supplement APC's proprietary Microlink protocol. Microlink is not going
281    away, but APC has realized that third parties require access to UPS status
282    and control information. Rather than publicly open Microlink, they have
283    created another protocol to operate along side it.
284
285    Many existing Microlink UPSes can be upgraded to support MODBUS via a
286    firmware update. See [2]. Certain older models are not upgradeable. APC
287    support will be your best contact for determining if your UPS supports a
288    MODBUS upgrade the information linked below does not make it clear.
289
290    For now, apcupsd supports MODBUS over RS232 serial only. It DOES NOT yet
291    support MODBUS over USB. See the apcupsd manual[3] for information on
292    setting up apcupsd.conf for MODBUS UPSes.
293
294    [1] http://www.apc.com/whitepaper/?an=176
295    [2] http://www.schneider-electric.us/support/index?page=content&country=ITB&lang=EN&id=FA164737
296    [3] http://www.apcupsd.com/manual/manual.html
297
298  * Windows USB driver is now digitally signed thanks to Jernej Simoncic
299    <jernej's-sflist@eternallybored.org>
300
301
3023.14.10 -- 13 September 2011         (Maintenance Release)
303
304BUG FIXES
305
306  * Fix missing status and spurrious incorrect status on newer BackUPS CS
307    models using USB interface.
308
309  * USB compatibility fixes for Mac OS X Lion
310
311  * USB driver support for newer Microlink models on Mac OS X Lion and Windows
312
313  * Ignore transitions to battery due to calibration (possible if user
314    initiates calibration, then exits apctest and starts apcupsd before
315    calibration completes.
316
317  * Fix truncation of long UPS model names such as "Smart-UPS RT 5000 XL"
318
319  * Fix MODEL vs. APCMODEL confusion. Remove APCMODEL and rename old MODEL
320    aka 'mode' to DRIVER.
321
322
3233.14.9 -- 22 July 2011               (Maintenance Release)
324
325NEW FEATURES
326
327  * SNMP enhancements:
328    - Autodetection of MIB and community if they are not specified in
329      apcupsd.conf
330    - Support for RFC1628 MIB
331    - Support for MGE MIB (Contributed by	Lars Taeuber <taeuber@bbaw.de>)
332
333  * Windows USB support for 64-bit platforms
334
335  * USB support for latest APC models such as SMT* and SMX* series
336    - No support for Microlink, but basic USB interface should be
337      detected and provide status now.
338
339  * When using the generic USB driver (Windows, OS X, newer FreeBSD)
340    DEVICE string in apcupsd.conf can be set as serial number of UPS
341    to monitor. This is useful in order to "lock" apcupsd to a specific
342    UPS if you have more than one connected to the server.
343
344  * Ed Dondlinger's Windows email scripts are included in the Win32
345    install package now. Documentation includes information on how
346    to hook them in.
347
348BUG FIXES
349
350  * general: Rework signal handling to eliminate crashes and hangs.
351
352  * general: Fix issue of overwriting pid file even when we failed
353    to acquire the lock file
354
355  * snmp: Add workaround for FreeBSD libsupc++.a issue (FreeBSD PR
356    #99702) This will allow snmplite driver to compile/link on
357    FreeBSD 5.x.
358
359  * usb: Automatically use generic_usb driver on FreeBSD 8.0 and
360    newer. FreeBSD USB API was changed in 8.0, so from now on we will
361    use libusb.
362
363  * usb: Add support for DALARM
364
365  * usb: Fix BATTV and MANDATE on certain newer APC models
366
367  * win32: Honor INSTDIR specified on command line via /D
368
369  * win32: When running uninstaller in silent mode, always remove
370    config and events files without prompting.
371
372  * win32: When logging events, convert LOG_CRIT to a WARNING rather
373	 than an ERROR since apcupsd uses it for power events which aren't
374	 really daemon errors.
375
376
3773.14.8 -- 16 January 2010            (Maintenance Release)
378
379NEW FEATURES
380
381  * Mac OS X version of apctray (apcagent) for monitoring apcupsd instances.
382    Same feature set as apctray on Windows (monitor multiple instances,
383    get detailed status and events logs). Popup notifications delivered via
384    Growl, if available.
385
386  * Major update to win32 version of apctray. Includes many visual and
387    usability improvements to match OS X version.
388
389  * apctest now supports battery calibration and self-test interval control
390    on USB models. Many thanks to James Belleau <james@belleau.net> for
391    contributing these features.
392
393  * New SNMP driver that does not require libsnmp.so, thus eliminating
394    issues with not finding the library during shutdown when /usr has
395    been unmounted. The new driver is the default for 'UPSTYPE snmp'.
396    The old driver is still available as "UPSTYPE netsnmp" if needed.
397
398BUG FIXES
399
400   * Add missing NOMINV, NOMOUTV, and NOMPOWER to net clients
401
402   * Fix missing WALL in apccontrol (debian bug #546019)
403     http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=546019
404
405   * Change all time/date strings to simplified ISO format:
406     "YYYY-MM-DD HH:MM:SS +/-UTC"
407
408   * Fix battery voltage readout on "Back-UPS 500 FW: 6.3.I USB FW: c1"
409
410   * Remove obsolete image files from source tree
411
412   * Fix issues with popup.exe running when it shouldn't and sometimes
413     hanging and/or generating an "Interactive Services Dialog Detected"
414     error.
415
416   * Use /kill switch from the installer to shut down running instances
417     of apcupsd and apctray. This will provide more reliable termination
418     on Vista/Win7.
419
420   * Update apctest to use 'Q' to exit any menu instead of a number that
421     is always changing. Contributed by James Belleau <jpbelleau@gmail.com>
422
423   * apctest: 	Fix compiler warnings. Contributed by
424     Andy O'Shaughnessy <andrewjoshaughnessy@gmail.com>
425
426
4273.14.7 -- 31 July 2009               (Maintenance Release)
428
429NEW FEATURES
430
431  * Multimon CGI programs are included with the Windows binary package
432
433BUG FIXES
434
435  * Windows COM ports above COM9 now work without user needing to manually
436    add \\.\ UNC prefix in apcupsd.conf
437
438  * Fix configure script not noticing when C++ compiler is missing
439
440  * Fix for battery date (BATTDAT) displaying invalid values on USB models
441
442  * Fix version reporting in cgi and examples
443
444  * Misc documentation fixes for typos, etc.
445
446
4473.14.6 -- 16 May 2009                (Maintenance Release)
448
449NEW FEATURES
450
451  * Major updates to the User Manual. Rewritten battery maintenance section
452    courtesy of Trevor Roydhouse <trev@sentry.org>. Many other updates
453    including the SmartUPS protocol and OS support sections. Furthermore,
454    the manual is now formatted in reStructuredText
455    (http://docutils.sourceforge.net/rst.html) and as a result is very
456    easy to update. (The only down side is the multi-page HTML version is
457    no longer available; the HTML version is all on a single page.)
458
459  * New manpages for apcupsd, apcupsd.conf, apctest, apcaccess, and
460    apccontrol. Many thanks to Trevor Roydhouse <trev@sentry.org> for the
461    hard work!
462
463  * Support for QNX. Tested on QNX 6.3.2. Contributed by Mikhail
464    Gruzdev <michail.gruzdev@gmail.com>
465
466  * Add support for turning the UPS off completely. This complements
467    existing hibernate (aka killpower) functionality. Turn-off is
468    implemented for apcsmart and USB drivers, subject to support for the
469    relevant commands in the UPS itself. Contributed by Keith Campbell
470    <campbell@econnectix.com>.
471
472BUG FIXES
473
474  * apcsmart: Deadlock fixes during comms failures. Contributed by Keith
475    Campbell <campbell@econnectix.com>
476
477  * linux-usb: Fix out-of-bounds array access. Contributed by David Fries
478    <david@fries.net>
479
480  * Fix build with gcc-4.4. Contributed by Michal Hlavinka <mhlavink@redhat.com>
481
482  * apcsmart: Fix crash during process shutdown (SIGTERM). Contributed by
483    Andrey Sharandakov <ash.ashway@gmail.com>
484
485  * Several other minor fixes and improvements. See ChangeLog for details.
486
487
4883.14.5 -- 26 October 2008            (Maintenance Release)
489
490BUG FIXES
491
492  * docs: Document the /refresh switch for apctray.
493
494  * apctest: Do not create pid file. There is little reason for it
495    since apctest is a command-line tool, not a daemon. Plus nothing
496    ever deletes the file so it interferes with apcupsd operation.
497
498  * gapcmon: Network connect timeout fix.
499
500  * Fix a few unsafe uses of sprintf and strcat.
501
502  * Makefile: Fix cgi build on OpenBSD. libgd on OpenBSD requires X_LIBS
503    for libfreetype and libfontconfig.
504
505  * gapcmon: Iconify fixes for KDE
506
507  * Fix LOWBATT glitch handling bug that could cause us to act on a
508    LOWBATT signal immediately instead of waiting for the debounce time.
509
510  * apctray: Improve multiple instance behavior for /add, /del, and
511    /kill on modern platforms (Win2K and newer).
512
513  * Support shutting down apcupsd instances running in other sessions
514    (such as terminal services or remote desktop sessions).
515
516  * Makefile: 'make install' fixes for first install on RedHat/SuSE.
517
518  * docs: PCNET minimum password length is 15 chars, default username
519    is 'apc', no known way to change the username.
520
521  * Makefile: Fix dependency build errors on Darwin and other platforms.
522    ('echo -n' is not portable; use 'tr' to strip newline instead)
523
524  * RPMs: Automatically restart apcupsd when upgrading
525
526
5273.14.4 -- 18 May 2008                (Maintenance Release)
528
529MAJOR CHANGES
530
531  * Build system rewrite: All Makefiles have been rewritten from scratch.
532    Improvements include reliable dependencies, support for parallel make,
533    elimination of Makefile.in -> Makefile conversion, consistent use of
534    DESTDIR during 'make install', and pretty-printed output during builds.
535
536    NEW BUILD SYSTEM NOTES
537      - GNU make is required. The configure script checks for this and tells
538        you how to invokve it (on some platforms it is 'gmake' instead of
539        'make').
540      - Output during build is pretty-printed by default. To see more details,
541        use 'make VERBOSE=1' for output similar to the old build system. For
542        even more verbosity, use 'make VERBOSE=2'.
543      - Parallel builds work well. If you have a multiprocessor (or multicore)
544        system, try 'make -j<number-of-processors>' for the fastest possible
545        build.
546
547  * Built-in version of libgd for multimon cgi has been removed. The version
548    previously included in apcupsd was old and likely had security issues.
549    It is safer to use libgd from the target system. Therefore, your system
550    must provide libgd if you choose to build cgi now. Generally this is
551    easy to achieve by installing a vendor-supplied package.
552
553  * Removal of NLS support: The NLS code was terribly bit-rotted with many
554    non-internationalized messages and almost every translated message was
555    incorrect. At this point the maintenance burden of keeping NLS support
556    building was deemed too high considering the small benefit it was able
557    to provide.
558
559  * Powerflute has been disabled. It has been broken for the last several
560    releases because it relied on an untrushworthy source of UPS status
561    (rawupsstats) which was itself removed. Powerflute could be converted to
562    use the standard NIS status mechanism and its source code remains in
563    the tree in case someone has the desire to contribute this code.
564
565NEW FEATURES
566
567  * Add POLLTIME directive to control UPS polling interval. This directive
568    specifies the number of seconds to delay between polling the UPS for
569    status. Previously, NETTIME allowed this to be adjusted for network
570    connections only (snmp, pcnet, nis-net). POLLTIME configures the delay
571    for all connection types. NETTIME is accepted as a synonym for
572    compatibility with old config files.
573
574BUG FIXES
575
576  * gapcmon: Corrected the use of NOMPOWER and the calc of current usage
577    amount. Thanks to James Scott Jr <skoona@verizon.net>.
578
579  * Add a heuristic to fix up incorrect NOMINV or NOMOUTV. Some UPSes
580    (RS 500) report decivolts instead of volts. Reported by Kirill S.
581    Bychkov <yason@linklevel.net>.
582
583  * Various build fixes on Solaris and OpenSolaris. Thanks to James Dean
584    <jgmdean@gmail.com> for loaning me an ssh login on his OpenSolaris box.
585
586  * Fix hal policy file syntax. For some reason this blatantly	incorrect
587    file actually works on RHEL5 (hal-0.5.8). Thanks to Andrew Telford
588    <a.telford@ieee.org> for correcting it.
589
590  * Fix gapcmon build on OpenBSD.
591
592  * Fix BSD USB driver build.
593
594  * Fix default NIS port on Debian. Debian is now using the standard NIS
595    port, 3551.  Contributed by imacat <imacat@mail.imacat.idv.tw>
596
597
5983.14.3 -- 20 January 2008            (Maintenance Release)
599
600NEW FEATURES
601
602  * A HAL policy file is automatically installed on Linux systems to disable
603    the hald-addon-hid-ups module which conflicts with apcupsd's control of
604    USB UPSes. The file is automatically removed when apcupsd is uninstalled.
605
606BUG FIXES
607
608  * Add support for Nominal Power (aka Configured Active Power) reading.
609    Credit to Lars Randers <lars@nstec.dk> for most of the code.
610
611  * Add units to NOMINV, NOMOUTV, and NOMBATTV stats.
612
613  * Eliminate "warning: deprecated conversion from string constant to
614    'char*'" warnings emitted from gcc-4.2.1 (earlier versions with
615    -Wwrite-strings). Contributed by Steve Yarmie <tribhuvanji@gmail.com>.
616
617  * Fix killpower and eeprom settings bug on USB models introduced when
618    INPUT reports were prioritized over FEATURE reports.
619
620  * Fix bugs that could cause NIS-net driver to get stuck waiting for
621    comms to be restored instead of shutting down.
622
623
6243.14.2 -- 15 September 2007          (Maintenance Release)
625
626NEW FEATURES
627
628  * Tray icon support on Vista. Vista does not allow background services
629    to interact with the user's desktop, so winapcupsd's built-in tray
630    icon did not work.
631
632  * Tray icon is now a standalone application "apctray" which is capable of
633    monitoring multiple apcupsd instances via apcupsd's NIS. Any apcupsd
634    running NIS can be monitored. By default the icon monitors a single
635    apcupsd at 127.0.0.1:3551. See command line options below for adding
636    additional monitors.
637
638  * Tray icon can be installed individually (disable other packages in the
639    installer) for users who want to use the icon only.
640
641  * Apctray command line options:
642
643       apctray.exe
644          - No parameters: Start any instances listed in registry. If no
645          instances in reg, start a default instance monitoring the local
646          machine (127.0.0.1:3551).
647
648       apctray.exe /host foo /port 3551 /add
649          - Add a monitor for the given host and port.
650
651       apctray.exe /host foo /port 3551 /del
652          - Remove the given monitor.
653
654       apctray.exe /del
655          - Remove all monitors.
656
657       apctray.exe /install
658          - Configure apctray to start automatically.
659
660       apctray.exe /remove
661          - Do not start automatically.
662
663       apctray.exe /kill
664          - Shut down apctray
665
666BUG FIXES
667
668  * The win32 portions of winapcupsd have been almost entirely rewritten.
669    The code is cleaner (mostly) and lots of unused baggage has been removed.
670
671  * USB fix for BackUPS LCD series. This fix carries a risk of breaking other
672    models, but test results are positive so far.
673
674  * Fix linux-usb device detection bug when multiple hiddev nodes are
675    present.  Fixes Fedora Bugzilla #245864:
676    <https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=245864>
677
678  * Fix SNMP port selection when using SNMP driver
679
680  * Add workaround for broken BackUPS Pro model that returns certain
681    reports encoded in ASCII. Based on a patch from David Fries
682    <David@Fries.net>.
683
684  * apcsmart: Wait 20 seconds before declaring COMMLOST. This is necessary
685    when using a smart serial cable on an UPS with an SNMP monitoring card
686    installed. The SNMP card appears to disrupt serial comms for several
687    seconds when interesting events are in progress.
688
689  * Documentation updates: Fix up udev info for modern Linux distros.
690    Update Windows section for apctray.
691
692  * Don't leak unnecessary descriptors to child when execing apccontrol.
693
694  * Fix bug with multi-threaded net_open() calls. net_open() was using
695    a global buffer for the destination address. Yikes! Bug manifestied
696    itself in apctray with multiple monitors occasionally (and
697    timing-dependently) pointing to the wrong UPS.
698
699  * Correct multimon.conf humidity monitoring.  Problem fixed by
700    Patrick Frei.  Reference:
701    https://bugzilla.novell.com/show_bug.cgi?id=199834
702
703  * Fix race between attach_ups() and detach_ups() which could result
704    in the UPSINFO structure being freed prematurely. Thanks to James
705    Abbott <j.abbott@imperial.ac.uk> for running many tests to help me
706    find this bug.
707
708  * Remove dependency on libc++ (again). Must use gcc as linker when
709    using libsupc++ since g++ automatically links against full libc++.
710
711
7123.14.1 -- 04 May 2007           (Maintenance Release)
713
714NEW FEATURES
715
716  * MacOS X GUI installer
717
718  * PCNET driver supports remote shutdown request from UPS web interface
719
720BUG FIXES
721
722  * (win32) Detect when balloon tips have been disabled via a group policy
723      and fall back on the standard popup message box.
724
725  * (win32) Fix typo: "%sbindir\%popup" -> "%sbindir%\popup" in apccontrol.bat
726      Discovered by Stefan.Hegnauer@elektrobit.com.
727
728  * (all) Fix potential NIS client lockup when server disappears. Many thanks
729      to Jan Ceuleers <jan.ceuleers@computer.org> for reporting the problem
730      and gathering data to track down the cause.
731
732  * (apctest) Fix link error after configuring with --disable-apcsmart.
733
734  * (doc) Document how to force ugen binding on NetBSD 4.x.
735      Contributed by Curt Sampson <cjs@starling-software.com>.
736
737  * (apctest) Fix crash when displaying EEPROM values more than once.
738      Contributed by Ivaylo Haratcherev <I.J.Haratcherev@tudelft.nl>.
739
740  * Increase self-test timeout to 40 seconds to accomodate the RS 800.
741      Contributed by Lars Randers <lars@nstec.dk>.
742
743  * (linux-usb) Rewrite device opening logic to be more reliable. See
744      ChangeLog for details.
745
746  * (apcupsd) Do not attempt to cancel shutdowns.
747
748
7493.14.0 -- 09 February 2007      (Feature Release)
750
751NEW FEATURES
752
753  * USB support for 3 new platforms:
754
755  	- Windows (Win98SE, WinME, Win2000, Win2003 Server, WinXP)
756  	- Mac OS X (Darwin)
757  	- Solaris 10 (x86 and SPARC)
758
759        Please see the apcupsd manual for details on USB configuration for the
760        new platforms.
761
762  * Native Windows port
763
764       The winapcupsd port has been completely rewritten to use native
765       Win32 libraries (based on MinGW32). It no longer relies on a Cygwin
766       translation layer, thus improving compatibility and performance.
767
768  * PowerChute Network Shutdown driver
769
770       apcupsd now supports the PowerChute Network Shutdown protocol (PCNET)
771       offered by the AP9617 family of smart slot modules. This protocol is
772       much lighter-weight than SNMP and offers better security. Please see
773       the apcupsd manual for details on PCNET configuration.
774
775  * GAPCMON GUI monitoring tool
776
777       apcupsd is now packaged with the GAPCMON GUI monitoring application
778       thanks to James Scott, Jr. This is a Gnome/GTK based application which
779       integrates into most desktop panels (not just Gnome). It monitors one or
780       more apcupsd instances using apcupsd's NIS networking server. The status
781       of each UPS is shown with a icon similar to the Win32 tray icon in
782       winapcupsd. Enable building of gapcmon at compile time via
783       --enable-gapcmon or install the apcupsd-gapcmon RPM.
784
785  * Unreliable MASTER/SLAVE networking mode is removed
786
787       Yes, this is a feature. The old MASTER/SLAVE mode for shutting down
788       multiple servers from one UPS has historically been unreliable and prone
789       to loss of communications or lockups. apcupsd has long had a replacement
790       networking mode using the NIS server (NIS stands for Network Information
791       Server, and has nothing to do with Sun's NIS/YP protocol). The NIS net
792       mode is very reliable and has none of the lockup bugs that have plagued
793       MASTER/SLAVE mode.
794
795       In 3.14.x, MASTER/SLAVE mode has been removed and the associated
796       configuration directives are now obsolete. Please see the apcupsd manual
797       for a very simple NIS networking configuration to replace MASTER/SLAVE.
798
799   * New configuration directives to set paths at runtime
800
801       Several new (optional) configuration directives have been added to
802       allow overriding compiled-in paths at runtime. The directives are:
803
804          - SCRIPTDIR (sets location of apccontrol and event scripts)
805          - PWRFAILDIR (sets location where powerfail file will be written)
806          - NOLOGINDIR (set location where nologin file will be written)
807
808       These directives can be used to rearrange the apcupsd installation
809       after compiling, or to run multiple apcupsd instances on the
810       same machine without compiling separate copies.
811
812       See the apcupsd manual for details on these new directives.
813