File: dircproxyrc

package info (click to toggle)
dircproxy 1.0.5-5etch1
  • links: PTS
  • area: main
  • in suites: etch
  • size: 1,120 kB
  • ctags: 740
  • sloc: ansic: 9,466; sh: 2,946; makefile: 113; perl: 70
file content (983 lines) | stat: -rw-r--r-- 33,210 bytes parent folder | download | duplicates (8)
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
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
# Welcome to dircproxy!
#
# This is an example configuration file, you can use it as a template to
# write your own.  Copy it to your home directory and name it
# .dircproxyrc to get it automatically picked up when you run dircproxy.
#
# You can also place it as /usr/local/etc/dircproxyrc if you want it globally
# installed, or anywhere else and load it with the -f parameter
#
# Before dircproxy will start you need to define a number of connection
# classes.  Instructions on how to do this are at the bottom of this file.
# Skip down and do that if you are happy to go with the defaults for
# everything else.
#
# All options are commented out, with their default value shown.  To set
# one you need to uncomment and change the value.


#------------------------------------------------------------------------------#
# GLOBAL OPTIONS
#
# These options may *not* be placed inside a configuration file, and affect
# the general operation of dircproxy.
#

# listen_port
#     What port should dircproxy listen for connections from IRC clients
#     on?
#
#     This can be a numeric port number, or a service name from /etc/services
#
#listen_port 57000

# pid_file
#     File to write the dircproxy process id to on startup.  If you start
#     this with a "~/" then it refers to a file in a directory under your
#     home directory.
#
#     none = Don't write pid file
#
#pid_file "none"

# client_timeout
#     Maxmimum amount of time (in seconds) a client can take to connect to
#     dircproxy and provide their password and nickname etc.
#
#client_timeout 60

# connect_timeout
#     Maximum amount of time (in seconds) a client has to provide a server
#     to connect to after they've logged in.  This only applies if
#     'server_autoconnect' is 'no' for that class.
#
#connect_timeout 60

# dns_timeout
#     Maximum amount of time (in seconds) to wait for a reply from a DNS
#     server.  If the time exceeds this then the lookup is cancelled.
#
#dns_timeout 20



#------------------------------------------------------------------------------#
# LOCAL OPTIONS
#
# The rest of the options in this configuration file may be placed in
# connection classes or in the main body of the configuration file.  If
# placed in the main body, they only affect connection classes
# defined *after* them in the configuration file.
#

# SERVER OPTIONS
#     Options affecting the connection to the IRC server.

# server_port
#     What port do we connect to IRC servers on if the server string doesn't
#     explicitly set one
#
#     This can be a numeric port number, or a service name from /etc/services
#
#server_port 6667

# server_retry
#     How many seconds after disconnection or last connection attempt do we
#     wait before retrying again?
#
#server_retry 15

# server_maxattempts
#     If we are disconnected from the server, how many times should we iterate
#     the server list before giving up and declaring the proxied connection
#     dead?
#
#     0 = iterate forever
#
#server_maxattempts 0

# server_maxinitattempts
#     On first connection, how many times should we iterate the server list
#     before giving up and declaring the proxied connection dead?
#
#     0 = iterate forever.  This isn't recommended.
#
#server_maxinitattempts 5

# server_keepalive
#     This checks whether the dircproxy to server connection is alive at the
#     TCP level.  If no data is sent in either direction for a period of time,
#     a TCP keepalive probe is sent.
#
#     yes = send keepalive probes
#      no = don't send keepalive probes
#
#server_keepalive no

# server_pingtimeout
#     For some people, dircproxy doesn't notice that the connection to the
#     server has been dropped because the socket remains open.  For example,
#     those behind a NAT'd firewall.  dircproxy can ping the server and make
#     sure it gets replies back.  If the time since the last reply was
#     received exceeds the number of seconds below the server is assumed to be
#     "stoned" and dircproxy leaves it.  If you have a high latency connection
#     to the server, it can wrongly assume the server is stoned because the
#     PINGs don't arrive in time.  Either raise the value, or use the
#     'server_keepalive' option instead.
#
#     0 = don't send PINGs
#
#server_pingtimeout 0

