capircvd.conf

# structure of capircvd.conf:
#  this file contains several "sections" each beginning with a
#  "=sectionname". This sections contain "option value"
#  combinations. Samples later in this file...
#
# Every option has to be written in lowercase letters !
# Alle Optionen und Werte müssen in Kleinbuchstaben geschrieben sein! 
#
# !!! ATTENTION !!! Configure every option!
#  Missing options may result in loss of data !
#  or can cause capircvd to crash !!!
#
#

# The "global"-section:
# iprefix	string		# The prefix for your country, 1 for USA,
				# 49 for germany and so on
# nprefix	string		# The prefix for your region, 89 for munich
				# 5921 for nordhorn and so on
=global
iprefix		49
nprefix		5921
onerror		exit

# Using the controller-section you can activate some
# options for a specific controller. the number following
# specifies the controllernumber, i.e.: "=controller1"
# is for the first controller!
#
# Options are:
# numlength	integer		# specifies the number of digits
				# to be dialled by the caller

# prefix	string		# when a call arrives this number
				# is placed in front of the
				# calledpartynumber, useful
				# if your ISDN-equipment doesn't
				# transmit the whole number
				# !!! this number is placed in front of
				# the callednumber everytime !!!
# dontuse	boolean		# 'false' if you whish to use the controller
      				# which is default. 'true' if capircvd
				# shouldn't touch anything on this
				# controller!
# maxfax	integer		# how many b-channels can be used
				# for faxing...(not implemented/used!!!)
# onerror	string		# what to on error, if set to "exit"
				# known bugs cause capircvd to quit!

=controller1
numlength	12

=controller2
numlength	14
prefix		495921851
dontuse		true
maxfax		1

# the admin-section contains the password for the 'root'-user
# used only for telnet-session, which can be activated here...
#
# Options are:
# password	string		# sets the password for 'root'
# telnet	boolean		# 'true' activates the telnet-server
				# for remotecontrol of capircvd
# telnetport	integer		# defines the tcp-port the server
				# is running on (default: 20013)
# debug		integer		# changes debugmode (like cmdline)
				# cmdline overrides!

# The use of the telnet-server is not recommended for open environments
# use it only if you and all users from "passwd"-section know what they do!!!
# A better approach would be the use of a database with webinterface
# and a script which creates "capircvd.conf" from this database.
#  maybe this will be implemented later...

=admin
password	test
telnetport	20013
telnet		false
debug		0

# The passwd-sections contains passwords for telnet-users
# every section containing an option "user username"
# can be configured by username!
# Do not create a user 'root', the admin/password is for user 'root'!
# 

=passwd
alex		test

# the callednumber-section
# the name of the section is the calledpartynumber!
# options for this section configure the handling of an
# incoming call...
#
# Options are:
# mode		string		# defines what is being done with the call
				# these modes exist:

# mode ignore		# call is being ignored
			# no more options used!

# mode deflect		# activates calldeflect
			# valid options for deflect-mode are:
# delay	integer		# delay in seconds until cd is activated
# destination string	# destination of the cd

# mode voice		# call is a voicecall
			# valid options are:
# pin	integer		# the pin to identify the user
			# of this number, this pin is entered 
			# via DTMF while talking to the box...
# delay integer		# delay in seconds until call will be connected
# announcement string	# the filename of the announcement being played
			# relative to /var/spool/capircvd
# record string		# with "record" you can define when
			# recording should be started
			# "off" means: no recording, call
			# will be dropped after announcement
			# "later" means: after the announcement
			# the recording will be started 
# handler string	# the handler for received files
			# use capircvd.handler.
			# you can use own programs if yuo wish
			# for commandlineoptions to the handler
			# see sourcecode of capircvd.handler
# recipient string	# the mailadress the file is being sent to.
			# You can use other values if using an other
			# handler! 
# mailformat		# defines the format of the mail being sent.
			# in mode voice this options is ignored
			# in fax mode you can use
			# 'inline_jpeg' you receive mails with inline-images
			# 'attached_pdf_zip' send a zip containing a pdf-file
			#  which is default.
# filename string	# describes how filenames generated look like:
                        #       Parameters:
                        #        %1$s   calledparty
                        #        %2$s   callingparty
                        #        %3$d   auto_increment
                        #        %4$d   seconds since 1970-01-01 
                        #        %5$d   microseconds to %4
                        #        %6$d   year
                        #        %7$d   month
                        #        %8$d   day
                        #        %9$d   hour
                        #        %10$d  minute
                        #        %11$d  second
# example: filename     from-%2$s-to-%1$s-%3$06d_%6$04d-%7$02d-%8$02d_%9$02d-%10$02d-%11$02d.alaw
# results in            from-495459801045-to-495459801046-000041_2000-06-14_19-48-52.alaw
#
#	!!! ATTENTION !!! Use only correct formatstrings otherwise it is
#	  possible to crash capircvd (see "man 3 sprintf") !!!
#
#     	Don't use the character ":" !!!
#	  Some programs won't work with it!!!
#

# mode fax		# for receiving faxes, options are all of voice-options
			# and these ones:
# faxid	string		# The local faxid. The sender of a fax receives this
			# string. If the number of your fax is 495921851234
			# use this string: +49_5921_851234
			# '_' are replaced by a ' ' internally. Using real ' '
			# won't work because of limitations of the configfile

# mode ping		# gives you a "ping"-Interface. Enter the IP in octal
			# (10.1.0.1 is 01200200001, always with a starting 0)
                        # using DTMF and end with "#". Or enter in dotted quad
			# (10.1.0.1) with an "*" as "." and end it with "#",
			# i.e. press "10*1*0*1#" to test 10.1.0.1 !
			# It will try to ping and answer what's up...
			# You can use delay-option to set delay-time
			# Other options are senseless...
			# BE CAREFUL! While fping is running
			# nothing else works!!! Use ony if absolutely 
			# necessary!!! In future versions this behaviour
			# will be changed (maybe in 0.2.193 :-) ...
			# Use in a callingparty subsection to control use!

# More options:
#
# exec		string	# capircvd is running this program when a call
			# arrives, see capircvd.handler sourcecode 
# 

=default
handler		capircvd.handler
recipient	root@localhost

=4954597728
mode		ignore

# using callingparty to change options
# add a "+callingpartynumber" to the sectionname and it will
# modify the original section with its options
# the callingpartynumber needs not to complete!
# for example: +875 works for 875155 but not for 851234 as
# calling party 

=495459801045+495921875
mode		ignore
destination	1

=495459801045+4917
mode		deflect
delay		1
destination	01735282280

#
# default-section
# this sections defines default-values for all following sections!
# Use with caution !!!
#
=default
mode		voice
delay		10
announcement	Ansage_495459801061.alaw
recipient	root@localhost

# using the default-values
=495459801045
exec		capircvd.handler

# using the default-values
=495459801046
exec		capircvd.handler
delay		5
filename	from-%2$s-to-%1$s-%3$06d_%6$04d-%7$02d-%8$02d_%9$02d-%10$02d-%11$02d.alaw

# using the default-values, changing the default mode to fax
=default
mode		fax

# the following numbers are for fax but use the other options defined
# before...
=495459801062
recipient	alex@localhost
filename	from-%2$s-to-%1$s-%3$06d_%6$04d-%7$02d-%8$02d_%9$02d.%10$02d.%11$02d.sff
mailformat	inline_jpeg

=495459801063
recipient	root@localhost

=495459801061
mode		deflect
delay		10
destination	01735282280

=495459801064
mode		ping
delay		0