1
# $Id: giftd.conf.template,v 1.6 2004/09/08 12:05:32 mkern Exp $
2
###############################################################################
4
###############################################################################
10
# Boolean determining whether or not this file has been reviewed and is
11
# complete. giFT will fail to start unless this is non-zero. This is done
12
# so that we can make sure you, at the very least, read through this file.
19
# Space separated list of hosts to allow connection to giFT's interface
20
# protocol (running default on port 1213). This protocol is used for GUIs
21
# to communicate with giFT and could be considered a security risk to allow
22
# external connections.
24
# The following special keywords are supported:
26
# ALL - Synonym for 0.0.0.0/0
27
# LOCAL - Synonym for 127.0.0.0/8 192.168.0.0/16 172.0.0.0/11 10.0.0.0/8
29
# Bitwidth fields are optional.
36
# Port on which to listen for user interface connections. Unless you have a
37
# special need to talk to the client on a non-standard port, just accept the
41
# If you change this value, you will also need to modify the ui.conf
42
# configuration for the machine which will be making outgoing connections
48
# Determines whether or not to follow symbolic links. If this value is set
49
# non-zero, symlinks will be traversed and a directory inode tracking system
50
# will be used to ensure that giFT does not descend the same directory
51
# twice. If you do not have any symlinks or do not want them traversed, set
52
# this to 0 for a very minor efficiency gain.
54
# Windows users: this setting has no effect.
61
# Colon separated list of protocol plugins to load by default. If dynamic
62
# library support is enabled, the plugin specified will be stat'd to check if
63
# it is a loadable path. If that fails, the fallback method is to attempt to
64
# construct the fully qualified path based on the configured environment.
67
# Without dynamic library support, this plugin must have been compiled into
68
# your giFT binary. With, this plugin must exist in the installed
69
# plugin directory. giFT -V will output this path to you, if you are not
72
# Protocol names are case sensitive, so use OpenFT, not Openft.
74
# For example, to use the OpenFT and Gnutella protocols use:
80
plugins = OpenFT:Gnutella
82
###############################################################################
88
# Directory to store transfers while they are being operated on. Temporary
89
# state files are also kept here. It is recommended, but not required, that
90
# the incoming and completed directories are on the same partition (drive).
92
# Windows users: please use the following path specification:
94
# incoming=/[drive]/dir1/dir2
96
# For example, to refer to C:\Program Files\giFT\incoming, use:
98
# incoming=/C/Program Files/giFT/incoming
100
# Default (*nix): ~/.giFT/incoming
101
# Default (Windows): /C/Program Files/giFT/incoming
103
incoming = ~/.giFT/incoming
106
# Directory which will contain files after they have successfully finished
109
# Default (*nix): ~/.giFT/completed
110
# Default (Windows): /C/Program Files/giFT/completed
112
completed = ~/.giFT/completed
114
###############################################################################
115
# SHARE SUBMISSION AND UPLOAD CONTROL
120
# Maximum amount of uploads allowed from the same user at any given time. It
121
# is recommended that you keep this at 1 in order to prevent users from
122
# unfairly queueing your connection.
126
max_peruser_uploads = 1
129
# Determines whether or not to hide directories which contain a leading dot.
130
# These directories are commonly meant to be "hidden" and thus should not be
131
# submitted to the network. Selecting 0 here will submit all directories.
133
# On Windows files will additionally be checked for the hidden attribute and
134
# not shared if it is set and hide_dot_files is 1.
141
# Colon separated list of fully qualified paths you wish to share. These
142
# directories will be recursed at giFT's startup and the files contained
143
# within will be subjected to an MD5 hashing. The results will be cached and
144
# will only be recalculated on a per share basis when the size or
145
# modification time in the cache and on disk disagree, or the file name is
149
# Do NOT share source directories! Remote nodes will refuse to index your
150
# shares if you are attempting to submit more than 64000 files.
153
# Do not share directories which may contain sensitive information, such as
154
# ~ ($HOME). Also note that any directories shared here will be stripped of
155
# all but the last path element when submitted to other nodes for indexing,
156
# effectively "hiding" the directory prefix.
158
# Windows users: please use the following path specification:
160
# /[drive]/dir1/dir2:/[drive]/dir3/dir4 ...
162
# For example, to refer to C:\Program Files\giFT\shares and D:\shares, use:
164
# /C/Program Files/giFT/shares:/D/shares
171
# Maximum amount of simultaneous uploads allowed. Setting this to 0 will
172
# cause giFT to not limit outgoing transfers. Use shares_hidden to disable
180
# Whether we allow sharing. Setting this to 0 will allow sharing and uploads
181
# up to max_uploads. If this is 1 your shares will be hidden from the world
182
# and uploading will be denied. This may also be handled at run time via your
190
# Controls when giFT periodically rescans your shared directories for any
191
# changes (new files, missing files, changed files, etc.) and communicates
192
# those changes to the underlying protocols. This parameter specifies how
193
# often (in seconds) you want that to happen.
197
# 0 turns off periodic auto-resync
204
auto_resync_interval = 86400
207
# Controls whether or not giFT should automatically share files that you have
208
# finished downloading. This feature significantly improves the network's
209
# abundance of files and helps ease the load on those sharing popular files.
210
# It's a Good Thing (TM), please leave it on.
212
# Avoid setting your completed directories through sharing/root, as that
213
# setting will duplicate recursion of the completed directory and cause
214
# generally undesirable results.
221
# Controls whether giFT ignores the incoming directory when sharing files. If
222
# this is 1 and the incoming directory is within one of the sharing roots all
223
# files in and below it will not be shared. This is what you want in all known
224
# universes. Should you find yourself running this software on a parallel
225
# world where it is necessary to share the incoming files please make sure it
226
# doesn't affect us back here. Thank you.
232
###############################################################################
233
# USER SPACE BANDWIDTH CONTROL
238
# Bandwidth throttling allows giFT to have some basic control over your
239
# bandwidth usage. This code operates in user space, and as a result can not
240
# guarantee perfect accuracy. If you wish to use this feature, please
241
# consider using a more reliable kernel space option first. As always, google
242
# should be able to assist you there.
244
# The following configuration switches control the maximum number of bytes
245
# per second allowed for the given stream direction. A setting of 0 will
246
# disable throttling for that direction.