cjdcmd-ng

README

cjdcmd-ng

Usage: 
  cjdcmd [command]
Available Commands: 
  ping <IPv6/DNS>                                               Preforms a cjdns ping to a specified address.
  route <IPv6/DNS/Path>                                         Prints all routes to a specific node
  traceroute <IPv6/DNS/Path>                                    Performs a traceroute on a specific node by pinging each known hop to the target on all known paths
  ip <cjdns public key>                                         Converts a cjdns public key to its corresponding IPv6 address.
  peers [<IPv6/DNS/Path>]                                       Displays a list of currently connected peers for a node, if no node is specified your peers are shown.
  host <IPv6/DNS>                                               Returns a list of all known IP addresses for a specified hostname or the hostname for an address.
  cjdnsadmin <-file /path/to/cjdroute.conf>                     Generates a .cjdnsadmin file in your home diectory using the specified cjdroute.conf as input
  addpeer '<json peer details>'                                 Adds the peer details to your config file
  addpass [password]                                            Adds the password to your config file, or generates one and then adds that
  listpass                                                      ALPHA FEATURE - List currently loaded peering passwords.
  cleanconfig [-file] [-outfile]                                Strips all comments from the config file and saves it at outfile
  log [--level level] [--file file] [--line]                    Prints cjdns logs to stdout
  passgen [prefix]                                              Generates a random alphanumeric password between 15 and 50 characters. If you provide [prefix], it will be prepended. This is to help you keep track of your peering passwords
  dump                                                          Dumps the entire routing table to stdout.
  nick <IPv6/DNS>                                               Scrape HyperIRC for nicks using host
  convert                                                       Convert key forms
  connect PUBLIC_KEY HOST:PORT [ PASSWORD ] [ INTERFACE_INDEX ] Connect directly to another node over UDP
  info HOST [ HOST ... ]                                        Show node information
  help [command]                                                Help about any command
 Available Flags:
  -h, --help=false: help for cjdcmd
  -r, --resolve=true: reverse resolve IP addresses
  -v, --verbose=false: verbose output
Use "cjdcmd help [command]" for more information about that command.

Install from source

To install go, check out the install instructions.

Run the following command to have cjdcmd-ng download, build, and install:

go get github.com/ehmry/cjdcmd-ng

Configuration

You'll need a to create the file ''~/.cjdnsadmin'' so that cjdcmd-ng knows how to connect to CJDNS.

{
        "addr": "127.0.0.1",
        "port": 11234,
        "password": "xxxxxxxxxxxxxxxxxxxxxxx",
        "config": "/etc/cjdroute.conf"
}

If you are using NixOS (like me) the password is stored in /etc/cjdns.keys.

Documentation

Overview

* You may redistribute this program and/or modify it under the terms of * the GNU General Public License as published by the Free Software Foundation, * either version 3 of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see <http://www.gnu.org/licenses/>.

Notes

Bugs

• Find a better way of dealing with these errors.

• Instead of printing x amount of characters, print the previous and following 2 lines

• oft useless instantiation