r148 - /debtorrent/trunk/config.debtorrent.ini
camrdale-guest at users.alioth.debian.org
camrdale-guest at users.alioth.debian.org
Thu Jul 12 19:01:53 UTC 2007
Author: camrdale-guest
Date: Thu Jul 12 19:01:53 2007
New Revision: 148
URL: http://svn.debian.org/wsvn/debtorrent/?sc=1&rev=148
Log:
Reorganize the config file.
Modified:
debtorrent/trunk/config.debtorrent.ini
Modified: debtorrent/trunk/config.debtorrent.ini
URL: http://svn.debian.org/wsvn/debtorrent/debtorrent/trunk/config.debtorrent.ini?rev=148&op=diff
==============================================================================
--- debtorrent/trunk/config.debtorrent.ini (original)
+++ debtorrent/trunk/config.debtorrent.ini Thu Jul 12 19:01:53 2007
@@ -19,24 +19,6 @@
# L O C A T I O N S
###############################################################################
#
-# Config Directory
-#
-# The directory to use to get/store configuration files, if left blank then
-# ~/.DebTorrent will be used.
-#
-
-# config_dir = "/etc/debtorrent"
-
-#
-# Cache Directory
-#
-# The directory to use to get/store cache files, if left blank then
-# ~/.DebTorrent will be used.
-#
-
-# cache_dir = "/var/cache/debtorrent/.cache"
-
-#
# SaveAs
#
# The directory to save the downloaded files in.
@@ -57,21 +39,34 @@
# saveas_style = 1
#
+# Cache Directory
+#
+# The directory to use to get/store cache files, if left blank then
+# ~/.DebTorrent will be used.
+#
+
+# cache_dir = "/var/cache/debtorrent/.cache"
+
+#
# Expire Cache Data
#
-# The number of days after which you wish to expire old cache data
-# (0 = disabled).
+# The number of days after which you wish to expire old cached data. Set this
+# to 0 to never expire cached data.
#
# expire_cache_data = 10
###############################################################################
-# R A T E L I M I T S
+# R A T E L I M I T S
###############################################################################
#
# Maximum Upload Rate
#
-# The maximum rate to upload at, in kB/s (0 = no limit, -1 = automatic).
+# The maximum rate to upload at:
+#
+# -1 -- try to set the rate automatically
+# 0 -- no limit
+# > 0 -- number of KB/s to limit the uploading rate to
#
# max_upload_rate = 0
@@ -79,7 +74,8 @@
#
# Maximum Download Rate
#
-# The maximum rate to download at, in kB/s (0 = no limit)
+# The maximum rate to download at, in kB/s. Set to 0 to not limit the download
+# rate.
#
# max_download_rate = 0
@@ -88,7 +84,7 @@
# Upload Rate Fudge
#
# The time equivalent of writing to kernel-level TCP buffer, for rate
-# adjustment.
+# adjustment (in seconds).
#
# upload_rate_fudge = 5.0
@@ -96,8 +92,10 @@
#
# TCP Ack Fudge
#
-# How much TCP ACK download overhead to add to upload rate calculations
-# (0 = disabled).
+# To account for the part of the upload bandwidth that is due to TCP
+# acknowledgements sent for downloaded packets, the TCP Ack Fudge fraction of
+# the downloaded bytes will be added to the uploaded bytes for the upload rate
+# calculations.
#
# tcp_ack_fudge = 0.03
@@ -120,12 +118,13 @@
# upload_unit_size = 1460
###############################################################################
-# I N C O M I N G C O N N E C T I O N S
+# C O N N E C T I O N S
###############################################################################
#
# Bind
#
-# A comma-separated list of ips and hostnames to bind to locally.
+# A comma-separated list of IPs and hostnames to bind to listen on locally.
+# Leaving this blank will cause it to listen on all IPs and hostnames.
#
# bind = ""
@@ -133,7 +132,10 @@
#
# IP
#
-# The IP to report you have to the tracker (useful for local connections).
+# The IP to report you have to the tracker. Normally the tracker can
+# successfully determine all peers external IP addresses, so this can be left
+# blank. The only exception is when the peer and tracker are behind the same
+# NAT, in which case this should be set to the external IP address of the NAT.
#
# ip = ""
@@ -141,7 +143,8 @@
#
# Minimum Port
#
-# The minimum port to try listening on. Only one will be used.
+# The minimum port to try listening on. Only one port in the range given by
+# the minimum and maximum will be used.
#
# minport = 10000
@@ -149,7 +152,8 @@
#
# Maximum Port
#
-# The maximum port to try listening on. Only one will be used.
+# The maximum port to try listening on. Only one port in the range given by
+# the minimum and maximum will be used.
#
# maxport = 60000
@@ -195,58 +199,6 @@
#
# timeout_check_interval = 60.0
-
-###############################################################################
-# T R A C K E R C O N N E C T I O N S
-###############################################################################
-#
-# Default Tracker
-#
-# The default tracker address to use for new torrents that don't specify one.
-#
-
-# default_tracker = http://dttracker.debian.net:6969/announce
-
-#
-# Rerequest Interval
-#
-# The time to wait between requesting more peers from the tracker (in seconds).
-#
-
-# rerequest_interval = 300
-
-#
-# Min Peers
-#
-# The minimum number of peers to not do tracker rerequesting when above.
-#
-
-# min_peers = 20
-
-#
-# Max Initiate
-#
-# The number of peers at which to stop initiating new connections to peers.
-#
-
-# max_initiate = 40
-
-#
-# Maximum Connections
-#
-# The absolute maximum number of peers to connect with (0 = no limit).
-#
-
-# max_connections = 0
-
-#
-# HTTP Timeout
-#
-# The number of seconds to wait before assuming that an http connection to a
-# tracker has timed out.
-#
-
-# http_timeout = 60
###############################################################################
# E N C R Y P T I O N
@@ -323,26 +275,180 @@
#
# Crypto Stealth
#
-# Whether to prevent all non-encrypted connection attempts; will result in an
-# effectively firewalled state on older trackers.
+# Whether to prevent all non-encrypted connection attempts.
#
# crypto_stealth = 0
###############################################################################
+# A P T R E Q U E S T S
+###############################################################################
+#
+# Port
+#
+# The port to listen for APT requests on.
+#
+
+# port = 9988
+
+#
+# Show InfoPage
+#
+# Whether to display an information and statistics page when the APT
+# requester's root dir is loaded. If enabled, the page can be viewed at:
+#
+# http://localhost:9988/
+#
+# where 9988 is the port specified for listening for APT requests.
+#
+
+# show_infopage = 1
+
+#
+# InfoPage Redirect
+#
+# A URL to redirect the info page to. The Show InfoPage option must be set to
+# True (1) for this to work.
+#
+
+# infopage_redirect = ""
+
+#
+# favicon
+#
+# The file containing x-icon data to return when a browser requests
+# favicon.ico from the APT request listener.
+#
+
+# favicon = ""
+
+#
+# Display Path
+#
+# Whether to display the full path or the torrent contents for each torrent on
+# the InfoPage.
+#
+
+# display_path = 0
+
+#
+# Allow Get
+#
+# Add a /file?hash={hash} url that allows users to download the torrent file
+# from the APT request listener's info page.
+#
+
+# allow_get = 0
+
+#
+# Log File
+#
+# The file to write the APT request listener logs to.
+#
+
+# logfile = "/var/log/debtorrent/apt_access.log"
+
+#
+# Min Time Between Log Flushes
+#
+# The minimum time it must have been since the last log flush to do another
+# one (in seconds).
+#
+
+# min_time_between_log_flushes = 3.0
+
+#
+# HUP Monitor
+#
+# Whether to reopen the log file upon receipt of a HUP signal.
+#
+
+# hupmonitor = 0
+
+#
+# Allowed IPs
+#
+# A file containing IPs to only allow connections from. The file must contain
+# a single subnet data on each line in the format:
+#
+# aa.bb.cc.dd/len
+#
+# Leaving this option empty allows all IPs to connect to the APT listener
+# (except for those listed in the Banned IPs ranges).
+#
+
+# allowed_ips = ""
+
+#
+# Banned IPs
+#
+# A file containing IPs to NOT allow connections from. The file must contain
+# IP range data on each line in the format:
+#
+# xxx:xxx:ip1-ip2
+#
+
+# banned_ips = ""
+
+#
+# APT Parse Directory Interval
+#
+# The number of seconds between reloading of Allowed and Banned IP lists
+# for the APT request listener.
+#
+
+# apt_parse_dir_interval = 60
+
+###############################################################################
+# B A C K U P H T T P D O W N L O A D E R
+###############################################################################
+#
+# Disable HTTP Downloader
+#
+# Whether to disable the backup HTTP downloader.
+#
+# WARNING: Disabling this may seriously impact the ability of the client to
+# find some packages. It is only intended for testing purposes.
+#
+
+# disable_http_downloader = 0
+
+###############################################################################
+# O T H E R T H I N G S
+###############################################################################
+#
+# Separate All
+#
+# Whether to separate the architecture:all packages into a separate torrent:
+#
+# 0 -- Don't separate, only run a single torrent for all packages
+# 1 -- Separate, and run the architecture:all torrent
+# 2 -- Separate, and run the the non-architecture:all torrent
+# 3 -- Separate, and run both torrents
+#
+
+# separate_all = 0
+
+###############################################################################
+# E N D O F N O R M A L O P T I O N S
+###############################################################################
+#
+# WARNING: The variables in the sections below control some of the inner
+# workings of the bittorrent client. You should not need to change
+# any of them, and it is NOT recommended that you change them unless
+# you are VERY familiar with bittorrent, as poor choices for some of
+# the variables can have bad results, such as other clients refusing
+# to connect to you.
+#
+###############################################################################
+
+###############################################################################
# B I T T O R R E N T O P T I O N S
###############################################################################
#
-# These variables control some of the inner workings of the bittorrent client.
-# It is NOT recommended that you change them unless you are VERY familiar with
-# bittorrent, as poor choices for some of the variables can result in other
-# clients refusing to connect to you.
-#
-###############################################################################
-#
# KeepAlive Interval
#
-# The number of seconds to pause between sending keepalive message to peers.
+# The number of seconds to wait between sending keepalive message to peers.
#
# keepalive_interval = 120.0
@@ -367,8 +473,8 @@
#
# Maximum Message Length
#
-# The maximum length (in bytes) prefix encoding you'll accept over the wire.
-# Larger values get the connection dropped.
+# The maximum length (in bytes) prefix encoding you'll accept over a
+# connection. Larger values get the connection dropped.
#
# max_message_length = 8388608
@@ -396,7 +502,7 @@
#
# Whether to send an incomplete bitfield and then fill it in with have
# messages, instead of sending a complete (all 1's) bitfield. This is used
-# in order to get around some stupid ISP manipulations.
+# in order to get around some bad ISP manipulations.
#
# breakup_seed_bitfield = 1
@@ -460,6 +566,59 @@
# security = 1
###############################################################################
+# T R A C K E R C O N N E C T I O N S
+###############################################################################
+#
+# Default Tracker
+#
+# The default tracker address to use for new torrents that don't specify one.
+#
+
+# default_tracker = "http://dttracker.debian.net:6969/announce"
+
+#
+# Rerequest Interval
+#
+# The time to wait between requesting more peers from the tracker (in seconds).
+#
+
+# rerequest_interval = 300
+
+#
+# Min Peers
+#
+# The minimum number of peers to not do tracker rerequesting when above.
+#
+
+# min_peers = 20
+
+#
+# Max Initiate
+#
+# The number of peers at which to stop initiating new connections to peers.
+#
+
+# max_initiate = 40
+
+#
+# Maximum Connections
+#
+# The absolute maximum number of peers to connect with. Set this to 0 to
+# disable the limit and allow all connections.
+#
+
+# max_connections = 0
+
+#
+# HTTP Timeout
+#
+# The number of seconds to wait before assuming that an HTTP connection to a
+# tracker has timed out.
+#
+
+# http_timeout = 60
+
+###############################################################################
# F I L E S Y S T E M
###############################################################################
#
@@ -473,8 +632,8 @@
#
# Write Buffer Size
#
-# The maximum amount of space to use for buffering disk writes, in megabytes
-# (0 = disabled).
+# The maximum amount of space to use for buffering disk writes, in megabytes.
+# Set this to 0 to disable disk write buffering.
#
# write_buffer_size = 4
@@ -482,7 +641,8 @@
#
# Maximum Files Open
#
-# The maximum number of files to keep open at a time (0 = no limit).
+# The maximum number of files to keep open at a time. Setting this to 0 will
+# impose no limit on the number of open files.
#
# max_files_open = 50
@@ -532,13 +692,14 @@
#
# Auto Flush
#
-# The number of minutes between automatic flushes to disk (0 = disabled).
+# The number of minutes between automatic flushes to disk. Setting this to 0
+# will flush the most frequently allowed (currently once per minute).
#
# auto_flush = 0
###############################################################################
-# A D V A N C E D B I T T O R R E N T S T U F F
+# A D V A N C E D F E A T U R E S
###############################################################################
#
# Super Seeder
@@ -556,151 +717,3 @@
#
# dedicated_seed_id = ""
-
-###############################################################################
-# B A C K U P H T T P D O W N L O A D E R
-###############################################################################
-#
-# Disable HTTP Downloader
-#
-# Whether to disable the backup HTTP downloader.
-#
-# WARNING: This may serously impact the ability of the client to find some
-# packages. It is only intended for testing purposes.
-#
-
-# disable_http_downloader = 0
-
-###############################################################################
-# O T H E R T H I N G S
-###############################################################################
-#
-# Display Path
-#
-# Whether to display the full path or the torrent contents for each torrent.
-#
-
-# display_path = 0
-
-#
-# Separate All
-#
-# Whether to separate the architecture:all packages into a separate torrent:
-#
-# 0 -- Don't separate, only run a single torrent for all packages
-# 1 -- Separate, and run the architecture:all torrent
-# 2 -- Separate, and run the the non-architecture:all torrent
-# 3 -- Separate, and run both torrents
-#
-
-# separate_all = 0
-
-###############################################################################
-# A P T L I S T E N E R
-###############################################################################
-#
-# Port
-#
-# The port to listen for apt requests on.
-#
-
-# port = 9988
-
-#
-# Log File
-#
-# File to write the APT request listener logs to.
-#
-
-# logfile = "/var/log/debtorrent/apt_access.log"
-
-#
-# Min Time Between Log Flushes
-#
-# The minimum time it must have been since the last log flush to do another
-# one (in seconds).
-#
-
-# min_time_between_log_flushes = 3.0
-
-#
-# HUP Monitor
-#
-# Whether to reopen the log file upon receipt of a HUP signal.
-#
-
-# hupmonitor = 0
-
-#
-# Show InfoPage
-#
-# Whether to display an information and statistics page when the APT
-# requester's root dir is loaded. If enabled, the page can be viewed at:
-#
-# http://localhost:9988/
-#
-# where 9988 is the port specified for listening for APT requests.
-#
-
-# show_infopage = 1
-
-#
-# InfoPage Redirect
-#
-# A URL to redirect the info page to. The Show InfoPage option must be set to
-# True (1) for this to work.
-#
-
-# infopage_redirect = ""
-
-#
-# favicon
-#
-# The file containing x-icon data to return when a browser requests
-# favicon.ico to the APT request listener.
-#
-
-# favicon = ""
-
-#
-# Allow Get
-#
-# Add a /file?hash={hash} url that allows users to download the torrent file
-# from the APT request linstener's info page.
-#
-
-# allow_get = 0
-
-#
-# Allowed IPs
-#
-# A file containing IPs to only allow connections from. The file must contain
-# a single subnet data on each line in the format:
-#
-# aa.bb.cc.dd/len
-#
-# Leaving this option empty allows all IPs to connect to the APT listener
-# (except for those listed in the Banned IPs ranges).
-#
-
-# allowed_ips = ""
-
-#
-# Banned IPs
-#
-# A file containing IPs to NOT allow connections from. The file must contain
-# IP range data on each line in the format:
-#
-# xxx:xxx:ip1-ip2
-#
-
-# banned_ips = ""
-
-#
-# apt_parse_dir_interval
-#
-# The number of seconds between reloading of allowed_ips and banned_ips lists
-# for the APT request listener.
-#
-
-# apt_parse_dir_interval = 60
More information about the Debtorrent-commits
mailing list