# server_throttle
#     To prevent you from being flooded off the IRC network, dircproxy can
#     throttle the connection to the server to prevent too much being sent
#     within a certain time period. 
#
#     For this you specify a number of bytes, then optionally a time period
#     in seconds seperated by a colon.  If the time period is ommitted then
#     per second is assmued.
#
#     server_throttle 10        # 10 bytes per second
#     server_throttle 10:2      # 10 bytes per 2 seconds (5 per second)
#
#     0 = do not throttle the connection
#
#server_throttle 1024:10

# server_autoconnect
#     Should dircproxy automatically connect to the first server in the list
#     when you connect.  If you set this to 'no', then 'allow_jump' is 
#     automatically set to 'yes'.  If 'allow_jump_new' is also 'yes', then you
#     can create connection classes with no 'server' lines.
#
#     yes = Automatically connect to the first server
#      no = Wait for a /DIRCPROXY JUMP from the client
#
#server_autoconnect yes


# CHANNEL OPTIONS
#     Options affecting channels you join.

# channel_rejoin
#     If we are kicked off a channel, how many seconds do we wait before
#     attempting to rejoin.
#
#     -1 = Don't rejoin
#      0 = Immediately
#
#channel_rejoin 15

# channel_leave_on_detach
#     Should dircproxy automatically make you leave all the channels you
#     were on when you detach?
#
#     yes = Leave them
#      no = Remain on them
#
#channel_leave_on_detach no

# channel_rejoin_on_attach
#     If 'channel_leave_on_detach' is 'yes' then should dircproxy rejoin
#     those channels when you attach again?
#
#     yes = Rejoin the channels dircproxy automatically left
#      no = Leave permanently on detach
#
#channel_rejoin_on_attach yes


# IDLE OPTIONS
#     Options affecting idle times on IRC.

# idle_maxtime
#     Set this to the maximum amount of time you want to appear idle for
#     while on IRC, if you set this then dircproxy will reset your idle
#     time if it reaches this limit (in seconds).
#
#     0 = Don't reset idle time
#
#idle_maxtime 0


# DISCONNECTION OPTIONS
#     Options affecting when dircproxy disconnects you.

# disconnect_existing_user
#     If, when you connect to dircproxy, another client is already using
#     your connection class (ie, if you forgot to close that one), then
#     this option lets you automatically kill that one off.  Make sure you
#     turn any "automatic reconnect to server" options off before using
#     this, otherwise you'll have a fight on your hands.
#
#     yes = Yes, disconnect
#      no = No, don't let me on
#
#disconnect_existing_user no

# disconnect_on_detach
#     When you detach from dircproxy it usually keeps you connected to the
#     server until you connect again.  If you don't want this, and you want
#     it to close your server connection as well, then set this.
#
#     yes = Close session on disconnection
#      no = Stay connected to server until reattachment
#
#disconnect_on_detach no


# MODE OPTIONS
#     Options affecting user modes set by the IRC server.

# initial_modes
#     Which user modes should we automatically set when you first connect
#     to a server.  Just in case you forget to do it yourself with your
#     irc client.
#
#     Set to "" to not set any modes.
#
#initial_modes "i"

# drop_modes
#     Which user modes to drop automatically when you detach, handy to
#     limit the impact that your client has while connected, or for extra
#     security if you're an IRCop.
#
#     Set to "" to not drop any modes.
#
#drop_modes "oOws"

# refuse_modes
#     Which user modes to refuse to accept from a server.  If the server
#     attempts to set one of these, then the connection to it will be dropped
#     and the next server in the list will be tried.
#
#     A good setting for many people would be "+r", as most servers use that
#     to mean your connection is restricted.  Don't set it to this if you're
#     on DALnet however, DALnet uses +r to indicate you have registered
#     with NickServ (gee, thanks guys!).
#
#     Set to "" to not refuse any modes.
#
#refuse_modes ""


# ADDRESS OPTIONS
#     Options affecting your address on IRC.

# local_address
#     Local hostname to use when connecting to an IRC server.  This provides
#     the same functionality as the ircII -H parameter.
#
#     none = Do not bind any specific hostname
#
#local_address "none"


# MESSAGE OPTIONS
#     Options affecting messages sent or set by dircproxy on behalf of you.

# away_message
#     If you don't explicitly set an /AWAY message before you detach, dircproxy
#     can for you, so people don't think you are really at your keyboard
#     when you're not.
#
#     none = Do not set an away message for you
#
#away_message "Not available, messages are logged"

