Options
All
  • Public
  • Public/Protected
  • All
Menu

Module cat

@ndn/cat

This package is part of NDNts, Named Data Networking libraries for the modern web.

ndncat is a command line utility to publish and retrieve objects in various formats.

Publish and Retrieve Segmented Object

ndncat put-segmented publishes a segmented object, reading payload from standard input. It accepts the following arguments:

  • Positional argument: name prefix.
  • NDNTS_UPLINK, NDNTS_NFDREG, NDNTS_KEYCHAIN, NDNTS_KEY environment variables, as explained in @ndn/cli-common package.
  • --convention1 selects 2014 Naming Convention instead of 2019 Naming Convention for version and segment components.
  • --ver=42 inserts a specific version number as version component.
  • --ver=now (default) inserts current timestamp as version component.
  • --ver=none omits version component.
  • --no-rdr disables publishing current version as a RDR metadata packet. This is ignored with --ver=none.
  • --file=FILE reads from a file instead of standard input.
  • --chunk-size=N sets segment payload size.

ndncat get-segmented retrieves a segmented object, writing payload to standard output. It accepts the following arguments:

  • Positional argument: name prefix.
  • NDNTS_UPLINK environment variable, as explained in @ndn/cli-common package.
  • --convention1 selects 2014 Naming Convention instead of 2019 Naming Convention for version and segment components.
  • --ver=none disables version discovery and assumes either Data has no version component or the input name has version component.
  • --ver=cbp sends Interest with CanBePrefix and MustBeFresh to discover version.
  • --ver=rdr (default) sends an RDR discovery Interest to discover version.

Example

dd if=/dev/urandom of=/tmp/1.bin bs=1M count=1

# producer: serve from stdin
NDNTS_NFDREG=1 ndncat put-segmented /A </tmp/1.bin

# producer: serve from file, 8KB chunks
NDNTS_NFDREG=1 ndncat put-segmented /A --file=/tmp/1.bin --chunk-size=8192

# consumer: perform version discovery via RDR protocol
ndncat get-segmented /A >/tmp/2.bin

# consumer: perform version discovery via CanBePrefix
ndncat get-segmented --ver=cbp /A >/tmp/2.bin

# producer: use 2014 convention; retrieve with ndncatchunks
NDNTS_NFDREG=1 ndncat put-segmented --convention1 /A </tmp/1.bin
ndncatchunks /A >/tmp/2.bin

# consumer: use 2014 convention; retrieve from ndnputchunks
ndnputchunks /A </tmp/1.bin
ndncat get-segmented --convention1 --ver=rdr /A >/tmp/2.bin

diff /tmp/1.bin /tmp/2.bin
rm /tmp/1.bin /tmp/2.bin

Generated using TypeDoc