More work on the TODO.
[quix0rs-apt-p2p.git] / apt-dht.conf
1 # The apt-dht configuration file.
2 #
3 # This is an ini-type configuration file, using sections identified by
4 # square brackets. Values are specified on a single line using the '='
5 # sign. Some values indicate times, in which case a suffix of 'd' for
6 # days, 'h' for hours, 'm' for minutes, and 's' for seconds can be used.
7 # Some values can span multiple lines by starting the subsequent lines
8 # with one or more spaces.
9 #
10 #########################  DEFAULT  ###################################
11 # This is the default section containing the configuration options for the
12 # main application.
13 [DEFAULT]
14
15 # The number of the port to listen on for requests.
16 # The main application will use this TCP port to listen for requests from APT, and
17 # for uploads to other peers. If a port is not specified for the DHT, it will also
18 # use this UDP port to listen for DHT requests.
19 PORT = 9977
20     
21 # Directory to store the downloaded files in
22 CACHE_DIR = /var/cache/apt-dht
23     
24 # Other directories containing packages to share with others
25 # WARNING: all files in these directories will be hashed and available
26 #          for everybody to download
27 # OTHER_DIRS = 
28     
29 # Whether it's OK to use an IP addres from a known local/private range
30 LOCAL_OK = no
31
32 # Which DHT implementation to use.
33 # It must be possile to do "from <DHT>.DHT import DHT" to get a class that
34 # implements the IDHT interface. There should also be a similarly named
35 # section below to specify the options for the DHT.
36 DHT = apt_dht_Khashmir
37
38 # Whether to only run the DHT (for providing only a bootstrap node)
39 DHT-ONLY = no
40
41 #######################  apt_dht_Khashmir  ############################
42 # This is the default (included) DHT to use.
43 [apt_dht_Khashmir]
44
45 # To specify a different (UDP) port for the DHT to use.
46 # If not specified here, the PORT value in the DEFAULT section will be used.
47 # PORT = 
48
49 # bootstrap nodes to contact to join the DHT
50 BOOTSTRAP = www.camrdale.org:9977
51             steveholt.hopto.org:9976
52
53 # whether this node is a bootstrap node
54 BOOTSTRAP_NODE = no
55
56 # Kademlia "K" constant, this should be an even number
57 K = 8
58
59 # SHA1 is 160 bits long
60 HASH_LENGTH = 160
61
62 # interval between saving the running state
63 CHECKPOINT_INTERVAL = 15m
64
65 # concurrent number of calls per find node/value request!
66 CONCURRENT_REQS = 4
67
68 # how many hosts to post values to
69 STORE_REDUNDANCY = 3
70
71 # how many times in a row a node can fail to respond before it's booted from the routing table
72 MAX_FAILURES = 3
73
74 # never ping a node more often than this
75 MIN_PING_INTERVAL = 15m
76
77 # refresh buckets that haven't been touched in this long
78 BUCKET_STALENESS = 1h
79
80 # time before expirer starts running
81 KEINITIAL_DELAY = 15s
82
83 # time between expirer runs
84 KE_DELAY = 20m
85
86 # expire entries older than this
87 KE_AGE = 1h
88
89 # whether to spew info about the requests/responses in the protocol
90 SPEW = no