#!/bin/bash
# tin key help - Show key management help

set -euo pipefail

show_key_help() {
    cat << EOF
tin key - SSH Key Management for NAS Servers

USAGE:
    tin key <command> [options]

COMMANDS:
    generate <nas-server>           Generate SSH key pair for NAS server
    install <nas-server> [user]     Install public key on NAS server  
    test <nas-server> [user]        Test SSH connection to NAS server
    list                            List all generated SSH keys
    show <nas-server>               Show detailed key information
    status <nas-server> [user]      Test key status and show diagnostics
    remove <nas-server>             Remove SSH key pair
    help                            Show this help message

EXAMPLES:
    tin key generate 192.168.0.206         # Generate key for NAS
    tin key install 192.168.0.206          # Install key (uses current user)
    tin key test 192.168.0.206             # Test connection
    tin key list                           # Show all keys
    tin key show 192.168.0.206             # Show key details
    tin key remove 192.168.0.206           # Remove key

DESCRIPTION:
    Manages SSH keys for automated access to NAS servers. Keys enable
    tinsnip to perform administrative tasks without password prompts.
    
    Username defaults to current user ($(whoami)) if not specified.
    
    For more help on a specific command:
        tin key <command> --help

EOF
}

show_key_help