File: debtorrent-client.conf

package info (click to toggle)
debtorrent 0.1.9
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 1,452 kB
  • ctags: 1,183
  • sloc: python: 13,526; sh: 274; makefile: 51
file content (788 lines) | stat: -rw-r--r-- 19,522 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
###############################################################################
#              D E B T O R R E N T   C O N F I G U R A T I O N
###############################################################################
#
# This is a Windows-style INI file for configuring DebTorrent.
#
# Values that are strings are written surrounded by quotes, and the decoding
# routine automatically strips any quotes from the values. Booleans are 
# written as integers, with 0 being false, anything else is true. Decimal
# numbers are read in as floats. Anything other than strings, integers, and 
# floats may have unpredictable results. Lines beginning with a '#' are
# considered comments and are ignored, as are blank lines. There are no 
# sections, all configuration variables are global.
#
# This file should be placed in /etc/debtorrent
#

###############################################################################
#                              L O C A T I O N S
###############################################################################
#
# Download Directory
#
# The directory to save the downloaded files in. If left blank then the user's
# home directory will be used.
#

# download_dir = ""

#
# SaveAs Style
#
# How to name the torrent download directories:
#         1 -- <mirror>_dists_<suite>_<section>_binary-<arch>
#         2 -- <mirror> 
#
# WARNING: A SaveAs Style of 2 is experimental and may result in problems.
#

# saveas_style = 1

#
# Cache Directory
#
# The directory to use to get/store cache files. If left blank then a
# .DebTorrent directory in the user's home directory will be used.
#

# cache_dir = ""

#
# Expire Cache Data
#
# The number of days after which you wish to expire old cached data so that it
# will no longer be used. Set this to 0 to always use old cached data.
#

# expire_cache_data = 30

#
# Log Directory
#
# The directory to write the output logs to. If left blank, the cache
# directory will be used.
#

# log_dir = ""

#
# Log Level
#
# The log level to write output logs at. The possible values are:
#
#         50 -- Critical
#         40 -- Error
#         30 -- Warn (default)
#         20 -- Info
#         10 -- Debug
#

# log_level = 20

###############################################################################
#                              R A T E   L I M I T S
###############################################################################
#
# Maximum Upload Rate
#
# 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

#
# Maximum Download Rate
#
# The maximum rate to download at, in kB/s. Set to 0 to not limit the download
# rate.
#

# max_download_rate = 0

#
# Upload Rate Fudge
#
# The time equivalent of writing to kernel-level TCP buffer, for rate 
# adjustment (in seconds).
#

# upload_rate_fudge = 5.0

#
# TCP Ack Fudge
#
# 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

#
# Maximum Rate Period
#
# The maximum amount of time to guess the current rate estimate represents
# (in seconds).
#

# max_rate_period = 20.0

#
# Upload Unit Size
#
# When limiting the upload rate, how many bytes to send at a time.
#

# upload_unit_size = 1460

###############################################################################
#                     T O R R E N T   C O N N E C T I O N S
###############################################################################
#
# Bind
#
# A comma-separated list of IPs and hostnames to bind to listen on locally for
# connections from peers. Leaving this blank will cause it to listen on all
# IPs and hostnames.
#

# bind = ""

#
# IP
#
# 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 = ""

#
# Minimum Port
#
# The minimum port to try listening on. Only one port in the range given by
# the minimum and maximum will be used.
#

# minport = 10000

#
# Maximum Port
#
# The maximum port to try listening on. Only one port in the range given by
# the minimum and maximum will be used.
#

# maxport = 60000

#
# Random Port
#
# Whether to choose randomly inside the port range instead of counting up 
# linearly.
#

# random_port = 1

#
# IPv6 Enabled
#
# Allow the client to connect to peers via IPv6.
#

# ipv6_enabled = 0

#
# IPv6 Binds v4
#
# Whether an IPv6 server socket will also field IPv4 connections.
#

# ipv6_binds_v4 = 0

#
# Timeout
#
# Time to wait between closing sockets which nothing has been received on
# (in seconds).
#

# timeout = 300.0

#
# Timeout Check Interval
#
# Time to wait between checking if any connections have timed out (in seconds).
#

