apt-p2p.conf

   1 # The apt-p2p 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 # The rate to limit sending data to peers to, in KBytes/sec.
  22 # Set this to 0 to not limit the upload bandwidth.
  23 UPLOAD_LIMIT = 0
  24
  25 # The minimum number of peers before the mirror is not used.
  26 # If there are fewer peers than this for a file, the mirror will also be
  27 # used to speed up the download. Set to 0 to never use the mirror if
  28 # there are peers.
  29 MIN_DOWNLOAD_PEERS = 3
  30
  31 # Directory to store the downloaded files in
  32 CACHE_DIR = /var/cache/apt-p2p
  33
  34 # Other directories containing packages to share with others
  35 # WARNING: all files in these directories will be hashed and available
  36 #          for everybody to download
  37 # OTHER_DIRS =
  38
  39 # Whether it's OK for the application to use for sharing files an IP
  40 # address from a known local or private range (RFC 1918). This should
  41 # only be set true if you are running your own private apt-p2p network
  42 # that no one else will be connecting to.
  43 LOCAL_OK = no
  44
  45 # Whether a remote peer can access the statistics page
  46 REMOTE_STATS = yes
  47
  48 # Unload the packages cache after an interval of inactivity this long.
  49 # The packages cache uses a lot of memory, and only takes a few seconds
  50 # to reload when a new request arrives.
  51 UNLOAD_PACKAGES_CACHE = 5m
  52
  53 # Refresh the DHT keys after this much time has passed.
  54 # This should be a time slightly less than the DHT's KEY_EXPIRE value.
  55 KEY_REFRESH = 2.5h
  56
  57 # The user name to try and run as (leave blank to run as current user)
  58 USERNAME = apt-p2p
  59
  60 # Which DHT implementation to use.
  61 # It must be possible to do "from <DHT>.DHT import DHT" to get a class that
  62 # implements the IDHT interface. There should also be a similarly named
  63 # section below to specify the options for the DHT.
  64 DHT = apt_p2p_Khashmir
  65
  66 # Whether to only run the DHT (for providing only a bootstrap node)
  67 DHT-ONLY = no
  68
  69 #######################  apt_p2p_Khashmir  ############################
  70 # This is the default (included) DHT to use.
  71 [apt_p2p_Khashmir]
  72
  73 # To specify a different (UDP) port for the DHT to use.
  74 # If not specified here, the PORT value in the DEFAULT section will be used.
  75 # PORT =
  76
  77 # bootstrap nodes to contact to join the DHT
  78 BOOTSTRAP = www.camrdale.org:9977
  79             www.camrdale.org:9976
  80             steveholt.hopto.org:9976
  81
  82 # whether this node is a bootstrap node
  83 BOOTSTRAP_NODE = no
  84
  85 # interval between saving the running state
  86 CHECKPOINT_INTERVAL = 5m
  87
  88 # concurrent number of calls per find node/value request!
  89 CONCURRENT_REQS = 8
  90
  91 # how many hosts to post values to
  92 STORE_REDUNDANCY = 6
  93
  94 # How many values to attempt to retrieve from the DHT.
  95 # Setting this to 0 will try and get all values (which could take a while if
  96 # a lot of nodes have values). Setting it negative will try to get that
  97 # number of results from only the closest STORE_REDUNDANCY nodes to the hash.
  98 # The default is a large negative number so all values from the closest
  99 # STORE_REDUNDANCY nodes will be retrieved.
 100 RETRIEVE_VALUES = -10000
 101
 102 # how many times in a row a node can fail to respond before it's booted from the routing table
 103 MAX_FAILURES = 3
 104
 105 # never ping a node more often than this
 106 MIN_PING_INTERVAL = 15m
 107
 108 # refresh buckets that haven't been touched in this long
 109 BUCKET_STALENESS = 1h
 110
 111 # Whether it's OK to add nodes to the routing table that use an IP
 112 # address from a known local or private range (RFC 1918). This should
 113 # only be set true if you are running your own private apt-p2p network
 114 # that no one else will be connecting to.
 115 # If not specified here, the LOCAL_OK value in the DEFAULT section will be used.
 116 # LOCAL_OK = no
 117
 118 # expire unrefreshed entries older than this
 119 KEY_EXPIRE = 3h
 120
 121 # Timeout KRPC requests to nodes after this time.
 122 KRPC_TIMEOUT = 9s
 123
 124 # KRPC requests are resent using exponential backoff starting with this delay.
 125 # The request will first be resent after the delay set here.
 126 # The request will be resent again after twice the delay set here. etc.
 127 # e.g. if TIMEOUT is 9 sec., and INITIAL_DELAY is 2 sec., then requests will
 128 # be resent at times 0, 2 (2 sec. later), and 6 (4 sec. later), and then will
 129 # timeout at 9.
 130 KRPC_INITIAL_DELAY = 2s
 131
 132 # whether to spew info about the requests/responses in the protocol
 133 SPEW = no