NABUCTL(1)

NAME
nabuctl - Send control messages to nabud

SYNOPSIS
nabuctl [-d]

DESCRIPTION
nabuctl is a tool for sending control messages to nabud(8). nabuctl must be run on the same system as nabud(8).

nabuctl accepts the following options:

-d  Enables extremely verbose debugging messages.

Upon start-up nabuctl queries the server version and enters an interactive command mode. The following top-level commands are available:

exit
    This command exits nabuctl.

quit
    This is a synonym for “exit”.

help
    Displays a list of available commands.

?   This is a synonym for “help”.

channel number subcommand
    Specifies an operation on a channel. A channel sub-command must follow.

connection number subcommand
    Specifies an operation on a connection. A connection sub-command must follow.

list channels|connections
    Lists either the available channels or connections.

show channel|connection number
    Shows details about either a channel or a connection.

show all channels|connections
    Show details about all channels or connections.

  Channel subcommands
The following channel subcommands are available:

clear-cache
    Clears the channel's cache on the server.

listing
    Retrieve and display the channel's listing. Note that not all channels have listings; this is intended primarily for the NabuRetroNet “HomeBrew” channel.

  Connection subcommands

cancel
    Cancels a connection. This is useful mainly for TCP/IP connections.

channel number
    Selects channel number as this connection's channel.

listing
    This displays the channel listing for the connection's currently-selected channel.

file number
    This selects the file that will be loaded by the NABU when it requests image 000001 (the boot image). The Ar number argument is the file number obtained from the “listing” subcommand.

FILES
nabuctl connects to the control message socket at:

    /tmp/nabuctl.sock

SEE ALSO
nabud(8)