Upgrade policies to SVN version and fix a small bug.
[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 # Unload the packages cache after an interval of inactivity this long.
33 # The packages cache uses a lot of memory, and only takes a few seconds
34 # to reload when a new request arrives.
35 UNLOAD_PACKAGES_CACHE = 5m
36
37 # Refresh the DHT keys after this much time has passed.
38 # This should be a time slightly less than the DHT's KEY_EXPIRE value.
39 KEY_REFRESH = 57m
40
41 # Which DHT implementation to use.
42 # It must be possile to do "from <DHT>.DHT import DHT" to get a class that
43 # implements the IDHT interface. There should also be a similarly named
44 # section below to specify the options for the DHT.
45 DHT = apt_dht_Khashmir
46
47 # Whether to only run the DHT (for providing only a bootstrap node)
48 DHT-ONLY = no
49
50 #######################  apt_dht_Khashmir  ############################
51 # This is the default (included) DHT to use.
52 [apt_dht_Khashmir]
53
54 # To specify a different (UDP) port for the DHT to use.
55 # If not specified here, the PORT value in the DEFAULT section will be used.
56 # PORT = 
57
58 # bootstrap nodes to contact to join the DHT
59 BOOTSTRAP = www.camrdale.org:9977
60             steveholt.hopto.org:9976
61
62 # whether this node is a bootstrap node
63 BOOTSTRAP_NODE = no
64
65 # Kademlia "K" constant, this should be an even number
66 K = 8
67
68 # SHA1 is 160 bits long
69 HASH_LENGTH = 160
70
71 # interval between saving the running state
72 CHECKPOINT_INTERVAL = 5m
73
74 # concurrent number of calls per find node/value request!
75 CONCURRENT_REQS = 4
76
77 # how many hosts to post values to
78 STORE_REDUNDANCY = 3
79
80 # How many values to attempt to retrieve from the DHT.
81 # Setting this to 0 will try and get all values (which could take a while if
82 # a lot of nodes have values). Setting it negative will try to get that
83 # number of results from only the closest STORE_REDUNDANCY nodes to the hash.
84 # The default is a large negative number so all values from the closest
85 # STORE_REDUNDANCY nodes will be retrieved.
86 RETRIEVE_VALUES = -10000
87
88 # how many times in a row a node can fail to respond before it's booted from the routing table
89 MAX_FAILURES = 3
90
91 # never ping a node more often than this
92 MIN_PING_INTERVAL = 15m
93
94 # refresh buckets that haven't been touched in this long
95 BUCKET_STALENESS = 1h
96
97 # expire unrefreshed entries older than this
98 KEY_EXPIRE = 1h
99
100 # whether to spew info about the requests/responses in the protocol
101 SPEW = no