Program Files

Stephen Oliver edited this page Aug 12, 2016 · 1 revision
Clone this wiki locally

What all the files are and what they do.

Disclaimer: currently not an exhaustive list.

Table of Contents

Program

bin/, lib/
Program files needed to launch or update freenet, mostly relating to the Tanuki Java wrapper and the auto-update scripts.
license/
Licensing information.
run.sh
Freenet control shell script. (TODO windows has one, freenet.exe?)
freenet*.jar
Java packages, the core bulk of Freenet.
plugins/
Java packages for plugins, and their SHA-1 sums.
seednodes.fref
List of seed node references used for announcement.
startssl.pem
SSL certificate for freenet servers. Used by update.sh/update.cmd but also when loading a plugin from the central servers.
Files only used by the installer/updater:
freenet-latest-installer-windows.exe, freenet-latest-installer-nonwindows.jar
Official installer
update.sh
Update script, to run outside of the main Freenet daemon.
wrapper_Linux.zip
Archive containing the Tanuki Java wrapper.
sha1test.jar
Downloads files and verifies checksums
freenet*.jar.sha1, seednodes.fref.sha1, update.sha1, wrapper_Linux.zip.sha1, plugins/*.sha1
SHA-1 sums used by the install/update scripts to verify downloads.

Config

wrapper.conf, freenet.ini
The main configuration files.
freenet.l10n.*.override.properties
Language overrides, defined by the user.

Node references

seednodes.fref
List of seed node references used for announcement.
node-XXXX, peers-XXXX, opennet-ZZZZ, openpeers-ZZZZ, openpeers-old-ZZZZ
Your darknet (X) and opennet (Z) identities and peers.

User state

master.keys
Don't lose these!
node.db4o (or node.db4o.crypt)
Persistent download status (pre-1468)
client.dat (or client.dat.crypt)
Persistent downloads/uploads status (post 1468)
client.dat.bak (or client.dat.bak.crypt)
Backup of persistent downloads/uploads status
extra-peer-data-XXXX
Stuff like N2N messages.
persistent-temp-XXXX
Persistent temp files - space used by in-progress persistent downloads/uploads (also .fblob's for auto-updater)
bookmarks.dat, completed.list.downloads, completed.list.uploads
Self-explanatory.
Note that post 1468, the downloaded blocks and status information for any given download are stored in a separate file. This might be in persistent-temp, but in some cases it will be in the folder the download is being saved to (as it can then be truncated and renamed when the download is finished). It will be larger than the (compressed) file and have a similar filename ending with .freenet-tmp.

Run-time state

bootID
Changes on each startup so we can tell whether we have shutdown cleanly
prng.seed
Seed for the PRNG.
client-throttle.dat, node-throttle.dat
Used by load management
packets-XXXX.dat, packets-ZZZZ.dat,
Used by internet connectivity page
uptime.dat, uptime.old.dat
Used to determine uptime so we can tell other peers

Storage

datastore/
See Datastore
downloads/
Completed downloads.

Logs

hs_err_pidNNNN.log
Log dumped when the JVM crashes
logs/, wrapper.log*
Freenet logs and Wrapper logs.
Category:Architecture