# quit_message
#     If you don't explicitly give a message when you /DIRCPROXY QUIT, this
#     will be used instead.  Also used for when you've sent dircproxy not to
#     remain attached to the server on detachment.
#
#     none = Use dircproxy version number as QUIT message
#
#quit_message "none"

# attach_message
#     dircproxy can send an announcement onto every channel you are on when
#     you reattach to it, just to let everyone know you are back.  If you
#     start this with "/ME " then it will be sent as an ACTION CTCP message
#     (just like the ircII /me command).
#
#     none = Do not announce attachment
#
#attach_message "none"

# detach_message
#     dircproxy can send an announcement onto every channel you are on when
#     you detach from it, just to let everyone know you are gone.  If you
#     start this with "/ME " then it will be sent as an ACTION CTCP message
#     (just like the ircII /me command).
#
#     none = Do not announce detachment
#
#detach_message "none"

# detach_nickname
#     Nickname to change to automatically after you detach, to indicate you
#     are away for example.  If this contains a '*' character, then that
#     character is replaced with whataver your nickname was before you
#     detached (ie "*_away" adds "_away" to the end of your nickname);
#
#     none = Leave nickname as it is
#
#detach_nickname "none"


# NICKNAME OPTIONS
#     Options affecting your nickname

# nick_keep
#     Whether dircproxy should attempt to keep the nickname you last set
#     using your client.  If this is 'yes' and your nickname is lost while
#     your client is disconnected, then it will keep on trying to get it back
#     until a client connects again.
#
#     yes = try to keep my nickname while I'm disconnected
#     no = if it changes, leave it
#
#nick_keep yes


# CTCP OPTIONS
#     Options affecting CTCP replies

# ctcp_replies
#     Whether dircproxy should reply to the standard set of CTCP messages
#     while the client is detached.
#
#     yes = reply to ctcp messages while client is detached
#     no = nothing but silence
#
#ctcp_replies yes


# CHANNEL LOG OPTIONS
#     Options affecting logging of channel text.

# chan_log_enabled
#     Whether logging of channel text to files should take place.  If this
#     is 'yes', then you'll be able to recall channel text when you rejoin
#     and see what you missed.
#
#     yes = Channel text is logged to files
#      no = Channel text is NOT logged to files
#
#chan_log_enabled yes

# chan_log_always
#     Channel text will always be logged while you are offline, so when you
#     come back you can see what you missed.  You can also, if you wish, log
#     channel text while online, so if you're only away a short time you can
#     get an idea of any context etc.
#
#     This only applies if 'chan_log_enabled' is 'yes'.
#
#     yes = Log channel text while offline and online
#      no = Log channel text only while offline
#
#chan_log_always yes

# chan_log_maxsize
#     To preserve your harddisk space, you can limit the size of a channel
#     log file.  Once the log file reaches this number of lines, every line
#     added will result in a line removed from the top.  If you know you are
#     never going to want all that logged information, this might be a good
#     setting for you.
#
#     This only applies if 'chan_log_enabled' is 'yes'.
#
#     0 = No limit to log files
#
#chan_log_maxsize 0

# chan_log_recall
#     Number of lines from each channel log file to automatically recall
#     to your IRC client when you attach.  If this is low, you may not get
#     much useful information, if this is high, it may take a long time for
#     all the information to arrive.
#
#     This only applies if 'chan_log_enabled' is 'yes'.
#
#     -1 = Recall the whole log (not recommended if chan_log_always is yes)
#      0 = Don't automatically recall anything
#
#chan_log_recall 128

# chan_log_timestamp
#     Channel text can have a timestamp added to the front to let you know
#     exactly when a message was logged.  These timestamps are displayed when
#     you recall the log files, or when automatially dumped.
#
#     This applies to ordinary channel logs if 'chan_log_enabled' is 'yes'
#     and also to the permanent copy if 'chan_log_copydir' is set to something
#     other than 'none'.
#
#     yes = Include timestamp
#      no = Do not include timestamp
#
#chan_log_timestamp no

