.Dd 2025-09-25
.Dt DATT 1
.Os WORLIO
.ds REPO dat://59d8099399510e23a3c693fb5887b7bba1586f4117f7ef1c5872622ada0c1181
.Sh NAME
.Nm dat-thang
.Nd call a dat method
.Sh SYNOPSIS
.Nm
.Oo 
.Op Fl c Ar create
	.Oo 
	.Op Fl d Ar debug
	.Oo 
		.Op Fl s Ar sync
			.Oo 
			.Op Fl t Ar type
				.Oo 
				.Op Fl v Ar version
				.Ar method
				.Op Ar argument ...
			
		
	

.Oc
.Sh DESCRIPTION
The C dat command creates and maintains local Dat archives. Archive metadata
is append-only, so each metadata entry advances the archive version and older
file contents remain addressable by their earlier version number.
.Pp
The status subcommand reports the archive key, current version, metadata entry
count, and latest live path counts. The files subcommand lists the paths at
the current version, or at a selected historical version.
.Pp
Canonical archive addresses use the historical 64-character hexadecimal key.
Base32768 is available for compact test addresses with Cm dat url --compact;
the parser accepts both forms. Secret key filenames and dat-dns records
continue to use hexadecimal keys.
.Pp
The library provides an archive session, Cesspool discovery, and a Hypercore
feed codec. The `hypercore` build selects the legacy V6 wire session. Discovery
and transport establishment are separate layers.
.Sh COMMANDS
.Bl -tag -width "checkout"
.It Cm create , init
Create an archive, write its title, description, and dat:// address as a
`dat.scm` S-expression, and print the address. New archives do not get a
`dat.json` sidecar. `--title` and `--description` set the presentation fields.
.It Cm share , sync
Import changed local paths into the archive.
.It Cm status
Show the archive key and metadata/version counts.
.It Cm files Op version
List the live files and directories at a version.
.It Cm log
Show appended metadata entries, including history and tombstones.
.It Cm cat Ar version path
Write a historical file's bytes to standard output.
.It Cm checkout Ar version destination
Export a historical snapshot to a directory.
.It Cm url Op version Op path
Print an archive URL, optionally pinned to a version and path.
.It Cm resolve Ar hostname
Resolve a dat-dns hostname through the legacy HTTPS /.well-known/dat response
and print its canonical dat:// key and TTL. This does not use the operating
system DNS TXT resolver.
.It Cm dns set Ar hostname archive-dir|dat://key
Create or replace this machine's local dat-dns name mapping. Names are stored
in Pa ~/.dat/dat-dns and used by resolve and the dat-thang SITE field. For
public Dillo-compatible resolution, publish an HTTPS /.well-known/dat file
whose first line is dat:// followed by the archive's 64-digit key and whose
optional second line is TTL=<seconds>.
.It Cm dns list
List local dat-dns name mappings.
.It Cm dns remove Ar hostname
Remove a local dat-dns name mapping.
.It Cm verify Op dir
Verify metadata and content feeds with the archive's public keys.
.It Cm bootstrap Op udp-port
Run a Cesspool rendezvous node on all local interfaces. The node prints the
DDAT_BOOTSTRAP setting participating C clients should use. The UDP port must
be reachable from those clients through the host firewall and router. Peer
records expire after ten minutes without an announce or lookup. This is the
Cesspool protocol used by dat-thang and cable-thang, not the historical
JavaScript Dat BitTorrent DHT bootstrap protocol.
.It Cm bootstrap add Ar host:port
Save a Cesspool rendezvous endpoint for dat-thang and cable-thang in the
per-user configuration file. It is used in addition to DDAT_BOOTSTRAP.
.It Cm bootstrap set Ar host:port
Replace the active rendezvous list with one Cesspool endpoint. The desktop
client exposes the same setting under Settings, so this command is only needed
for terminal-only setup.
.El
.Sh OPTIONS
.It Fl d
Debug
.Sh FILES
.Bl -tag -width -indent
.It Pa ~/.dat/secret_keys/
Contains private feed secrets as raw Ed25519 secret bytes, indexed by
discovery key. See the key format and Dat Desktop compatibility notes in
the installed key-management.md documentation.
.Sh AUTHORS
"Dat" was first written about by Mathias Buus Madsen & Maxwell Ogden (c) 2015
.Nm
was written and directed by
.An 𝖼̴̸͍͚͍̝͓̘͌̽͑̚͝͝𝗁̵̸̻͇̘̝̞͍̈́̔̾̾̓͘𝗎̸̴̡̼͕̻̦̓́̓̈́͘͜͠𝗋̸̵̡͎̼͇͖͊͐͆͜͝͝𝗍̸̸͕̠̼̙͚̻͆́̈́̒͛͝𝗓̵̴̢̟̝͎̝̪̓̀̕̚͝𝖺̸̸͚͓̠͕͕̒̒́͋͜͝͠𝗇̴̵͙̞͇̙͕̐͋̈́͌͒͜ Aq @4c3NtV5p+7MRCwinLcD+dVMgz2rGbX2wF/ZtDxBA/Lw=.ed25519
.Sh BUGS
.Pp
Go ahead an fix em ;)
.Lk \*[REPO]