SYNOPSIS

       upsdrvctl -h

       upsdrvctl [OPTIONS] {start | stop | shutdown} [ups]

DESCRIPTION

       upsdrvctl  provides  a uniform interface for controlling your UPS driv-
       ers.  You should use upsdrvctl instead of direct calls to  the  drivers
       whenever possible.

       When  used  properly,  upsdrvctl  lets  you  maintain identical startup
       scripts across multiple systems with different UPS configurations.

OPTIONS

       -h     Display the help message.


       -r directory
              If starting a driver, this value will  direct  it  to  chroot(2)
              into directory.  This can be useful when securing systems.

              This may be set in the ups.conf with "chroot" in the global sec-
              tion.


       -t     Enable testing mode.  This also  enables  debug  mode.   Testing
              mode  makes upsdrvctl display the actions it would execute with-
              out actually doing them.  Use this to test out  your  configura-
              tion  without actually doing anything to your UPS drivers.  This
              may be helpful when defining the  'sdorder'  directive  in  your
              ups.conf(5).


       -u username
              If  starting a driver, this value will direct it to setuid(2) to
              the user id associated with username.

              If the driver is started as root without specifying this  value,
              it  will  use  the  username  that was compiled into the binary.
              This defaults to "nobody", and is far from ideal.

              This may be set in ups.conf with "user" in the global section.


       -D     Raise the debug level.  Use this multiple times  for  additional
              details.

COMMANDS

       upsdrvctl  supports  three  commands  - start, stop and shutdown.  They
              ups.conf(5).

              WARNING: this will probably power off your computers,  so  don't
              play around with this option.  Only use it when your systems are
              prepared to lose power.

ENVIRONMENT VARIABLES

       NUT_CONFPATH is the path name of the directory that contains  ups.conf.
       If  this  variable  is not set, upsdrvctl and the driver use a built-in
       default, which is often /usr/local/ups/etc.

DIAGNOSTICS

       upsdrvctl will return a nonzero exit code if  it  encounters  an  error
       while  performing  the  desired  operation.  This will also happen if a
       driver takes longer than the maxstartdelay period to  enter  the  back-
       ground.

SEE ALSO

       nutupsdrv(8), upsd(8) ups.conf(5)


   Internet resources:
       The NUT (Network UPS Tools) home page: http://www.networkupstools.org/



                                Sat Jan 31 2004                   UPSDRVCTL(8)