PitchHut logo
Efficiently manage processes on specified ports with ease.
Pitch

killport is a robust command-line utility designed to streamline the termination of processes and containers listening on specified ports across Linux, macOS, and Windows. Built in Rust, it emphasizes performance while offering features like multi-port operations and a dry-run mode for safe management.

Description

killport is a command-line utility that simplifies the process of terminating active processes and containers that are listening on specified ports. With support for both single and multiple port operations, this tool enhances system management across various platforms including Linux, macOS, and Windows. Developed in Rust, killport seamlessly combines flexibility with exceptional performance in process management tasks.

Key Features

  • Efficient Termination: Quickly kill processes or containers on specified ports, accommodating both single and multiple port requests.
  • Flexible Modes of Operation: Choose to target processes, containers, or both, depending on specific needs.
  • Safe Dry-Run Option: Preview actions with the dry-run feature, allowing for safe assessments before actual termination commands are executed.
  • Customizable Verbosity: Adjust the verbosity of logs with options for detailed output or quiet operation for minimal display.
  • Comprehensive Signal Support: Use a variety of termination signals to exercise precise control over how processes or containers are terminated.
  • Cross-Platform Compatibility: Fully functional on Linux, macOS, and Windows, providing versatile management capabilities.

Usage Examples

The command structure for killport is straightforward:

killport [OPTIONS] <ports>...

Example Commands

  • To kill a single process running on port 8080:
    killport 8080
    
  • To terminate processes on multiple ports with a specific signal:
    killport -s sigterm 8045 8046 8080
    
  • To check which processes would be affected on port 8080 without executing the command:
    killport --dry-run 8080
    

Supported Signals

killport supports a range of signals for various scenarios, from gentle requests like SIGTERM to more forceful signals such as SIGKILL. For detailed signal options, refer to the full list categorized by preference and disruption level.

Contributing to killport

Contributions to the killport project are encouraged. Interested developers can fork the repository, work on their features or bug fixes, and submit pull requests for review. Please ensure adherence to the project's coding guidelines and include appropriate tests with any changes.

0 comments

No comments yet.

Sign in to be the first to comment.