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.
  memory                                     :: Returns the bytes of memory allocated by the router
  nick <IPv6/DNS>                            :: Scrape HyperIRC for nicks using host
  help [command]                             :: Help about any command

 Available Flags:
  -r, --resolve=false: 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