# chan_log_relativetime
#     If 'chan_log_timestamp' is 'yes' then you also have the option of
#     using intelligent relative timestamps.  If you do, the timestamp shown
#     when log file information is recalled depends on how old that line is,
#     making sure it displays enough information (including date if necessary).
#     Otherwise dircproxy will just tell you the time in HH:MM format which
#     may not be as useful.
#   
#     This does mean that the time itself won't be displayed in the log files
#     themselves, a timestamp is in place instead.  This may cause problems
#     if you're doing things with the log files yourself.
#
#     yes = Do fancy relative timestamping
#      no = Do normal timestamping
#
#chan_log_relativetime yes

# chan_log_copydir
#     As well as dircproxy's own log files, it can also keep a permanent
#     copy somewhere for your use.  dircproxy will append all channel text
#     seen to this file, but will not use it itself.
#
#     If you do define it, it'll add to each log as you use it.  If you
#     start with "~/" then it will use a directory under your home directory.
#
#     This is done regardless of the 'chan_log_enabled' and 'chan_log_always'
#     options, although if those are off then you won't get that text
#     recalled to your client, despite it being in this file.  The timestamping
#     options do apply however.
#
#     none = Do not make a permanent copy
#
#chan_log_copydir "none"

# chan_log_program
#     Program to pipe channel text into.  If given, dircproxy will run this
#     program for each log file entry giving the full source information as
#     the first argument, the destination as the second and the text as a
#     single line on standard input.
#
#     The program can be anywhere in your $PATH, or you can start it with
#     "~/" if its in a directory under your home directory.
#
#     This is done regardless of the 'chan_log_enabled' and 'chan_log_always'
#     options.
#
#     none = Do not pipe log messages to a program
#
#chan_log_program "none"


# OTHER LOG OPTIONS
#     Options affecting logging of server and private messages.

# other_log_enabled
#     Whether logging of server and private messages to files should take
#     place.  If this is 'yes', then you'll be able to recall server and
#     private messages when you rejoined and see what you missed.
#
#     yes = Server/private messages are logged to files
#      no = Server/private messages are NOT logged to files
#
#other_log_enabled yes

# other_log_always
#     Server and private messages will always be logged while you are offline,
#     so when you come back you can see what you missed.  You can also, if you
#     wish, log these messages while online, so if you're only away a short
#     time you can get an idea of any context etc.
#
#     This only applies if 'other_log_enabled' is 'yes'.
#
#     yes = Log server/private messages while offline and online
#      no = Log server/private messages only while offline
#
#other_log_always no

# other_log_maxsize
#     To preserve your harddisk space, you can limit the size of the
#     server/private message log file.  Once the log file reaches this number
#     of lines, every line added will result in a line removed from the top.
#     If you know you are never going to want all that logged information,
#     this might be a good setting for you.
#
#     This only applies if 'other_log_enabled' is 'yes'.
#
#     0 = No limit to log file
#
#other_log_maxsize 0

# other_log_recall
#     Number of lines from the server/private message log file to automatically
#     recall to your IRC client when you attach.  If this is low, you may not
#     get much useful information, if this is high, it may take a long time for
#     all the information to arrive.
#
#     This only applies if 'other_log_enabled' is 'yes'.
#
#     -1 = Recall the whole log (not recommended if other_log_always is yes)
#      0 = Don't automatically recall anything
#
#other_log_recall -1

# other_log_timestamp
#     Server and private messages can have a timestamp added to the front to
#     let you know exactly when a message was logged.  These timestamps are
#     displayed when you recall the log files, or when automatially dumped.
#
#     This applies to the server/private message log if 'other_log_enabled'
#     is 'yes' and also the permanent copy if 'other_log_copydir' is set to
#     something other than 'none'.
#
#     yes = Include timestamp
#      no = Do not include timestamp
#
#other_log_timestamp no

# other_log_relativetime
#     If 'other_log_timestamp' is 'yes' then you also have the option of
#     using intelligent relative timestamps.  If you do, the timestamp shown
#     when log file information is recalled depends on how old that line is,
#     making sure it displays enough information (including date if necessary).
#     Otherwise dircproxy will just tell you the time in HH:MM format which
#     may not be as useful.
#
#     This does mean that the time itself won't be displayed in the log files
#     themselves, a timestamp is in place instead.  This may cause problems
#     if you're doing things with the log files yourself.
#
#     yes = Do fancy relative timestamping
#      no = Do normal timestamping
#
#other_log_relativetime yes

