Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   31559 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

UPSRW(8)	     Network UPS Tools (NUT)		 UPSRW(8)

NAME
       upsrw - UPS variable administration tool

SYNOPSIS
       upsrw ups

       upsrw -h

       upsrw -s variable [-u username] [-p password] ups

DESCRIPTION
       upsrw  allows  you to view and change the read/write vari-
       ables inside your UPS.  It sends commands via  the  server
       upsd(8)	to your driver, which configures the hardware for
       you.

       The list of variables that allow you to change their  val-
       ues  is	based  on the capabilities of your UPS equipment.
       Not all models support this feature.   Typically,  cheaper
       hardware	 does  not support any of them.	 Run upsrw with a
       UPS identifier to see what will work for you.

OPTIONS
       -h     Display the help message.

       -s variable
	      Specify the variable to be changed inside the  UPS.
	      For  unattended  mode such as in shell scripts, use
	      the format VAR=VALUE to specify both  the	 variable
	      and the value, for example:

	      -s HIGHXFER=129

	      Without  this argument, upsrw will just display the
	      list of the variables and their possible values.

	      Some variables are strings, and can be set  to  any
	      value  within the length limit.  Others are enumer-
	      ated types and can only be set to one of those val-
	      ues.  Refer to the list to know what's available in
	      your hardware.

       -u username
	      Set the username for the connection to the  server.
	      This is optional, and you will be prompted for this
	      when using the -s option if you don't specify -u on
	      the command line.

       -p password
	      Set  the	password  to  authenticate to the server.
	      This is also optional like  -u,  and  you	 will  be
	      prompted for it if necessary.

       ups    View  or change the settings on this UPS.	 The for-
	      mat for this option is [upsname@]hostname[:port].

UNATTENDED MODE
       If you run this program inside a shell script  or  similar
       to  set	variables,  you	 will  need to specify all of the
       information on the command  line.   This	 means	using  -s
       VAR=VALUE,  -u  and -p.	Otherwise it will put up a prompt
       and your program will hang.

       This is not necessary when displaying  the  list,  as  the
       username and password are not required for read-only mode.

DIAGNOSTICS
       upsrw can't set variables on your UPS unless you provide a
       valid  username	and password.  If you get "access denied"
       errors, make sure that your upsd.users(5) has an entry for
       you,  and  that the username you are using has permissions
       to SET variables.

HISTORY
       This program used to be called upsct2, which was ambiguous
       and confusing.

SEE ALSO
       upsd(8), upscmd(8)

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

       NUT    mailing	 list	 archives    and     information:
       http://lists.exploits.org/

			 Sat Aug 31 2002		 UPSRW(8)

Vote for polarhome