⚡ ssh-shut

A C utility to securely shut down/reboot remote machines via SSH.

##Dependance

-sshpass

arch linux:

pacman -S sshpass

debian:

apt install sshpass

📖 Overview

ssh-shut is a command-line interface (CLI) utility developed in C, designed to provide a secure and efficient way to remotely shut down or reboot machines using the SSH protocol. It aims to simplify the management of remote systems for administrators and users who need reliable remote power control.

✨ Features

Based on the project's description, ssh-shut is expected to offer the following core functionalities:

• Secure Remote Access: Leverages the robust SSH protocol for encrypted communication.
• Remote Shutdown: Initiates a graceful shutdown of a specified remote machine.
• Remote Reboot: Triggers a system reboot on a target remote machine.
• C-based Efficiency: Provides a lightweight and performant solution compiled directly to machine code.

🛠️ Tech Stack

Core Language:

🚀 Quick Start

To get ssh-shut up and running, follow these steps:

Prerequisites

• C Compiler: A C compiler like GCC or Clang (e.g., build-essential package on Debian/Ubuntu).
• Make: The make utility for building the project.
• SSH Client Libraries: Depending on implementation, you might need libssh or similar development libraries (e.g., libssh-dev on Debian/Ubuntu). This will be resolved during compilation.

Installation

1. Clone the repository

   git clone https://github.com/undercraft2206/ssh-shut.git
   cd ssh-shut

2. Navigate to the source directory The core C source files and Makefile are expected to be within the ssh-shut subdirectory:

   cd ssh-shut

3. Compile the utility

   gcc ssh-shut.c -o ssh-shut
   ./ssh-shut

   This command will compile the C source code and create an executable named ssh-shut in the current directory.

📖 Usage

Once installed, you can use ssh-shut to interact with your remote machines.

Basic Commands

# launch the program
./ssh-shut 

⚙️ Configuration

As a C-based CLI utility, ssh-shut may offer configuration through command-line arguments. Environment variables are less common for simple C tools.

Environment Variables

No specific environment variables have been detected. If any are used, they would typically be for advanced logging or connection settings.

Configuration Files

No dedicated configuration files (e.g., .conf, .ini) have been detected in the repository structure. All configurations are expected to be handled via command-line options.

Running Tests

No explicit testing framework or test files were detected for this C project. Testing would typically involve manually running the compiled utility with various arguments and observing its behavior and output..

Made with ❤️ by undercraft2206

README made with https://readmestudio.zenui.net/editor