# other_log_copydir
#     As well as dircproxy's own log file, it can keep a permanent copy
#     somewhere for your use.  dircproxy will append all server and private
#     messages seen to this file, but will not use it itself.
#
#     If you do define it, it'll add to the log as it uses it.  If you start
#     with "~/" then it will use a directory under your home directory.
#
#     This is done regardless of the 'other_log_enabled' and 'other_log_always'
#     options, although if those are off then won't get that text recalled
#     to your client, despite it being in this file.  The timestamping options
#     do apply however.
#
#     none = Do not make a permanent copy
#
#other_log_copydir "none"

# other_log_program
#     Program to pipe server and private messages into.  If given, dircproxy
#     will run this program for each log file entry giving the full source
#     information as the first argument, the destination as the second and
#     the text as a single line on standard input.
#
#     The program can be anywhere in your $PATH, or you can start it with
#     "~/" if its in a directory under your home directory.
#
#     This is done regardless of the 'other_log_enabled' and 'other_log_always'
#     options.
#
#     none = Do not pipe log messages to a program
#
#other_log_program "none"


# MISC LOG OPTIONS
#     Options affecting both channel and server/private message logs

# log_timeoffset
#     Differenice in minutes from your IRC client to the dircproxy machine.
#     So if you're in GMT, but your dircproxy machine is in PST (which is
#     8 hours behind), then this would be -(8 * 60) = -480.  Used for log
#     file timestamps.
#
#      0 = Don't adjust log timestamps.
#
#log_timeoffset 0

# log_events
#     Events you want dircproxy to log for you.  This is a comma seperated
#     list of event names, prefixed with '+' to add the event to the list or
#     '-' to remove an event.  You can also specify 'all' to log all events
#     (the default) or 'none' to not log anything.
#
#     Example, to just log text and action's:
#         log_events "none,+text,+action"
#
#     Example, to log everything but server messages:
#         log_events "all,-server"
#         log_events -server        # you don't need to specify 'all'
#
#     The possible events are:
#       text      Channel text and private messages
#       action    CTCP ACTION events (/me) sent to you or channels
#       ctcp      Whether to record whether a CTCP was sent to you
#       join      People (including you) joining channels
#       part      People (including you) leaving channels
#       kick      People (including you) being kicked from channels
#       quit      People quit'ing from IRC
#       nick      People (including you) changing nickname
#       mode      Changes in channel modes or your own personal mode
#       topic     Changes to the channel topic
#       client    You detaching and attaching
#       server    Connections and disconnections from servers
#       error     Problems and errors dircproxy encounters (recommended!)
#
#log_events all


# DCC PROXY OPTIONS
#     Options affecting proxying and capturing of DCC chat and send
#     requests.

# dcc_proxy_incoming
#     Whether dircproxy should proxy DCC chat and send requests sent
#     *to* you by others on IRC.
#
#     yes = Proxy incoming requests.
#      no = Do not proxy incoming requests.
#
#dcc_proxy_incoming yes

# dcc_proxy_outgoing
#     Whether dircproxy should proxy DCC chat and send requests sent
#     *by* you to others on IRC.
#
#     yes = Proxy outgoing requests.
#      no = Do not proxy outgoing requests.
#
#dcc_proxy_outgoing yes

# dcc_proxy_ports
#     Ports that dircproxy can use to listen for DCC connections on.
#     This is for when you're behind a firewall that only allows certain
#     ports through, or when doing DCC-via-ssh.
#
#     It is a comma seperated list of port numbers or ranges of ports,
#     for example '57100-57199,57400,57500,57600-57800'
#
#     any = Use any port given to us by the kernel.
#
#dcc_proxy_ports any

# dcc_proxy_timeout
#     Maxmimum amount of time (in seconds) to allow for both sides of
#     a DCC proxy to be connected.
#
#dcc_proxy_timeout 60

# dcc_proxy_sendreject
#     Whether to send a physical REJECT message via CTCP back to the
#     source of the request in event of failure.
#
#     yes = Send reject CTCP message back.
#      no = Do not send any message back.
#
#dcc_proxy_sendreject yes

# dcc_send_fast
#     Whether to ignore the "acknowledgment" packets from the client and
#     just send the file to them as fast as possible.  There should be no
#     real danger in doing this.
#
#     yes = Send as fast as possible.
#      no = Wait for each packet to be acknowledged.
#
#dcc_send_fast no

