Skip to main content

Module cli

Module cli 

Source
Expand description

rdrop — ringdrop CLI

§Usage

# Manage the background daemon
rdrop daemon start                   # start daemon in the background
rdrop daemon stop                    # stop the running daemon
rdrop daemon status                  # show daemon status and node ID

# Print your peer-id so others can add you to their rings
rdrop id

# Manage rings
rdrop ring new friends               # create a ring named "friends"
rdrop ring list                      # list all rings
rdrop ring add friends <peer-id>     # add a peer to a ring (auto-registers in address book)
rdrop ring members friends

# Manage the local peer address book
rdrop peer add <peer-id>                    # register a peer
rdrop peer add <peer-id> --nickname alice   # register with a nickname (idempotent; re-run to rename)
rdrop peer list                             # list all known peers
rdrop peer remove <peer-id>                 # remove peer from address book, rings, and grants

# Import a file and get a ticket (shortcut)
rdrop import file.txt                       # untagged — warns until tagged
rdrop import file.txt --open                # publicly accessible
rdrop import file.txt --ring friends        # restrict to a ring
rdrop import file.txt --ring friends --ring work  # multiple rings

# Manage blobs
rdrop blob import file.txt --ring friends
rdrop blob list
rdrop blob remove file.txt
rdrop blob remove <hash>

# Attach or detach a blob from rings at any time
rdrop blob attach file.txt friends     # associate with a ring
rdrop blob attach <hash> --open        # associate with the public ring
rdrop blob detach file.txt friends     # remove one ring association
rdrop blob detach <hash> --open        # revoke public ring association
rdrop blob detach <hash> --all         # revoke all ring associations

# Receive — resumes automatically if interrupted
rdrop receive rdrop://ABCDEF... [--dest ./downloads]

# Inspect a ticket without downloading
rdrop info rdrop://ABCDEF...

# Manage catalog access grants
rdrop grant add <peer-id> <privilege>           # e.g. blob-list
rdrop grant remove <peer-id> <privilege>
rdrop grant list [--peer <peer-id>] [--privilege <privilege>]

# Query remote nodes
rdrop remote blob-list <peer-id>                # list blobs accessible to you on a remote node

Functions§

run
Parses CLI arguments and dispatches the requested command to the daemon.