# timeout_check_interval = 60.0

###############################################################################
#                            E N C R Y P T I O N
###############################################################################
#
# These variables control the use of encryption by the client. Encyption can
# be used to speed up downloads for clients on ISPs that attempt to filter or
# shape bittorrent downloads. To see the recommended encryption level for your
# ISP, go to:
#
#         http://www.azureuswiki.com/index.php/Bad_ISPs
#
# The encryption levels listed here:
#
#         http://www.azureuswiki.com/index.php/Avoid_traffic_shaping
#
# correspond to DebTorrent configuration variables of:
#
#      Encryption
#        Level          crypto_allowed     crypto_only     crypto_stealth
#      ----------       --------------     -----------     --------------
#           0                 0                 0                0
#           1 (default)       1                 0                0
#           2                 1                 1                0
#           4                 1                 1                1
#
# The encryption standard followed, developed by Azureus, is available at:
#
#         http://www.azureuswiki.com/index.php/Message_Stream_Encryption
#
# DebTorrent supports both header-only and full-stream encryption, though
# header-only is only supported in one of DebTorrent's four encryption
# modes.
#
# These modes are:
#
# 0. No encryption permitted. The client won't make or accept any encrypted
#    connections.
#
# 1. Encryption enabled (default). The client will accept incoming
#    encrypted connections, and will make outgoing encrypted connections
#    if the tracker tells it that the peer requires it (and if the tracker has
#    the extensions to do so). In this mode, the client will recognize
#    header-only encryption.
#
# 2. Encrypted connections only. This restricts the client to only
#    connecting via encrypted links, and only via full stream encryption.
#    This may drastically affect the ability of the client to connect to
#    peers with a tracker that doesn't support the crypto extensions.
#
# 4. Full stealth encryption. Like the above mode, except it also modifies
#    tracker communications so that (assuming peers are coded properly) the
#    client will never receive any unencrypted incoming connection attempts.
#    If the tracker doesn't support the crypto extensions, this will also
#    effectively firewall the client.
#
###############################################################################
#
# Crypto Allowed
#
# Whether to allow the client to accept encrypted connections. The default
# value for this option is determined by the presence of the python "Crypto"
# module (debian package "python-crypto") necessary for encryption to work.
# It is therefore not recommended that you change the default, unless you want
# to specifically disable encryption.
#

# crypto_allowed = 0

#
# Crypto Only
#
# Whether to only create or allow encrypted connections.
#

# crypto_only = 0

#
# Crypto Stealth
#
# Whether to prevent all non-encrypted connection attempts.
#

# crypto_stealth = 0

###############################################################################
#                            A P T   R E Q U E S T S
###############################################################################
#
# APT Port
#
# The port to listen for APT requests on.
#

# apt_port = 9988

#
# Apt Bind
#
# A comma-separated list of IPs and hostnames to bind to listen on locally for
# connections from Apt clients. Leaving this blank will cause it to listen on
# all IPs and hostnames.
#

# apt_bind = ""

#
# 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?info_hash=<hash> url that allows users to download the dtorrent
# file from the APT request listener's info page.
#

# allow_get = 0

#
# 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 = ""

#
# Parse IP Files
#
# The number of seconds between reloading of Allowed and Banned IP lists
# for the APT request listener.
#

# parse_ip_files = 60

###############################################################################
#                           O T H E R   T H I N G S
###############################################################################
#
# 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

#
# 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 non-architecture:all torrent
#         3 -- Separate, and run both torrents
#
# WARNING: Using 0 will cause your torrent to be different from all peers
#          using the default of 3, which will make it difficult to find peers.
#          On testing/unstable, it will also prevent the use of unique piece
#          numbers to create a longer-lived torrent.
#          Using 1 or 2 will prevent DebTorrent from downloading some files
#          (architecture:all files for 2, non-architecture:all files for 1).
#          In other words, you probably want to leave this at the default.

# separate_all = 3

#
# Pieces URL
#
# The remote URL to use to fetch information on the splitting of large packages
# into pieces. This is probably only useful to users of non-Debian systems.
#

# pieces_url = merkel.debian.org/~camrdale/extrapieces/