# dcc_capture_directory
#     dircproxy can capture files sent via DCC and store them on the
#     server.  Especially useful while you are detached, whether it
#     does it while attached or not depends on 'dcc_capture_always'.
#     This is the directory to store those captured files in.
#
#     If start with "~/" then it will use a directory under your home
#     directory.
#
#     none = Do not capture files.
#
#dcc_capture_directory "none"

# dcc_capture_always
#     If we're capturing DCC send's, should we do it while the client
#     is connected as well?  If 'yes', then the client will never see
#     the file, it'll be just stored on the server with a notice sent
#     to the client telling them where.
#
#     yes = Capture even when a client is connected.
#      no = Capture only when client detached.
#
#dcc_capture_always no

# dcc_capture_withnick
#     Whether to start the filename of the captured file with the
#     nickname of the sender, so you know who it came from.
#
#     yes = Start with nickname.
#      no = Do not alter the filename.
#
#dcc_capture_withnick no

# dcc_capture_maxsize
#     Maximum size (in kilobytes) that a captured file can be.  If
#     a captured file is larger than this, or becomes larger than
#     this, then the capture will be aborted and the file removed
#     from the disk.  Prevents people from filling your disk up while
#     you're detached with a massive file.
#
#     0 = No limit to file size.
#
#dcc_capture_maxsize 0

# dcc_tunnel_incoming
#     Port of a local ssh tunnel leading to another dircproxy client that
#     we should use for incoming DCC requests.  This should not be set if
#     'dcc_tunnel_outgoing' is set.
#
#     See the README.dcc-via-ssh file included with the dircproxy
#     distribution for more information.
#
#     This can be a numeric port number, or a service name from /etc/services
#
#     none = There is no tunnel.
#
#dcc_tunnel_incoming "none"

# dcc_tunnel_outgoing
#     Port of a local ssh tunnel leading to another dircproxy client that
#     we should use for outgoing DCC requests.  This should not be set if
#     'dcc_tunnel_incoming' is set.
#
#     See the README.dcc-via-ssh file included with the dircproxy
#     distribution for more information.
#
#     This can be a numeric port number, or a service name from /etc/services
#
#     none = There is no tunnel.
#
#dcc_tunnel_outgoing "none"


# ADVANCED OPTIONS
#     Options for the advanced user.

# switch_user
#     If you're running dircproxy as root, it can switch to a different
#     "effective user id" to create the server connection.  This means
#     that your system ident daemon (and therefore IRC, if it queries it)
#     will see your server connection as the user you put here, instead of
#     root.
#
#     This is most useful if you are sysadmin running a dircproxy server
#     for multiple people and want them to all appear as different usernames
#     without using a hacked identd.  Because dircproxy is still running as
#     root, it will have those privileges for all operations, including the
#     bind(2) for the 'local_address' config option if you're using Secure
#     Linux patches.
#
#     This can only be used if your system supports seteuid(2) and if you
#     are running dircproxy as the root user, and not just setuid.  Attempting
#     otherwise will generate a warning as dircproxy starts.
#
#     This can be a numeric uid or a username from /etc/passwd.
#
#     none = Do not do this.
#
#switch_user "none"


# MOTD OPTIONS
#     Options affecting the dircproxy message of the day.

# motd_logo
#     If this is yes, then the dircproxy logo and version number will be
#     included in the message of the day when you connect.  Only the picky
#     would turn this off, its pretty!
#
#     yes = Show me the pretty logo
#      no = I don't like logos, I'm boring, I eat llamas.
#
#motd_logo yes

# motd_file
#     Custom message of the day file to send when users connect to dircproxy.
#     The contents of this file will be sent after the logo and before the
#     stats.  If you start this with a "~/" then it refers to a file in
#     a directory under your home directory.
#
#     none = No custom motd
#
#motd_file "none"

# motd_stats
#     Display information on what channels you were on, and log file sizes
#     etc in the message of the day.  This is handy, and lets you know how
#     not only much information you missed, but how much will be sent to you.
#
#     yes = Show the stats
#      no = They don't interest me, don't show them.
#
#motd_stats yes


# COMMAND OPTIONS
#     Options allowing or disallowing use of /DIRCPROXY commands.

# allow_persist
#     You can disable the /DIRCPROXY PERSIST command here if you do not want
#     people using your proxy to be able to do that.
#
#     yes = Command enabled
#      no = Command disabled
#
#allow_persist yes

