beacons

package
v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 17, 2025 License: GPL-3.0 Imports: 23 Imported by: 0

README

client/command/beacons

Overview

Implements the 'beacons' command group for the Sliver client console. Handlers map Cobra invocations to beacons workflows such as prune, RM, and watch.

Go Files

  • beacons.go – Retrieves beacon inventories and renders them in tabular form with optional filtering.
  • commands.go – Declares the beacons command set, binds flags/completions, and wires subcommands like prune, rm, and watch.
  • helpers.go – Provides helper RPC wrappers for selecting, fetching, and listing beacons.
  • prune.go – Implements the prune routine that removes stale beacon entries via the backend API.
  • rm.go – Removes a specific beacon by ID, coordinating confirmation and RPC teardown.
  • watch.go – Streams beacon events in a watch loop, handling cancellation and console interaction.

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	// ErrNoBeacons - No sessions available
	ErrNoBeacons = errors.New("no beacons")
	// ErrNoSelection - No selection made
	ErrNoSelection = errors.New("no selection")
	// ErrBeaconNotFound
	ErrBeaconNotFound = errors.New("no beacon found for this ID")
)

Functions

func BeaconIDCompleter

func BeaconIDCompleter(con *console.SliverClient) carapace.Action

BeaconIDCompleter completes beacon IDs

func BeaconsCmd

func BeaconsCmd(cmd *cobra.Command, con *console.SliverClient, args []string)

BeaconsCmd - Display/interact with beacons

func BeaconsPruneCmd

func BeaconsPruneCmd(cmd *cobra.Command, con *console.SliverClient, args []string)

BeaconsPruneCmd - Prune stale beacons automatically

func BeaconsRmCmd

func BeaconsRmCmd(cmd *cobra.Command, con *console.SliverClient, args []string)

BeaconsRmCmd - Display/interact with beacons

func BeaconsWatchCmd

func BeaconsWatchCmd(cmd *cobra.Command, con *console.SliverClient, args []string)

BeaconsWatchCmd - Watch your beacons in real-ish time

func Commands

func Commands(con *console.SliverClient) []*cobra.Command

Commands returns the “ command and its subcommands.

func GetBeacon

func GetBeacon(con *console.SliverClient, beaconID string) (*clientpb.Beacon, error)

func GetBeacons

func GetBeacons(con *console.SliverClient) (*clientpb.Beacons, error)

func PrintBeacons

func PrintBeacons(beacons []*clientpb.Beacon, filter string, filterRegex *regexp.Regexp, con *console.SliverClient)

PrintBeacons - Display a list of beacons

func SelectBeacon

func SelectBeacon(con *console.SliverClient) (*clientpb.Beacon, error)

SelectBeacon - Interactive menu for the user to select an session, optionally only display live sessions

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL