nut-rs/rupsc/README.md
Aram Peres d36999db6d
Add SSL support (#7)
Fixes #1
2021-07-31 08:43:26 -04:00

1.8 KiB

rupsc

crates.io Documentation MIT licensed CI

A Rust clone of upsc, the Network UPS Tools (NUT) demo program to display UPS variables.

Written using the nut-client crate.

  • Connect to upsd/nut-server using TCP
  • List UPS devices
  • List variables for a UPS device
  • Get variable value of a UPS device
  • List clients connected to a UPS device
  • Connect securely with SSL

Installation

# Using cargo
cargo install rupsc

# Or, build for other targets
# (make sure you install the appropriate toolchain & gcc linker)
cargo build --release --target armv7-unknown-linux-gnueabihf
cargo build --release --target aarch64-unknown-linux-gnu
cargo build --release --target arm-unknown-linux-gnueabihf

Usage

This is a clone of upsc, so the usage is the same:

# Show usage
rupsc -h

# List variables on UPS device "nutdev1" (assumes upsd running on 127.0.0.1:3493)
rupsc nutdev1

# List variables on UPS device "nutdev1" (remove upsd)
rupsc nutdev1@192.168.1.2:3493

# List available UPS devices
rupsc -l

# List available UPS devices, with description
rupsc -L

# List clients connected to UPS device "nutdev1"
rupsc -c nutdev1

However, there are also some additions:

# Enable network debugging (global flag).
ruspc -D

# Enable SSL
rupsc -S

Pronunciation

r-oopsie