Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/robertpeteuil/sysis
SYSIS is a cross-platform script that displays base system & network information
https://github.com/robertpeteuil/sysis
bash cli hardware-information host-discovery linux macos multi-platform network-info raspberry-pi script settings shell-script system-identification system-information
Last synced: 24 days ago
JSON representation
SYSIS is a cross-platform script that displays base system & network information
- Host: GitHub
- URL: https://github.com/robertpeteuil/sysis
- Owner: robertpeteuil
- License: mit
- Created: 2017-03-08T07:44:58.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-01-18T23:19:28.000Z (10 months ago)
- Last Synced: 2024-10-04T17:56:02.510Z (about 1 month ago)
- Topics: bash, cli, hardware-information, host-discovery, linux, macos, multi-platform, network-info, raspberry-pi, script, settings, shell-script, system-identification, system-information
- Language: Shell
- Homepage:
- Size: 171 KB
- Stars: 8
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# SYSIS - the Lightweight System-Information Utility
## Quickly Display System Information for Varied Host Types
[](https://github.com/robertpeteuil/sysis/blob/master/CHANGELOG.md)
[](https://github.com/robertpeteuil/sysis)
[](https://github.com/robertpeteuil/sysis)
---
**SYSIS provides a simple way to retrieve and display system information across multiple system types, by eliminating the need to use multiple OS specific commands.** It is especially useful for sys-admins, developers and IT Professionals who maintain simultaneous connections to multiple hosts, as it allows rapid retrieval of system info for any host.
Designed for maximum productivity:
- Simple to use and requires no parameters
- Executes quickly by focusing on most commonly needed information
- Includes Network Connection Details - Adapter Name, IPv4 Address, IPv6 Address, and MAC Address
- Details about Network Info are described in the [CHANGELOG](https://github.com/robertpeteuil/sysis/blob/master/CHANGELOG.md)
### macOS with 2 NICs: "en1" with IPv4 & IPv6, "en2" with IPv4
### Ubuntu with 1 NIC: "enp0s10" with IPv4 & IPv6
### Supported Platforms
- Linux
- macOS (OS X)
- Windows 10 Linux Shells
- Embedded Devices running Linux
### Download
Download latest release from my bootstrap server (iac.sh or )
``` shell
curl iac.sh/sysis > sysis
chmod +x sysis
# optional - move to system binary directory
sudo mv sysis /usr/local/bin
```
Download from GitHub
``` shell
curl -LO https://raw.github.com/robertpeteuil/sysis/master/sysis
chmod +x sysis
```
### Hosted Script Execution and Security
For the purpose of this utility, there are two scenarios where executing a script directly from GitHub is desirable:
- executing the installation script
- this makes for an extremely simple, one-step install
- executing `sysis` without installation
- this is enables use of the utility on hosts where installation is not possible
In general, executing hosted scripts is not secure because the scripts are executed without a chance to inspect them. Fortunately, the security risks can be mitigated by performing actions specific to each scenario.
**Preparations for Using Hosted Installation Script**
This is the easier of the two scenarios to address because you will only run the installer once and don't need to consider future changes.
- review the [installer](https://github.com/robertpeteuil/sysis/blob/master/install.sh) and ensure its safe and meets your security standards
- After review, the hosted installation script can be executed with the command below.
- This is the equivalent of the first installation option, but performed in one step.
The online-installation command:
``` shell
bash -c "`curl -s -L https://raw.github.com/robertpeteuil/sysis/master/install.sh`"
```
**Preparations for Using Hosted `sysis` Script**
- Review the [sysis script](https://github.com/robertpeteuil/sysis/blob/master/sysis) and ensure its safe and meets your security standards
- Create a fork of this repo in your GitHub account
- This provides an isolated copy that you control and allows you to review all future commits before [syncing them to your fork](https://help.github.com/articles/syncing-a-fork/).
- In your fork, edit `install.sh` and change the value assigned to `REPOACCT` to your username. (This ensures that running the installer in your fork will look for releases in your fork.)
- Change the username in the command below so the script runs from your fork.
- For ease of use, you will likely want to create an alias or terminal macro to execute the command:
``` shell
bash -c "`curl -s -L https://raw.github.com/robertpeteuil/sysis/master/sysis`"
# remember to change 'robertpeteuil' to your account name if you've created a fork
```
### Usage and Options
``` shell
USAGE: sysis [OPTIONS]
OPTIONS:
-c : compressed output (no separation lines)
-d : debug only report
-n : network only report
-h : help
-V : version info
--help : detailed help
```
### Project History
**SYSIS**, an acronym for "SYStem IS", was originally written in 2014 and released as open-source in 2017.