# allow_jump
#     You can disable the /DIRCPROXY JUMP command here if you do not want
#     people to do that.
#
#     yes = Command enabled
#     no = Command disabled
#
#allow_jump yes

# allow_jump_new
#     If the /DIRCPROXY JUMP commmand is enabled, then you can disable it being
#     used to jump to a server:port not in the list specified in the
#     configuration file.
#
#     yes = Can jump to any server
#     no = Only ones in the config file
#
#allow_jump_new yes

# allow_host
#     You can disable the /DIRCPROXY HOST command here if you do not want
#     people to do that.
#
#     yes = Command enabled
#     no = Command disabled
#
#allow_host yes

# allow_die
#     You can enable the /DIRCPROXY DIE command here if you want people
#     to be able to kill your proxy.  This isn't recommended, instead only
#     enable it for a specific connection class (ie yours).
#
#     yes = Command enabled
#     no = Command disabled
#
#allow_die no

# allow_users
#     You can enable the /DIRCPROXY USERS command here if you want people
#     to be able to see who's using your proxy.  This isn't recommended,
#     instead only enable it for a specific connection class (ie yours).
#
#     yes = Command enabled
#     no = Command disabled
#
#allow_users no

# allow_kill
#     You can enable the /DIRCPROXY KILL command here if you want people
#     to be able to disconnect anyone using your proxy (including you!).
#     This isn't recommended, instead only enable it for a specific
#     connection class (ie yours).
#
#     yes = Command enabled
#     no = Command disabled
#
#allow_kill no



#------------------------------------------------------------------------------#
# CONNECTION CLASSES
#
# Okay, thats the easy bit of the config file over and done with, now
# you have to define "connection classes" to allow yourself, and others
# if you wish, to connect to dircproxy.  Only one person may use a
# connection class at one time.
#
# You can define as many of these as you like!
#
# A connection class must have a password, and the address of at least
# one server (except as noted above) to connect to.  The password is
# compared with the one you configure your IRC client to use, and if they
# match then the connection class is used.
#
# Don't have two classes with the same password, as the second one will
# never be seen.
#
# Please note that although the passwords are shown here in plain text,
# they MUST be encrypted (unless you manually edit src/dircproxy.h and
# remove the ENCRYPTED_PASSWORDS #define).  Encrypt the passwords using
# your system's standard crypt(3) function, there's a handy utility
# installed with dircproxy called dircproxy-crypt(1) that can do this
# for you.  Its in the crypt directory of the source, or installed
# in the same place as dircproxy.
#
#connection {
#    # this password must by encrypted using dircproxy-crypt(1)
#    password "foobar"
#    server "irc.linux.com"
#}

# You can specify multiple servers, they are iterated if one fails or
# disconnects you.  You can also specify specific ports and
# optional passwords for a server, seperating the port and password with
# a ':'.  To use a default port, and a specific password, separate it
# from the server with a '::'.  (These passwords are *not* encrypted!)
#
# To provide extra security you can limit the places you can connect from
# using the 'from' keyword, specifying the hostname and/or IP address
# masks with * or ?.
#     from "*.myisp.com"
#     from "*.mywork.net"
# 
# You can also specify an initial channel set to be joined using the
# 'join' keyword.  Note that the list of channels MUST be surrounded
# by quotes (to distinguish from a comment) and seperated by commas.
#     join "#foo"
#     join "#foo,bar"
#
# Channel keywords should be seperated by the channel name with a space
# as you'd expect.
#     join "#foo key,#bar,#baz key2"
#
# Additionally, as already noted, any local option from above can be included
# to further configure the class. (but not the global options)
#
#connection {
#    # this password must by encrypted using dircproxy-crypt(1)
#    password "applejack"
#
#    server "irc.linux.com"
#    server "irc.openprojects.net:6668"
#    server "irc.linux.com:6668"
#    server "oper.irc.netsplit.com:6660:scrumpy"
#    server "oper.irc.gurgle.org::scrumpy"
#
#    from "*.myisp.com"
#    from "*.mywork.net"
#
#    join "#foo key,#bar"
#    join "#baz"
#
#    local_address "i.am.a.virtual.host.com"
#    away_message "I'm not here, go away!"
#
#    channel_rejoin -1
#    disconnect_existing_user yes
#
#    allow_die yes
#}