#
# Long-lived Torrent URL
#
# The remote URL to use to fetch information on creating a long-lived torrent
# for testing or unstable using unique piece numbers. This is probably only
# useful to users of non-Debian systems.
#

# long_lived_torrent_url = merkel.debian.org/~camrdale/uniquepieces/

###############################################################################
#                   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
###############################################################################
#
# KeepAlive Interval
#
# The number of seconds to wait between sending keepalive message to peers.
#

# keepalive_interval = 120.0

#
# Download Slice Size
#
# The number of bytes to ask a peer for in a request. The default is 16384
# which is 16K or 2^14.
#

# download_slice_size = 16384

#
# Maximum Slice Length
#
# The maximum length slice to send to peers, in bytes, larger requests are 
# ignored. The default value is 131702 which is 128K or 2^17.
#

# max_slice_length = 131072

#
# Maximum Message Length
#
# The maximum length (in bytes) prefix encoding you'll accept over a
# connection. Larger values get the connection dropped. The default value is
# 8,388,608 which is 8M or 2^23.
#

# max_message_length = 8388608

#
# Rarest First Cutoff
#
# The number of downloaded pieces at which to switch from random piece
# selection to a rarest first piece policy.
#

# rarest_first_cutoff = 2

#
# Rarest First Priority Cutoff
#
# The number of peers which need to have a piece before completing other
# partial pieces takes priority over the rarest first piece policy.
#

# rarest_first_priority_cutoff = 5

#
# Breakup Seed Bitfield
#
# 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 bad ISP manipulations.
#

# breakup_seed_bitfield = 1

#
# Snub Time
#
# The number of seconds to wait for data to come in over a connection before 
# assuming it's semi-permanently choked.
#

# snub_time = 30.0

###############################################################################
#                     I N C E N T I V E   M E C H A N I S M
###############################################################################
#
# Max Uploads
# 
# The maximum number of peers to upload to at once.
#

# max_uploads = 7

#
# Minimum Uploads
#
# The number of uploads to fill out to with extra optimistic unchokes.
#

# min_uploads = 4

#
# Round Robin Period
#
# The number of seconds between the client's switching upload targets.
#

# round_robin_period = 30

#
# Auto Kick
#
# Whether to allow the client to automatically kick/ban peers that send bad 
# data.
#

# auto_kick = 1

#
# Security
#
# Whether to enable extra security features intended to prevent abuse. Enabling
# this feature will prevent the client from accepting multiple connections from
# the same IP address for the same torrent. It will also result in a banned
# peer's IP address being banned from all connections for the duration of the
# torrent. With Security set to 0, the ban would only apply to the combination
# of IP address and Peer ID sending bad data.
#

# 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"

#
# Force Tracker
#
# If set, this will force all new torrents to use this address for the tracker,
# regardless of the one specified for the torrent.
#
# WARNING: This may seriously limit the number of peers you can find, since
#          most will be using the address specified in the torrent. This option
#          is only intended for testing purposes.
#

# force_tracker = ""

#
# 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
###############################################################################
#
# Buffer Reads
#
# Whether to buffer disk reads.
#

# buffer_reads = 1

#
# Write Buffer Size
#
# 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

#
# Maximum Files Open
#
# 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

#
# Check Hashes
#
# Whether to re-check hashes of data already downloaded during startup.
#

# check_hashes = 1

#
# Double Check
#
# Whether to double-check data being written to the disk for errors (may 
# increase CPU load).
#

# double_check = 1

#
# Triple Check
#
# Whether to thoroughly check data being written to the disk (may slow disk 
# access).
#

# triple_check = 0

#
# Lock Files
#
# Whether to lock files the client is working with.
#

# lock_files = 1

#
# Lock While Reading
#
# Whether to lock access to files being read.
#

# lock_while_reading = 0

#
# Auto Flush
#
# 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   F E A T U R E S
###############################################################################
#
# Super Seeder
#
# Whether to use special upload-efficiency-maximizing routines (only for
# dedicated seeds).
#

# super_seeder = 0

#
# Dedicated Seed ID
#
# The code to send to a tracker identifying this client as a dedicated seed.
#

# dedicated_seed_id = ""