UPSC(8)                    <?><?><?><?><?><?><?> NUT                   UPSC(8)

<?><?><?> (NAME)
       upsc - <?><?><?><?><?><?> <?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> NUT

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       upsc [-j] -l | -L [host]

       upsc [-j] ups [variable]

       upsc [-j] -c ups

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> upsc <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> (UPS) <?><?><?><?><?> <?><?><?>
       <?><?><?>. <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> UPS <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -j
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> JSON. <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?>
           <?><?> <?><?><?> JSON <?><?> stdout <?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?> JSON <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>:

           `upsc -j -l`: <?><?><?><?><?><?><?><?> JSON <?><?> <?><?><?><?><?><?><?> UPS <?><?> <?><?><?><?><?><?><?><?><?><?><?>.
           `upsc -j -L`: <?><?><?> JSON <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> UPS <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>.
           `upsc -j <ups>`: <?><?><?> JSON <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>.
           `upsc -j <ups> <variable>`: <?><?> <?><?><?><?> JSON <?><?><?><?><?> (<?><?><?><?><?>) <?><?> <?><?><?><?><?><?><?><?><?><?><?>.
           `upsc -j -c <ups>`: <?><?><?><?><?><?><?><?> JSON <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>.

       -l host
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> UPS
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> host<?> <?><?>
           <?><?><?> <?><?> <?><?> <?><?>. <?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?> "localhost" <?><?><?>.
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

       -L host
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> UPS
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> host<?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           upsd(8) <?><?><?><?><?><?> <?><?> <?><?><?><?> ups.conf(5) <?><?>.
           <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
           "localhost" <?><?><?>. <?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       -c ups
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?> ups<?> <?><?> <?><?><?> <?><?> <?><?> <?><?>.

       ups
           <?><?><?><?><?> <?><?><?><?><?> <?><?> UPS. <?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> upsname[@hostname[:port]]
           <?><?><?>. <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           "localhost" <?><?><?>.

       variable
           <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?> upsc <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?>
           <?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> (pipe) <?><?><?><?><?> <?><?> grep
           <?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (COMMON OPTIONS)
       -h
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?>.

       -D
           <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           (debugging). <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> NUT_DEBUG_LEVEL <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       -V
           <?><?><?><?><?> <?><?><?> <?><?><?><?> NUT. <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> export NUT_DEBUG_LEVEL=1 <?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?>.

       -W secs
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> (timeout) <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> (<?><?>
           <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>).
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           NUT_DEFAULT_CONNECT_TIMEOUT <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> UPS <?><?> <?><?><?> "myups" <?><?><?>
       <?><?><?><?><?><?> "mybox"<?> <?><?> <?><?><?><?><?> upsd(8) <?><?><?>
       <?><?><?><?> 1234:

           :; upsc myups@mybox:1234
           battery.charge: 100.0
           battery.voltage: 13.9
           battery.voltage.nominal: 13.6
           . . .

       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       "myups" <?><?> <?><?><?><?> <?><?> <?><?><?> JSON:

           :; upsc -j myups@mybox:1234
           {
             "battery.charge": "100.0",
             "battery.voltage": "13.9",
             "battery.voltage.nominal": "13.6",
             ...
           }

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> UPS<?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?>:

           :; upsc -L
           apc: Back-UPS 500
           ppro2: Patriot Pro II

       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       UPS<?><?><?> <?><?><?><?> <?><?> mybox <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?> Bourne-shell:

           :; for UPS in `upsc -l mybox:1234`; do
               upsc $UPS ups.status
           done

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> "myups":

           :; upsc -c myups
           127.0.0.1
           ::1
           192.168.1.2

<?><?><?><?> <?><?><?><?><?><?><?><?> (SCRIPTED MODE)
       <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> stdout <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       stderr.

<?><?><?><?><?><?><?><?> (DIAGNOSTICS)
       <?><?><?><?><?><?> upsc <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> UPS<?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> UPS<?> <?><?> <?><?>
       <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?> UPS
       <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> upsd(8) <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?> <?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (HISTORY)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> upsfetch <?> <?><?><?><?><?><?><?><?>
       UDP <?><?><?><?> <?><?><?><?><?> <?><?> upsd <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?> upsc <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> upsclient <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?> TCP
       <?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?><?>
       upsct <?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       upslog(8), ups.conf(5), upsd(8)

   <?><?><?><?><?> <?><?><?><?><?><?><?><?>:
       <?><?><?><?> <?><?><?><?><?> NUT (Network UPS Tools):
       https://www.networkupstools.org/historic/v2.8.5

Network UPS Tools 2.8.5           06/21/2026                           UPSC(8)