Skip to content

ycd/dstp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dstp

dstp, run common networking tests against your site.

dstp gif


Usage

Usage: dstp [OPTIONS] [ARGS]
Options:
        -a, --addr   <string>  The URL or the IP address to run tests against      [REQUIRED]
        -o, --out    <string>  The type of the output, either json or plaintext    [Default: plaintext] 
        -p           <int>     Number of ping packets                              [Default: 3]
        -t           <int>     Give up on ping after this many seconds             [Default: 2s per ping packet]
        --port       <string>  Port for testing TLS and HTTPS connectivity         [Default: 443]
        -h, --help             Show this message and exit.

Motivation

A comment on lobste.rs, in a thread about DNS gave a great idea and thought a robust tool like that come in handy!

Installation

Packages

Homebrew

For Homebrew on macOS, install the ycd/tap/dstp formula.

brew install ycd/tap/dstp

Go Install

go install github.com/ycd/dstp/cmd/dstp@latest

NixOS

  1. Add dstpto /etc/nixos/configuration.nix:
environment.systemPackages = with pkgs; [
  dstp
];
  1. Run:
sudo nixos-rebuild switch

Arch Linux

git clone https://aur.archlinux.org/dstp.git
cd dstp
makepkg -sri

Downloads

Binary downloads of example are available from the releases section on GitHub for 64-bit Windows, macOS, and Linux targets. They contain the compiled executable.

platform
macOS ARM 64 Bit
macOS 64 Bit
Linux 32-Bit
Linux ARM 64 Bit
Linux 64 Bit
Windows 64 Bit
Windows 32 Bit

Installation from source

  1. Verify that you have Go 1.17+ installed (The source code uses ( //go:build ) conditional compilation directives that is introduced in Go 1.17.)

    $ go version
    

    If go is not installed, follow instructions on the Go website.

  2. Clone this repository

    $ git clone https://github.com/ycd/dstp 
    $ cd dstp
    
  3. Build and install

    Unix/Linux

    # May require you to use sudo
    $ go build cmd/dstp/main.go
    $ cp dstp /usr/local/bin/dstp
    

    Mac/BSD

    # May require you to use sudo
    $ make
    $ cp dstp /usr/local/bin/dstp
    
  4. Verify installation

    $ dstp -h 
    
    Usage: dstp [OPTIONS] [ARGS]
    Options:
          -a, --addr   <string>  The URL or the IP address to run tests against      [REQUIRED]
          -o, --out    <string>  The type of the output, either json or plaintext    [Default: plaintext]
          -p           <int>     Number of ping packets                              [Default: 3]
          -t           <int>     Give up on ping after this many seconds             [Default: 2s per ping packet]
          --port       <string>  Port for testing TLS and HTTPS connectivity         [Default: 443]
          -h, --help             Show this message and exit.
    

Contributing

All kinds of Pull Requests and Feature Requests are welcomed!

Licence

dstp's source code is licenced under the MIT License.